@graph8/sdk 0.373.0 → 0.374.0

package/dist/types/blocks/auth.d.ts

@@ -0,0 +1,45 @@
+/**
+ * `create --auth <preset>`: scaffold sign-in for a generated app so it can go live, using the presets in
+ * blocks/_foundation/server/auth.ts. Pure planning helpers (string in, string out) plus one file write for the
+ * development secrets, so they are easy to test. Without `--auth`, nothing here runs and the app is generated
+ * exactly as before (the proxy keeps refusing a production build until `authorize` is set).
+ *
+ * Files a preset adds or changes:
+ *   - g8.auth.ts (every preset): `export const appAuth = <preset>()`, documented
+ *   - app/api/g8/[...path]/route.ts: `authorize: appAuth.authorize`
+ *   - app/api/g8-auth/route.ts + app/layout.tsx wrapped in <G8AuthGate> (password, jwt, session: the sign-in screen)
+ *   - middleware.ts (basic: the browser's prompt protects every page)
+ *   - README.md "Sign-in" section and .env.local.example variables; .env.local gets fresh secrets (password, basic)
+ */
+export declare const AUTH_PRESETS: readonly ["password", "basic", "jwt", "session", "anonymous"];
+export type AuthPreset = (typeof AUTH_PRESETS)[number];
+export declare const AUTH_CONFIG_FILE = "g8.auth.ts";
+export declare const AUTH_ROUTE_FILE = "app/api/g8-auth/route.ts";
+export declare function isAuthPreset(v: string): v is AuthPreset;
+/** Presets whose visitors see the in-app sign-in screen (G8AuthGate + /api/g8-auth). */
+export declare function usesSignInScreen(p: AuthPreset): boolean;
+export declare function authSummary(p: AuthPreset): string;
+/** The variables a preset reads, as `.env.local.example` lines (no values). */
+export declare function authEnvLines(p: AuthPreset): string[];
+export interface AuthFile {
+    rel: string;
+    content: string;
+}
+/** The new files a preset writes (g8.auth.ts, the sign-in route or middleware.ts). */
+export declare function planAuthFiles(p: AuthPreset, templatesRoot: string): AuthFile[];
+/**
+ * The generated proxy route with `authorize: appAuth.authorize` set (the commented example line replaced) and
+ * the g8.auth import added. Null when the route does not have the generated shape (the user owns it).
+ */
+export declare function applyAuthToRoute(source: string): string | null;
+/** app/layout.tsx with the app inside <G8AuthGate> (on brand through BrandProvider) and a Sign out button. */
+export declare function applyAuthToLayout(source: string): string | null;
+/** README.md with a "Sign-in" section before "Go live" and the `authorize` checklist item marked as done by the preset. */
+export declare function applyAuthToReadme(source: string, p: AuthPreset): string | null;
+/** .env.local.example with the preset's variables appended. */
+export declare function applyAuthToEnvExample(source: string, p: AuthPreset): string;
+/**
+ * Fresh development secrets for presets that need them, appended to `.env.local` (git-ignored by the template)
+ * without touching variables that are already set. Returns the names written. Values are never printed.
+ */
+export declare function writeAuthSecrets(root: string, p: AuthPreset): string[];

package/dist/types/blocks/create.d.ts

@@ -9,9 +9,10 @@
  */
 import { type OrgBrandValues, type BrandOptions } from "./brand";
 import { type AddIO, type PackageManager } from "./add";
+import { type AuthPreset } from "./auth";
 import { componentImportPath, navParts, navUsesExtras, pageFileFor, render } from "./navfile";
 import { type Registry, type Stack, type StackNav } from "./registry";
-export declare const CREATE_USAGE = "Usage: npx @graph8/sdk create <stack> <dir> [options]\n\nScaffold a Next.js (App Router, TypeScript, Tailwind CSS v4) app for a stack and\ninstall the stack's blocks into it. Run `graph8-sdk list` to see the stacks.\n  --package-manager <npm|pnpm|yarn|bun>   default: the one running the command, else npm\n  --no-install      write the files and blocks, do not install dependencies\n  --dry-run         print what would be written, write and install nothing\n  --force           allow a non-empty <dir> (template files are overwritten, and graph8.json\n                    is reset: blocks you added to that app earlier are no longer recorded)\nThen: `npm run dev` in <dir>, open http://localhost:3000 and paste a graph8 API key (local preview), and run\n`npx @graph8/sdk doctor --stack <stack>` (add --production before going live).\n\nOr pick the features yourself, for any app (also: `create custom --blocks ...`):\n  npx @graph8/sdk create --blocks <id,id,...> [--title \"Acme CRM\"] <dir> [options]\nEvery requested block's dependencies come with it. The app gets one route and one sidebar entry per finished\nScreen of the requested blocks, plus the user-facing Screens of their dependencies (asking for deals also gives\nyou crm's screens). `/` opens the analytics screen if you asked for one, else the first screen.\n  --title <text>          the app's name (default: graph8 app)\n  --with-deps-screens     also add the plain fallback page of dependency blocks that have no Screen\n  --no-deps-screens       add screens only for the blocks you named\nRun `graph8-sdk list` to see each block and which have Screens.\n\nBrand it (any stack or --blocks; the same as running `graph8-sdk brand` in the new app afterwards):\n  --name <text>             the app's name (with --blocks, the same as --title)\n  --brand-color <hex>       primary colour, AA-checked; --dark-brand-color <hex> for dark mode\n  --logo <path>             svg/png/jpg/webp/gif, shown in the sidebar\n  --app-url <url>           white-label: where \"Open in graph8\" links go; --link-label <text>: what they call it\nWith a graph8 API key (G8_API_KEY in the environment or .env.local) the org's Brand Kit fills in what you did not\npass: the app name, the primary colour and the logo (downloaded into public/brand/). No key, no kit or an error:\nthe default look, one info line, never a failure. --no-org-brand skips it.\nA directory literally named `custom` would read as the alias: pass `--blocks crm ./custom`.";
+export declare const CREATE_USAGE = "Usage: npx @graph8/sdk create <stack> <dir> [options]\n\nScaffold a Next.js (App Router, TypeScript, Tailwind CSS v4) app for a stack and\ninstall the stack's blocks into it. Run `graph8-sdk list` to see the stacks.\n  --package-manager <npm|pnpm|yarn|bun>   default: the one running the command, else npm\n  --no-install      write the files and blocks, do not install dependencies\n  --dry-run         print what would be written, write and install nothing\n  --force           allow a non-empty <dir> (template files are overwritten, and graph8.json\n                    is reset: blocks you added to that app earlier are no longer recorded)\n  --auth <preset>   scaffold sign-in so the app can go live (sets `authorize` on the proxy route):\n                      password   one shared team password, session cookie, sign-in screen\n                      basic      HTTP Basic auth on every page (the browser asks)\n                      jwt        your identity provider's JWT (OIDC JWKS or an HS256 secret)\n                      session    your own session library (Clerk, NextAuth, Supabase): wire g8.auth.ts\n                      anonymous  NO sign-in: anyone who can reach the app uses its key (public demos)\n                    Without --auth: local preview only, and a production build refuses /api/g8 until you\n                    set `authorize` yourself (unchanged).\nThen: `npm run dev` in <dir>, open http://localhost:3000 and paste a graph8 API key (local preview), and run\n`npx @graph8/sdk doctor --stack <stack>` (add --production before going live).\n\nOr pick the features yourself, for any app (also: `create custom --blocks ...`):\n  npx @graph8/sdk create --blocks <id,id,...> [--title \"Acme CRM\"] <dir> [options]\nEvery requested block's dependencies come with it. The app gets one route and one sidebar entry per finished\nScreen of the requested blocks, plus the user-facing Screens of their dependencies (asking for deals also gives\nyou crm's screens). `/` opens the analytics screen if you asked for one, else the first screen.\n  --title <text>          the app's name (default: graph8 app)\n  --with-deps-screens     also add the plain fallback page of dependency blocks that have no Screen\n  --no-deps-screens       add screens only for the blocks you named\nRun `graph8-sdk list` to see each block and which have Screens.\n\nBrand it (any stack or --blocks; the same as running `graph8-sdk brand` in the new app afterwards):\n  --name <text>             the app's name (with --blocks, the same as --title)\n  --brand-color <hex>       primary colour, AA-checked; --dark-brand-color <hex> for dark mode\n  --logo <path>             svg/png/jpg/webp/gif, shown in the sidebar\n  --app-url <url>           white-label: where \"Open in graph8\" links go; --link-label <text>: what they call it\nWith a graph8 API key (G8_API_KEY in the environment or .env.local) the org's Brand Kit fills in what you did not\npass: the app name, the primary colour and the logo (downloaded into public/brand/). No key, no kit or an error:\nthe default look, one info line, never a failure. --no-org-brand skips it.\nA directory literally named `custom` would read as the alias: pass `--blocks crm ./custom`.";
 export interface CreateOptions {
     stack: string;
     dir: string;
@@ -28,6 +29,8 @@ export interface CreateOptions {
     brand?: Omit<BrandOptions, "dir" | "dryRun">;
     /** false with `--no-org-brand`: do not pull the org's Brand Kit. */
     orgBrand?: false;
+    /** `--auth <preset>`: scaffold sign-in (g8.auth.ts, `authorize` on the proxy route). */
+    auth?: AuthPreset;
 }
 export declare function parseCreateArgs(argv: string[]): CreateOptions;
 /** What `graph8.json` records about a custom app, so `add` and `doctor` know its routes. */
@@ -61,7 +64,7 @@ interface OutFile {
 export declare function stackProblem(reg: Registry, stack: Stack): string | null;
 /** Absolute path of a nav entry's hand-written page template, or null when it uses the generic route page. */
 export declare function stackPageFile(reg: Registry, stack: Stack, n: StackNav): string | null;
-export declare function planCreate(reg: Registry, stack: Stack, appName: string, pm: PackageManager, io: CreateIO, app?: AppRecord): OutFile[];
+export declare function planCreate(reg: Registry, stack: Stack, appName: string, pm: PackageManager, io: CreateIO, app?: AppRecord, auth?: AuthPreset): OutFile[];
 /** Run `create`. Returns the process exit code. */
 export declare function runCreate(given: CreateOptions, reg: Registry, io: CreateIO, cwd: string): number;
 export { componentImportPath, navParts, navUsesExtras, pageFileFor, render };

package/dist/types/version.d.ts

@@ -5,6 +5,6 @@
  * both together (the version-parity gate already pins package.json, the
  * lockfile and the CHANGELOG to each other).
  */
-export declare const SDK_VERSION = "0.373.0";
+export declare const SDK_VERSION = "0.374.0";
 /** Value of the `X-G8-Client` header every SDK request carries (I-13). */
-export declare const SDK_CLIENT_ID = "js-sdk/0.373.0";
+export declare const SDK_CLIENT_ID = "js-sdk/0.374.0";

package/docs/api/forms.md

@@ -1507,7 +1507,7 @@ The inventory filter set a saved view stores. Mirrors `PaginationRequest`.
 | `mapping_state` | `"mapped" \| "unmapped" \| null` | no |  |
 | `owner_id` | `string \| null` | no | max length 200 |
 | `page` | `integer` | no | default `1`, min 1 |
-| `per_page` | `integer` | no | default `20`, min 1 |
+| `per_page` | `integer` | no | default `20`, min 1, max 500 |
 | `saved_view` | `"live" \| "needs_setup" \| "failing" \| "ignored" \| "healthy" \| "failures" \| "new_fields" \| "no_recent_submissions" \| … \| null` | no |  |
 | `search` | `string \| null` | no | max length 200 |
 | `sort_field` | `"submissions_30d" \| "total_submissions" \| "latest_submitted_at" \| "form_tag_id" \| null` | no |  |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graph8/sdk",
-  "version": "0.373.0",
+  "version": "0.374.0",
   "description": "graph8 SDK - CRM, enrichment, sequences, campaigns, and tracking for B2B",
   "license": "MIT",
   "author": "graph8 <support@graph8.com> (https://graph8.com)",

package/stacks/6sense/pages/contacts.tsx.tmpl

@@ -4,6 +4,7 @@
 // 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 { RecordSocialTab } from "@/components/g8/signals/record-social-tab";
 import { useRouter } from "next/navigation";
 
 export default function Page() {
@@ -13,6 +14,7 @@ export default function Page() {
       onOpenCompany={(id) => router.push(`/companies?id=${id}`)}
       extraDetailTabs={[
         { id: "engagement", label: "Engagement", render: (c) => <RecordEngagementTab kind="contacts" id={c.id} /> },
+        { id: "social", label: "Social posts", render: (c) => <RecordSocialTab contactId={c.id} onOpenListeners={() => router.push("/social-listening")} /> },
       ]}
     />
   );

package/stacks/6sense.json

@@ -8,7 +8,9 @@
     "foundation",
     "crm",
     "intent",
+    "signals",
     "visitors",
+    "web-analytics",
     "radar",
     "company-intelligence"
   ],
@@ -23,6 +25,15 @@
       "group": "Signals",
       "description": "Accounts showing buying intent"
     },
+    {
+      "label": "Social listening",
+      "path": "/social-listening",
+      "block": "signals",
+      "component": "SocialListenersScreen",
+      "icon": "Ear",
+      "group": "Signals",
+      "description": "Posts about you, competitors and keywords"
+    },
     {
       "label": "Visitors",
       "path": "/visitors",
@@ -32,6 +43,15 @@
       "group": "Signals",
       "description": "Who is on your website right now"
     },
+    {
+      "label": "Web analytics",
+      "path": "/web-analytics",
+      "block": "web-analytics",
+      "component": "WebAnalyticsScreen",
+      "icon": "ChartNoAxesCombined",
+      "group": "Signals",
+      "description": "Traffic, audience, engagement and conversions for your sites"
+    },
     {
       "label": "Competitors",
       "path": "/competitors",

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

@@ -3,21 +3,21 @@
 // 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 { RecordOpenLinks } from "@/components/g8/crm/record-open-links";
 import { CallLogScreen } from "@/components/g8/dialer/call-log-screen";
 
-/** A call opens the person it was made to. */
+/** A call opens the person it was made to, and their company. The ids are checked against your CRM first, so a call whose contact is gone shows no link. */
 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}
+      renderDetailActions={(call) => (
+        <RecordOpenLinks
+          contactId={call.contact_id}
+          onOpenContact={(id) => router.push(`/contacts?id=${id}`)}
+          onOpenCompany={(id) => router.push(`/companies?id=${id}`)}
+        />
+      )}
     />
   );
 }

package/stacks/apollo/pages/campaigns.tsx.tmpl

@@ -0,0 +1,27 @@
+"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 { CampaignLinksTab } from "@/components/g8/campaigns/campaign-links";
+import { CampaignsScreen } from "@/components/g8/campaigns/campaigns-screen";
+
+/** A campaign lists its landing pages, workflows and newsletters. This app has no screens for them, so the rows show names only. */
+export default function Page() {
+  const router = useRouter();
+  return (
+    <CampaignsScreen
+      extraDetailTabs={[
+        {
+          id: "links",
+          label: "Links",
+          render: (c) => (
+            <CampaignLinksTab
+              campaignId={c.id}
+            />
+          ),
+        },
+      ]}
+    />
+  );
+}

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

@@ -3,8 +3,10 @@
 // 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 { MemberPicker } from "@/components/g8/pickers/member-picker";
 import { ContactsScreen } from "@/components/g8/crm/contacts-screen";
 import { RecordEngagementTab } from "@/components/g8/crm/record-engagement-tab";
+import { CreateDealButton } from "@/components/g8/deals/create-deal-button";
 import { RecordDealsTab } from "@/components/g8/deals/record-deals-tab";
 import { CallContactButton } from "@/components/g8/dialer/call-contact-button";
 import { RecordCallsTab } from "@/components/g8/dialer/record-calls-tab";
@@ -14,12 +16,14 @@ 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 { RecordSocialTab } from "@/components/g8/signals/record-social-tab";
 import { useRouter } from "next/navigation";
 
 export default function Page() {
   const router = useRouter();
   return (
     <ContactsScreen
+      renderOwnerPicker={(picker) => <MemberPicker label="New owner" {...picker} />}
       onOpenCompany={(id) => router.push(`/companies?id=${id}`)}
       renderRowActions={(c, { reload }) => <EnrichButton kind="person" lookup={{ email: c.work_email ?? undefined, linkedin_url: c.linkedin_url ?? undefined, first_name: c.first_name ?? undefined, last_name: c.last_name ?? undefined }} record={{ ...c }} onApplied={reload} label="Enrich" size="sm" variant="ghost" />}
       renderBulkActions={({ ids, clear }) => (
@@ -35,6 +39,7 @@ export default function Page() {
           <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 }} />
+          <CreateDealButton contactId={c.id} onCreated={(id) => router.push(`/deals?id=${encodeURIComponent(id)}`)} />
         </>
       )}
       extraDetailTabs={[
@@ -45,6 +50,7 @@ export default function Page() {
         { id: "deals", label: "Deals", render: (c) => <RecordDealsTab kind="contacts" id={c.id} onOpenDeal={(id) => router.push(`/deals?id=${encodeURIComponent(id)}`)} /> },
         { 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} /> },
+        { id: "social", label: "Social posts", render: (c) => <RecordSocialTab contactId={c.id} onOpenListeners={() => router.push("/social-listening")} /> },
       ]}
     />
   );

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

@@ -3,11 +3,11 @@
 // 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 { ContactLookupLink, splitName } 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. */
+/** A conversation opens the sender when they are a contact in your CRM, or adds them when they are new. */
 export default function Page() {
   const router = useRouter();
-  return <InboxScreen renderDetailActions={(thread) => <ContactLookupLink email={thread.contact?.email} onOpen={(id) => router.push(`/contacts?id=${id}`)} />} />;
+  return <InboxScreen renderDetailActions={(thread) => <ContactLookupLink email={thread.contact?.email} createIfMissing={splitName(thread.contact?.name)} onOpen={(id) => router.push(`/contacts?id=${id}`)} />} />;
 }

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

@@ -3,10 +3,22 @@
 // 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 { Sparkles } from "lucide-react";
 import { ListsScreen } from "@/components/g8/lists/lists-screen";
 
-/** A list member opens in Contacts. */
+/** A list member opens in Contacts; an open list can be enriched (its pipelines, priced before they run). */
 export default function Page() {
   const router = useRouter();
-  return <ListsScreen onOpenContact={(id) => router.push(`/contacts?id=${id}`)} />;
+  return (
+    <ListsScreen
+      onOpenContact={(id) => router.push(`/contacts?id=${id}`)}
+      renderDetailActions={(list) => (
+        <Button size="sm" variant="outline" onClick={() => router.push(`/enrichment?tab=list-pipelines&list=${list.id}`)}>
+          <Sparkles className="mr-1 size-4" aria-hidden />
+          Enrich this list
+        </Button>
+      )}
+    />
+  );
 }

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

@@ -3,10 +3,16 @@
 // 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 { SequenceCampaignLink } from "@/components/g8/sequencer/sequence-campaign-link";
 import { SequencesScreen } from "@/components/g8/sequencer/sequences-screen";
 
-/** An enrolled person opens in Contacts. */
+/** An enrolled person opens in Contacts; a sequence opens, links or unlinks its campaign. */
 export default function Page() {
   const router = useRouter();
-  return <SequencesScreen onOpenContact={(id) => router.push(`/contacts?id=${id}`)} />;
+  return (
+    <SequencesScreen
+      onOpenContact={(id) => router.push(`/contacts?id=${id}`)}
+      renderDetailActions={(sequence) => <SequenceCampaignLink sequence={sequence} onOpenCampaign={(id) => router.push(`/campaigns?id=${encodeURIComponent(id)}`)} />}
+    />
+  );
 }

package/stacks/apollo.json

@@ -12,7 +12,9 @@
     "search",
     "enrichment",
     "intent",
+    "signals",
     "visitors",
+    "web-analytics",
     "mailboxes",
     "sequencer",
     "campaigns",
@@ -23,7 +25,8 @@
     "deals",
     "analytics",
     "integrations",
-    "company-intelligence"
+    "company-intelligence",
+    "email-signatures"
   ],
   "home": "/analytics",
   "nav": [
@@ -102,6 +105,15 @@
       "group": "Signals",
       "description": "Accounts showing buying intent"
     },
+    {
+      "label": "Social listening",
+      "path": "/social-listening",
+      "block": "signals",
+      "component": "SocialListenersScreen",
+      "icon": "Ear",
+      "group": "Signals",
+      "description": "Posts about you, competitors and keywords"
+    },
     {
       "label": "Visitors",
       "path": "/visitors",
@@ -111,6 +123,15 @@
       "group": "Signals",
       "description": "Who is on your website right now"
     },
+    {
+      "label": "Web analytics",
+      "path": "/web-analytics",
+      "block": "web-analytics",
+      "component": "WebAnalyticsScreen",
+      "icon": "ChartNoAxesCombined",
+      "group": "Signals",
+      "description": "Traffic, audience, engagement and conversions for your sites"
+    },
     {
       "label": "Sequences",
       "path": "/sequences",
@@ -128,7 +149,8 @@
       "component": "CampaignsScreen",
       "icon": "Rocket",
       "group": "Engage",
-      "description": "Campaigns from brief to launch"
+      "description": "Campaigns from brief to launch",
+      "page": "pages/campaigns.tsx.tmpl"
     },
     {
       "label": "Inbox",
@@ -207,6 +229,15 @@
       "group": "Setup",
       "description": "Sending mailboxes and warmup health"
     },
+    {
+      "label": "Email signatures",
+      "path": "/email-signatures",
+      "block": "email-signatures",
+      "component": "EmailSignaturesScreen",
+      "icon": "PenLine",
+      "group": "Setup",
+      "description": "One signature for the team, kept on every mailbox"
+    },
     {
       "label": "Phone numbers",
       "path": "/phone-numbers",

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

@@ -2,6 +2,7 @@
 
 // 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 { MemberPicker } from "@/components/g8/pickers/member-picker";
 import { ContactsScreen } from "@/components/g8/crm/contacts-screen";
 import { RecordEngagementTab } from "@/components/g8/crm/record-engagement-tab";
 import { EnrichButton } from "@/components/g8/enrichment/enrich-button";
@@ -13,6 +14,7 @@ export default function Page() {
   const router = useRouter();
   return (
     <ContactsScreen
+      renderOwnerPicker={(picker) => <MemberPicker label="New owner" {...picker} />}
       onOpenCompany={(id) => router.push(`/companies?id=${id}`)}
       renderRowActions={(c, { reload }) => <EnrichButton kind="person" lookup={{ email: c.work_email ?? undefined, linkedin_url: c.linkedin_url ?? undefined, first_name: c.first_name ?? undefined, last_name: c.last_name ?? undefined }} record={{ ...c }} onApplied={reload} label="Enrich" size="sm" variant="ghost" />}
       renderBulkActions={({ ids, clear }) => <AddToListButton contactIds={ids} onAdded={clear} />}

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

@@ -3,10 +3,22 @@
 // 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 { Sparkles } from "lucide-react";
 import { ListsScreen } from "@/components/g8/lists/lists-screen";
 
-/** A list member opens in Contacts. */
+/** A list member opens in Contacts; an open list can be enriched (its pipelines, priced before they run). */
 export default function Page() {
   const router = useRouter();
-  return <ListsScreen onOpenContact={(id) => router.push(`/contacts?id=${id}`)} />;
+  return (
+    <ListsScreen
+      onOpenContact={(id) => router.push(`/contacts?id=${id}`)}
+      renderDetailActions={(list) => (
+        <Button size="sm" variant="outline" onClick={() => router.push(`/enrichment?tab=list-pipelines&list=${list.id}`)}>
+          <Sparkles className="mr-1 size-4" aria-hidden />
+          Enrich this list
+        </Button>
+      )}
+    />
+  );
 }

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

@@ -3,21 +3,21 @@
 // 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 { RecordOpenLinks } from "@/components/g8/crm/record-open-links";
 import { CallLogScreen } from "@/components/g8/dialer/call-log-screen";
 
-/** A call opens the person it was made to. */
+/** A call opens the person it was made to, and their company. The ids are checked against your CRM first, so a call whose contact is gone shows no link. */
 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}
+      renderDetailActions={(call) => (
+        <RecordOpenLinks
+          contactId={call.contact_id}
+          onOpenContact={(id) => router.push(`/contacts?id=${id}`)}
+          onOpenCompany={(id) => router.push(`/companies?id=${id}`)}
+        />
+      )}
     />
   );
 }

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

@@ -3,6 +3,7 @@
 // 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 { MemberPicker } from "@/components/g8/pickers/member-picker";
 import { ContactsScreen } from "@/components/g8/crm/contacts-screen";
 import { RecordEngagementTab } from "@/components/g8/crm/record-engagement-tab";
 import { RecordCallsTab } from "@/components/g8/dialer/record-calls-tab";
@@ -14,6 +15,7 @@ export default function Page() {
   const router = useRouter();
   return (
     <ContactsScreen
+      renderOwnerPicker={(picker) => <MemberPicker label="New owner" {...picker} />}
       onOpenCompany={(id) => router.push(`/companies?id=${id}`)}
       renderBulkActions={({ ids, clear }) => <AddToListButton contactIds={ids} onAdded={clear} />}
       renderDetailActions={(c) => (

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

@@ -2,6 +2,7 @@
 
 // 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 { MemberPicker } from "@/components/g8/pickers/member-picker";
 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";
@@ -12,6 +13,7 @@ export default function Page() {
   const router = useRouter();
   return (
     <ContactsScreen
+      renderOwnerPicker={(picker) => <MemberPicker label="New owner" {...picker} />}
       onOpenCompany={(id) => router.push(`/companies?id=${id}`)}
       renderBulkActions={({ ids, clear }) => <AddToListButton contactIds={ids} onAdded={clear} />}
       renderDetailActions={(c) => (

package/stacks/hootsuite.json

@@ -11,6 +11,7 @@
     "lists",
     "social-ads",
     "pages",
+    "programmatic-pages",
     "analytics"
   ],
   "home": "/analytics",
@@ -51,6 +52,15 @@
       "group": "Marketing",
       "description": "Landing pages, brand kit and content"
     },
+    {
+      "label": "Programmatic pages",
+      "path": "/programmatic-pages",
+      "block": "programmatic-pages",
+      "component": "ProgrammaticPagesScreen",
+      "icon": "Layers",
+      "group": "Marketing",
+      "description": "A page per row: render, preview, publish and roll back"
+    },
     {
       "label": "Contacts",
       "path": "/contacts",

package/stacks/hubspot/pages/campaigns.tsx.tmpl

@@ -0,0 +1,30 @@
+"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 { CampaignLinksTab } from "@/components/g8/campaigns/campaign-links";
+import { CampaignsScreen } from "@/components/g8/campaigns/campaigns-screen";
+
+/** A campaign lists its landing pages, workflows and newsletters, and opens each in its own screen. */
+export default function Page() {
+  const router = useRouter();
+  return (
+    <CampaignsScreen
+      extraDetailTabs={[
+        {
+          id: "links",
+          label: "Links",
+          render: (c) => (
+            <CampaignLinksTab
+              campaignId={c.id}
+              onOpenLandingPage={(id) => router.push(`/pages?id=${encodeURIComponent(id)}`)}
+              onOpenWorkflow={(id) => router.push(`/workflows?id=${encodeURIComponent(id)}`)}
+              onOpenNewsletter={(id) => router.push(`/newsletter?newsletter=${encodeURIComponent(id)}`)}
+            />
+          ),
+        },
+      ]}
+    />
+  );
+}

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

@@ -5,6 +5,7 @@
 import { CompaniesScreen } from "@/components/g8/crm/companies-screen";
 import { RecordEngagementTab } from "@/components/g8/crm/record-engagement-tab";
 import { RecordDealsTab } from "@/components/g8/deals/record-deals-tab";
+import { RecordDocumentsTab } from "@/components/g8/documents/record-documents-tab";
 import { AddCompanyPeopleToListButton } from "@/components/g8/lists/add-company-people-to-list-button";
 import { RecordQuotesTab } from "@/components/g8/quotes/record-quotes-tab";
 import { useRouter } from "next/navigation";
@@ -19,6 +20,7 @@ export default function Page() {
       extraDetailTabs={[
         { id: "quotes", label: "Quotes", render: (c) => <RecordQuotesTab kind="companies" id={c.id} onOpenQuote={(id) => router.push(`/quotes?id=${encodeURIComponent(id)}`)} /> },
         { id: "deals", label: "Deals", render: (c) => <RecordDealsTab kind="companies" id={c.id} onOpenDeal={(id) => router.push(`/deals?id=${encodeURIComponent(id)}`)} /> },
+        { id: "documents", label: "Documents", render: (c) => <RecordDocumentsTab companyId={c.id} onOpenDocuments={(href) => router.push(href)} /> },
         { id: "engagement", label: "Engagement", render: (c) => <RecordEngagementTab kind="companies" id={c.id} /> },
       ]}
     />

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

@@ -3,9 +3,12 @@
 // 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 { MemberPicker } from "@/components/g8/pickers/member-picker";
 import { ContactsScreen } from "@/components/g8/crm/contacts-screen";
 import { RecordEngagementTab } from "@/components/g8/crm/record-engagement-tab";
+import { CreateDealButton } from "@/components/g8/deals/create-deal-button";
 import { RecordDealsTab } from "@/components/g8/deals/record-deals-tab";
+import { RecordDocumentsTab } from "@/components/g8/documents/record-documents-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";
@@ -18,6 +21,7 @@ export default function Page() {
   const router = useRouter();
   return (
     <ContactsScreen
+      renderOwnerPicker={(picker) => <MemberPicker label="New owner" {...picker} />}
       onOpenCompany={(id) => router.push(`/companies?id=${id}`)}
       renderBulkActions={({ ids, clear }) => (
         <>
@@ -29,6 +33,7 @@ export default function Page() {
         <>
           <AddToSequenceButton contactIds={[c.id]} />
           <AddToListButton contactIds={[c.id]} />
+          <CreateDealButton contactId={c.id} onCreated={(id) => router.push(`/deals?id=${encodeURIComponent(id)}`)} />
         </>
       )}
       extraDetailTabs={[
@@ -38,6 +43,7 @@ export default function Page() {
         { id: "quotes", label: "Quotes", render: (c) => <RecordQuotesTab kind="contacts" id={c.id} onOpenQuote={(id) => router.push(`/quotes?id=${encodeURIComponent(id)}`)} /> },
         { id: "deals", label: "Deals", render: (c) => <RecordDealsTab kind="contacts" id={c.id} onOpenDeal={(id) => router.push(`/deals?id=${encodeURIComponent(id)}`)} /> },
         { id: "conversations", label: "Conversations", render: (c) => <RecordConversationsTab email={c.work_email} alsoEmails={[c.personal_emails]} onOpenThread={(sel) => router.push(`/inbox?id=${encodeURIComponent(sel)}`)} /> },
+        { id: "documents", label: "Documents", render: (c) => <RecordDocumentsTab contactId={c.id} onOpenDocuments={(href) => router.push(href)} /> },
         { id: "engagement", label: "Engagement", render: (c) => <RecordEngagementTab kind="contacts" id={c.id} /> },
       ]}
     />