@posthog/wizard 2.15.0 → 2.16.1

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

@@ -1,11 +1,11 @@
-import { g as SERVICE_LABELS } from "./debug-DRKLej5r.js";
+import { g as SERVICE_LABELS, s as logToFile } from "./debug-ubpO6102.js";
 import { n as isTaskStatus } from "./wizard-ui-YdGFRyu_.js";
-import { n as analytics, r as sessionProperties } from "./analytics-Da4QHjMw.js";
-import { i as buildSession } from "./wizard-session-BlgiX-5d.js";
-import { _ as AUDIT_SEVERITY_STYLE } from "./agent-interface-yB_27jG8.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-B_8bXLLs.js";
-import { n as Program, r as getProgramConfig, s as getKindMeta, t as PROGRAM_REGISTRY } from "./bin.js";
-import { n as AVAILABLE_FEATURES, t as ALL_FEATURE_VALUES } from "./defaults-CPH6eWhN.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 { 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 * 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";
@@ -274,6 +274,14 @@ var WizardStore = class {
 		analytics.wizardCapture("auth complete", { project_id: credentials?.projectId });
 		this.emitChange();
 	}
+	setRoleAtOrganization(role) {
+		this.$session.setKey("roleAtOrganization", role);
+		this.emitChange();
+	}
+	setApiUser(user) {
+		this.$session.setKey("apiUser", user);
+		this.emitChange();
+	}
 	setFrameworkConfig(integration, config) {
 		this.$session.setKey("integration", integration);
 		this.$session.setKey("frameworkConfig", config);
@@ -466,6 +474,10 @@ var WizardStore = class {
 		});
 		this.emitChange();
 	}
+	setMcpSuggestedPromptsDismissed() {
+		this.$session.setKey("mcpSuggestedPromptsDismissed", true);
+		this.emitChange();
+	}
 	setOutroDismissed() {
 		this.$session.setKey("outroDismissed", true);
 		this.emitChange();
@@ -475,9 +487,15 @@ var WizardStore = class {
 		this.emitChange();
 	}
 	setDashboardUrl(url) {
+		logToFile(`store.setDashboardUrl: ${url}`);
 		this.$session.setKey("dashboardUrl", url);
 		this.emitChange();
 	}
+	setNotebookUrl(url) {
+		logToFile(`store.setNotebookUrl: ${url}`);
+		this.$session.setKey("notebookUrl", url);
+		this.emitChange();
+	}
 	setFrameworkContext(key, value) {
 		const ctx = {
 			...this.$session.get().frameworkContext,
@@ -774,22 +792,18 @@ function deduplicateAndSort(hints) {
 * KeyboardHintsProvider — Context for collecting and displaying keyboard hints.
 *
 * Input components register their hints via useKeyBindings. The provider
-* flattens, deduplicates, and sorts them. It auto-dismisses 3s after the
-* first keypress and resets when the hint set changes (screen navigation).
+* flattens, deduplicates, and sorts them. The hints bar stays visible for as
+* long as a screen has registered hints — it never auto-dismisses.
 */
 const KeyboardHintsContext = createContext({
 	register: () => void 0,
 	unregister: () => void 0,
-	hints: [],
-	visible: false
+	hints: []
 });
 const useKeyboardHintsContext = () => useContext(KeyboardHintsContext);
-const DISMISS_DELAY = 3e3;
 const KeyboardHintsProvider = ({ children }) => {
 	const registrationsRef = useRef(/* @__PURE__ */ new Map());
 	const [hints, setHints] = useState([]);
-	const [visible, setVisible] = useState(true);
-	const timerRef = useRef(null);
 	const prevHintsKeyRef = useRef("");
 	const recompute = useCallback(() => {
 		const all = [];
@@ -799,13 +813,6 @@ const KeyboardHintsProvider = ({ children }) => {
 		if (newKey !== prevHintsKeyRef.current) {
 			prevHintsKeyRef.current = newKey;
 			setHints(deduped);
-			if (newKey.length > 0) {
-				setVisible(true);
-				if (timerRef.current) {
-					clearTimeout(timerRef.current);
-					timerRef.current = null;
-				}
-			}
 		}
 	}, []);
 	const register = useCallback((id, h) => {
@@ -816,25 +823,11 @@ const KeyboardHintsProvider = ({ children }) => {
 		registrationsRef.current.delete(id);
 		recompute();
 	}, [recompute]);
-	useInput(() => {
-		if (!visible) return;
-		if (timerRef.current) return;
-		timerRef.current = setTimeout(() => {
-			setVisible(false);
-			timerRef.current = null;
-		}, DISMISS_DELAY);
-	});
-	useEffect(() => {
-		return () => {
-			if (timerRef.current) clearTimeout(timerRef.current);
-		};
-	}, []);
 	return /* @__PURE__ */ jsx(KeyboardHintsContext.Provider, {
 		value: {
 			register,
 			unregister,
-			hints,
-			visible
+			hints
 		},
 		children
 	});
@@ -888,12 +881,13 @@ function useKeyBindings(id, bindings) {
 * Key bindings are declared via useKeyBindings, which auto-registers
 * hints in the KeyboardHintsBar.
 */
-const PickerMenu = ({ message, options, mode = "single", centered = false, columns = 1, onSelect }) => {
+const PickerMenu = ({ message, options, mode = "single", centered = false, columns = 1, optionMarginBottom = 0, onSelect }) => {
 	if (mode === "multi") return /* @__PURE__ */ jsx(MultiPickerMenu, {
 		message,
 		options,
 		centered,
 		columns,
+		optionMarginBottom,
 		onSelect
 	});
 	return /* @__PURE__ */ jsx(SinglePickerMenu, {
@@ -901,11 +895,12 @@ const PickerMenu = ({ message, options, mode = "single", centered = false, colum
 		options,
 		centered,
 		columns,
+		optionMarginBottom,
 		onSelect
 	});
 };
 /** Custom single-select with triangle indicator and accent highlight. */
-const SinglePickerMenu = ({ message, options, centered = false, columns = 1, onSelect }) => {
+const SinglePickerMenu = ({ message, options, centered = false, columns = 1, optionMarginBottom = 0, onSelect }) => {
 	const [focused, setFocused] = useState(0);
 	const rows = Math.ceil(options.length / columns);
 	const bindings = [{
@@ -966,6 +961,7 @@ const SinglePickerMenu = ({ message, options, centered = false, columns = 1, onS
 					const label = opt.hint ? `${opt.label} (${opt.hint})` : opt.label;
 					return /* @__PURE__ */ jsxs(Box, {
 						gap: 1,
+						marginBottom: optionMarginBottom,
 						children: [/* @__PURE__ */ jsx(Text, {
 							color: isFocused ? Colors.accent : void 0,
 							dimColor: !isFocused,
@@ -983,7 +979,7 @@ const SinglePickerMenu = ({ message, options, centered = false, columns = 1, onS
 	});
 };
 /** Custom multi-select with checkbox glyphs and accent highlight. */
-const MultiPickerMenu = ({ message, options, centered = false, columns = 1, onSelect }) => {
+const MultiPickerMenu = ({ message, options, centered = false, columns = 1, optionMarginBottom = 0, onSelect }) => {
 	const [focused, setFocused] = useState(0);
 	const [selected, setSelected] = useState(/* @__PURE__ */ new Set());
 	const rows = Math.ceil(options.length / columns);
@@ -1067,6 +1063,7 @@ const MultiPickerMenu = ({ message, options, centered = false, columns = 1, onSe
 					const checkbox = isSelected ? Icons.squareFilled : Icons.squareOpen;
 					return /* @__PURE__ */ jsxs(Box, {
 						gap: 1,
+						marginBottom: optionMarginBottom,
 						children: [/* @__PURE__ */ jsx(Text, {
 							color: isSelected ? "white" : Colors.muted,
 							dimColor: !isFocused && !isSelected,
@@ -1441,40 +1438,92 @@ const ModalOverlay = ({ borderColor, title, titleColor, width = 68, children, fe
 /**
 * LogViewer — Real-time log tail, pinned to available terminal height.
 * Only renders the last N lines that fit on screen.
+*
+* Reads only the last TAIL_BYTES of the file on each refresh and throttles
+* fs.watch callbacks to one refresh per WATCH_THROTTLE_MS. Without this,
+* fs.readFileSync allocates a string the size of the entire log on every
+* append — during subagent fan-out that's tens of writes per second against
+* a log that grows into the hundreds of MB, producing OOM-grade allocation
+* pressure on V8's heap.
 */
 /** Rows consumed by TitleBar + spacer + ScreenContainer padding + status bar + tab bar */
 const CHROME_ROWS$1 = 8;
+/** Bytes read from the end of the log per refresh — large enough to contain
+*  any practical visible window of lines, small enough to allocate cheaply. */
+const TAIL_BYTES = 256 * 1024;
+/** Minimum gap between watch-triggered refreshes. fs.watch fires on every
+*  append */
+const WATCH_THROTTLE_MS = 250;
+function readTailLines(filePath, visibleLines) {
+	const stat = fs$1.statSync(filePath);
+	if (stat.size === 0) return [];
+	const start = Math.max(0, stat.size - TAIL_BYTES);
+	const length = stat.size - start;
+	const buf = Buffer.alloc(length);
+	const fd = fs$1.openSync(filePath, "r");
+	try {
+		fs$1.readSync(fd, buf, 0, length, start);
+	} finally {
+		fs$1.closeSync(fd);
+	}
+	let text = buf.toString("utf-8");
+	if (start > 0) {
+		const firstNewline = text.indexOf("\n");
+		if (firstNewline >= 0) text = text.slice(firstNewline + 1);
+	}
+	return text.split("\n").slice(-visibleLines);
+}
 const LogViewer = ({ filePath, height }) => {
 	const [, rows] = useStdoutDimensions();
 	const visibleLines = height ?? Math.max(5, rows - CHROME_ROWS$1);
 	const [lines, setLines] = useState([]);
 	useEffect(() => {
+		let lastReadAt = 0;
+		let pendingTimer;
 		const readTail = () => {
 			try {
-				setLines(fs$1.readFileSync(filePath, "utf-8").split("\n").slice(-visibleLines));
+				setLines(readTailLines(filePath, visibleLines));
 			} catch {
 				setLines(["(No log file found)"]);
 			}
 		};
+		const scheduleRead = () => {
+			const now = Date.now();
+			const elapsed = now - lastReadAt;
+			if (elapsed >= WATCH_THROTTLE_MS) {
+				lastReadAt = now;
+				readTail();
+				return;
+			}
+			if (pendingTimer) return;
+			pendingTimer = setTimeout(() => {
+				pendingTimer = void 0;
+				lastReadAt = Date.now();
+				readTail();
+			}, WATCH_THROTTLE_MS - elapsed);
+		};
 		readTail();
+		lastReadAt = Date.now();
 		let watcher;
 		try {
-			watcher = fs$1.watch(filePath, () => {
-				readTail();
-			});
+			watcher = fs$1.watch(filePath, () => scheduleRead());
 		} catch {
 			const interval = setInterval(() => {
 				try {
 					fs$1.accessSync(filePath);
 					readTail();
 					clearInterval(interval);
-					watcher = fs$1.watch(filePath, () => readTail());
+					watcher = fs$1.watch(filePath, () => scheduleRead());
 				} catch {}
 			}, 1e3);
-			return () => clearInterval(interval);
+			return () => {
+				clearInterval(interval);
+				if (pendingTimer) clearTimeout(pendingTimer);
+			};
 		}
 		return () => {
 			watcher?.close();
+			if (pendingTimer) clearTimeout(pendingTimer);
 		};
 	}, [filePath, visibleLines]);
 	return /* @__PURE__ */ jsx(Box, {
@@ -1656,16 +1705,15 @@ const DissolveTransition = ({ transitionKey, width, height, children, direction
 /**
 * KeyboardHintsBar — Row showing active keyboard shortcuts.
 *
-* Always reserves its row to prevent layout shift. When hints are
-* visible, renders them in dimmed grey text. When dismissed, renders
-* an empty reserved row.
+* Always reserves its row to prevent layout shift, and always renders the
+* active hints (in dimmed grey text) while a screen has registered them.
 */
 const KeyboardHintsBar = () => {
-	const { hints, visible } = useKeyboardHintsContext();
+	const { hints } = useKeyboardHintsContext();
 	return /* @__PURE__ */ jsx(Box, {
 		height: 1,
 		paddingX: 1,
-		children: visible && hints.length > 0 && hints.map((hint, i) => /* @__PURE__ */ jsxs(Box, {
+		children: hints.map((hint, i) => /* @__PURE__ */ jsxs(Box, {
 			marginRight: i < hints.length - 1 ? 2 : 0,
 			children: [/* @__PURE__ */ jsx(Text, {
 				bold: true,
@@ -2184,7 +2232,8 @@ const BlockRenderer = ({ block, active, completed, onComplete, mode, bullet, ani
 		animationInterval: block.animationInterval ?? animationInterval,
 		sentenceInterval: block.sentenceInterval ?? sentenceInterval,
 		maxHeight,
-		availableWidth
+		availableWidth,
+		dimWhenComplete: block.dimWhenComplete ?? true
 	});
 	return /* @__PURE__ */ jsx(NodeBlock, {
 		content: block.content,
@@ -2622,10 +2671,10 @@ const McpScreen = ({ store, installer, mode = "install" }) => {
 	return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		flexGrow: 1,
-		children: [/* @__PURE__ */ jsxs(Text, {
+		children: [/* @__PURE__ */ jsx(Text, {
 			bold: true,
 			color: Colors.accent,
-			children: ["MCP Server ", isRemove ? "Removal" : "Setup"]
+			children: isRemove ? "Remove the PostHog MCP" : "Install the MCP so you can chat to your data"
 		}), /* @__PURE__ */ jsxs(Box, {
 			marginTop: 1,
 			flexDirection: "column",
@@ -2642,19 +2691,38 @@ const McpScreen = ({ store, installer, mode = "install" }) => {
 						" MCP clients detected. Skipping..."
 					]
 				}),
-				phase === "ask" && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsxs(Text, {
-					dimColor: true,
-					children: ["Detected: ", clients.map((c) => c.name).join(", ")]
-				}), /* @__PURE__ */ jsx(Box, {
-					marginTop: 1,
-					children: /* @__PURE__ */ jsx(ConfirmationInput, {
-						message: `${isRemove ? "Remove" : "Install"} the PostHog MCP server${clients.some((c) => c.supportsPlugin) ? " and plugin" : ""}?`,
-						confirmLabel: isRemove ? "Remove" : "Install",
-						cancelLabel: "No thanks",
-						onConfirm: handleConfirm,
-						onCancel: handleSkip
+				phase === "ask" && /* @__PURE__ */ jsxs(Fragment$1, { children: [
+					!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, {
+							dimColor: true,
+							children: [
+								"•",
+								" ",
+								bullet
+							]
+						}, bullet))
+					}),
+					/* @__PURE__ */ jsxs(Text, {
+						dimColor: true,
+						children: ["Detected: ", clients.map((c) => c.name).join(", ")]
+					}),
+					/* @__PURE__ */ jsx(Box, {
+						marginTop: 1,
+						children: /* @__PURE__ */ jsx(ConfirmationInput, {
+							message: `${isRemove ? "Remove" : "Install"} the PostHog MCP server${clients.some((c) => c.supportsPlugin) ? " and plugin" : ""}?`,
+							confirmLabel: isRemove ? "Remove" : "Install",
+							cancelLabel: "No thanks",
+							onConfirm: handleConfirm,
+							onCancel: handleSkip
+						})
 					})
-				})] }),
+				] }),
 				phase === "pick" && /* @__PURE__ */ jsx(PickerMenu, {
 					message: "Select editor to install MCP server",
 					options: clients.map((c) => ({
@@ -2706,6 +2774,490 @@ const McpScreen = ({ store, installer, mode = "install" }) => {
 	});
 };
 //#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.
+*/
+const TAILORED_ROLES = [
+	"founder",
+	"product",
+	"leadership",
+	"marketing",
+	"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."
+	}
+];
+//#endregion
+//#region src/ui/tui/screens/McpSuggestedPromptsScreen.tsx
+/**
+* McpSuggestedPromptsScreen — shown after MCP install succeeds in the
+* standalone `wizard mcp add` program.
+*
+* 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.
+*
+* 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.
+*/
+const MAX_PROMPT_RUNS = 3;
+const McpSuggestedPromptsScreen = ({ store, services }) => {
+	useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
+	const session = store.session;
+	const kit = STOCK_MCP_SUGGESTED_PROMPTS;
+	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 [runCount, setRunCount] = useState(0);
+	const canPickAnother = runCount < MAX_PROMPT_RUNS;
+	const runAbortRef = useRef(null);
+	useEffect(() => {
+		if (phase !== "authenticating") return;
+		let cancelled = false;
+		(async () => {
+			try {
+				const { credentials, roleAtOrganization, user } = await services.performLogin();
+				if (cancelled) return;
+				store.setCredentials(credentials);
+				store.setRoleAtOrganization(roleAtOrganization);
+				store.setApiUser(user);
+				store.setLoginUrl(null);
+				setPhase("prompt-picker");
+			} catch (err) {
+				if (cancelled) return;
+				const message = err instanceof Error ? err.message : String(err);
+				logToFile(`[McpSuggestedPromptsScreen] login failed: ${message}`);
+				store.setLoginUrl(null);
+				setLoginError(message);
+				setPhase("choose");
+			}
+		})();
+		return () => {
+			cancelled = true;
+		};
+	}, [
+		phase,
+		services,
+		store
+	]);
+	useEffect(() => {
+		if (phase !== "running") return;
+		if (!runningPrompt) return;
+		if (!session.credentials) throw new Error("[McpSuggestedPromptsScreen] Running phase reached without credentials. The Choose gate should have prevented this.");
+		const controller = new AbortController();
+		runAbortRef.current = controller;
+		const startedAt = Date.now();
+		setRunStartedAt(startedAt);
+		setRunChunks([]);
+		(async () => {
+			const credentials = session.credentials;
+			if (!credentials) return;
+			try {
+				for await (const chunk of services.runPromptStreaming({
+					prompt: runningPrompt,
+					credentials,
+					signal: controller.signal
+				})) {
+					if (controller.signal.aborted) return;
+					setRunChunks((prev) => [...prev, chunk]);
+					if (chunk.kind === "done") {
+						analytics.wizardCapture("mcp suggested prompts run", {
+							prompt: runningPrompt,
+							durationMs: Date.now() - startedAt
+						});
+						return;
+					}
+					if (chunk.kind === "error") {
+						analytics.wizardCapture("mcp suggested prompts run failed", {
+							prompt: runningPrompt,
+							error: chunk.text
+						});
+						return;
+					}
+				}
+			} catch (err) {
+				if (controller.signal.aborted) return;
+				const text = err instanceof Error ? err.message : String(err);
+				setRunChunks((prev) => [...prev, {
+					kind: "error",
+					text
+				}]);
+				analytics.wizardCapture("mcp suggested prompts run failed", {
+					prompt: runningPrompt,
+					error: text
+				});
+			}
+		})();
+		return () => {
+			controller.abort();
+			if (runAbortRef.current === controller) runAbortRef.current = null;
+		};
+	}, [
+		phase,
+		runningPrompt,
+		services,
+		session.credentials
+	]);
+	const dismiss = () => {
+		setPhase("done");
+		setTimeout(() => {
+			store.setMcpSuggestedPromptsDismissed();
+		}, 0);
+	};
+	const handleChoice = (value) => {
+		const choice = Array.isArray(value) ? value[0] : value;
+		setLoginError(null);
+		if (choice === "login") {
+			analytics.wizardCapture("mcp suggested prompts choose", { choice: "login" });
+			setPhase("authenticating");
+		} else {
+			analytics.wizardCapture("mcp suggested prompts choose", { choice: "exit" });
+			dismiss();
+		}
+	};
+	const handlePromptPick = (value) => {
+		setRunningPrompt(Array.isArray(value) ? value[0] : value);
+		setRunCount((c) => c + 1);
+		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");
+		}
+	}]);
+	return /* @__PURE__ */ jsx(Box, {
+		flexDirection: "column",
+		flexGrow: 1,
+		children: /* @__PURE__ */ jsxs(Box, {
+			marginTop: 1,
+			flexDirection: "column",
+			children: [
+				phase === "choose" && /* @__PURE__ */ jsx(ChoosePhase, {
+					error: loginError,
+					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,
+					userDisplayName: session.apiUser?.first_name || null,
+					onSelect: handlePromptPick
+				})] }),
+				phase === "running" && runningPrompt && /* @__PURE__ */ jsx(RunningPhase, {
+					prompt: runningPrompt,
+					chunks: runChunks,
+					startedAt: runStartedAt,
+					canPickAnother,
+					runCount,
+					maxRuns: MAX_PROMPT_RUNS
+				})
+			]
+		})
+	});
+};
+const ChoosePhase = ({ error, onSelect }) => /* @__PURE__ */ jsxs(Box, {
+	flexDirection: "column",
+	children: [
+		/* @__PURE__ */ jsx(Text, {
+			bold: true,
+			color: Colors.accent,
+			children: "PostHog MCP"
+		}),
+		/* @__PURE__ */ jsx(Box, {
+			marginTop: 1,
+			children: /* @__PURE__ */ jsx(Text, { children: "With MCP your agent works directly with the PostHog platform. You can prompt it to:" })
+		}),
+		/* @__PURE__ */ jsxs(Box, {
+			marginTop: 1,
+			flexDirection: "column",
+			children: [
+				/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+					color: "cyan",
+					children: Icons.diamond
+				}), " Build dashboards"] }),
+				/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+					color: "cyan",
+					children: Icons.diamond
+				}), " Run SQL queries"] }),
+				/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+					color: "cyan",
+					children: Icons.diamond
+				}), " Deploy feature flags"] }),
+				/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+					color: "cyan",
+					children: Icons.diamond
+				}), " Debug exceptions and errors"] }),
+				/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+					color: "cyan",
+					children: Icons.diamond
+				}), " And lots more..."] })
+			]
+		}),
+		/* @__PURE__ */ jsx(Box, {
+			marginTop: 1,
+			children: /* @__PURE__ */ jsx(Text, { children: "Want a live demo using real data from your project?" })
+		}),
+		/* @__PURE__ */ jsx(Box, { children: /* @__PURE__ */ jsx(PickerMenu, {
+			options: [{
+				label: "Start MCP tutorial",
+				value: "login"
+			}, {
+				label: "Exit",
+				value: "exit"
+			}],
+			onSelect
+		}) }),
+		error && /* @__PURE__ */ jsx(Box, {
+			marginTop: 1,
+			children: /* @__PURE__ */ jsxs(Text, {
+				color: "red",
+				children: [
+					"Login failed: ",
+					error,
+					". Try again or exit."
+				]
+			})
+		})
+	]
+});
+const AuthenticatingPhase = ({ loginUrl }) => /* @__PURE__ */ jsxs(Box, {
+	flexDirection: "column",
+	children: [/* @__PURE__ */ jsx(LoadingBox, { message: "Waiting for authentication..." }), loginUrl && /* @__PURE__ */ jsx(Box, {
+		marginTop: 1,
+		marginBottom: 1,
+		flexDirection: "column",
+		children: /* @__PURE__ */ jsxs(Text, { children: [
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "If the browser didn't open, copy and paste:"
+			}),
+			"\n\n",
+			/* @__PURE__ */ jsx(Text, {
+				color: "cyan",
+				children: loginUrl
+			})
+		] })
+	})]
+});
+const PromptPickerPhase = ({ promptKit, userDisplayName, onSelect }) => {
+	const options = promptKit.map((p) => ({
+		label: p.prompt,
+		value: p.prompt
+	}));
+	return /* @__PURE__ */ jsx(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
+				}
+			],
+			mode: 0,
+			blockInterval: 350
+		})
+	});
+};
+const RunningPhase = ({ prompt, chunks, startedAt, canPickAnother, 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;
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [
+			/* @__PURE__ */ jsxs(Text, { children: [
+				/* @__PURE__ */ jsx(Text, {
+					bold: true,
+					children: "Prompt:"
+				}),
+				" ",
+				/* @__PURE__ */ jsx(Text, {
+					color: Colors.accent,
+					children: prompt
+				})
+			] }),
+			/* @__PURE__ */ jsxs(Box, {
+				marginTop: 1,
+				gap: 1,
+				children: [
+					!finished && /* @__PURE__ */ jsx(Spinner, {}),
+					/* @__PURE__ */ jsx(Text, {
+						bold: finished,
+						children: finished ? errorChunk ? `Failed after ${elapsed}s.` : `Done in ${elapsed}s.` : "Streaming from PostHog MCP"
+					}),
+					/* @__PURE__ */ jsxs(Text, {
+						dimColor: true,
+						children: [
+							"(",
+							runCount,
+							"/",
+							maxRuns,
+							" prompts)"
+						]
+					})
+				]
+			}),
+			/* @__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."
+					})
+				] })
+			})
+		]
+	});
+};
+/**
+* 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.
+*/
+function capTextChunks(chunks) {
+	const rows = process.stdout.rows ?? 24;
+	const maxMessageRows = Math.max(6, rows - 8);
+	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");
+	return [{
+		kind: "text",
+		text: `[${hidden} line${hidden === 1 ? "" : "s"} above — expand terminal to see more]\n\n${tail}`
+	}, ...errors];
+}
+const ChunkLine = ({ chunk }) => {
+	if (chunk.kind === "text") return /* @__PURE__ */ jsx(Text, { children: chunk.text });
+	if (chunk.kind === "tool-call") return /* @__PURE__ */ jsxs(Text, { children: [
+		"  ",
+		/* @__PURE__ */ jsxs(Text, {
+			color: "cyan",
+			children: ["↳ ", chunk.toolName]
+		}),
+		chunk.detail ? ` ${chunk.detail}` : ""
+	] });
+	if (chunk.kind === "tool-result") return /* @__PURE__ */ jsxs(Text, { children: [
+		"    ",
+		/* @__PURE__ */ jsx(Text, {
+			color: "green",
+			children: "✓"
+		}),
+		" ",
+		chunk.detail
+	] });
+	if (chunk.kind === "error") return /* @__PURE__ */ jsxs(Text, {
+		color: "red",
+		children: ["Error: ", chunk.text]
+	});
+	return null;
+};
+//#endregion
 //#region src/ui/tui/screens/audit/AuditChecksViewer/AreaHeaderRow.tsx
 /** Sub-header row inside the scrollable body — one per area group. */
 const AreaHeaderRow = ({ area, resolved, total }) => /* @__PURE__ */ jsxs(Box, {
@@ -3317,11 +3869,83 @@ const EventCaptureSlide = {
 	docsUrl: "https://posthog.com/docs/product-analytics/capture-events"
 };
 //#endregion
+//#region src/ui/tui/screens/audit/slides/writeReport.tsx
+const ReportVisual = () => /* @__PURE__ */ jsxs(VisualBox, { children: [
+	/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "posthog-audit-report.md"
+	}),
+	/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "  # "
+	}), /* @__PURE__ */ jsx(Text, { children: "Summary" })] }),
+	/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "  # "
+	}), /* @__PURE__ */ jsx(Text, { children: "Recommended actions" })] }),
+	/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "  # "
+	}), /* @__PURE__ */ jsx(Text, { children: "Full audit" })] })
+] });
+const WriteReportSlide = {
+	area: "Write report",
+	intro: [
+		"Now we write an audit report at ./posthog-audit-report.md. that summarizes our findings.",
+		"The report leads with a summary, then a prioritized list of fixes with file:line citations, then every check we ran grouped by area so nothing is hidden.",
+		"We will upload the report into a PostHog notebook in the next step."
+	],
+	visual: /* @__PURE__ */ jsx(ReportVisual, {}),
+	docsUrl: "https://posthog.com/docs/product-analytics/best-practices"
+};
+//#endregion
+//#region src/ui/tui/screens/audit/slides/uploadNotebook.tsx
+const NotebookVisual = () => /* @__PURE__ */ jsxs(VisualBox, { children: [
+	/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "posthog-audit-report.md"
+	}),
+	/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "  │"
+	}),
+	/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "  ▼ "
+	}), /* @__PURE__ */ jsx(Text, {
+		color: "cyan",
+		children: "PostHog notebook"
+	})] }),
+	/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "     # Summary"
+	}),
+	/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "     # Recommended actions"
+	}),
+	/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "     # Full audit"
+	})
+] });
+//#endregion
 //#region src/ui/tui/screens/audit/slides/index.ts
 const AUDIT_AREA_SLIDES = [
 	InstallationSlide,
 	IdentificationSlide,
-	EventCaptureSlide
+	EventCaptureSlide,
+	WriteReportSlide,
+	{
+		area: "Upload notebook",
+		intro: [
+			"Next we upload the report into a PostHog notebook so you can share it with your team as a URL.",
+			"Hang tight.",
+			"The markdown file on disk is still there for you to read locally."
+		],
+		visual: /* @__PURE__ */ jsx(NotebookVisual, {}),
+		docsUrl: "https://posthog.com/docs/notebooks"
+	}
 ];
 //#endregion
 //#region src/ui/tui/screens/audit-3000/slides/eventQuality.tsx
@@ -3494,6 +4118,6 @@ const AUDIT_3000_AREA_SLIDES = [
 	}
 ];
 //#endregion
-export { ProgressList as C, WizardStore as D, CardLayout as E, useKeyBindings as S, SplitView as T, ModalOverlay as _, IssueTable as a, useStdoutDimensions as b, ServiceHealthList as c, ContentSequencer as d, HNViewer as f, LogViewer as g, EventPlanViewer as h, McpScreen as i, TipsCard as l, ScreenContainer as m, AUDIT_AREA_SLIDES as n, SEVERITY_LABEL as o, TabContainer as p, AuditChecksViewer as r, SEVERITY_ORDER as s, AUDIT_3000_AREA_SLIDES as t, LearnCard as u, ConfirmationInput as v, LoadingBox as w, PickerMenu as x, GroupedPickerMenu as y };
+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-D3I6JzlG.js.map
+//# sourceMappingURL=slides-CL1mv_Kq.js.map