@posthog/wizard 2.16.1 → 2.17.0

package/dist/{slides-CL1mv_Kq.js → slides-DRbBgsdd.js}

@@ -1,11 +1,11 @@
-import { g as SERVICE_LABELS, s as logToFile } from "./debug-ubpO6102.js";
+import { g as SERVICE_LABELS, s as logToFile } from "./debug-Bx7nvCWW.js";
 import { n as isTaskStatus } from "./wizard-ui-YdGFRyu_.js";
-import { n as sessionProperties, t as analytics } from "./analytics-DUuUurR3.js";
-import { i as buildSession } from "./wizard-session-gsn8Z3bZ.js";
-import { _ as AUDIT_SEVERITY_STYLE } from "./agent-interface-B4eUlMso.js";
-import { a as isObjectBlock, i as isLinesBlock, n as computeVisibleRange, o as Colors, r as isClearBlock, s as Icons, t as TextBlock } from "./TextBlock-CdeZog_6.js";
+import { n as sessionProperties, t as analytics } from "./analytics-DN_Gy87F.js";
+import { i as buildSession } from "./wizard-session-d27JGRGi.js";
+import { v as AUDIT_SEVERITY_STYLE } from "./agent-interface-7t5DBo2A.js";
+import { a as isObjectBlock, i as isLinesBlock, n as computeVisibleRange, o as Colors, r as isClearBlock, s as Icons, t as TextBlock } from "./TextBlock-D0Ep3zC9.js";
 import { a as getProgramConfig, i as Program, l as getKindMeta, r as PROGRAM_REGISTRY } from "./bin.js";
-import { n as AVAILABLE_FEATURES, t as ALL_FEATURE_VALUES } from "./defaults-zrYmZ2ID.js";
+import { n as AVAILABLE_FEATURES, t as ALL_FEATURE_VALUES } from "./defaults-CPH6eWhN.js";
 import * as fs$1 from "fs";
 import { Box, Text, measureElement, useInput, useStdout } from "ink";
 import { Component, Fragment, createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
@@ -2628,8 +2628,17 @@ const McpScreen = ({ store, installer, mode = "install" }) => {
 	}, [installer]);
 	const proceedToFeatureSelectOrInstall = (clientNames) => {
 		setSelectedClientNames(clientNames);
-		if (store.session.mcpFeatures) doInstall(clientNames, store.session.mcpFeatures);
-		else setPhase("feature-select");
+		if (store.session.mcpFeatures) {
+			doInstall(clientNames, store.session.mcpFeatures);
+			return;
+		}
+		if (!clientNames.some((name) => {
+			return !clients.find((c) => c.name === name)?.finish;
+		})) {
+			doInstall(clientNames, []);
+			return;
+		}
+		setPhase("feature-select");
 	};
 	const handleConfirm = () => {
 		if (isRemove) doRemove();
@@ -2668,6 +2677,17 @@ const McpScreen = ({ store, installer, mode = "install" }) => {
 		const outcome = result.length > 0 ? "installed" : "failed";
 		setTimeout(() => markDone(store, outcome, result), 2e3);
 	};
+	const installValueBullets = [
+		"Ask your agent: \"List my feature flags\" — and it does.",
+		"Run SQL, build dashboards, ship flags, all from your IDE.",
+		"No copy-pasting tokens or context. Your agent has the keys."
+	];
+	const finishNotes = clients.flatMap((c) => c.finish && resultClients.includes(c.name) ? [{
+		name: c.name,
+		url: c.finish.url,
+		instruction: c.finish.instruction
+	}] : []);
+	const installedNow = resultClients.filter((name) => !finishNotes.some((n) => n.name === name));
 	return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		flexGrow: 1,
@@ -2695,11 +2715,7 @@ const McpScreen = ({ store, installer, mode = "install" }) => {
 					!isRemove && /* @__PURE__ */ jsx(Box, {
 						flexDirection: "column",
 						marginBottom: 1,
-						children: [
-							"Ask your agent: \"List my feature flags\" — and it does.",
-							"Run SQL, build dashboards, ship flags, all from your IDE.",
-							"No copy-pasting tokens or context. Your agent has the keys."
-						].map((bullet) => /* @__PURE__ */ jsxs(Text, {
+						children: installValueBullets.map((bullet) => /* @__PURE__ */ jsxs(Text, {
 							dimColor: true,
 							children: [
 								"•",
@@ -2748,7 +2764,10 @@ const McpScreen = ({ store, installer, mode = "install" }) => {
 				}),
 				phase === "done" && /* @__PURE__ */ jsx(Box, {
 					flexDirection: "column",
-					children: resultClients.length > 0 ? /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsxs(Text, {
+					children: installedNow.length === 0 && finishNotes.length === 0 ? /* @__PURE__ */ jsxs(Text, {
+						dimColor: true,
+						children: [isRemove ? "Removal" : "Installation", " skipped."]
+					}) : /* @__PURE__ */ jsxs(Fragment$1, { children: [installedNow.length > 0 && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsxs(Text, {
 						color: "green",
 						bold: true,
 						children: [
@@ -2759,25 +2778,874 @@ const McpScreen = ({ store, installer, mode = "install" }) => {
 							isRemove ? "removed from" : "installed for",
 							":"
 						]
-					}), resultClients.map((name, i) => /* @__PURE__ */ jsxs(Text, { children: [
+					}), installedNow.map((name, i) => /* @__PURE__ */ jsxs(Text, { children: [
 						" ",
 						"•",
 						" ",
 						name
-					] }, i))] }) : /* @__PURE__ */ jsxs(Text, {
-						dimColor: true,
-						children: [isRemove ? "Removal" : "Installation", " skipped."]
-					})
+					] }, i))] }), finishNotes.map((note) => /* @__PURE__ */ jsxs(Box, {
+						flexDirection: "column",
+						marginTop: 1,
+						children: [
+							/* @__PURE__ */ jsxs(Text, {
+								color: "green",
+								bold: true,
+								children: [note.name, " \\u2014 finish in your browser:"]
+							}),
+							/* @__PURE__ */ jsxs(Text, { children: [
+								"  ",
+								"Opened ",
+								/* @__PURE__ */ jsx(Text, {
+									color: "cyan",
+									children: note.url
+								})
+							] }),
+							/* @__PURE__ */ jsxs(Text, {
+								dimColor: true,
+								children: ["  ", note.instruction]
+							}),
+							/* @__PURE__ */ jsxs(Text, {
+								dimColor: true,
+								children: ["  ", "(If it didn't open, paste the URL above.)"]
+							})
+						]
+					}, note.name))] })
 				})
 			]
 		})]
 	});
 };
 //#endregion
+//#region src/lib/mcp-role-prompts.copy.json
+var pinnedFirstPrompt = {
+	"prompt": "Show me my top 5 events from the last 7 days",
+	"description": "A safe first pick — works on any project regardless of role or setup."
+};
+var defaultKit = [
+	{
+		"key": "verify",
+		"prompt": "Annotate today with 'PostHog wizard install'",
+		"description": "Creates a dated note on your project — visible on every chart. Delete anytime from PostHog."
+	},
+	{
+		"key": "top-events",
+		"prompt": "Show me my top 5 events from the last 7 days",
+		"description": "Get a feel for what your project is tracking."
+	},
+	{
+		"key": "main-funnel",
+		"prompt": "Build me a funnel for my main user journey and show where the drop-off is",
+		"description": "Insight discovery — your agent picks the events."
+	},
+	{
+		"key": "flags-inventory",
+		"prompt": "Show me my feature flags and what each is currently rolled out to",
+		"description": "Inventory the rollout state of every flag in your project."
+	},
+	{
+		"key": "error-trend",
+		"prompt": "Show me daily error count for the last 30 days and flag anything that looks like a spike",
+		"description": "Pulse-check on stability — no dashboard setup required."
+	}
+];
+var roleKits = {
+	"founder": [
+		{
+			"key": "verify",
+			"prompt": "Annotate today with 'PostHog wizard install'",
+			"description": "Creates a dated note on your project — visible on every chart. Delete anytime from PostHog."
+		},
+		{
+			"key": "exec-dashboard",
+			"prompt": "Build me an exec dashboard with MRR, MAU, churn, and top events, then save it",
+			"description": "A one-glance view of the business you can pin and share."
+		},
+		{
+			"key": "wau",
+			"prompt": "Show me weekly active users for the last 90 days",
+			"description": "The trendline you actually care about."
+		},
+		{
+			"key": "mau-trend",
+			"prompt": "Show me weekly MAU for the last 12 weeks and where the inflection points are",
+			"description": "See where growth bent — up or down — without setting up alerts."
+		},
+		{
+			"key": "nps-summary",
+			"prompt": "Show me NPS responses from my paid users and summarize the themes",
+			"description": "Pulse-check on the people paying you."
+		}
+	],
+	"product": [
+		{
+			"key": "verify",
+			"prompt": "Annotate today with 'PostHog wizard install'",
+			"description": "Creates a dated note on your project — visible on every chart. Delete anytime from PostHog."
+		},
+		{
+			"key": "onboarding",
+			"prompt": "Build a funnel for my onboarding flow and show me the biggest drop-off step",
+			"description": "See where new users drop off in their first session."
+		},
+		{
+			"key": "pricing-flag-state",
+			"prompt": "Show me feature flags scoped to the pricing page and who's currently in each",
+			"description": "Inspect rollout state of pricing experiments without changing anything."
+		},
+		{
+			"key": "cta-compare",
+			"prompt": "Show me how my upgrade CTA variants are converting across my recent experiments",
+			"description": "Read the verdict on CTA tests without spinning up a new one."
+		},
+		{
+			"key": "retention",
+			"prompt": "Compute week-1 retention split by acquisition channel",
+			"description": "Find the channel that actually retains users."
+		}
+	],
+	"leadership": [
+		{
+			"key": "verify",
+			"prompt": "Annotate today with 'PostHog wizard install'",
+			"description": "Creates a dated note on your project — visible on every chart. Delete anytime from PostHog."
+		},
+		{
+			"key": "board-dashboard",
+			"prompt": "Build a board dashboard with revenue, MAU, churn, and support backlog, then save it",
+			"description": "Pre-board prep in one prompt."
+		},
+		{
+			"key": "mau-growth",
+			"prompt": "Show MAU growth over the last 4 quarters",
+			"description": "The chart for the next leadership slide."
+		},
+		{
+			"key": "churn-trend",
+			"prompt": "Show me churn over the last 8 weeks and where it moved most",
+			"description": "See the trend without configuring a notification."
+		},
+		{
+			"key": "upgrade-drivers",
+			"prompt": "Which features drive the most upgrades?",
+			"description": "Ranked breakdown of what actually moves the needle."
+		}
+	],
+	"marketing": [
+		{
+			"key": "verify",
+			"prompt": "Annotate today with 'PostHog wizard install'",
+			"description": "Creates a dated note on your project — visible on every chart. Delete anytime from PostHog."
+		},
+		{
+			"key": "pricing-leavers",
+			"prompt": "Show me users who saw pricing but didn't sign up — what did they do next?",
+			"description": "Identify high-intent visitors and what they bounced to."
+		},
+		{
+			"key": "hero-compare",
+			"prompt": "Show me how my landing page hero variants performed — which group converted best?",
+			"description": "Read the verdict on hero copy tests."
+		},
+		{
+			"key": "newsletter-clicks",
+			"prompt": "Find users who clicked our last newsletter and show me what they did next",
+			"description": "See the downstream behavior of your last campaign."
+		},
+		{
+			"key": "landing-annotation",
+			"prompt": "Annotate today as the launch of the new landing page",
+			"description": "Pin the deploy on every chart so future you can find it."
+		}
+	],
+	"engineering": [
+		{
+			"key": "verify",
+			"prompt": "Annotate today with 'PostHog wizard install'",
+			"description": "Creates a dated note on your project — visible on every chart. Delete anytime from PostHog."
+		},
+		{
+			"key": "stale-flags",
+			"prompt": "List flags rolled out to 100% — they're probably safe to delete",
+			"description": "Dead-code hunt for your feature flag config."
+		},
+		{
+			"key": "top-errors",
+			"prompt": "Show me the top 5 unresolved errors this week",
+			"description": "Triage queue without opening another tab."
+		},
+		{
+			"key": "reliability-trend",
+			"prompt": "Show me 5xx error rate over the last 24 hours by endpoint",
+			"description": "See where reliability is drifting, no alert setup."
+		},
+		{
+			"key": "zero-rollout-flags",
+			"prompt": "Show me feature flags currently rolled out at 0% — anything ready to retire?",
+			"description": "Find dead kill-switch flags you can clean up later."
+		}
+	],
+	"data": [
+		{
+			"key": "verify",
+			"prompt": "Annotate today with 'PostHog wizard install'",
+			"description": "Creates a dated note on your project — visible on every chart. Delete anytime from PostHog."
+		},
+		{
+			"key": "top-events-24h",
+			"prompt": "Top 5 events by volume in the last 24 hours",
+			"description": "Smoke test for ingestion + a sanity check on volumes."
+		},
+		{
+			"key": "paid-retention",
+			"prompt": "Retention curve for paid users by signup month",
+			"description": "The cohort chart you'd build first anyway."
+		},
+		{
+			"key": "full-funnel",
+			"prompt": "Funnel: signup → activated → first power feature → paid",
+			"description": "Drop-off across the full journey, ready to slice."
+		},
+		{
+			"key": "power-users-query",
+			"prompt": "Show me users with 5+ sessions per week over the last month and what they have in common",
+			"description": "Profile your power-user segment without materializing a cohort."
+		}
+	]
+};
+var roleFamilyOverrides = {
+	"product": {
+		"frontend-web": { "cta-compare": {
+			"prompt": "Compare conversion across the variants of my last upgrade CTA experiment (control, red, green)",
+			"description": "Read the verdict on a three-arm frontend experiment."
+		} },
+		"mobile": {
+			"onboarding": {
+				"prompt": "Build a funnel app_open → onboarding_complete → first_session_complete and show me the drop-off",
+				"description": "Mobile-flavored onboarding funnel with sensible defaults."
+			},
+			"cta-compare": {
+				"prompt": "Show me feature flags gated on app version — who's in each release tier?",
+				"description": "See which clients see what, without changing anything."
+			}
+		},
+		"backend": { "onboarding": {
+			"prompt": "Funnel of signup → first API call → paid for last 30 days",
+			"description": "Backend funnel that reflects what your service actually sees."
+		} }
+	},
+	"engineering": {
+		"frontend-web": { "top-errors": {
+			"prompt": "Top 5 JS errors by occurrence count this week, with affected URLs",
+			"description": "Frontend-specific error triage — sorted by blast radius."
+		} },
+		"mobile": {
+			"top-errors": {
+				"prompt": "Top crashes this week by app version, sorted by affected users",
+				"description": "Mobile crash triage straight from the same data PostHog has."
+			},
+			"reliability-trend": {
+				"prompt": "Show me crash-free sessions over the last 7 days by app version",
+				"description": "Crash-free trend per release — the one mobile metric that matters."
+			}
+		},
+		"backend": {
+			"top-errors": {
+				"prompt": "Top 5 server-side errors this week, grouped by endpoint",
+				"description": "Backend error triage by route, sorted by frequency."
+			},
+			"reliability-trend": {
+				"prompt": "Show me p95 response time over the last 24 hours by endpoint",
+				"description": "Latency trend from the data you already collect."
+			}
+		}
+	},
+	"data": { "backend": { "full-funnel": {
+		"prompt": "Funnel: api_signup → first_api_call → first_paid_event over last 30 days",
+		"description": "Backend conversion funnel — captures the value your service delivers."
+	} } }
+};
+var roleGreetings = {
+	"founder": {
+		"headline": "Founders use MCP to keep a hand on growth.",
+		"bullets": [
+			"Weekly active users, retention, and revenue without leaving your IDE.",
+			"Spot stalls in your trends without setting up dashboards by hand.",
+			"Pin annotations on every chart so you remember what shipped."
+		],
+		"outro": "Pick a prompt — your agent will run it on your project's real data."
+	},
+	"product": {
+		"headline": "PMs use MCP to learn faster and decide quicker.",
+		"bullets": [
+			"Funnels for every onboarding flow you want to inspect.",
+			"Inspect feature flags and experiment outcomes without leaving your IDE.",
+			"Retention sliced by acquisition channel in seconds."
+		],
+		"outro": "Pick a prompt — your agent will do the legwork."
+	},
+	"leadership": {
+		"headline": "Read the business from your terminal.",
+		"bullets": [
+			"Board-ready dashboards in one prompt.",
+			"Trend lines for MAU, churn, and revenue, one query away.",
+			"The numbers for the next leadership slide, on tap."
+		],
+		"outro": "Pick a prompt to see PostHog work for you."
+	},
+	"marketing": {
+		"headline": "Inspect campaigns, end to end.",
+		"bullets": [
+			"Find high-intent visitors and what they did next.",
+			"Compare landing-copy experiments and see which arm is winning.",
+			"Tie every campaign to revenue with annotated launches."
+		],
+		"outro": "Pick a prompt to try it on your data."
+	},
+	"engineering": {
+		"headline": "MCP is your shortest path from bug to root cause.",
+		"bullets": [
+			"Top errors this week, sorted by blast radius.",
+			"Latency and crash-free trends checked against real data.",
+			"Audit which flags are stale or fully rolled out."
+		],
+		"outro": "Pick a prompt — your agent has read access across your project."
+	},
+	"data": {
+		"headline": "Data work without leaving the terminal.",
+		"bullets": [
+			"Profile any segment in seconds.",
+			"Retention curves by signup month, sliced any way you want.",
+			"Run SQL against your event stream — no copy-paste, no exports."
+		],
+		"outro": "Pick a prompt — every result is real data from your project."
+	}
+};
+var neutralGreeting = {
+	"headline": "PostHog MCP turns your agent into a product analyst.",
+	"bullets": [
+		"Run queries, build insights, save dashboards — straight from your IDE.",
+		"Every result is real data from your project.",
+		"No copy-pasting tokens, no context switching."
+	],
+	"outro": "Pick a prompt to see what MCP can do."
+};
+var toolFollowUps = {
+	"query-error-tracking-issue": [
+		{
+			"label": "Stack trace for the top error",
+			"prompt": "Show me the stack trace and recent occurrences for the top error."
+		},
+		{
+			"label": "Who is most affected?",
+			"prompt": "Which users have hit that error most often in the last 7 days?"
+		},
+		{
+			"label": "When did it start?",
+			"prompt": "Show me when that error first appeared and any deploy that landed nearby."
+		},
+		{
+			"label": "Find related sessions",
+			"prompt": "Find session recordings that hit that error so I can see what users were doing."
+		},
+		{
+			"label": "Save the top-errors view",
+			"prompt": "Save this top-errors view as an insight I can come back to."
+		},
+		{
+			"label": "Pin to engineering dashboard",
+			"prompt": "Pin this errors view to my engineering dashboard."
+		}
+	],
+	"query-trends": [
+		{
+			"label": "Break down by property",
+			"prompt": "Break that trend down by the most common user property."
+		},
+		{
+			"label": "Find the outlier day",
+			"prompt": "Which day stood out the most and what else was going on?"
+		},
+		{
+			"label": "Compare to last month",
+			"prompt": "Compare that against the same period last month."
+		},
+		{
+			"label": "Build a funnel from it",
+			"prompt": "Build a funnel using the top events from that trend."
+		},
+		{
+			"label": "Save as an insight",
+			"prompt": "Save that trend as an insight named 'Trends'."
+		},
+		{
+			"label": "Pin to main dashboard",
+			"prompt": "Pin that trend to my main dashboard."
+		}
+	],
+	"query-funnel": [
+		{
+			"label": "Biggest drop-off",
+			"prompt": "Which step has the biggest drop-off, and who falls out there?"
+		},
+		{
+			"label": "Completion time",
+			"prompt": "How long does it take users who complete that funnel?"
+		},
+		{
+			"label": "Slice by platform",
+			"prompt": "Show that funnel split by mobile vs desktop."
+		},
+		{
+			"label": "Find drop-off sessions",
+			"prompt": "Find session recordings of users who dropped out at the biggest step."
+		},
+		{
+			"label": "Save the funnel",
+			"prompt": "Save that funnel as an insight."
+		},
+		{
+			"label": "Pin to dashboard",
+			"prompt": "Pin that funnel to my main dashboard."
+		}
+	],
+	"query-retention": [
+		{
+			"label": "Best-retaining cohort",
+			"prompt": "Which cohort retains the longest in that curve?"
+		},
+		{
+			"label": "Worst-retaining cohort",
+			"prompt": "Which cohort drops off fastest in that curve?"
+		},
+		{
+			"label": "Slice by acquisition channel",
+			"prompt": "Re-run that retention split by acquisition channel."
+		},
+		{
+			"label": "Find churned users",
+			"prompt": "Find session recordings of users who churned during week 1."
+		},
+		{
+			"label": "Save the retention chart",
+			"prompt": "Save that retention chart as an insight."
+		},
+		{
+			"label": "Pin to growth dashboard",
+			"prompt": "Pin that retention chart to my growth dashboard."
+		}
+	],
+	"query-feature-flag": [
+		{
+			"label": "Who's in this flag?",
+			"prompt": "Show me which users are currently in the rollout for that flag."
+		},
+		{
+			"label": "What changed recently?",
+			"prompt": "Show me the rollout history for that flag — when did it last change?"
+		},
+		{
+			"label": "Compare against another flag",
+			"prompt": "Show me the audience overlap between that flag and one related flag."
+		},
+		{
+			"label": "Find sessions for that flag",
+			"prompt": "Find recent session recordings from users currently in that flag."
+		},
+		{
+			"label": "Save flag inventory",
+			"prompt": "Save this flag inventory as an insight."
+		},
+		{
+			"label": "Pin to release dashboard",
+			"prompt": "Pin this flag view to my release dashboard."
+		}
+	],
+	"query-survey-responses": [
+		{
+			"label": "Summarize the themes",
+			"prompt": "Summarize the themes from those survey responses."
+		},
+		{
+			"label": "Score distribution",
+			"prompt": "Show me the score distribution across those responses."
+		},
+		{
+			"label": "Who are the detractors?",
+			"prompt": "Show me users who left a low score and what they did next."
+		},
+		{
+			"label": "Find their sessions",
+			"prompt": "Find session recordings from users who left a low score."
+		},
+		{
+			"label": "Save the response summary",
+			"prompt": "Save this response summary as an insight."
+		},
+		{
+			"label": "Add to research notebook",
+			"prompt": "Add this survey summary to my user research notebook."
+		}
+	],
+	"query-experiment": [
+		{
+			"label": "Which variant is winning?",
+			"prompt": "Show me the conversion rate of each variant in that experiment."
+		},
+		{
+			"label": "Slice by segment",
+			"prompt": "Show me how each variant performed by user segment."
+		},
+		{
+			"label": "Statistical significance",
+			"prompt": "Has that experiment reached statistical significance yet?"
+		},
+		{
+			"label": "Find variant sessions",
+			"prompt": "Find session recordings from users in the winning variant."
+		},
+		{
+			"label": "Save the readout",
+			"prompt": "Save that experiment readout as an insight."
+		},
+		{
+			"label": "Add to experiment notebook",
+			"prompt": "Add this experiment readout to my experiments notebook."
+		}
+	],
+	"query-session-recordings-list": [
+		{
+			"label": "Summarize what users did",
+			"prompt": "Summarize what users did in those sessions."
+		},
+		{
+			"label": "Find common drop-offs",
+			"prompt": "What's the most common step where users got stuck in those sessions?"
+		},
+		{
+			"label": "Errors in those sessions",
+			"prompt": "Which errors fired most often across those sessions?"
+		},
+		{
+			"label": "Properties of those users",
+			"prompt": "Show me the most common user properties across those sessions."
+		},
+		{
+			"label": "Save the session summary",
+			"prompt": "Save the summary of those sessions as an insight."
+		},
+		{
+			"label": "Add to UX notebook",
+			"prompt": "Add these session findings to my UX research notebook."
+		}
+	],
+	"execute-sql": [
+		{
+			"label": "Add p50/p90/p99",
+			"prompt": "Re-run that query with p50/p90/p99 added."
+		},
+		{
+			"label": "Slice differently",
+			"prompt": "Re-run that query grouped by the most common user property."
+		},
+		{
+			"label": "Find the outliers",
+			"prompt": "Re-run that query and surface the top 5 outliers."
+		},
+		{
+			"label": "Compare to last week",
+			"prompt": "Compare that query result to the same window last week."
+		},
+		{
+			"label": "Save as an insight",
+			"prompt": "Turn that query result into a saved insight."
+		},
+		{
+			"label": "Pin to data dashboard",
+			"prompt": "Pin that query result to my data dashboard."
+		}
+	],
+	"create-dashboard": [
+		{
+			"label": "Add another tile",
+			"prompt": "Add a tile showing daily active users to that dashboard."
+		},
+		{
+			"label": "Add a leaderboard tile",
+			"prompt": "Add a top-5 users tile to that dashboard."
+		},
+		{
+			"label": "Annotate today",
+			"prompt": "Annotate today on that dashboard as the launch baseline."
+		},
+		{
+			"label": "Compare to last quarter",
+			"prompt": "Add a tile comparing this quarter to the last on the same dashboard."
+		},
+		{
+			"label": "Add an errors tile",
+			"prompt": "Add a tile showing the top 3 errors this week to that dashboard."
+		},
+		{
+			"label": "Add to dashboards notebook",
+			"prompt": "Add a link to that dashboard in my dashboards notebook."
+		}
+	],
+	"create-insight": [
+		{
+			"label": "Pin to main dashboard",
+			"prompt": "Pin that insight to my main dashboard."
+		},
+		{
+			"label": "Split by user property",
+			"prompt": "Re-run that insight split by the most common user property."
+		},
+		{
+			"label": "Compare to a control",
+			"prompt": "Re-run that insight comparing paid vs free users side-by-side."
+		},
+		{
+			"label": "Save the underlying query",
+			"prompt": "Save the underlying query for that insight so I can edit it later."
+		},
+		{
+			"label": "Add to notebook",
+			"prompt": "Add that insight to my analytics notebook."
+		},
+		{
+			"label": "Annotate the moment",
+			"prompt": "Annotate today on the chart for that insight."
+		}
+	]
+};
+var roleFollowUps = {
+	"founder": [
+		{
+			"label": "Pin to exec dashboard",
+			"prompt": "Add that result to my exec dashboard."
+		},
+		{
+			"label": "Tie it to revenue",
+			"prompt": "How does that correlate with paid conversions?"
+		},
+		{
+			"label": "Compare to last quarter",
+			"prompt": "How does that compare against the same period last quarter?"
+		},
+		{
+			"label": "Save for board update",
+			"prompt": "Save that as an insight I can attach to the next board update."
+		}
+	],
+	"product": [
+		{
+			"label": "Build a funnel around it",
+			"prompt": "Build a funnel that includes that step."
+		},
+		{
+			"label": "Find high-intent users",
+			"prompt": "Show me which users in that group also completed activation."
+		},
+		{
+			"label": "Check related experiments",
+			"prompt": "Show me how this metric trended across my recent experiments."
+		},
+		{
+			"label": "Save to product notebook",
+			"prompt": "Add this finding to my product analytics notebook."
+		}
+	],
+	"leadership": [
+		{
+			"label": "Compare to last quarter",
+			"prompt": "How does that compare against the same period last quarter?"
+		},
+		{
+			"label": "Pin to leadership dashboard",
+			"prompt": "Pin this view to my leadership dashboard."
+		},
+		{
+			"label": "Save for next meeting",
+			"prompt": "Save this as an insight I can pull up in the next leadership meeting."
+		}
+	],
+	"marketing": [
+		{
+			"label": "Annotate the launch",
+			"prompt": "Annotate today as the campaign launch on that chart."
+		},
+		{
+			"label": "What did they do next?",
+			"prompt": "Show me what users in that group did next."
+		},
+		{
+			"label": "Tie back to channel",
+			"prompt": "Split that result by acquisition channel."
+		},
+		{
+			"label": "Compare to landing tests",
+			"prompt": "Compare this result across my recent landing-page experiments."
+		}
+	],
+	"engineering": [
+		{
+			"label": "Did a deploy land?",
+			"prompt": "Did that change land alongside a deploy in the last 24 hours?"
+		},
+		{
+			"label": "Flag changes that fit",
+			"prompt": "Show me which feature flag changes correlate with that change in metric."
+		},
+		{
+			"label": "Group by release",
+			"prompt": "Re-run that broken down by app version or release."
+		},
+		{
+			"label": "Save to incident notebook",
+			"prompt": "Save this analysis to my incident notebook."
+		}
+	],
+	"data": [
+		{
+			"label": "Add percentiles",
+			"prompt": "Add p50/p90/p99 distributions to that result."
+		},
+		{
+			"label": "Compare to last month",
+			"prompt": "Show me how that result trended over the last month."
+		},
+		{
+			"label": "Save as an insight",
+			"prompt": "Save that query result as an insight."
+		},
+		{
+			"label": "Pin to data dashboard",
+			"prompt": "Pin this result to my data team dashboard."
+		}
+	]
+};
+var genericFollowUps = [
+	{
+		"label": "Go one level deeper",
+		"prompt": "Run that same question one level deeper."
+	},
+	{
+		"label": "Take a different angle",
+		"prompt": "Look at the same question from a completely different angle."
+	},
+	{
+		"label": "Find the surprise",
+		"prompt": "What's the most surprising thing in that result?"
+	},
+	{
+		"label": "Slice by user",
+		"prompt": "Re-run that split by the highest-value user segment."
+	},
+	{
+		"label": "Compare with last month",
+		"prompt": "How does that look compared to the same window a month ago?"
+	},
+	{
+		"label": "Save as an insight",
+		"prompt": "Save that result as an insight I can come back to."
+	},
+	{
+		"label": "Pin to a dashboard",
+		"prompt": "Pin this view to my main dashboard."
+	},
+	{
+		"label": "Add to a notebook",
+		"prompt": "Add this finding to my notebook."
+	}
+];
+var deepDiveFollowUps = [
+	{
+		"label": "Save this exploration",
+		"prompt": "Save the most useful chart from this session as a dashboard I can come back to."
+	},
+	{
+		"label": "Summarize what we found",
+		"prompt": "Summarize the key findings from everything we just looked at in 3 bullets."
+	},
+	{
+		"label": "Pin a session summary",
+		"prompt": "Pin a summary of this session to my main dashboard."
+	},
+	{
+		"label": "Write to a notebook",
+		"prompt": "Write everything we just covered into a notebook entry I can revisit."
+	}
+];
+var crossSellByRole = {
+	"founder": [{
+		"product": "Session Replay",
+		"prompt": "Find 3 recent sessions where a user looked at pricing but did not sign up.",
+		"description": "Watch what users see — replay turns funnel drop-offs into video."
+	}, {
+		"product": "Surveys",
+		"prompt": "Show me how my NPS results have trended over the last quarter.",
+		"description": "Quantitative pulse check on the survey side of PostHog."
+	}],
+	"product": [{
+		"product": "Experiments",
+		"prompt": "Show me results from my latest onboarding experiment — which variant is winning?",
+		"description": "Experiments piggyback on flags — same SDK, all readable here."
+	}, {
+		"product": "Session Replay",
+		"prompt": "Find sessions where users got stuck on the empty state in onboarding.",
+		"description": "See what funnels can't show you."
+	}],
+	"leadership": [{
+		"product": "Surveys",
+		"prompt": "Show me NPS scores from the last quarter — who are the detractors?",
+		"description": "Read the survey data PostHog already collects for you."
+	}, {
+		"product": "Data Warehouse",
+		"prompt": "Compare MRR by signup source using Stripe data joined with event data.",
+		"description": "Query revenue alongside events when warehouse is connected."
+	}],
+	"marketing": [{
+		"product": "Session Replay",
+		"prompt": "Watch 5 sessions from users who came via our last campaign and converted.",
+		"description": "See campaign visitors behave — beyond aggregate numbers."
+	}, {
+		"product": "Web Analytics",
+		"prompt": "Show me top traffic sources to the pricing page this week.",
+		"description": "GA-style first-party web analytics, no cookie banner."
+	}],
+	"engineering": [{
+		"product": "Error Tracking",
+		"prompt": "Show me the top 5 errors this week and who is affected.",
+		"description": "Built-in error tracking — no Sentry subscription."
+	}, {
+		"product": "Session Replay",
+		"prompt": "Replay the last 3 sessions that hit a 5xx error.",
+		"description": "Stack trace meets replay — see what the user did."
+	}],
+	"data": [{
+		"product": "Data Warehouse",
+		"prompt": "Join my event stream with Stripe subscriptions to surface churn signals.",
+		"description": "Connect Stripe / Salesforce / S3, query everything with SQL."
+	}, {
+		"product": "LLM Observability",
+		"prompt": "Show me the top 5 LLM prompts by cost over the last 7 days.",
+		"description": "Track LLM calls, latency, and cost next to product events."
+	}]
+};
+var neutralCrossSell = [{
+	"product": "Session Replay",
+	"prompt": "Show me 5 recent sessions where users dropped off before completing signup.",
+	"description": "Replay what users actually do — included on every plan."
+}, {
+	"product": "Error Tracking",
+	"prompt": "List the top errors my users hit this week.",
+	"description": "Built-in error tracking — no separate tool."
+}];
+//#endregion
 //#region src/lib/mcp-role-prompts.ts
 /**
 * Roles that ship from `role_at_organization` on the PostHog user object.
-* `security` isn't in the enum upstream — the engineering kit covers that audience.
+* `security` isn't in the enum upstream — the engineering kit covers
+* that audience.
 */
 const TAILORED_ROLES = [
 	"founder",
@@ -2787,62 +3655,198 @@ const TAILORED_ROLES = [
 	"engineering",
 	"data"
 ];
-const STOCK_MCP_SUGGESTED_PROMPTS = [
-	{
-		prompt: "What are my busiest 10 events and when did each last fire?",
-		description: "Inventories your project’s event stream so you can see what’s being captured at a glance."
-	},
-	{
-		prompt: "Show me daily event volume for the last 30 days.",
-		description: "Charts your event count day by day — a quick read on volume and trend."
-	},
-	{
-		prompt: "Create a dashboard with my top 10 events broken down by day for the last 7 days.",
-		description: "Builds a saved dashboard you can pin and share — written back to your project."
+const FOLLOW_UP_EXIT_SENTINEL = "__follow_up_exit__";
+/**
+* Always shown as the picker's first option regardless of role —
+* a safe generic read that works on any project setup. The screen
+* prepends it and dedupes against the role kit so it never appears
+* twice when DEFAULT_KIT happens to include it.
+*/
+const PINNED_FIRST_PROMPT = pinnedFirstPrompt;
+const DEFAULT_KIT = defaultKit;
+const ROLE_KITS = roleKits;
+const ROLE_FAMILY_OVERRIDES = roleFamilyOverrides;
+const ROLE_GREETINGS = roleGreetings;
+const NEUTRAL_GREETING = neutralGreeting;
+const TOOL_FOLLOW_UPS = toolFollowUps;
+const ROLE_FOLLOW_UPS = roleFollowUps;
+const GENERIC_FOLLOW_UPS = genericFollowUps;
+const DEEP_DIVE_FOLLOW_UPS = deepDiveFollowUps;
+const CROSS_SELL_BY_ROLE = crossSellByRole;
+const NEUTRAL_CROSS_SELL = neutralCrossSell;
+const INTEGRATION_FAMILY = {
+	nextjs: "fullstack",
+	nuxt: "fullstack",
+	"tanstack-start": "fullstack",
+	astro: "fullstack",
+	sveltekit: "fullstack",
+	vue: "frontend-web",
+	angular: "frontend-web",
+	"react-router": "frontend-web",
+	"tanstack-router": "frontend-web",
+	javascript_web: "frontend-web",
+	"react-native": "mobile",
+	swift: "mobile",
+	android: "mobile",
+	django: "backend",
+	flask: "backend",
+	fastapi: "backend",
+	python: "backend",
+	laravel: "backend",
+	rails: "backend",
+	ruby: "backend",
+	javascript_node: "backend"
+};
+const EXIT_FOLLOW_UP = {
+	label: "I'm done — exit",
+	prompt: FOLLOW_UP_EXIT_SENTINEL
+};
+function isTailoredRole(role) {
+	return typeof role === "string" && TAILORED_ROLES.includes(role);
+}
+/**
+* Strip MCP tool-name prefixes so lookup keys can stay short. Real MCP
+* tool names arrive as `mcp__<server>__<tool>`; the agent SDK also
+* sometimes drops the prefix. We take the substring after the last
+* double-underscore (or the input untouched if there's none).
+*/
+function normalizeToolName(toolName) {
+	if (!toolName) return null;
+	const idx = toolName.lastIndexOf("__");
+	return idx >= 0 ? toolName.slice(idx + 2) : toolName;
+}
+/** Pick `n` items from a pool starting at a rotation offset. */
+function pickRotated(pool, n, rotation) {
+	if (pool.length === 0) return [];
+	if (pool.length <= n) return pool;
+	const start = (Math.floor(rotation) % pool.length + pool.length) % pool.length;
+	const result = [];
+	for (let i = 0; i < n; i++) result.push(pool[(start + i) % pool.length]);
+	return result;
+}
+/** Drop duplicates while preserving order (by prompt text). */
+function dedupeFollowUps(list) {
+	const seen = /* @__PURE__ */ new Set();
+	const out = [];
+	for (const f of list) {
+		if (seen.has(f.prompt)) continue;
+		seen.add(f.prompt);
+		out.push(f);
 	}
-];
+	return out;
+}
+function getFrameworkFamily(integration) {
+	if (!integration) return "unknown";
+	return INTEGRATION_FAMILY[integration] ?? "unknown";
+}
+/**
+* Resolve the right kit given everything we know about the user + project.
+* Always returns at least DEFAULT_KIT; never throws.
+*/
+function getRolePrompts(role, integration) {
+	const family = getFrameworkFamily(integration);
+	if (!isTailoredRole(role)) return DEFAULT_KIT;
+	const baseKit = ROLE_KITS[role];
+	const overridesForFamily = ROLE_FAMILY_OVERRIDES[role]?.[family];
+	if (!overridesForFamily) return baseKit;
+	return baseKit.map((entry) => {
+		return (entry.key ? overridesForFamily[entry.key] : void 0) ?? entry;
+	});
+}
+function getRoleGreeting(role) {
+	if (!isTailoredRole(role)) return NEUTRAL_GREETING;
+	return ROLE_GREETINGS[role];
+}
+/**
+* Resolve `FOLLOW_UP_COUNT` context-aware follow-ups + an always-present
+* exit entry. Pulls from up to four pools — tool-specific, role-specific,
+* deep-dive (only after the user has explored a few steps), and generic —
+* dedupes, filters out anything already in `branchHistory`, then picks
+* `FOLLOW_UP_COUNT` with a rotation offset driven by `branchHistory.length`
+* so successive visits surface different slices.
+*/
+function getFollowUps(args) {
+	const { lastToolName, role, branchHistory } = args;
+	const normalized = normalizeToolName(lastToolName);
+	const depth = branchHistory.length;
+	const candidates = [];
+	if (normalized && TOOL_FOLLOW_UPS[normalized]) candidates.push(...TOOL_FOLLOW_UPS[normalized]);
+	if (isTailoredRole(role)) candidates.push(...ROLE_FOLLOW_UPS[role]);
+	if (depth >= 3) candidates.push(...DEEP_DIVE_FOLLOW_UPS);
+	candidates.push(...GENERIC_FOLLOW_UPS);
+	const deduped = dedupeFollowUps(candidates);
+	const seen = new Set(branchHistory);
+	return [...pickRotated(deduped.filter((f) => !seen.has(f.prompt)), 3, depth), EXIT_FOLLOW_UP];
+}
+/**
+* Cross-sell prompts to surface above the role kit in PromptPicker.
+* Filtered by role so the recommendations stay coherent (founders see
+* the "exec-friendly" cross-sells, engineers see "debug-friendly", etc).
+*/
+function getCrossSellPrompts(role) {
+	if (!isTailoredRole(role)) return NEUTRAL_CROSS_SELL;
+	return CROSS_SELL_BY_ROLE[role];
+}
 //#endregion
 //#region src/ui/tui/screens/McpSuggestedPromptsScreen.tsx
 /**
 * McpSuggestedPromptsScreen — shown after MCP install succeeds in the
-* standalone `wizard mcp add` program.
+* standalone `wizard mcp add` program, and as the entry point for
+* `wizard mcp tutorial`.
 *
 * Phases:
-*   1. Choose         — opens with a Log in / Exit picker, framed by a
-*                       hardcoded teaser of three example prompts.
-*   2. Authenticating — runs `services.performLogin()` (OAuth in
-*                       production, canned values in the playground).
-*                       Renders a spinner + login URL inline while the
-*                       promise is pending. Errors return to Choose
-*                       with an inline error line.
-*   3. PromptPicker   — lists the role-tailored kit; user picks one to
-*                       run. The picker has its own "Exit" entry so
-*                       dismissal is discoverable without a hidden
-*                       hotkey.
-*   4. Running        — streams the agent's response inline via
-*                       `services.runPromptStreaming`. `[esc]` aborts
-*                       and returns to the picker; `[enter]` after
-*                       completion goes back to the picker so the user
-*                       can run another or exit.
+*   1. Choose          — opens with a Log in / Exit picker, framed by a
+*                        teaser of what MCP can do.
+*   2. Authenticating  — runs `services.performLogin()` (OAuth in
+*                        production, canned values in the playground).
+*                        Renders a spinner + login URL inline while the
+*                        promise is pending. Errors return to Choose
+*                        with an inline error line.
+*   3. Greeting        — role-tuned welcome via `getRoleGreeting`. A
+*                        ContentSequencer animates the headline,
+*                        bullets, and outro, then hands off to
+*                        PromptPicker. Only fires once per session
+*                        (returning via `[p]` skips it).
+*   4. PromptPicker    — lists the role-tailored kit from
+*                        `getRolePrompts`; user picks one to run.
+*   5. Running         — streams the agent's response inline via
+*                        `services.runPromptStreaming`. Text chunks
+*                        typewrite in; tool calls and results render
+*                        as styled badges. `[esc]` aborts; `[p]`
+*                        returns to the picker. On `done`/`error`,
+*                        auto-advances to FollowUp.
+*   6. FollowUp        — surfaces 3 context-aware next prompts inferred
+*                        from the last tool the agent used (via
+*                        `getFollowUps`), plus an explicit exit.
+*                        Picking a follow-up re-enters Running; the
+*                        conversation tree grows as deep as
+*                        MAX_PROMPT_RUNS allows.
 *
-* Credentials are guaranteed non-null once PromptPicker / Running are
-* reached (the Choose → Authenticating gate forces a successful login
-* before getting there). A defensive throw protects the Running
-* useEffect against a state-machine bug.
+* Credentials are guaranteed non-null once Greeting / PromptPicker /
+* Running / FollowUp are reached (the Choose → Authenticating gate
+* forces a successful login first). A defensive throw protects the
+* Running useEffect against a state-machine bug.
 */
-const MAX_PROMPT_RUNS = 3;
+const MAX_PROMPT_RUNS = 5;
+const FOLLOW_UP_DELAY_MS = 3e3;
 const McpSuggestedPromptsScreen = ({ store, services }) => {
 	useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
 	const session = store.session;
-	const kit = STOCK_MCP_SUGGESTED_PROMPTS;
+	const kit = getRolePrompts(session.roleAtOrganization, session.integration);
+	const crossSell = useMemo(() => getCrossSellPrompts(session.roleAtOrganization), [session.roleAtOrganization]);
+	const greeting = useMemo(() => getRoleGreeting(session.roleAtOrganization), [session.roleAtOrganization]);
 	const [phase, setPhase] = useState("choose");
 	const [loginError, setLoginError] = useState(null);
 	const [runningPrompt, setRunningPrompt] = useState(null);
 	const [runChunks, setRunChunks] = useState([]);
 	const [runStartedAt, setRunStartedAt] = useState(null);
+	const [runDurationSecs, setRunDurationSecs] = useState(null);
 	const [runCount, setRunCount] = useState(0);
 	const canPickAnother = runCount < MAX_PROMPT_RUNS;
+	const [lastToolName, setLastToolName] = useState(null);
+	const [branchHistory, setBranchHistory] = useState([]);
 	const runAbortRef = useRef(null);
+	const currentSessionIdRef = useRef(null);
 	useEffect(() => {
 		if (phase !== "authenticating") return;
 		let cancelled = false;
@@ -2854,7 +3858,7 @@ const McpSuggestedPromptsScreen = ({ store, services }) => {
 				store.setRoleAtOrganization(roleAtOrganization);
 				store.setApiUser(user);
 				store.setLoginUrl(null);
-				setPhase("prompt-picker");
+				setPhase("greeting");
 			} catch (err) {
 				if (cancelled) return;
 				const message = err instanceof Error ? err.message : String(err);
@@ -2881,6 +3885,24 @@ const McpSuggestedPromptsScreen = ({ store, services }) => {
 		const startedAt = Date.now();
 		setRunStartedAt(startedAt);
 		setRunChunks([]);
+		setLastToolName(null);
+		setRunDurationSecs(null);
+		const finishStream = (kind, durationMs, errorText) => {
+			if (controller.signal.aborted) return;
+			setRunDurationSecs(Math.round(durationMs / 1e3));
+			if (kind === "done") analytics.wizardCapture("mcp suggested prompts run", {
+				prompt: runningPrompt,
+				durationMs
+			});
+			else analytics.wizardCapture("mcp suggested prompts run failed", {
+				prompt: runningPrompt,
+				error: errorText
+			});
+			setTimeout(() => {
+				if (controller.signal.aborted) return;
+				setPhase("follow-up");
+			}, FOLLOW_UP_DELAY_MS);
+		};
 		(async () => {
 			const credentials = session.credentials;
 			if (!credentials) return;
@@ -2888,22 +3910,19 @@ const McpSuggestedPromptsScreen = ({ store, services }) => {
 				for await (const chunk of services.runPromptStreaming({
 					prompt: runningPrompt,
 					credentials,
-					signal: controller.signal
+					signal: controller.signal,
+					resumeSessionId: currentSessionIdRef.current ?? void 0
 				})) {
 					if (controller.signal.aborted) return;
 					setRunChunks((prev) => [...prev, chunk]);
+					if (chunk.kind === "tool-call") setLastToolName(chunk.toolName);
 					if (chunk.kind === "done") {
-						analytics.wizardCapture("mcp suggested prompts run", {
-							prompt: runningPrompt,
-							durationMs: Date.now() - startedAt
-						});
+						if (chunk.sessionId) currentSessionIdRef.current = chunk.sessionId;
+						finishStream("done", Date.now() - startedAt);
 						return;
 					}
 					if (chunk.kind === "error") {
-						analytics.wizardCapture("mcp suggested prompts run failed", {
-							prompt: runningPrompt,
-							error: chunk.text
-						});
+						finishStream("error", Date.now() - startedAt, chunk.text);
 						return;
 					}
 				}
@@ -2914,10 +3933,7 @@ const McpSuggestedPromptsScreen = ({ store, services }) => {
 					kind: "error",
 					text
 				}]);
-				analytics.wizardCapture("mcp suggested prompts run failed", {
-					prompt: runningPrompt,
-					error: text
-				});
+				finishStream("error", Date.now() - startedAt, text);
 			}
 		})();
 		return () => {
@@ -2930,7 +3946,11 @@ const McpSuggestedPromptsScreen = ({ store, services }) => {
 		services,
 		session.credentials
 	]);
-	const dismiss = () => {
+	const enterGoodbye = () => {
+		runAbortRef.current?.abort();
+		setPhase("goodbye");
+	};
+	const closeWizard = () => {
 		setPhase("done");
 		setTimeout(() => {
 			store.setMcpSuggestedPromptsDismissed();
@@ -2944,35 +3964,66 @@ const McpSuggestedPromptsScreen = ({ store, services }) => {
 			setPhase("authenticating");
 		} else {
 			analytics.wizardCapture("mcp suggested prompts choose", { choice: "exit" });
-			dismiss();
+			enterGoodbye();
 		}
 	};
-	const handlePromptPick = (value) => {
-		setRunningPrompt(Array.isArray(value) ? value[0] : value);
+	const startRun = (prompt) => {
+		setRunningPrompt(prompt);
 		setRunCount((c) => c + 1);
+		setBranchHistory((h) => [...h, prompt]);
 		setPhase("running");
 	};
-	useKeyBindings("mcp-suggested-prompts", [{
-		match: "escape",
-		label: "esc",
-		action: phase === "prompt-picker" ? "exit" : "exit",
-		handler: () => {
-			if (phase === "running") {
-				runAbortRef.current?.abort();
-				dismiss();
-			} else if (phase === "prompt-picker") dismiss();
-		}
-	}, {
-		match: "p",
-		label: "p",
-		action: canPickAnother ? "pick new prompt" : "cap reached",
-		handler: () => {
-			if (phase !== "running") return;
-			if (!canPickAnother) return;
-			runAbortRef.current?.abort();
-			setPhase("prompt-picker");
+	const handlePromptPick = (value) => {
+		startRun(Array.isArray(value) ? value[0] : value);
+	};
+	const handleFollowUpPick = (value) => {
+		const picked = Array.isArray(value) ? value[0] : value;
+		if (picked === "__follow_up_exit__") {
+			analytics.wizardCapture("mcp suggested prompts follow-up", {
+				choice: "exit",
+				depth: branchHistory.length
+			});
+			enterGoodbye();
+			return;
 		}
-	}]);
+		analytics.wizardCapture("mcp suggested prompts follow-up", {
+			choice: "continue",
+			depth: branchHistory.length,
+			lastToolName
+		});
+		startRun(picked);
+	};
+	useKeyBindings("mcp-suggested-prompts", [
+		{
+			match: "escape",
+			label: "esc",
+			action: phase === "goodbye" ? "close" : "exit",
+			handler: () => {
+				if (phase === "goodbye") closeWizard();
+				else if (phase === "running" || phase === "prompt-picker" || phase === "follow-up" || phase === "greeting") enterGoodbye();
+			}
+		},
+		{
+			match: "p",
+			label: "p",
+			action: canPickAnother ? "pick new prompt" : "cap reached",
+			handler: () => {
+				if (phase !== "running" && phase !== "follow-up") return;
+				if (!canPickAnother) return;
+				runAbortRef.current?.abort();
+				currentSessionIdRef.current = null;
+				setPhase("prompt-picker");
+			}
+		},
+		...phase === "greeting" ? [{
+			match: "return",
+			label: "enter",
+			action: "continue",
+			handler: () => {
+				setPhase("prompt-picker");
+			}
+		}] : []
+	]);
 	return /* @__PURE__ */ jsx(Box, {
 		flexDirection: "column",
 		flexGrow: 1,
@@ -2985,25 +4036,60 @@ const McpSuggestedPromptsScreen = ({ store, services }) => {
 					onSelect: handleChoice
 				}),
 				phase === "authenticating" && /* @__PURE__ */ jsx(AuthenticatingPhase, { loginUrl: session.loginUrl }),
-				phase === "prompt-picker" && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx(Box, {
-					marginBottom: 1,
-					children: /* @__PURE__ */ jsx(Text, {
-						bold: true,
-						color: Colors.accent,
-						children: "MCP tutorial"
-					})
-				}), /* @__PURE__ */ jsx(PromptPickerPhase, {
-					promptKit: kit,
+				phase === "greeting" && /* @__PURE__ */ jsx(GreetingPhase, {
+					greeting,
 					userDisplayName: session.apiUser?.first_name || null,
+					onComplete: () => setPhase("prompt-picker")
+				}),
+				phase === "prompt-picker" && /* @__PURE__ */ jsx(PromptPickerPhase, {
+					promptKit: kit,
+					crossSell,
 					onSelect: handlePromptPick
-				})] }),
+				}),
 				phase === "running" && runningPrompt && /* @__PURE__ */ jsx(RunningPhase, {
 					prompt: runningPrompt,
 					chunks: runChunks,
 					startedAt: runStartedAt,
-					canPickAnother,
+					frozenDurationSecs: runDurationSecs,
 					runCount,
 					maxRuns: MAX_PROMPT_RUNS
+				}),
+				phase === "follow-up" && /* @__PURE__ */ jsxs(Box, {
+					flexDirection: "column",
+					flexGrow: 1,
+					children: [runningPrompt && /* @__PURE__ */ jsx(Box, {
+						flexDirection: "column",
+						flexShrink: 1,
+						children: /* @__PURE__ */ jsx(RunningPhase, {
+							prompt: runningPrompt,
+							chunks: runChunks,
+							startedAt: runStartedAt,
+							frozenDurationSecs: runDurationSecs,
+							runCount,
+							maxRuns: MAX_PROMPT_RUNS
+						})
+					}), /* @__PURE__ */ jsx(Box, {
+						marginTop: 1,
+						flexShrink: 0,
+						flexDirection: "column",
+						children: /* @__PURE__ */ jsx(FollowUpPhase, {
+							lastToolName,
+							lastPrompt: runningPrompt,
+							chunks: runChunks,
+							role: session.roleAtOrganization,
+							branchHistory,
+							canPickAnother,
+							maxRuns: MAX_PROMPT_RUNS,
+							onSelect: handleFollowUpPick
+						})
+					})]
+				}),
+				phase === "goodbye" && /* @__PURE__ */ jsx(GoodbyePhase, {
+					installedClients: session.mcpInstalledClients,
+					role: session.roleAtOrganization,
+					integration: session.integration,
+					engaged: branchHistory.length > 0,
+					onClose: closeWizard
 				})
 			]
 		})
@@ -3093,56 +4179,109 @@ const AuthenticatingPhase = ({ loginUrl }) => /* @__PURE__ */ jsxs(Box, {
 		] })
 	})]
 });
-const PromptPickerPhase = ({ promptKit, userDisplayName, onSelect }) => {
-	const options = promptKit.map((p) => ({
-		label: p.prompt,
-		value: p.prompt
-	}));
-	return /* @__PURE__ */ jsx(Box, {
+const GreetingPhase = ({ greeting, userDisplayName, onComplete }) => {
+	const blocks = [];
+	if (userDisplayName) blocks.push({
+		content: `Hi ${userDisplayName}!`,
+		mode: 0,
+		animationInterval: 70,
+		pause: 1200
+	});
+	blocks.push({
+		content: greeting.headline,
+		mode: 0,
+		animationInterval: 45,
+		pause: 2e3
+	});
+	blocks.push({
+		type: "lines",
+		lines: greeting.bullets.map((bullet, i) => /* @__PURE__ */ jsxs(Text, { children: [
+			/* @__PURE__ */ jsx(Text, {
+				color: Colors.primary,
+				children: Icons.diamond
+			}),
+			" ",
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: bullet
+			})
+		] }, i)),
+		interval: 700,
+		pause: 2200
+	});
+	blocks.push({
+		content: greeting.outro,
+		mode: 0,
+		animationInterval: 38,
+		pause: 1800
+	});
+	return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
-		children: /* @__PURE__ */ jsx(ContentSequencer, {
-			blocks: [
-				{
-					content: `Hello there, ${userDisplayName || "there"}!`,
-					mode: 0,
-					animationInterval: 100,
-					pause: 1200,
-					dimWhenComplete: false
-				},
-				{
-					content: "Pick a prompt to see the PostHog MCP in action.",
-					mode: 0,
-					animationInterval: 50,
-					pause: 1e3,
-					dimWhenComplete: false
-				},
-				{
-					content: /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx(PickerMenu, {
-						options,
-						optionMarginBottom: 1,
-						onSelect
-					}), /* @__PURE__ */ jsx(Box, {
-						marginTop: 2,
-						children: /* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
-							bold: true,
-							children: "[esc]"
-						}), /* @__PURE__ */ jsx(Text, { children: " to exit" })] })
-					})] }),
-					persist: true
-				}
-			],
+		children: [/* @__PURE__ */ jsx(Box, {
+			marginBottom: 1,
+			children: /* @__PURE__ */ jsx(Text, {
+				bold: true,
+				color: Colors.accent,
+				children: "MCP tutorial"
+			})
+		}), /* @__PURE__ */ jsx(ContentSequencer, {
+			blocks,
 			mode: 0,
-			blockInterval: 350
-		})
+			blockInterval: 500,
+			onSequenceComplete: onComplete
+		})]
+	});
+};
+const PromptPickerPhase = ({ promptKit, crossSell, onSelect }) => {
+	const seenPrompts = /* @__PURE__ */ new Set();
+	const options = [
+		PINNED_FIRST_PROMPT,
+		...crossSell,
+		...promptKit
+	].filter((o) => {
+		if (seenPrompts.has(o.prompt)) return false;
+		seenPrompts.add(o.prompt);
+		return true;
+	}).slice(0, 4).map((o) => ({
+		label: o.product ? `Try ${o.product}  —  ${o.label ?? o.prompt}` : o.label ?? o.prompt,
+		value: o.prompt
+	}));
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [
+			/* @__PURE__ */ jsx(Box, {
+				marginBottom: 1,
+				children: /* @__PURE__ */ jsx(Text, {
+					bold: true,
+					color: Colors.accent,
+					children: "MCP tutorial"
+				})
+			}),
+			/* @__PURE__ */ jsx(Box, {
+				marginBottom: 1,
+				children: /* @__PURE__ */ jsx(Text, { children: "Pick a prompt to see the PostHog MCP in action." })
+			}),
+			/* @__PURE__ */ jsx(PickerMenu, {
+				options,
+				optionMarginBottom: 1,
+				onSelect
+			}),
+			/* @__PURE__ */ jsx(Box, {
+				marginTop: 2,
+				children: /* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+					bold: true,
+					children: "[esc]"
+				}), /* @__PURE__ */ jsx(Text, { children: " to exit" })] })
+			})
+		]
 	});
 };
-const RunningPhase = ({ prompt, chunks, startedAt, canPickAnother, runCount, maxRuns }) => {
+const RunningPhase = ({ prompt, chunks, startedAt, frozenDurationSecs, runCount, maxRuns }) => {
 	const isDone = chunks.some((c) => c.kind === "done");
 	const errorChunk = chunks.find((c) => c.kind === "error");
 	const finished = isDone || !!errorChunk;
-	const elapsed = startedAt ? Math.round((Date.now() - startedAt) / 1e3) : 0;
-	const visibleChunks = finished ? chunks.filter((c) => c.kind === "text" || c.kind === "error") : chunks;
-	const cappedChunks = finished ? capTextChunks(visibleChunks) : visibleChunks;
+	const elapsed = frozenDurationSecs ?? (startedAt ? Math.round((Date.now() - startedAt) / 1e3) : 0);
+	const visibleChunks = finished ? capTextChunks(collapseToFinalAnswer(chunks)) : chunks;
 	return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		children: [
@@ -3181,52 +4320,63 @@ const RunningPhase = ({ prompt, chunks, startedAt, canPickAnother, runCount, max
 			/* @__PURE__ */ jsx(Box, {
 				marginTop: 1,
 				flexDirection: "column",
-				children: cappedChunks.map((chunk, idx) => /* @__PURE__ */ jsx(ChunkLine, { chunk }, idx))
-			}),
-			finished && !canPickAnother && /* @__PURE__ */ jsx(Box, {
-				marginTop: 1,
-				children: /* @__PURE__ */ jsxs(Text, { children: [
-					/* @__PURE__ */ jsxs(Text, {
-						dimColor: true,
-						children: [
-							"You've hit the ",
-							maxRuns,
-							"-prompt tutorial cap. Press",
-							" "
-						]
-					}),
-					/* @__PURE__ */ jsx(Text, {
-						bold: true,
-						dimColor: true,
-						children: "[esc]"
-					}),
-					/* @__PURE__ */ jsx(Text, {
-						dimColor: true,
-						children: " to exit."
-					})
-				] })
+				children: visibleChunks.map((chunk, idx) => /* @__PURE__ */ jsx(ChunkLine, { chunk }, idx))
 			})
 		]
 	});
 };
 /**
+* Strip everything except the agent's final answer + any error chunks.
+* Drops tool-call / tool-result chatter (their work is done once the
+* stream completes) and any text blocks emitted BEFORE the last text
+* block — those are typically Sonnet's "I'll query X…" preamble that
+* arrives alongside the first tool_use and adds noise above the picker.
+*
+* If the run produced no text at all (pure tool calls, or only errors),
+* fall through to whatever chunks survived so the user isn't left with
+* a blank result.
+*/
+function collapseToFinalAnswer(chunks) {
+	const textChunks = chunks.filter((c) => c.kind === "text");
+	const errors = chunks.filter((c) => c.kind === "error");
+	if (textChunks.length === 0) return errors;
+	return [textChunks[textChunks.length - 1], ...errors];
+}
+/**
 * Belt-and-suspenders fallback for runs where Claude ignored the
 * terminal-fit system prompt and produced an overlong response. Joins
-* all text chunks, slices to the last N lines that fit in the current
-* terminal, and prepends an indicator showing how many lines got cut.
-* Errors are preserved separately so failures don't disappear into the
-* truncation.
+* all text chunks, then walks them from the bottom keeping only as many
+* lines as fit in the visual row budget — wide lines that wrap to
+* multiple rows on a narrow terminal cost their wrapped row count, not
+* 1. Prepends an indicator showing how many source lines got cut. Tool
+* calls, results, and errors are preserved separately so they don't
+* disappear into the truncation.
+*
+* Visual-row-aware truncation is what makes the FollowUp picker feel
+* pinned: a 5-row table that wraps to 12 visual rows on a 60-col
+* terminal correctly counts as 12, so the cap leaves exactly the room
+* the picker needs.
 */
 function capTextChunks(chunks) {
 	const rows = process.stdout.rows ?? 24;
-	const maxMessageRows = Math.max(6, rows - 8);
+	const cols = process.stdout.columns ?? 120;
+	const maxVisualRows = Math.max(3, rows - 19);
 	const textChunks = chunks.filter((c) => c.kind === "text");
 	const errors = chunks.filter((c) => c.kind === "error");
 	if (textChunks.length === 0) return chunks;
 	const lines = textChunks.map((c) => c.text).join("").split("\n");
-	if (lines.length <= maxMessageRows) return chunks;
-	const hidden = lines.length - maxMessageRows;
-	const tail = lines.slice(-maxMessageRows).join("\n");
+	const visualRows = (line) => Math.max(1, Math.ceil(line.length / cols));
+	let used = 0;
+	let keepFrom = lines.length;
+	for (let i = lines.length - 1; i >= 0; i--) {
+		const cost = visualRows(lines[i]);
+		if (used + cost > maxVisualRows) break;
+		used += cost;
+		keepFrom = i;
+	}
+	if (keepFrom === 0) return chunks;
+	const hidden = keepFrom;
+	const tail = lines.slice(keepFrom).join("\n");
 	return [{
 		kind: "text",
 		text: `[${hidden} line${hidden === 1 ? "" : "s"} above — expand terminal to see more]\n\n${tail}`
@@ -3257,6 +4407,101 @@ const ChunkLine = ({ chunk }) => {
 	});
 	return null;
 };
+const FollowUpPhase = ({ lastToolName, lastPrompt, chunks, role, branchHistory, canPickAnother, maxRuns, onSelect }) => {
+	const followUps = useMemo(() => getFollowUps({
+		lastToolName,
+		lastPrompt: lastPrompt || "",
+		role,
+		branchHistory
+	}), [
+		lastToolName,
+		lastPrompt,
+		role,
+		branchHistory
+	]);
+	const options = canPickAnother ? followUps.map((f) => ({
+		label: f.label ?? f.prompt,
+		value: f.prompt
+	})) : [{
+		label: "Exit",
+		value: FOLLOW_UP_EXIT_SENTINEL
+	}];
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [/* @__PURE__ */ jsx(Text, { children: chunks.find((c) => c.kind === "error") ? "That one errored out — try a different angle?" : !canPickAnother ? `You've hit the ${maxRuns}-prompt tutorial cap.` : `Want to keep exploring? Select a follow-up prompt.` }), /* @__PURE__ */ jsx(PickerMenu, {
+			options,
+			onSelect
+		})]
+	});
+};
+const GoodbyePhase = ({ installedClients, role, integration, engaged, onClose }) => {
+	const samples = getRolePrompts(role, integration).slice(0, 3);
+	const headline = engaged ? "Nice work. You can keep talking to PostHog anytime." : "You're all set — PostHog MCP is here when you're ready.";
+	const introLine = installedClients.length > 0 ? /* @__PURE__ */ jsxs(Text, { children: [
+		"MCP is set up in",
+		" ",
+		/* @__PURE__ */ jsx(Text, {
+			bold: true,
+			color: Colors.primary,
+			children: installedClients.join(", ")
+		}),
+		". Open one and try a prompt like:"
+	] }) : /* @__PURE__ */ jsx(Text, { children: "Wherever you have MCP set up (Claude Code, Cursor, VS Code, Windsurf, Zed, etc.), open the agent and try a prompt like:" });
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [
+			/* @__PURE__ */ jsx(Box, {
+				marginBottom: 1,
+				children: /* @__PURE__ */ jsx(Text, {
+					bold: true,
+					color: Colors.accent,
+					children: headline
+				})
+			}),
+			/* @__PURE__ */ jsx(Box, {
+				marginBottom: 1,
+				children: introLine
+			}),
+			/* @__PURE__ */ jsx(Box, {
+				marginBottom: 1,
+				flexDirection: "column",
+				children: samples.map((p, i) => /* @__PURE__ */ jsxs(Box, { children: [
+					/* @__PURE__ */ jsx(Text, {
+						color: Colors.primary,
+						children: Icons.triangleSmallRight
+					}),
+					/* @__PURE__ */ jsx(Text, { children: " " }),
+					/* @__PURE__ */ jsx(Text, {
+						dimColor: true,
+						children: p.prompt
+					})
+				] }, i))
+			}),
+			/* @__PURE__ */ jsx(Box, {
+				marginBottom: 1,
+				children: /* @__PURE__ */ jsxs(Text, {
+					dimColor: true,
+					children: [
+						"Re-run this tutorial anytime with",
+						" ",
+						/* @__PURE__ */ jsx(Text, {
+							bold: true,
+							children: "npx @posthog/wizard mcp tutorial"
+						}),
+						"."
+					]
+				})
+			}),
+			/* @__PURE__ */ jsx(PickerMenu, {
+				options: [{
+					label: "Close",
+					value: "close"
+				}],
+				onSelect: onClose
+			})
+		]
+	});
+};
 //#endregion
 //#region src/ui/tui/screens/audit/AuditChecksViewer/AreaHeaderRow.tsx
 /** Sub-header row inside the scrollable body — one per area group. */
@@ -4120,4 +5365,4 @@ const AUDIT_3000_AREA_SLIDES = [
 //#endregion
 export { WizardStore as A, useStdoutDimensions as C, LoadingBox as D, ProgressList as E, SplitView as O, GroupedPickerMenu as S, useKeyBindings as T, ScreenContainer as _, McpSuggestedPromptsScreen as a, ModalOverlay as b, IssueTable as c, ServiceHealthList as d, TipsCard as f, TabContainer as g, HNViewer as h, AuditChecksViewer as i, CardLayout as k, SEVERITY_LABEL as l, ContentSequencer as m, AUDIT_AREA_SLIDES as n, TAILORED_ROLES as o, LearnCard as p, VisualBox as r, McpScreen as s, AUDIT_3000_AREA_SLIDES as t, SEVERITY_ORDER as u, EventPlanViewer as v, PickerMenu as w, ConfirmationInput as x, LogViewer as y };
 
-//# sourceMappingURL=slides-CL1mv_Kq.js.map
+//# sourceMappingURL=slides-DRbBgsdd.js.map