@graph8/sdk 0.362.0 → 0.373.0

package/stacks/intercom.json

@@ -2,7 +2,7 @@
   "$schema": "./stack.schema.json",
   "id": "intercom",
   "title": "Intercom-style support and chat",
-  "summary": "Web chat, a shared AI inbox, AI agents and the CRM records behind each conversation.",
+  "summary": "Web chat conversations, shared inbox, mailboxes and AI agents over your contacts.",
   "status": "available",
   "blocks": [
     "foundation",
@@ -12,42 +12,74 @@
     "inbox",
     "agents"
   ],
+  "home": "/inbox",
   "nav": [
+    {
+      "label": "Inbox",
+      "path": "/inbox",
+      "block": "inbox",
+      "component": "InboxScreen",
+      "icon": "Inbox",
+      "group": "Engage",
+      "description": "Replies from every channel in one place",
+      "page": "pages/inbox-contact.tsx.tmpl"
+    },
+    {
+      "label": "Conversations",
+      "path": "/conversations",
+      "block": "webchat",
+      "component": "WebchatScreen",
+      "icon": "MessageCircle",
+      "group": "Engage",
+      "description": "Live chat with your website visitors"
+    },
     {
       "label": "Contacts",
       "path": "/contacts",
       "block": "crm",
-      "component": "ContactTable"
+      "component": "ContactsScreen",
+      "icon": "Users",
+      "group": "Prospect",
+      "description": "People you sell to, with notes, tasks and activity",
+      "page": "pages/contacts.tsx.tmpl"
     },
     {
       "label": "Companies",
       "path": "/companies",
       "block": "crm",
-      "component": "CompanyTable"
-    },
-    {
-      "label": "Conversations",
-      "path": "/conversations",
-      "block": "webchat",
-      "component": "ConversationList"
+      "component": "CompaniesScreen",
+      "icon": "Building2",
+      "group": "Prospect",
+      "description": "Accounts and the people at them",
+      "page": "pages/companies.tsx.tmpl"
     },
     {
-      "label": "Mailboxes",
-      "path": "/mailboxes",
-      "block": "mailboxes",
-      "component": "MailboxList"
-    },
-    {
-      "label": "Inbox",
-      "path": "/inbox",
-      "block": "inbox",
-      "component": "InboxList"
+      "label": "Tasks",
+      "path": "/tasks",
+      "block": "crm",
+      "component": "TasksScreen",
+      "icon": "CheckSquare",
+      "group": "Work",
+      "description": "Follow-ups due across your records",
+      "page": "pages/tasks.tsx.tmpl"
     },
     {
       "label": "Agents",
       "path": "/agents",
       "block": "agents",
-      "component": "AgentBuilder"
+      "component": "AgentsScreen",
+      "icon": "Bot",
+      "group": "Automation",
+      "description": "AI agents that work your inbox and data"
+    },
+    {
+      "label": "Mailboxes",
+      "path": "/mailboxes",
+      "block": "mailboxes",
+      "component": "MailboxesScreen",
+      "icon": "Mail",
+      "group": "Setup",
+      "description": "Sending mailboxes and warmup health"
     }
   ]
 }

package/stacks/mailchimp/pages/companies.tsx.tmpl

@@ -0,0 +1,22 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { CompaniesScreen } from "@/components/g8/crm/companies-screen";
+import { RecordEngagementTab } from "@/components/g8/crm/record-engagement-tab";
+import { AddCompanyPeopleToListButton } from "@/components/g8/lists/add-company-people-to-list-button";
+import { useRouter } from "next/navigation";
+
+export default function Page() {
+  const router = useRouter();
+  return (
+    <CompaniesScreen
+      onOpenContact={(contact) => router.push(`/contacts?id=${contact.id}`)}
+      renderBulkActions={({ ids, clear }) => <AddCompanyPeopleToListButton companyIds={ids} onAdded={clear} />}
+      renderDetailActions={(c) => <AddCompanyPeopleToListButton companyIds={[c.id]} />}
+      extraDetailTabs={[
+        { id: "engagement", label: "Engagement", render: (c) => <RecordEngagementTab kind="companies" id={c.id} /> },
+      ]}
+    />
+  );
+}

package/stacks/mailchimp/pages/contacts.tsx.tmpl

@@ -0,0 +1,28 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { ContactsScreen } from "@/components/g8/crm/contacts-screen";
+import { RecordEngagementTab } from "@/components/g8/crm/record-engagement-tab";
+import { AddToListButton } from "@/components/g8/lists/add-to-list-button";
+import { RecordListsTab } from "@/components/g8/lists/record-lists-tab";
+import { useRouter } from "next/navigation";
+
+export default function Page() {
+  const router = useRouter();
+  return (
+    <ContactsScreen
+      onOpenCompany={(id) => router.push(`/companies?id=${id}`)}
+      renderBulkActions={({ ids, clear }) => <AddToListButton contactIds={ids} onAdded={clear} />}
+      renderDetailActions={(c) => (
+        <>
+          <AddToListButton contactIds={[c.id]} />
+        </>
+      )}
+      extraDetailTabs={[
+        { id: "lists", label: "Lists", render: (c) => <RecordListsTab contactId={c.id} onOpenList={(id) => router.push(`/lists?id=${id}`)} /> },
+        { id: "engagement", label: "Engagement", render: (c) => <RecordEngagementTab kind="contacts" id={c.id} /> },
+      ]}
+    />
+  );
+}

package/stacks/mailchimp/pages/lists.tsx.tmpl

@@ -0,0 +1,12 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { ListsScreen } from "@/components/g8/lists/lists-screen";
+
+/** A list member opens in Contacts. */
+export default function Page() {
+  const router = useRouter();
+  return <ListsScreen onOpenContact={(id) => router.push(`/contacts?id=${id}`)} />;
+}

package/stacks/mailchimp/pages/tasks.tsx.tmpl

@@ -0,0 +1,19 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { TasksScreen } from "@/components/g8/crm/tasks-screen";
+
+/** A task's linked record opens in the screen that owns it. */
+export default function Page() {
+  const router = useRouter();
+  return (
+    <TasksScreen
+      onOpenRecord={(record) => {
+        if (record.entity_type === "contact") router.push(`/contacts?id=${encodeURIComponent(record.entity_id)}`);
+        if (record.entity_type === "company") router.push(`/companies?id=${encodeURIComponent(record.entity_id)}`);
+      }}
+    />
+  );
+}

package/stacks/mailchimp.json

@@ -2,70 +2,104 @@
   "$schema": "./stack.schema.json",
   "id": "mailchimp",
   "title": "Mailchimp-style email marketing",
-  "summary": "Forms, newsletters, nurture journeys and the lists that feed them.",
+  "summary": "Forms, lists, newsletters and nurture tracks over your contacts.",
   "status": "available",
   "blocks": [
     "foundation",
+    "pickers",
     "crm",
     "forms",
     "lists",
     "newsletter",
-    "nurture"
+    "nurture",
+    "surveys"
   ],
+  "home": "/newsletter",
   "nav": [
+    {
+      "label": "Newsletter",
+      "path": "/newsletter",
+      "block": "newsletter",
+      "component": "NewsletterScreen",
+      "icon": "Newspaper",
+      "group": "Marketing",
+      "description": "Write, send and measure issues"
+    },
+    {
+      "label": "Nurture",
+      "path": "/nurture",
+      "block": "nurture",
+      "component": "NurtureScreen",
+      "icon": "Sprout",
+      "group": "Marketing",
+      "description": "Automated nurture tracks"
+    },
+    {
+      "label": "Surveys",
+      "path": "/surveys",
+      "block": "surveys",
+      "component": "SurveysScreen",
+      "icon": "ClipboardCheck",
+      "group": "Marketing",
+      "description": "NPS and CSAT: ask, score and read the answers"
+    },
+    {
+      "label": "Forms",
+      "path": "/forms",
+      "block": "forms",
+      "component": "FormsScreen",
+      "icon": "ClipboardList",
+      "group": "Marketing",
+      "description": "Forms and their submissions"
+    },
     {
       "label": "Contacts",
       "path": "/contacts",
       "block": "crm",
-      "component": "ContactTable"
+      "component": "ContactsScreen",
+      "icon": "Users",
+      "group": "Prospect",
+      "description": "People you sell to, with notes, tasks and activity",
+      "page": "pages/contacts.tsx.tmpl"
     },
     {
       "label": "Companies",
       "path": "/companies",
       "block": "crm",
-      "component": "CompanyTable"
+      "component": "CompaniesScreen",
+      "icon": "Building2",
+      "group": "Prospect",
+      "description": "Accounts and the people at them",
+      "page": "pages/companies.tsx.tmpl"
     },
     {
-      "label": "Forms",
-      "path": "/forms",
-      "block": "forms",
-      "component": "FormBuilder"
-    },
-    {
-      "label": "Submissions",
-      "path": "/submissions",
-      "block": "forms",
-      "component": "SubmissionsTable"
+      "label": "Tasks",
+      "path": "/tasks",
+      "block": "crm",
+      "component": "TasksScreen",
+      "icon": "CheckSquare",
+      "group": "Work",
+      "description": "Follow-ups due across your records",
+      "page": "pages/tasks.tsx.tmpl"
     },
     {
       "label": "Lists",
       "path": "/lists",
       "block": "lists",
-      "component": "ListTable"
+      "component": "ListsScreen",
+      "icon": "ListChecks",
+      "group": "Prospect",
+      "description": "Saved audiences you can sequence or sync",
+      "page": "pages/lists.tsx.tmpl"
     },
     {
       "label": "Suppressions",
       "path": "/suppressions",
       "block": "lists",
-      "component": "SuppressionManager"
-    },
-    {
-      "label": "Newsletter",
-      "path": "/newsletter",
-      "block": "newsletter",
-      "component": "NewsletterEditor"
-    },
-    {
-      "label": "Subscribers",
-      "path": "/subscribers",
-      "block": "newsletter",
-      "component": "SubscriberTable"
-    },
-    {
-      "label": "Nurture",
-      "path": "/nurture",
-      "block": "nurture",
-      "component": "NurtureBuilder"
+      "component": "SuppressionsScreen",
+      "icon": "ShieldOff",
+      "group": "Setup",
+      "description": "People and domains you never contact"
     }
   ]
 }

package/stacks/outreach/pages/calls.tsx.tmpl

@@ -0,0 +1,23 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { Button } from "@graph8/sdk/ui";
+import { UserRound } from "lucide-react";
+import { CallLogScreen } from "@/components/g8/dialer/call-log-screen";
+
+/** A call opens the person it was made to. */
+export default function Page() {
+  const router = useRouter();
+  return (
+    <CallLogScreen
+      renderDetailActions={(call) => call.contact_id ? (
+        <Button size="sm" variant="outline" onClick={() => router.push(`/contacts?id=${encodeURIComponent(call.contact_id as string)}`)}>
+          <UserRound className="mr-1 size-4" aria-hidden />
+          Open contact
+        </Button>
+      ) : null}
+    />
+  );
+}

package/stacks/outreach/pages/companies.tsx.tmpl

@@ -0,0 +1,22 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { CompaniesScreen } from "@/components/g8/crm/companies-screen";
+import { RecordEngagementTab } from "@/components/g8/crm/record-engagement-tab";
+import { AddCompanyPeopleToListButton } from "@/components/g8/lists/add-company-people-to-list-button";
+import { useRouter } from "next/navigation";
+
+export default function Page() {
+  const router = useRouter();
+  return (
+    <CompaniesScreen
+      onOpenContact={(contact) => router.push(`/contacts?id=${contact.id}`)}
+      renderBulkActions={({ ids, clear }) => <AddCompanyPeopleToListButton companyIds={ids} onAdded={clear} />}
+      renderDetailActions={(c) => <AddCompanyPeopleToListButton companyIds={[c.id]} />}
+      extraDetailTabs={[
+        { id: "engagement", label: "Engagement", render: (c) => <RecordEngagementTab kind="companies" id={c.id} /> },
+      ]}
+    />
+  );
+}

package/stacks/outreach/pages/contacts.tsx.tmpl

@@ -0,0 +1,46 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { RecordMeetingsTab } from "@/components/g8/appointments/record-meetings-tab";
+import { ContactsScreen } from "@/components/g8/crm/contacts-screen";
+import { RecordEngagementTab } from "@/components/g8/crm/record-engagement-tab";
+import { CallContactButton } from "@/components/g8/dialer/call-contact-button";
+import { RecordCallsTab } from "@/components/g8/dialer/record-calls-tab";
+import { RecordConversationsTab } from "@/components/g8/inbox/record-conversations-tab";
+import { AddToListButton } from "@/components/g8/lists/add-to-list-button";
+import { RecordListsTab } from "@/components/g8/lists/record-lists-tab";
+import { AddToSequenceButton } from "@/components/g8/sequencer/add-to-sequence-button";
+import { RecordSequencesTab } from "@/components/g8/sequencer/record-sequences-tab";
+import { useRouter } from "next/navigation";
+
+export default function Page() {
+  const router = useRouter();
+  return (
+    <ContactsScreen
+      onOpenCompany={(id) => router.push(`/companies?id=${id}`)}
+      renderBulkActions={({ ids, clear }) => (
+        <>
+          <AddToSequenceButton contactIds={ids} onEnrolled={clear} />
+          <AddToListButton contactIds={ids} onAdded={clear} />
+        </>
+      )}
+      renderDetailActions={(c) => (
+        <>
+          <AddToSequenceButton contactIds={[c.id]} />
+          <AddToListButton contactIds={[c.id]} />
+          {/* One call to this contact through the dialer; confirmed, and your softphone joins it. */}
+          <CallContactButton contact={{ id: c.id, first_name: c.first_name, last_name: c.last_name, full_name: c.full_name, email: c.work_email, company: c.company_name, mobile_phone: c.mobile_phone, direct_phone: c.direct_phone }} />
+        </>
+      )}
+      extraDetailTabs={[
+        { id: "lists", label: "Lists", render: (c) => <RecordListsTab contactId={c.id} onOpenList={(id) => router.push(`/lists?id=${id}`)} /> },
+        { id: "sequences", label: "Sequences", render: (c) => <RecordSequencesTab contactId={c.id} onOpenSequence={(id) => router.push(`/sequences?id=${encodeURIComponent(id)}`)} /> },
+        { id: "meetings", label: "Meetings", render: (c) => <RecordMeetingsTab contactId={c.id} onOpenMeeting={(sel) => router.push(`/meetings?sel=${encodeURIComponent(sel)}`)} /> },
+        { id: "calls", label: "Calls", render: (c) => <RecordCallsTab contact={{ id: c.id, first_name: c.first_name, last_name: c.last_name, full_name: c.full_name, email: c.work_email, company: c.company_name, mobile_phone: c.mobile_phone, direct_phone: c.direct_phone }} onOpenCall={(room) => router.push(`/calls?id=${encodeURIComponent(room)}`)} /> },
+        { id: "conversations", label: "Conversations", render: (c) => <RecordConversationsTab email={c.work_email} alsoEmails={[c.personal_emails]} onOpenThread={(sel) => router.push(`/inbox?id=${encodeURIComponent(sel)}`)} /> },
+        { id: "engagement", label: "Engagement", render: (c) => <RecordEngagementTab kind="contacts" id={c.id} /> },
+      ]}
+    />
+  );
+}

package/stacks/outreach/pages/inbox-contact.tsx.tmpl

@@ -0,0 +1,13 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { ContactLookupLink } from "@/components/g8/crm/contact-lookup-link";
+import { InboxScreen } from "@/components/g8/inbox/inbox-screen";
+
+/** A conversation opens the sender when they are a contact in your CRM. */
+export default function Page() {
+  const router = useRouter();
+  return <InboxScreen renderDetailActions={(thread) => <ContactLookupLink email={thread.contact?.email} onOpen={(id) => router.push(`/contacts?id=${id}`)} />} />;
+}

package/stacks/outreach/pages/lists.tsx.tmpl

@@ -0,0 +1,12 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { ListsScreen } from "@/components/g8/lists/lists-screen";
+
+/** A list member opens in Contacts. */
+export default function Page() {
+  const router = useRouter();
+  return <ListsScreen onOpenContact={(id) => router.push(`/contacts?id=${id}`)} />;
+}

package/stacks/outreach/pages/meetings.tsx.tmpl

@@ -0,0 +1,13 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { MeetingContactLinks } from "@/components/g8/appointments/meeting-contact-links";
+import { MeetingsScreen } from "@/components/g8/appointments/meetings-screen";
+
+/** A meeting opens the attendees who are contacts in your CRM. */
+export default function Page() {
+  const router = useRouter();
+  return <MeetingsScreen renderDetailActions={(selection) => <MeetingContactLinks selection={selection} onOpenContact={(id) => router.push(`/contacts?id=${id}`)} />} />;
+}

package/stacks/outreach/pages/sequences.tsx.tmpl

@@ -0,0 +1,12 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { SequencesScreen } from "@/components/g8/sequencer/sequences-screen";
+
+/** An enrolled person opens in Contacts. */
+export default function Page() {
+  const router = useRouter();
+  return <SequencesScreen onOpenContact={(id) => router.push(`/contacts?id=${id}`)} />;
+}

package/stacks/outreach/pages/tasks.tsx.tmpl

@@ -0,0 +1,19 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { TasksScreen } from "@/components/g8/crm/tasks-screen";
+
+/** A task's linked record opens in the screen that owns it. */
+export default function Page() {
+  const router = useRouter();
+  return (
+    <TasksScreen
+      onOpenRecord={(record) => {
+        if (record.entity_type === "contact") router.push(`/contacts?id=${encodeURIComponent(record.entity_id)}`);
+        if (record.entity_type === "company") router.push(`/companies?id=${encodeURIComponent(record.entity_id)}`);
+      }}
+    />
+  );
+}