@runtypelabs/cli 1.9.4 → 2.0.0

package/dist/index.js

@@ -428,7 +428,7 @@ var require_builtin_tools_registry = __commonJS({
       {
         id: "firecrawl",
         name: "Firecrawl",
-        description: "Scrape and extract content from web pages. Supports markdown, HTML, screenshots, JSON extraction, and interactive actions.",
+        description: "Scrape and extract content from a URL as markdown. Provide a url and optional formats array.",
         category: exports.BuiltInToolCategory.WEB_SCRAPING,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
@@ -436,12 +436,12 @@ var require_builtin_tools_registry = __commonJS({
           properties: {
             url: {
               type: "string",
-              description: "URL of the webpage to scrape",
+              description: 'The full URL to scrape (e.g. "https://example.com/page")',
               minLength: 1
             },
             formats: {
               type: "array",
-              description: "Content formats to extract from the page",
+              description: 'Output formats (e.g. ["markdown"]). Options: markdown, html, rawHtml, screenshot, links',
               items: {
                 type: "string",
                 enum: ["markdown", "html", "rawHtml", "screenshot", "links"]
@@ -450,12 +450,12 @@ var require_builtin_tools_registry = __commonJS({
             },
             onlyMainContent: {
               type: "boolean",
-              description: "Extract only main content (removes navigation, footers, ads)",
+              description: "If true, strips navigation/footers/ads and returns only the main content",
               default: true
             },
             waitFor: {
               type: "number",
-              description: "Milliseconds to wait before extracting content (for dynamic pages)",
+              description: "Milliseconds to wait for dynamic content before scraping (0-30000)",
               minimum: 0,
               maximum: 3e4
             }
@@ -4545,8 +4545,8 @@ var CallbackServer = class {
   expectedState;
   constructor() {
     this.app = express();
-    this.codePromise = new Promise((resolve6, reject) => {
-      this.codeResolve = resolve6;
+    this.codePromise = new Promise((resolve7, reject) => {
+      this.codeResolve = resolve7;
       this.codeReject = reject;
     });
     this.app.get("/callback", (req, res) => {
@@ -5741,14 +5741,14 @@ async function promptConfirm(message, options) {
     output: process.stdout,
     terminal: true
   });
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     rl.question(chalk2.cyan(`${message} (${hint}): `), (answer) => {
       rl.close();
       const trimmed = answer.trim().toLowerCase();
       if (trimmed === "") {
-        resolve6(defaultYes);
+        resolve7(defaultYes);
       } else {
-        resolve6(trimmed === "y" || trimmed === "yes");
+        resolve7(trimmed === "y" || trimmed === "yes");
       }
     });
   });
@@ -5849,9 +5849,9 @@ var ApiClient = class {
     this.baseUrl = baseUrl || getApiUrl();
   }
   /** Prefix path with API version (e.g. /v1) so all requests hit versioned routes. */
-  path(path11) {
+  path(path13) {
     const version = getApiVersion();
-    const p = path11.startsWith("/") ? path11 : `/${path11}`;
+    const p = path13.startsWith("/") ? path13 : `/${path13}`;
     return p.startsWith(`/${version}/`) ? p : `/${version}${p}`;
   }
   headers(extra) {
@@ -5884,8 +5884,8 @@ var ApiClient = class {
     }
     return response.json();
   }
-  async get(path11, params) {
-    const url = new URL(this.path(path11), this.baseUrl);
+  async get(path13, params) {
+    const url = new URL(this.path(path13), this.baseUrl);
     if (params) {
       for (const [key, value] of Object.entries(params)) {
         if (value !== void 0 && value !== "") {
@@ -5898,32 +5898,32 @@ var ApiClient = class {
     });
     return this.handleResponse(response);
   }
-  async post(path11, body) {
-    const response = await fetch(new URL(this.path(path11), this.baseUrl).toString(), {
+  async post(path13, body) {
+    const response = await fetch(new URL(this.path(path13), this.baseUrl).toString(), {
       method: "POST",
       headers: this.headers(),
       body: body !== void 0 ? JSON.stringify(body) : void 0
     });
     return this.handleResponse(response);
   }
-  async put(path11, body) {
-    const response = await fetch(new URL(this.path(path11), this.baseUrl).toString(), {
+  async put(path13, body) {
+    const response = await fetch(new URL(this.path(path13), this.baseUrl).toString(), {
       method: "PUT",
       headers: this.headers(),
       body: body !== void 0 ? JSON.stringify(body) : void 0
     });
     return this.handleResponse(response);
   }
-  async patch(path11, body) {
-    const response = await fetch(new URL(this.path(path11), this.baseUrl).toString(), {
+  async patch(path13, body) {
+    const response = await fetch(new URL(this.path(path13), this.baseUrl).toString(), {
       method: "PATCH",
       headers: this.headers(),
       body: body !== void 0 ? JSON.stringify(body) : void 0
     });
     return this.handleResponse(response);
   }
-  async delete(path11) {
-    const response = await fetch(new URL(this.path(path11), this.baseUrl).toString(), {
+  async delete(path13) {
+    const response = await fetch(new URL(this.path(path13), this.baseUrl).toString(), {
       method: "DELETE",
       headers: this.headers()
     });
@@ -5937,8 +5937,8 @@ var ApiClient = class {
       throw new ApiError(response.status, message);
     }
   }
-  async stream(path11, body) {
-    const response = await fetch(new URL(this.path(path11), this.baseUrl).toString(), {
+  async stream(path13, body) {
+    const response = await fetch(new URL(this.path(path13), this.baseUrl).toString(), {
       method: "POST",
       headers: this.headers({ Accept: "text/event-stream" }),
       body: body !== void 0 ? JSON.stringify(body) : void 0
@@ -8588,8 +8588,8 @@ function useMarathonStream() {
   const reset = useCallback2(() => {
     setState(INITIAL_STATE);
   }, []);
-  const setSteering = useCallback2(() => {
-    setState((prev) => ({ ...prev, phase: "steering" }));
+  const setCheckpoint = useCallback2(() => {
+    setState((prev) => ({ ...prev, phase: "checkpoint" }));
   }, []);
   const markPendingStart = useCallback2(() => {
     setState((prev) => ({
@@ -8667,7 +8667,7 @@ function useMarathonStream() {
     state,
     callbacks,
     reset,
-    setSteering,
+    setCheckpoint,
     markPendingStart,
     startContextCompaction,
     finishContextCompaction,
@@ -8895,6 +8895,37 @@ function renderSegments(segments) {
     (seg, i) => /* @__PURE__ */ jsx8(Text8, { color: seg.color, bold: seg.bold, children: seg.text }, i)
   );
 }
+function buildMilestoneText(milestones, currentMilestone) {
+  if (milestones.length === 0) return "";
+  const currentIndex = currentMilestone ? currentMilestone === "complete" ? milestones.length : milestones.indexOf(currentMilestone) : 0;
+  return " " + milestones.map((name, i) => {
+    const isCompleted = currentIndex > i;
+    const isCurrent = currentIndex === i;
+    if (isCompleted) return `\u2713 ${name}`;
+    if (isCurrent) return `\u25CF ${name}`;
+    return `\u25CB ${name}`;
+  }).join(" \u2500\u2500 ");
+}
+function buildMilestoneSegments(milestones, currentMilestone) {
+  if (milestones.length === 0) return [];
+  const currentIndex = currentMilestone ? currentMilestone === "complete" ? milestones.length : milestones.indexOf(currentMilestone) : 0;
+  const segments = [{ text: " " }];
+  milestones.forEach((name, i) => {
+    const isCompleted = currentIndex > i;
+    const isCurrent = currentIndex === i;
+    if (isCompleted) {
+      segments.push({ text: `\u2713 ${name}`, color: theme9.textMuted });
+    } else if (isCurrent) {
+      segments.push({ text: `\u25CF ${name}`, color: theme9.accent, bold: true });
+    } else {
+      segments.push({ text: `\u25CB ${name}`, color: theme9.textSubtle });
+    }
+    if (i < milestones.length - 1) {
+      segments.push({ text: " \u2500\u2500 ", color: theme9.border });
+    }
+  });
+  return segments;
+}
 function SessionHeader({
   sessionName,
   sessionCount,
@@ -8911,13 +8942,17 @@ function SessionHeader({
   runnerLaps,
   onRunnerPositionChange,
   trackWidth,
-  previewUrl
+  previewUrl,
+  workflowMilestones,
+  currentMilestone
 }) {
   const showName = sessionName && sessionName !== `Marathon #${sessionCount}`;
   const separator = theme9.separator ?? " \xB7 ";
   const resolvedWidth = trackWidth ?? 40;
+  const hasMilestones = workflowMilestones && workflowMilestones.length > 0;
   let contentRowCount = 1;
   if (previewUrl) contentRowCount++;
+  if (hasMilestones) contentRowCount++;
   if (goal) contentRowCount++;
   const { topSegments, bottomSegments, innerWidth, borderSegments } = useRunnerTrack({
     width: resolvedWidth,
@@ -8956,6 +8991,11 @@ function SessionHeader({
       rowIdx++
     ));
   }
+  if (hasMilestones) {
+    const milestoneSegs = buildMilestoneSegments(workflowMilestones, currentMilestone);
+    const milestoneText = buildMilestoneText(workflowMilestones, currentMilestone);
+    rows.push(borderSegments(milestoneSegs, milestoneText.length, rowIdx++));
+  }
   if (goal) {
     const maxGoalLen = innerWidth - 1;
     const displayGoal = goalExpanded ? goal : goal.slice(0, maxGoalLen);
@@ -10170,7 +10210,7 @@ var FILES_SHORTCUTS = [
   { key: "\u2190/\u2192", desc: "Previous / next file" },
   { key: "c", desc: "Copy path / content" }
 ];
-var STEERING_COMMANDS = [
+var CHECKPOINT_COMMANDS = [
   { key: "/model", desc: "Change AI model" },
   { key: "/tools", desc: "Toggle local tools on/off" },
   { key: "/sandbox", desc: "Switch sandbox provider" },
@@ -10183,7 +10223,7 @@ var STEERING_COMMANDS = [
   { key: "/stop", desc: "Stop the marathon" },
   { key: "/help", desc: "Toggle this help dialog" }
 ];
-function buildLines(isSteering) {
+function buildLines(isCheckpoint) {
   const lines = [];
   const sections = [
     { title: "Navigation", items: NAVIGATION_SHORTCUTS },
@@ -10191,7 +10231,7 @@ function buildLines(isSteering) {
     { title: "Reasoning", items: REASONING_SHORTCUTS },
     { title: "Events", items: EVENTS_SHORTCUTS },
     { title: "Files", items: FILES_SHORTCUTS },
-    ...isSteering ? [{ title: "Steering Commands", items: STEERING_COMMANDS }] : []
+    ...isCheckpoint ? [{ title: "Checkpoint Commands", items: CHECKPOINT_COMMANDS }] : []
   ];
   for (let s = 0; s < sections.length; s++) {
     const section = sections[s];
@@ -10205,14 +10245,14 @@ function buildLines(isSteering) {
   }
   return lines;
 }
-function getHelpLineCount(isSteering) {
-  return buildLines(isSteering).length;
+function getHelpLineCount(isCheckpoint) {
+  return buildLines(isCheckpoint).length;
 }
-function HelpPanel({ width, height, isSteering, scrollOffset }) {
+function HelpPanel({ width, height, isCheckpoint, scrollOffset }) {
   const dialogWidth = Math.min(width - 4, 60);
-  const contentHeight = Math.min(height - 2, isSteering ? 38 : 28) - 8;
+  const contentHeight = Math.min(height - 2, isCheckpoint ? 38 : 28) - 8;
   const visibleRows = Math.max(1, contentHeight);
-  const allLines = useMemo7(() => buildLines(isSteering), [isSteering]);
+  const allLines = useMemo7(() => buildLines(isCheckpoint), [isCheckpoint]);
   const maxScroll = Math.max(0, allLines.length - visibleRows);
   const clampedOffset = Math.min(scrollOffset, maxScroll);
   const visibleLines = allLines.slice(clampedOffset, clampedOffset + visibleRows);
@@ -10220,7 +10260,7 @@ function HelpPanel({ width, height, isSteering, scrollOffset }) {
     Box17,
     {
       width: dialogWidth,
-      height: Math.min(height - 2, isSteering ? 38 : 28),
+      height: Math.min(height - 2, isCheckpoint ? 38 : 28),
       flexDirection: "column",
       borderStyle: "round",
       borderColor: theme21.accent,
@@ -10257,10 +10297,10 @@ function HelpPanel({ width, height, isSteering, scrollOffset }) {
           /* @__PURE__ */ jsx20(Text18, { color: theme21.muted, children: " or " }),
           /* @__PURE__ */ jsx20(Text18, { color: theme21.info, children: "?" }),
           /* @__PURE__ */ jsx20(Text18, { color: theme21.muted, children: " to close" }),
-          isSteering && /* @__PURE__ */ jsxs16(Fragment2, { children: [
+          isCheckpoint && /* @__PURE__ */ jsxs16(Fragment2, { children: [
             /* @__PURE__ */ jsx20(Text18, { color: theme21.muted, children: " (use " }),
             /* @__PURE__ */ jsx20(Text18, { color: theme21.info, children: "/help" }),
-            /* @__PURE__ */ jsx20(Text18, { color: theme21.muted, children: " during steering)" })
+            /* @__PURE__ */ jsx20(Text18, { color: theme21.muted, children: " during checkpoint)" })
           ] })
         ] })
       ]
@@ -10733,7 +10773,7 @@ function readSessionEventLog(stateFilePath2, sessionIndex) {
   return events;
 }
 
-// src/ink/marathon/SteeringPrompt.tsx
+// src/ink/marathon/CheckpointPrompt.tsx
 import { useState as useState21, useEffect as useEffect19, useRef as useRef7 } from "react";
 import { Box as Box22, Text as Text24 } from "ink";
 
@@ -10868,7 +10908,7 @@ function BlinkingTextInput({
   return /* @__PURE__ */ jsx21(Text19, { children: placeholder ? value.length > 0 ? renderedValue : renderedPlaceholder : renderedValue });
 }
 
-// src/ink/marathon/SteeringPrompt.tsx
+// src/ink/marathon/CheckpointPrompt.tsx
 import { theme as theme26 } from "@runtypelabs/ink-components";
 
 // src/ink/talk/ModelPicker.tsx
@@ -11052,7 +11092,7 @@ import TextInput3 from "ink-text-input";
 import { theme as theme23 } from "@runtypelabs/ink-components";
 
 // src/ink/marathon/types.ts
-var MARATHON_STEER_COMMANDS = [
+var MARATHON_CHECKPOINT_COMMANDS = [
   { name: "/model", description: "Change AI model", hasArgs: false },
   { name: "/tools", description: "Toggle local tools on/off", hasArgs: false },
   {
@@ -11086,9 +11126,9 @@ function CommandPicker({ onSelect, onCancel, initialFilter = "" }) {
     [contentWidth]
   );
   const filtered = useMemo9(() => {
-    if (!search.trim()) return MARATHON_STEER_COMMANDS;
+    if (!search.trim()) return MARATHON_CHECKPOINT_COMMANDS;
     const q = search.toLowerCase();
-    return MARATHON_STEER_COMMANDS.filter(
+    return MARATHON_CHECKPOINT_COMMANDS.filter(
       (cmd) => cmd.name.toLowerCase().includes(q) || cmd.description.toLowerCase().includes(q)
     );
   }, [search]);
@@ -11510,14 +11550,14 @@ function ReflectEditor({ onSubmit, onCancel, maxHeight = 10 }) {
   );
 }
 
-// src/ink/marathon/SteeringRecap.tsx
+// src/ink/marathon/CheckpointRecap.tsx
 import { Box as Box21, Text as Text23 } from "ink";
 import { theme as theme25 } from "@runtypelabs/ink-components";
 import { jsx as jsx26, jsxs as jsxs20 } from "react/jsx-runtime";
 function formatTokenCount2(value) {
   return value.toLocaleString("en-US");
 }
-function SteeringRecap({
+function CheckpointRecap({
   sessionNumber,
   toolCallsMade,
   tokensInput,
@@ -11553,13 +11593,13 @@ function SteeringRecap({
   );
 }
 
-// src/ink/marathon/steering-prompt-state.ts
-function shouldPauseSteeringTimer(state) {
+// src/ink/marathon/checkpoint-prompt-state.ts
+function shouldPauseCheckpointTimer(state) {
   return Boolean(
     state.isTerminal || state.timeout === 0 || state.isTyping || state.hasPendingChanges || state.showModelPicker || state.showReflectEditor || state.showCommandPicker || state.isReviewing
   );
 }
-function getSteeringCountdownText(state) {
+function getCheckpointCountdownText(state) {
   if (state.isTerminal) return "(complete)";
   if (state.timeout === 0) return "";
   if (state.isTyping) return "(typing)";
@@ -11568,9 +11608,9 @@ function getSteeringCountdownText(state) {
   return `(${state.remaining}s)`;
 }
 
-// src/ink/marathon/SteeringPrompt.tsx
+// src/ink/marathon/CheckpointPrompt.tsx
 import { jsx as jsx27, jsxs as jsxs21 } from "react/jsx-runtime";
-function SteeringPrompt({
+function CheckpointPrompt({
   onSubmit,
   onToggleHelp,
   onCopySession,
@@ -11637,7 +11677,7 @@ function SteeringPrompt({
     }
   };
   useEffect19(() => {
-    if (shouldPauseSteeringTimer({
+    if (shouldPauseCheckpointTimer({
       isTerminal,
       timeout,
       isTyping,
@@ -11760,7 +11800,7 @@ ${trimmed}` : trimmed);
   const handleCommandCancel = () => {
     setShowCommandPicker(false);
   };
-  const countdownText = getSteeringCountdownText({
+  const countdownText = getCheckpointCountdownText({
     isTerminal,
     timeout,
     isTyping,
@@ -11823,7 +11863,7 @@ ${trimmed}` : trimmed);
                 value,
                 onChange: handleChange,
                 onSubmit: handleSubmit,
-                placeholder: isTerminal ? "Send new instructions to continue marathon, or press enter to exit..." : "Steer next iteration..."
+                placeholder: isTerminal ? "Send new instructions to continue marathon, or press enter to exit..." : "Guide next iteration..."
               }
             ) }),
             countdownText && /* @__PURE__ */ jsxs21(Text24, { color: theme26.textSubtle, children: [
@@ -11840,7 +11880,7 @@ ${trimmed}` : trimmed);
         ]
       }
     ),
-    /* @__PURE__ */ jsx27(SteeringRecap, { ...recap, isTerminal })
+    /* @__PURE__ */ jsx27(CheckpointRecap, { ...recap, isTerminal })
   ] });
 }
 
@@ -12144,8 +12184,8 @@ function getSessionTabKeyForShortcut(visibleTabs, input) {
   return visibleTabs.find((tab) => tab.shortcut === slot)?.key;
 }
 
-// src/ink/marathon/steering-navigation.ts
-function isAllowedSteeringBrowseKey(key, isBrowsingScreen) {
+// src/ink/marathon/checkpoint-navigation.ts
+function isAllowedCheckpointBrowseKey(key, isBrowsingScreen) {
   return Boolean(
     key.upArrow || key.downArrow || key.return && isBrowsingScreen || key.input === "c" && isBrowsingScreen || key.leftArrow && isBrowsingScreen || key.rightArrow && isBrowsingScreen || key.tab || key.escape || key.shift && key.leftArrow || key.shift && key.rightArrow
   );
@@ -12160,7 +12200,7 @@ var STACKED_THRESHOLD = 80;
 var CHROME_ROWS_BASE = 9;
 var GOAL_ROW = 1;
 var SCROLL_STEP = 3;
-var STEERING_PROMPT_ROWS = 7;
+var CHECKPOINT_PROMPT_ROWS = 7;
 var SESSION_TABS_ROWS = 2;
 var SCREEN_TABS_ROWS = 2;
 function cloneSessionSnapshot(snapshot) {
@@ -12246,8 +12286,10 @@ function MarathonApp({
   stateFilePath: stateFilePath2,
   debug: _debug,
   plainText,
-  noSteer: _noSteer,
-  steeringTimeout,
+  noCheckpoint: _noCheckpoint,
+  checkpointTimeout,
+  workflowMilestones,
+  currentMilestone: initialCurrentMilestone,
   dashboardUrl,
   billingUrl,
   onSaveState,
@@ -12258,7 +12300,7 @@ function MarathonApp({
     state,
     callbacks,
     reset: _reset,
-    setSteering,
+    setCheckpoint,
     markPendingStart,
     startContextCompaction,
     finishContextCompaction,
@@ -12270,11 +12312,12 @@ function MarathonApp({
   const { exit } = useApp4();
   const { stdout } = useStdout5();
   const separator = theme30.separator ?? " \xB7 ";
-  const steeringResolveRef = useRef8(null);
-  const [steeringRecap, setSteeringRecap] = useState22(null);
+  const checkpointResolveRef = useRef8(null);
+  const [checkpointRecap, setCheckpointRecap] = useState22(null);
   const [currentModel, setCurrentModel] = useState22(model || "default");
   const [currentSandbox, setCurrentSandbox] = useState22(sandbox);
-  const [isTerminalSteering, setIsTerminalSteering] = useState22(false);
+  const [isTerminalCheckpoint, setIsTerminalCheckpoint] = useState22(false);
+  const [currentMilestone, setCurrentMilestone] = useState22(initialCurrentMilestone);
   const [allowInitialInlineLoader, setAllowInitialInlineLoader] = useState22(!suppressInitialInlineLoader);
   const [sessionSnapshots, setSessionSnapshots] = useState22(
     () => (initialSessionSnapshots || []).map((snapshot) => cloneSessionSnapshot(snapshot))
@@ -12284,35 +12327,35 @@ function MarathonApp({
   const [followLatest, setFollowLatest] = useState22(true);
   const [latestUnreadKey, setLatestUnreadKey] = useState22(void 0);
   const [previewUrl, setPreviewUrl] = useState22(initialPreviewUrl);
-  const [isSteeringExploring, setIsSteeringExploring] = useState22(false);
+  const [isCheckpointExploring, setIsCheckpointExploring] = useState22(false);
   const isRunnerAnimating = state.phase === "thinking" || state.phase === "streaming" || state.phase === "tool" || Boolean(state.contextCompaction?.active);
-  const isTerminalSteeringRef = useRef8(false);
-  const markSteeringExploring = useCallback8(() => {
-    if (state.phase === "steering" && steeringRecap) {
-      setIsSteeringExploring(true);
+  const isTerminalCheckpointRef = useRef8(false);
+  const markCheckpointExploring = useCallback8(() => {
+    if (state.phase === "checkpoint" && checkpointRecap) {
+      setIsCheckpointExploring(true);
     }
-  }, [state.phase, steeringRecap]);
-  const handleSteeringSubmit = useCallback8(
+  }, [state.phase, checkpointRecap]);
+  const handleCheckpointSubmit = useCallback8(
     (result) => {
-      setIsSteeringExploring(false);
+      setIsCheckpointExploring(false);
       if (result.model) {
         setCurrentModel(result.model);
       }
       if (result.sandbox !== void 0) {
         setCurrentSandbox(result.sandbox || void 0);
       }
-      if (isTerminalSteeringRef.current) {
-        if (steeringResolveRef.current) {
-          steeringResolveRef.current(result);
-          steeringResolveRef.current = null;
+      if (isTerminalCheckpointRef.current) {
+        if (checkpointResolveRef.current) {
+          checkpointResolveRef.current(result);
+          checkpointResolveRef.current = null;
         }
       } else {
         resetForNewSession();
-        setIsTerminalSteering(false);
-        isTerminalSteeringRef.current = false;
-        if (steeringResolveRef.current) {
-          steeringResolveRef.current(result);
-          steeringResolveRef.current = null;
+        setIsTerminalCheckpoint(false);
+        isTerminalCheckpointRef.current = false;
+        if (checkpointResolveRef.current) {
+          checkpointResolveRef.current(result);
+          checkpointResolveRef.current = null;
         }
       }
     },
@@ -12342,18 +12385,21 @@ function MarathonApp({
         setFollowLatest(true);
         setLatestUnreadKey(void 0);
       },
-      requestSteering: async (recap, isTerminal) => {
-        setSteering();
-        setSteeringRecap(recap);
-        setIsSteeringExploring(false);
+      requestCheckpoint: async (recap, isTerminal) => {
+        setCheckpoint();
+        setCheckpointRecap(recap);
+        setIsCheckpointExploring(false);
         if (isTerminal) {
-          setIsTerminalSteering(true);
-          isTerminalSteeringRef.current = true;
+          setIsTerminalCheckpoint(true);
+          isTerminalCheckpointRef.current = true;
         }
-        return new Promise((resolve6) => {
-          steeringResolveRef.current = resolve6;
+        return new Promise((resolve7) => {
+          checkpointResolveRef.current = resolve7;
         });
       },
+      updateMilestone: (milestone) => {
+        setCurrentMilestone(milestone);
+      },
       startContextCompaction,
       finishContextCompaction,
       reportContextNotice,
@@ -12370,9 +12416,9 @@ function MarathonApp({
     latestCompletedSessionIndex,
     markPendingStart,
     reportContextNotice,
-    setIsSteeringExploring,
+    setIsCheckpointExploring,
     setEventWriter,
-    setSteering,
+    setCheckpoint,
     showError,
     startContextCompaction,
     state,
@@ -12381,7 +12427,8 @@ function MarathonApp({
   ]);
   const terminalWidth = stdout?.columns ?? 120;
   const terminalRows = stdout?.rows ?? 40;
-  const chromeRows = CHROME_ROWS_BASE + (goal ? GOAL_ROW : 0);
+  const milestoneRow = workflowMilestones && workflowMilestones.length > 0 ? 1 : 0;
+  const chromeRows = CHROME_ROWS_BASE + (goal ? GOAL_ROW : 0) + milestoneRow;
   const contentHeight = Math.max(5, terminalRows - chromeRows);
   const isStacked = terminalWidth < STACKED_THRESHOLD;
   const toolPanelWidth = terminalWidth < NARROW_THRESHOLD ? TOOL_PANEL_NARROW : TOOL_PANEL_WIDE;
@@ -12470,7 +12517,7 @@ function MarathonApp({
       void open4(agentPageUrl);
     }
   }, [agentPageUrl]);
-  const shouldShowLiveTab = Boolean(state.contextCompaction?.active) || state.phase !== "idle" && state.phase !== "steering" && state.phase !== "complete" && (Boolean(state.content) || Boolean(state.reasoning) || state.tools.length > 0 || state.rawEvents.length > 0 || state.phase === "thinking" || state.phase === "error");
+  const shouldShowLiveTab = Boolean(state.contextCompaction?.active) || state.phase !== "idle" && state.phase !== "checkpoint" && state.phase !== "complete" && (Boolean(state.content) || Boolean(state.reasoning) || state.tools.length > 0 || state.rawEvents.length > 0 || state.phase === "thinking" || state.phase === "error");
   const liveSessionSnapshot = useMemo11(
     () => shouldShowLiveTab ? buildLiveSessionSnapshot(state, latestCompletedSessionIndex + 1, currentModel) : void 0,
     [currentModel, latestCompletedSessionIndex, shouldShowLiveTab, state]
@@ -12641,7 +12688,7 @@ function MarathonApp({
       setUpgradeModalDismissed(true);
       return;
     }
-    if (_input === "o" && agentPageUrl && !(state.phase === "steering" && steeringRecap)) {
+    if (_input === "o" && agentPageUrl && !(state.phase === "checkpoint" && checkpointRecap)) {
       void open4(agentPageUrl);
       return;
     }
@@ -12689,19 +12736,19 @@ function MarathonApp({
         setShowHelpOverlay(false);
         setHelpScrollOffset(0);
       } else if (key.downArrow) {
-        const isSteering = state.phase === "steering" && !!steeringRecap;
-        const maxScroll = Math.max(0, getHelpLineCount(isSteering) - 1);
+        const isAtCheckpoint = state.phase === "checkpoint" && !!checkpointRecap;
+        const maxScroll = Math.max(0, getHelpLineCount(isAtCheckpoint) - 1);
         setHelpScrollOffset((prev) => Math.min(prev + SCROLL_STEP, maxScroll));
       } else if (key.upArrow) {
         setHelpScrollOffset((prev) => Math.max(0, prev - SCROLL_STEP));
       }
       return;
     }
-    if (_input === "?" && !(state.phase === "steering" && steeringRecap)) {
+    if (_input === "?" && !(state.phase === "checkpoint" && checkpointRecap)) {
       setShowHelpOverlay(true);
       return;
     }
-    if (_input === "s" && !(state.phase === "steering" && steeringRecap)) {
+    if (_input === "s" && !(state.phase === "checkpoint" && checkpointRecap)) {
       setShowSessionMenu(true);
       return;
     }
@@ -12718,16 +12765,16 @@ function MarathonApp({
         return;
       }
     }
-    if (state.phase === "steering" && steeringRecap) {
-      if (!isAllowedSteeringBrowseKey({ ...key, input: _input }, showFilesPanel || showEventStream || showToolsPanel)) return;
+    if (state.phase === "checkpoint" && checkpointRecap) {
+      if (!isAllowedCheckpointBrowseKey({ ...key, input: _input }, showFilesPanel || showEventStream || showToolsPanel)) return;
     }
     if (key.shift && key.leftArrow) {
-      markSteeringExploring();
+      markCheckpointExploring();
       selectSessionTab(getAdjacentSessionTabKey(allTabs, selectedSessionKey, -1));
       return;
     }
     if (key.shift && key.rightArrow) {
-      markSteeringExploring();
+      markCheckpointExploring();
       selectSessionTab(getAdjacentSessionTabKey(allTabs, selectedSessionKey, 1));
       return;
     }
@@ -12741,7 +12788,7 @@ function MarathonApp({
       return;
     }
     if (key.tab) {
-      markSteeringExploring();
+      markCheckpointExploring();
       if (showFilesPanel) {
         setDetailFile(null);
         setDetailFileContent(null);
@@ -12769,8 +12816,8 @@ function MarathonApp({
       return;
     }
     if (key.escape) {
-      if (state.phase === "steering" && steeringRecap) {
-        markSteeringExploring();
+      if (state.phase === "checkpoint" && checkpointRecap) {
+        markCheckpointExploring();
       }
       if (detailFile) {
         setDetailFile(null);
@@ -12881,8 +12928,8 @@ function MarathonApp({
       return;
     }
     if (key.upArrow) {
-      if (state.phase === "steering" && steeringRecap) {
-        markSteeringExploring();
+      if (state.phase === "checkpoint" && checkpointRecap) {
+        markCheckpointExploring();
       }
       if (showReasoningPanel) {
         setReasoningScrollOffset((prev) => Math.max(0, prev - SCROLL_STEP));
@@ -12900,15 +12947,15 @@ function MarathonApp({
         setEventCursor((prev) => Math.max(0, prev - 1));
       } else {
         const contentLines = displayedContent.split("\n").length * 2;
-        const visibleRows = state.phase === "steering" && steeringRecap ? adjustedContentHeight - steeringPromptRows : transcriptRows;
+        const visibleRows = state.phase === "checkpoint" && checkpointRecap ? adjustedContentHeight - checkpointPromptRows : transcriptRows;
         const maxOverviewScroll = Math.max(0, contentLines - visibleRows);
         setScrollOffset((prev) => Math.min(prev + SCROLL_STEP, maxOverviewScroll));
       }
       return;
     }
     if (key.downArrow) {
-      if (state.phase === "steering" && steeringRecap) {
-        markSteeringExploring();
+      if (state.phase === "checkpoint" && checkpointRecap) {
+        markCheckpointExploring();
       }
       if (showReasoningPanel) {
         const totalReasoningLines = getReasoningLines(displayedReasoning, terminalWidth).length;
@@ -13049,7 +13096,7 @@ function MarathonApp({
     if (clipboardFlash) return clipboardFlash;
     if (showUpgradeModal) return joinHints("u: upgrade", "Enter: upgrade", "Esc: close", "Ctrl+C");
     if (state.phase === "error" && !canBrowseAfterUpgradeError) return joinHints("Enter: exit", "Ctrl+C");
-    if (state.phase === "steering" && steeringRecap) {
+    if (state.phase === "checkpoint" && checkpointRecap) {
       return joinHints(
         "\u2191\u2193: scroll",
         activeScreen !== "overview" ? "Esc: overview" : void 0,
@@ -13121,8 +13168,8 @@ function MarathonApp({
   const goalText = goal || "";
   const goalExpandedRows = goalExpanded && goalText.length > terminalWidth - 4 ? Math.ceil(goalText.length / (terminalWidth - 4)) - 1 : 0;
   const adjustedContentHeight = contentHeight - goalExpandedRows - SCREEN_TABS_ROWS - (hasTabs ? SESSION_TABS_ROWS : 0);
-  const steeringWarningRows = steeringRecap?.historyWarning ? Math.max(1, Math.ceil(steeringRecap.historyWarning.length / Math.max(10, terminalWidth - 6))) : 0;
-  const steeringPromptRows = STEERING_PROMPT_ROWS + steeringWarningRows;
+  const checkpointWarningRows = checkpointRecap?.historyWarning ? Math.max(1, Math.ceil(checkpointRecap.historyWarning.length / Math.max(10, terminalWidth - 6))) : 0;
+  const checkpointPromptRows = CHECKPOINT_PROMPT_ROWS + checkpointWarningRows;
   const reasoningHintRows = hasReasoning ? 1 : 0;
   const thinkingRows = showThinkingIndicator ? 2 : 0;
   const compactionIndicatorRows = showContextCompactionIndicator ? 1 : 0;
@@ -13165,7 +13212,9 @@ function MarathonApp({
             showRunner,
             showFinish,
             trackWidth: terminalWidth,
-            previewUrl
+            previewUrl,
+            workflowMilestones,
+            currentMilestone
           }
         ),
         /* @__PURE__ */ jsx31(Box26, { marginLeft: 1, children: /* @__PURE__ */ jsx31(ScreenTabs, { activeTab: activeScreen, width: terminalWidth - 1, shortcutHint: "Tab: next screen" }) }),
@@ -13255,7 +13304,7 @@ function MarathonApp({
               }
             )
           }
-        ) : state.phase === "steering" && steeringRecap ? /* @__PURE__ */ jsxs25(
+        ) : state.phase === "checkpoint" && checkpointRecap ? /* @__PURE__ */ jsxs25(
           Box26,
           {
             flexDirection: isStacked ? "column" : "row",
@@ -13277,38 +13326,38 @@ function MarathonApp({
                           content: displayedContent,
                           isStreaming: false,
                           enableMarkdown: !plainText,
-                          maxVisibleLines: adjustedContentHeight - steeringPromptRows - 1,
+                          maxVisibleLines: adjustedContentHeight - checkpointPromptRows - 1,
                           scrollOffset
                         }
                       ) }),
                       (() => {
-                        const steeringVisibleRows = adjustedContentHeight - steeringPromptRows - 1;
-                        const steeringTotalLines = displayedContent.split("\n").length;
-                        const steeringMaxScroll = Math.max(0, steeringTotalLines - steeringVisibleRows);
+                        const checkpointVisibleRows = adjustedContentHeight - checkpointPromptRows - 1;
+                        const checkpointTotalLines = displayedContent.split("\n").length;
+                        const checkpointMaxScroll = Math.max(0, checkpointTotalLines - checkpointVisibleRows);
                         return /* @__PURE__ */ jsx31(
                           Scrollbar,
                           {
-                            totalLines: steeringTotalLines,
-                            visibleLines: steeringVisibleRows,
-                            scrollOffset: steeringMaxScroll - Math.min(scrollOffset, steeringMaxScroll),
-                            height: steeringVisibleRows
+                            totalLines: checkpointTotalLines,
+                            visibleLines: checkpointVisibleRows,
+                            scrollOffset: checkpointMaxScroll - Math.min(scrollOffset, checkpointMaxScroll),
+                            height: checkpointVisibleRows
                           }
                         );
                       })()
                     ] }),
                     /* @__PURE__ */ jsx31(
-                      SteeringPrompt,
+                      CheckpointPrompt,
                       {
-                        onSubmit: handleSteeringSubmit,
+                        onSubmit: handleCheckpointSubmit,
                         onToggleHelp: () => setShowHelpOverlay((prev) => !prev),
                         onCopySession: handleCopySession,
                         onOpenStateFile: handleOpenStateFile,
-                        timeout: steeringTimeout ?? 10,
-                        isTerminal: isTerminalSteering,
+                        timeout: checkpointTimeout ?? 10,
+                        isTerminal: isTerminalCheckpoint,
                         currentModel,
                         currentSandbox,
-                        recap: steeringRecap,
-                        isReviewing: isSteeringExploring
+                        recap: checkpointRecap,
+                        isReviewing: isCheckpointExploring
                       }
                     )
                   ]
@@ -13458,7 +13507,7 @@ function MarathonApp({
               {
                 width: terminalWidth,
                 height: adjustedContentHeight,
-                isSteering: state.phase === "steering" && !!steeringRecap,
+                isCheckpoint: state.phase === "checkpoint" && !!checkpointRecap,
                 scrollOffset: helpScrollOffset
               }
             )
@@ -13545,11 +13594,13 @@ function MarathonApp({
 import { useEffect as useEffect21, useRef as useRef9, useState as useState23 } from "react";
 import { Box as Box27, Text as Text29, useApp as useApp5, useInput as useInput12, useStdout as useStdout6 } from "ink";
 import { theme as theme31 } from "@runtypelabs/ink-components";
+import { AnimatedVariant, StartupGridIconCompactLightInverted } from "@runtypelabs/terminal-animations";
 import { jsx as jsx32, jsxs as jsxs26 } from "react/jsx-runtime";
 var SCROLL_HINT = "\u2191\u2193 Enter 1-3";
 var PROMPT_COLUMN_MAX = 68;
 var MIN_HOLD_MS = 1500;
 var FADE_DURATION_MS = 260;
+var STARTUP_BACKGROUND_VARIANTS = ["vector3d-ghost-wave", "vector3d-ghost-box-drift"];
 function shortenPath2(filePath, maxLength) {
   if (filePath.length <= maxLength) return filePath;
   const normalizedSegments = filePath.split("/").filter(Boolean);
@@ -13599,6 +13650,7 @@ function MarathonStartupShell({
   const mountedAtRef = useRef9(Date.now());
   const promptResolverRef = useRef9(null);
   const modelResolverRef = useRef9(null);
+  const playbookConfirmResolverRef = useRef9(null);
   const appReadyResolverRef = useRef9(null);
   const dismissResolverRef = useRef9(null);
   const transitionPromiseRef = useRef9(null);
@@ -13609,20 +13661,24 @@ function MarathonStartupShell({
   const [prompt, setPrompt] = useState23(null);
   const [modelChoices, setModelChoices] = useState23(null);
   const [currentModel, setCurrentModel] = useState23("default");
+  const [playbookConfirm, setPlaybookConfirm] = useState23(null);
   const [selectedPromptIndex, setSelectedPromptIndex] = useState23(0);
+  const [backgroundVariantId] = useState23(
+    () => STARTUP_BACKGROUND_VARIANTS[Math.floor(Math.random() * STARTUP_BACKGROUND_VARIANTS.length)]
+  );
   latestAppPropsRef.current = marathonAppProps;
   useEffect21(() => {
     if (scene !== "app" || !appReadyResolverRef.current) return;
-    const resolve6 = appReadyResolverRef.current;
+    const resolve7 = appReadyResolverRef.current;
     appReadyResolverRef.current = null;
-    resolve6();
+    resolve7();
   }, [scene]);
   const beginTransition = (target) => {
     if (transitionPromiseRef.current) return transitionPromiseRef.current;
     if (target === "app" && !latestAppPropsRef.current) {
       throw new Error("Cannot complete startup before marathon app props are ready.");
     }
-    const promise = new Promise((resolve6) => {
+    const promise = new Promise((resolve7) => {
       globalThis.setTimeout(() => {
         setPrompt(null);
         setModelChoices(null);
@@ -13643,12 +13699,12 @@ function MarathonStartupShell({
         if (target === "app") {
           appReadyResolverRef.current = () => {
             transitionPromiseRef.current = null;
-            resolve6();
+            resolve7();
           };
         } else {
           dismissResolverRef.current = () => {
             transitionPromiseRef.current = null;
-            resolve6();
+            resolve7();
           };
         }
       }, Math.max(0, MIN_HOLD_MS - (Date.now() - mountedAtRef.current)));
@@ -13665,16 +13721,33 @@ function MarathonStartupShell({
         setModelChoices(null);
         setPrompt(nextPrompt);
         setSelectedPromptIndex(0);
-        return new Promise((resolve6) => {
-          promptResolverRef.current = resolve6;
+        return new Promise((resolve7) => {
+          promptResolverRef.current = resolve7;
         });
       },
       requestModelChoice: async (nextCurrentModel, models) => {
         setPrompt(null);
+        setPlaybookConfirm(null);
         setCurrentModel(nextCurrentModel);
         setModelChoices(models);
-        return new Promise((resolve6) => {
-          modelResolverRef.current = resolve6;
+        return new Promise((resolve7) => {
+          modelResolverRef.current = resolve7;
+        });
+      },
+      requestPlaybookModelConfirm: async (playbookName, milestoneModels) => {
+        setPrompt(null);
+        setModelChoices(null);
+        const names = Object.keys(milestoneModels);
+        setPlaybookConfirm({
+          name: playbookName,
+          milestoneModels: { ...milestoneModels },
+          originalModels: { ...milestoneModels },
+          milestoneNames: names,
+          // Default selection is the "Confirm" action (first item after milestones)
+          selectedIndex: names.length
+        });
+        return new Promise((resolve7) => {
+          playbookConfirmResolverRef.current = resolve7;
         });
       },
       completeStartup: () => beginTransition("app"),
@@ -13690,7 +13763,7 @@ function MarathonStartupShell({
         process.kill(process.pid, "SIGINT");
         return;
       }
-      if (!prompt || transition || modelChoices) return;
+      if (!prompt || transition || modelChoices || playbookConfirm) return;
       if (key.upArrow || input === "k") {
         setSelectedPromptIndex((current) => (current - 1 + prompt.choices.length) % prompt.choices.length);
         return;
@@ -13719,97 +13792,253 @@ function MarathonStartupShell({
         }
       }
     },
-    { isActive: scene !== "app" }
+    { isActive: scene !== "app" && !playbookConfirm && !modelChoices }
+  );
+  useInput12(
+    (input, key) => {
+      if (key.ctrl && input === "c") {
+        process.kill(process.pid, "SIGINT");
+        return;
+      }
+      if (!playbookConfirm) return;
+      const hasEdits = JSON.stringify(playbookConfirm.milestoneModels) !== JSON.stringify(playbookConfirm.originalModels);
+      const actionCount = hasEdits ? 3 : 2;
+      const totalItems = playbookConfirm.milestoneNames.length + actionCount;
+      if (key.upArrow || input === "k") {
+        setPlaybookConfirm((prev) => prev ? {
+          ...prev,
+          selectedIndex: (prev.selectedIndex - 1 + totalItems) % totalItems
+        } : null);
+        return;
+      }
+      if (key.downArrow || input === "j") {
+        setPlaybookConfirm((prev) => prev ? {
+          ...prev,
+          selectedIndex: (prev.selectedIndex + 1) % totalItems
+        } : null);
+        return;
+      }
+      if (key.return) {
+        const idx = playbookConfirm.selectedIndex;
+        const milestoneCount = playbookConfirm.milestoneNames.length;
+        if (idx < milestoneCount) {
+          const milestone = playbookConfirm.milestoneNames[idx];
+          playbookConfirmResolverRef.current?.({
+            action: "edit",
+            milestoneModels: playbookConfirm.milestoneModels,
+            editMilestone: milestone
+          });
+          playbookConfirmResolverRef.current = null;
+          setPlaybookConfirm(null);
+        } else {
+          const actionIndex = idx - milestoneCount;
+          if (actionIndex === 0) {
+            playbookConfirmResolverRef.current?.({
+              action: "confirm",
+              milestoneModels: playbookConfirm.milestoneModels
+            });
+            playbookConfirmResolverRef.current = null;
+            setPlaybookConfirm(null);
+          } else if (actionIndex === 1) {
+            playbookConfirmResolverRef.current?.({ action: "override" });
+            playbookConfirmResolverRef.current = null;
+            setPlaybookConfirm(null);
+          } else if (actionIndex === 2 && hasEdits) {
+            setPlaybookConfirm((prev) => prev ? {
+              ...prev,
+              milestoneModels: { ...prev.originalModels },
+              selectedIndex: prev.milestoneNames.length
+              // back to Confirm
+            } : null);
+          }
+        }
+      }
+    },
+    { isActive: scene !== "app" && !!playbookConfirm }
   );
   const terminalWidth = stdout?.columns ?? 120;
   const terminalRows = stdout?.rows ?? 40;
   const promptColumnWidth = Math.max(44, Math.min(PROMPT_COLUMN_MAX, terminalWidth - 14));
   const promptShellModel = prompt ? buildPromptShellModel(prompt, promptColumnWidth) : null;
   const selectedChoice = prompt?.choices[selectedPromptIndex];
+  const contentWidth = prompt || modelChoices || playbookConfirm ? promptColumnWidth : void 0;
   if (scene === "app" && marathonAppProps) {
     return /* @__PURE__ */ jsx32(MarathonApp, { ...marathonAppProps });
   }
-  return /* @__PURE__ */ jsx32(
-    Box27,
-    {
-      width: terminalWidth,
-      height: terminalRows,
-      backgroundColor: theme31.background,
-      flexDirection: "column",
-      justifyContent: "center",
-      alignItems: "center",
-      children: /* @__PURE__ */ jsxs26(Box27, { flexDirection: "column", alignItems: "center", children: [
-        !prompt && !modelChoices && /* @__PURE__ */ jsx32(Box27, { width: terminalWidth, justifyContent: "center", children: /* @__PURE__ */ jsx32(Text29, { color: theme31.textMuted, children: statusMessage }) }),
-        modelChoices && /* @__PURE__ */ jsx32(Box27, { width: promptColumnWidth, flexDirection: "column", marginTop: 1, children: /* @__PURE__ */ jsx32(
-          ModelPicker,
+  return /* @__PURE__ */ jsxs26(Box27, { width: terminalWidth, height: terminalRows, backgroundColor: theme31.background, children: [
+    /* @__PURE__ */ jsx32(
+      Box27,
+      {
+        position: "absolute",
+        width: terminalWidth,
+        height: terminalRows,
+        overflow: "hidden",
+        children: /* @__PURE__ */ jsx32(
+          AnimatedVariant,
           {
-            currentModel,
-            models: modelChoices,
-            onSelect: (model) => {
-              modelResolverRef.current?.(model);
-              modelResolverRef.current = null;
-              setCurrentModel(model);
-              setModelChoices(null);
-            },
-            onCancel: () => {
-              modelResolverRef.current?.(currentModel);
-              modelResolverRef.current = null;
-              setModelChoices(null);
-            }
+            variantId: backgroundVariantId,
+            width: terminalWidth,
+            height: terminalRows
           }
-        ) }),
-        prompt && /* @__PURE__ */ jsxs26(Box27, { width: promptColumnWidth, flexDirection: "column", marginTop: 1, children: [
-          /* @__PURE__ */ jsx32(Text29, { bold: true, color: theme31.text, children: promptShellModel?.heading }),
-          promptShellModel?.task && /* @__PURE__ */ jsxs26(Box27, { marginTop: 1, children: [
-            /* @__PURE__ */ jsx32(Text29, { color: theme31.textSubtle, children: "task " }),
-            /* @__PURE__ */ jsx32(Text29, { color: theme31.text, children: promptShellModel.task })
-          ] }),
-          promptShellModel?.filePath && /* @__PURE__ */ jsxs26(Box27, { children: [
-            /* @__PURE__ */ jsx32(Text29, { color: theme31.textSubtle, children: "state " }),
-            /* @__PURE__ */ jsx32(Text29, { color: theme31.textSubtle, children: promptShellModel.filePath })
-          ] }),
-          promptShellModel?.metaLine && /* @__PURE__ */ jsx32(Box27, { marginTop: 1, children: /* @__PURE__ */ jsx32(Text29, { color: theme31.textSubtle, children: promptShellModel.metaLine }) }),
-          /* @__PURE__ */ jsx32(Box27, { marginTop: 1, children: /* @__PURE__ */ jsx32(Text29, { color: theme31.textSubtle, children: prompt.hint }) }),
-          /* @__PURE__ */ jsx32(Box27, { flexDirection: "column", marginTop: 1, children: prompt.choices.map((choice, index) => {
-            const isSelected = index === selectedPromptIndex;
-            return /* @__PURE__ */ jsxs26(Box27, { marginTop: index === 0 ? 0 : 1, children: [
-              /* @__PURE__ */ jsx32(Text29, { color: isSelected ? theme31.accent : theme31.textSubtle, bold: isSelected, children: isSelected ? "\u203A " : "  " }),
-              /* @__PURE__ */ jsx32(Text29, { color: isSelected ? theme31.text : theme31.textSubtle, bold: isSelected, children: `${index + 1} ${choice.label}` })
-            ] }, choice.value);
-          }) }),
-          selectedChoice && /* @__PURE__ */ jsx32(Box27, { marginTop: 1, children: /* @__PURE__ */ jsx32(Text29, { color: theme31.textSubtle, children: selectedChoice.description }) }),
-          /* @__PURE__ */ jsx32(Box27, { marginTop: 1, children: /* @__PURE__ */ jsx32(Text29, { color: theme31.border, children: SCROLL_HINT }) })
-        ] })
-      ] })
-    }
-  );
+        )
+      }
+    ),
+    /* @__PURE__ */ jsx32(
+      Box27,
+      {
+        position: "absolute",
+        width: terminalWidth,
+        height: terminalRows,
+        alignItems: "flex-start",
+        justifyContent: "flex-start",
+        paddingX: 1,
+        paddingY: 1,
+        children: /* @__PURE__ */ jsx32(StartupGridIconCompactLightInverted, { autoplay: false })
+      }
+    ),
+    /* @__PURE__ */ jsx32(
+      Box27,
+      {
+        width: terminalWidth,
+        height: terminalRows,
+        flexDirection: "column",
+        justifyContent: "center",
+        alignItems: "center",
+        children: /* @__PURE__ */ jsxs26(
+          Box27,
+          {
+            flexDirection: "column",
+            alignItems: prompt || modelChoices || playbookConfirm ? "stretch" : "center",
+            backgroundColor: theme31.background,
+            paddingX: 2,
+            paddingY: 1,
+            children: [
+              !prompt && !modelChoices && !playbookConfirm && /* @__PURE__ */ jsx32(Text29, { color: theme31.textMuted, children: statusMessage }),
+              playbookConfirm && !modelChoices && (() => {
+                const milestoneCount = playbookConfirm.milestoneNames.length;
+                const hasEdits = JSON.stringify(playbookConfirm.milestoneModels) !== JSON.stringify(playbookConfirm.originalModels);
+                const actions = [
+                  "Confirm",
+                  "Use single model instead",
+                  ...hasEdits ? ["Discard changes"] : []
+                ];
+                return /* @__PURE__ */ jsxs26(Box27, { width: contentWidth, flexDirection: "column", marginTop: 1, children: [
+                  /* @__PURE__ */ jsxs26(Text29, { bold: true, color: theme31.text, children: [
+                    "Playbook: ",
+                    playbookConfirm.name
+                  ] }),
+                  /* @__PURE__ */ jsx32(Box27, { marginTop: 1, flexDirection: "column", children: playbookConfirm.milestoneNames.map((milestone, i) => {
+                    const isSelected = i === playbookConfirm.selectedIndex;
+                    const model = playbookConfirm.milestoneModels[milestone];
+                    const wasEdited = model !== playbookConfirm.originalModels[milestone];
+                    return /* @__PURE__ */ jsxs26(Box27, { children: [
+                      /* @__PURE__ */ jsx32(Text29, { color: isSelected ? theme31.accent : theme31.textSubtle, children: isSelected ? "\u203A " : "  " }),
+                      /* @__PURE__ */ jsx32(Text29, { color: isSelected ? theme31.text : theme31.textSubtle, bold: isSelected, children: milestone.padEnd(16) }),
+                      /* @__PURE__ */ jsx32(Text29, { color: isSelected ? theme31.accent : theme31.textMuted, children: model }),
+                      wasEdited && /* @__PURE__ */ jsx32(Text29, { color: theme31.textSubtle, children: " (edited)" })
+                    ] }, milestone);
+                  }) }),
+                  /* @__PURE__ */ jsx32(Box27, { marginTop: 1, flexDirection: "column", children: actions.map((label, ai) => {
+                    const isSelected = playbookConfirm.selectedIndex === milestoneCount + ai;
+                    return /* @__PURE__ */ jsxs26(Box27, { children: [
+                      /* @__PURE__ */ jsx32(Text29, { color: isSelected ? theme31.accent : theme31.textSubtle, children: isSelected ? "\u203A " : "  " }),
+                      /* @__PURE__ */ jsx32(Text29, { color: isSelected ? theme31.text : theme31.textSubtle, bold: isSelected, children: label })
+                    ] }, label);
+                  }) }),
+                  /* @__PURE__ */ jsx32(Box27, { marginTop: 1, children: /* @__PURE__ */ jsx32(Text29, { color: theme31.border, children: "\u2191\u2193 navigate \xB7 Enter select" }) })
+                ] });
+              })(),
+              modelChoices && /* @__PURE__ */ jsx32(Box27, { width: contentWidth, flexDirection: "column", marginTop: 1, children: /* @__PURE__ */ jsx32(
+                ModelPicker,
+                {
+                  currentModel,
+                  models: modelChoices,
+                  onSelect: (model) => {
+                    modelResolverRef.current?.(model);
+                    modelResolverRef.current = null;
+                    setCurrentModel(model);
+                    setModelChoices(null);
+                  },
+                  onCancel: () => {
+                    modelResolverRef.current?.(currentModel);
+                    modelResolverRef.current = null;
+                    setModelChoices(null);
+                  }
+                }
+              ) }),
+              prompt && /* @__PURE__ */ jsxs26(Box27, { width: contentWidth, flexDirection: "column", marginTop: 1, children: [
+                /* @__PURE__ */ jsx32(Text29, { bold: true, color: theme31.text, children: promptShellModel?.heading }),
+                promptShellModel?.task && /* @__PURE__ */ jsxs26(Box27, { marginTop: 1, children: [
+                  /* @__PURE__ */ jsx32(Text29, { color: theme31.textSubtle, children: "task " }),
+                  /* @__PURE__ */ jsx32(Text29, { color: theme31.text, children: promptShellModel.task })
+                ] }),
+                promptShellModel?.filePath && /* @__PURE__ */ jsxs26(Box27, { children: [
+                  /* @__PURE__ */ jsx32(Text29, { color: theme31.textSubtle, children: "state " }),
+                  /* @__PURE__ */ jsx32(Text29, { color: theme31.textSubtle, children: promptShellModel.filePath })
+                ] }),
+                promptShellModel?.metaLine && /* @__PURE__ */ jsx32(Box27, { marginTop: 1, children: /* @__PURE__ */ jsx32(Text29, { color: theme31.textSubtle, children: promptShellModel.metaLine }) }),
+                /* @__PURE__ */ jsx32(Box27, { marginTop: 1, children: /* @__PURE__ */ jsx32(Text29, { color: theme31.textSubtle, children: prompt.hint }) }),
+                /* @__PURE__ */ jsx32(Box27, { flexDirection: "column", marginTop: 1, children: prompt.choices.map((choice, index) => {
+                  const isSelected = index === selectedPromptIndex;
+                  return /* @__PURE__ */ jsxs26(Box27, { marginTop: index === 0 ? 0 : 1, children: [
+                    /* @__PURE__ */ jsx32(Text29, { color: isSelected ? theme31.accent : theme31.textSubtle, bold: isSelected, children: isSelected ? "\u203A " : "  " }),
+                    /* @__PURE__ */ jsx32(Text29, { color: isSelected ? theme31.text : theme31.textSubtle, bold: isSelected, children: `${index + 1} ${choice.label}` })
+                  ] }, choice.value);
+                }) }),
+                selectedChoice && /* @__PURE__ */ jsx32(Box27, { marginTop: 1, children: /* @__PURE__ */ jsx32(Text29, { color: theme31.textSubtle, children: selectedChoice.description }) }),
+                /* @__PURE__ */ jsx32(Box27, { marginTop: 1, children: /* @__PURE__ */ jsx32(Text29, { color: theme31.border, children: SCROLL_HINT }) })
+              ] })
+            ]
+          }
+        )
+      }
+    )
+  ] });
 }
 
 // src/commands/agents-task.ts
-import * as fs12 from "fs";
+import * as fs13 from "fs";
 import {
   RuntypeClient as RuntypeClient2,
+  defaultWorkflow,
   deployWorkflow,
   gameWorkflow
 } from "@runtypelabs/sdk";
 
+// src/lib/terminal-title.ts
+import path4 from "path";
+function setTerminalTitle(title) {
+  if (process.stdout.isTTY) {
+    process.stdout.write(`\x1B]0;${title}\x07`);
+  }
+}
+function getFolderName() {
+  return path4.basename(process.cwd());
+}
+function setCliTitle() {
+  setTerminalTitle(`Runtype (${getFolderName()})`);
+}
+function setMarathonTitle() {
+  setTerminalTitle(`Runtype: Marathon (${getFolderName()})`);
+}
+
 // src/marathon/checkpoint.ts
 import * as fs6 from "fs";
-import * as path5 from "path";
+import * as path6 from "path";
 
 // src/config/paths.ts
 import * as os3 from "os";
-import * as path4 from "path";
+import * as path5 from "path";
 import * as crypto3 from "crypto";
 import * as fs5 from "fs";
 function getRuntypeHomeDir() {
-  return process.env.RUNTYPE_STATE_DIR || path4.join(os3.homedir(), ".runtype");
+  return process.env.RUNTYPE_STATE_DIR || path5.join(os3.homedir(), ".runtype");
 }
 function getProjectStateDir(projectDir) {
   const dir = projectDir || process.cwd();
   const hash = crypto3.createHash("sha256").update(dir).digest("hex").slice(0, 12);
-  const stateDir = path4.join(getRuntypeHomeDir(), "projects", hash);
-  const breadcrumb = path4.join(stateDir, "project-path.txt");
+  const stateDir = path5.join(getRuntypeHomeDir(), "projects", hash);
+  const breadcrumb = path5.join(stateDir, "project-path.txt");
   if (!fs5.existsSync(breadcrumb)) {
     fs5.mkdirSync(stateDir, { recursive: true });
     fs5.writeFileSync(breadcrumb, dir);
@@ -13817,7 +14046,7 @@ function getProjectStateDir(projectDir) {
   return stateDir;
 }
 function getMarathonStateDir(projectDir) {
-  return path4.join(getProjectStateDir(projectDir), "marathons");
+  return path5.join(getProjectStateDir(projectDir), "marathons");
 }
 
 // src/marathon/checkpoint.ts
@@ -13828,12 +14057,12 @@ function stateSafeName(name) {
   return name.replace(/[^a-zA-Z0-9_-]/g, "_");
 }
 function marathonArtifactsDir(taskName, stateDir) {
-  return path5.join(stateDir || defaultStateDir(), stateSafeName(taskName));
+  return path6.join(stateDir || defaultStateDir(), stateSafeName(taskName));
 }
 function resolveMarathonCheckpointPath(taskName, targetPath, stateDir) {
-  const normalizedTargetPath = path5.normalize(targetPath);
-  const relativeTargetPath = path5.isAbsolute(normalizedTargetPath) ? path5.relative(process.cwd(), normalizedTargetPath) : normalizedTargetPath;
-  return path5.join(
+  const normalizedTargetPath = path6.normalize(targetPath);
+  const relativeTargetPath = path6.isAbsolute(normalizedTargetPath) ? path6.relative(process.cwd(), normalizedTargetPath) : normalizedTargetPath;
+  return path6.join(
     marathonArtifactsDir(taskName, stateDir),
     "checkpoints",
     "original",
@@ -13841,23 +14070,23 @@ function resolveMarathonCheckpointPath(taskName, targetPath, stateDir) {
   );
 }
 function ensureMarathonFileCheckpoint(taskName, targetPath, stateDir) {
-  const normalizedTargetPath = path5.resolve(targetPath);
-  const relativeTargetPath = path5.relative(process.cwd(), normalizedTargetPath);
+  const normalizedTargetPath = path6.resolve(targetPath);
+  const relativeTargetPath = path6.relative(process.cwd(), normalizedTargetPath);
   if (!relativeTargetPath || relativeTargetPath.startsWith("..")) return void 0;
   if (!fs6.existsSync(normalizedTargetPath)) return void 0;
   if (!fs6.statSync(normalizedTargetPath).isFile()) return void 0;
   const normalizedRelativeTargetPath = relativeTargetPath.replace(/\\/g, "/");
   if (normalizedRelativeTargetPath.startsWith(".runtype/")) return void 0;
-  if (normalizedTargetPath.startsWith(getRuntypeHomeDir() + path5.sep)) return void 0;
+  if (normalizedTargetPath.startsWith(getRuntypeHomeDir() + path6.sep)) return void 0;
   const checkpointPath = resolveMarathonCheckpointPath(taskName, normalizedTargetPath, stateDir);
   if (fs6.existsSync(checkpointPath)) return checkpointPath;
-  fs6.mkdirSync(path5.dirname(checkpointPath), { recursive: true });
+  fs6.mkdirSync(path6.dirname(checkpointPath), { recursive: true });
   fs6.copyFileSync(normalizedTargetPath, checkpointPath);
   return checkpointPath;
 }
 function restoreMarathonFileCheckpoint(taskName, targetPath, stateDir) {
-  const normalizedTargetPath = path5.resolve(targetPath);
-  const relativeTargetPath = path5.relative(process.cwd(), normalizedTargetPath);
+  const normalizedTargetPath = path6.resolve(targetPath);
+  const relativeTargetPath = path6.relative(process.cwd(), normalizedTargetPath);
   if (!relativeTargetPath || relativeTargetPath.startsWith("..")) {
     return {
       restored: false,
@@ -13872,7 +14101,7 @@ function restoreMarathonFileCheckpoint(taskName, targetPath, stateDir) {
       error: `No checkpoint found for ${normalizedTargetPath}`
     };
   }
-  fs6.mkdirSync(path5.dirname(normalizedTargetPath), { recursive: true });
+  fs6.mkdirSync(path6.dirname(normalizedTargetPath), { recursive: true });
   fs6.copyFileSync(checkpointPath, normalizedTargetPath);
   return { restored: true, checkpointPath };
 }
@@ -13930,7 +14159,7 @@ async function retryOnNetworkError(fn, opts = {}) {
       }
       const delay = Math.min(baseDelay * 2 ** attempt, maxDelay);
       opts.onRetry?.(attempt + 1, delay, error);
-      await new Promise((resolve6) => setTimeout(resolve6, delay));
+      await new Promise((resolve7) => setTimeout(resolve7, delay));
     }
   }
   throw lastError;
@@ -14046,7 +14275,7 @@ function isSafeVerificationCommand(command) {
 
 // src/marathon/state.ts
 import * as fs7 from "fs";
-import * as path6 from "path";
+import * as path7 from "path";
 import chalk15 from "chalk";
 
 // src/lib/select-prompt.ts
@@ -14081,14 +14310,14 @@ async function promptNumericSelect(choices, promptLabel) {
     output: process.stdout,
     terminal: true
   });
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     const ask = () => {
       rl.question(chalk14.cyan(`
 ${promptLabel} (1-${choices.length}): `), (answer) => {
         const value = parseInt(answer.trim(), 10);
         if (value >= 1 && value <= choices.length) {
           rl.close();
-          resolve6(choices[value - 1].value);
+          resolve7(choices[value - 1].value);
           return;
         }
         console.log(chalk14.red(`Please enter a number between 1 and ${choices.length}.`));
@@ -14116,7 +14345,7 @@ ${message}`));
   const previousRawMode = input.isRaw === true;
   let selectedIndex = 0;
   let renderedLineCount = 0;
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     const renderMenu = () => {
       if (renderedLineCount > 0) {
         clearRenderedLines(output, renderedLineCount);
@@ -14138,7 +14367,7 @@ ${message}`));
     };
     const finish = (value) => {
       cleanup();
-      resolve6(value);
+      resolve7(value);
     };
     const onKeypress = (_, key) => {
       if (key.ctrl && key.name === "c") {
@@ -14184,7 +14413,7 @@ function stateSafeName2(name) {
 }
 function stateFilePath(name, stateDir) {
   const dir = stateDir || defaultStateDir2();
-  return path6.join(dir, `${stateSafeName2(name)}.json`);
+  return path7.join(dir, `${stateSafeName2(name)}.json`);
 }
 function normalizeMarathonStatePath(candidatePath) {
   if (!candidatePath) return void 0;
@@ -14193,15 +14422,15 @@ function normalizeMarathonStatePath(candidatePath) {
 }
 function marathonStatePathExists(candidatePath) {
   if (!candidatePath) return false;
-  return fs7.existsSync(path6.resolve(candidatePath));
+  return fs7.existsSync(path7.resolve(candidatePath));
 }
 function isMarathonArtifactStatePath(candidatePath) {
   if (!candidatePath) return false;
   const normalized = normalizeMarathonStatePath(candidatePath)?.toLowerCase();
   if (normalized === ".runtype" || normalized?.startsWith(".runtype/") === true) return true;
-  const resolved = path6.resolve(candidatePath);
+  const resolved = path7.resolve(candidatePath);
   const homeStateDir = getRuntypeHomeDir();
-  return resolved.startsWith(homeStateDir + path6.sep) || resolved === homeStateDir;
+  return resolved.startsWith(homeStateDir + path7.sep) || resolved === homeStateDir;
 }
 function scoreMarathonCandidatePath(candidatePath) {
   const normalized = candidatePath.toLowerCase();
@@ -14374,7 +14603,7 @@ function loadState(filePath) {
   }
 }
 function saveState(filePath, state, options) {
-  const dir = path6.dirname(filePath);
+  const dir = path7.dirname(filePath);
   fs7.mkdirSync(dir, { recursive: true });
   const stateToWrite = options?.stripSnapshotEvents && state.sessionSnapshots?.length ? {
     ...state,
@@ -14412,9 +14641,9 @@ function findStateFile(name, stateDir) {
   }
   const homePath = stateFilePath(name, getMarathonStateDir());
   if (fs7.existsSync(homePath)) return homePath;
-  const oldMarathonPath = stateFilePath(name, path6.join(process.cwd(), ".runtype", "marathons"));
+  const oldMarathonPath = stateFilePath(name, path7.join(process.cwd(), ".runtype", "marathons"));
   if (fs7.existsSync(oldMarathonPath)) return oldMarathonPath;
-  const oldTaskPath = stateFilePath(name, path6.join(process.cwd(), ".runtype", "tasks"));
+  const oldTaskPath = stateFilePath(name, path7.join(process.cwd(), ".runtype", "tasks"));
   if (fs7.existsSync(oldTaskPath)) return oldTaskPath;
   return homePath;
 }
@@ -14423,15 +14652,15 @@ function findLatestStateFile(stateDir) {
     // New home-dir location
     getMarathonStateDir(),
     // Old project-dir locations (backward compat)
-    path6.join(process.cwd(), ".runtype", "marathons"),
-    path6.join(process.cwd(), ".runtype", "tasks")
+    path7.join(process.cwd(), ".runtype", "marathons"),
+    path7.join(process.cwd(), ".runtype", "tasks")
   ];
   let latest = null;
   for (const dir of dirs) {
     if (!fs7.existsSync(dir)) continue;
     const files = fs7.readdirSync(dir).filter((f) => f.endsWith(".json"));
     for (const file of files) {
-      const fullPath = path6.join(dir, file);
+      const fullPath = path7.join(dir, file);
       const stat = fs7.statSync(fullPath);
       if (!latest || stat.mtimeMs > latest.mtime) {
         latest = { name: file.replace(".json", ""), filePath: fullPath, mtime: stat.mtimeMs };
@@ -14553,12 +14782,12 @@ function buildResumeCommand(agent, options, parsedSandbox) {
 
 // src/marathon/local-tools.ts
 import * as fs9 from "fs";
-import * as path8 from "path";
+import * as path9 from "path";
 import { spawnSync } from "child_process";
 
 // src/marathon/repo-discovery.ts
 import * as fs8 from "fs";
-import * as path7 from "path";
+import * as path8 from "path";
 var IGNORED_REPO_DIRS = /* @__PURE__ */ new Set([
   ".git",
   ".next",
@@ -14633,8 +14862,8 @@ var SEARCH_STOP_WORDS = /* @__PURE__ */ new Set([
   "do"
 ]);
 function normalizeToolPath(toolPath) {
-  const resolved = path7.resolve(toolPath || ".");
-  return path7.relative(process.cwd(), resolved) || ".";
+  const resolved = path8.resolve(toolPath || ".");
+  return path8.relative(process.cwd(), resolved) || ".";
 }
 function tokenizeSearchQuery(query) {
   return query.toLowerCase().split(/[^a-z0-9./_-]+/g).map((token) => token.trim()).filter((token) => token.length >= 2 && !SEARCH_STOP_WORDS.has(token));
@@ -14643,7 +14872,7 @@ function scoreSearchPath(relativePath) {
   const normalized = relativePath.replace(/\\/g, "/");
   const segments = normalized.split("/");
   const fileName = segments[segments.length - 1] || normalized;
-  const extension = path7.extname(fileName).toLowerCase();
+  const extension = path8.extname(fileName).toLowerCase();
   let score = 0;
   if (LOW_SIGNAL_FILE_NAMES.has(fileName)) score -= 50;
   if (segments.some((segment) => LOW_SIGNAL_PATH_SEGMENTS.has(segment))) score -= 15;
@@ -14658,7 +14887,7 @@ function scoreSearchPath(relativePath) {
 function shouldIgnoreRepoEntry(entryPath) {
   const normalized = normalizeToolPath(entryPath);
   if (normalized === ".") return false;
-  return normalized.split(path7.sep).some((segment) => IGNORED_REPO_DIRS.has(segment));
+  return normalized.split(path8.sep).some((segment) => IGNORED_REPO_DIRS.has(segment));
 }
 function safeReadTextFile(filePath) {
   try {
@@ -14684,7 +14913,7 @@ function walkRepo(startPath, visitor) {
       continue;
     }
     for (const entry of entries) {
-      const entryPath = path7.join(currentDir, entry.name);
+      const entryPath = path8.join(currentDir, entry.name);
       if (shouldIgnoreRepoEntry(entryPath)) continue;
       const shouldStop = visitor(entryPath, entry);
       if (shouldStop === true) return;
@@ -14729,7 +14958,7 @@ function buildTree(dirPath, maxDepth, depth = 0) {
   }
   const lines = [];
   for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
-    const entryPath = path7.join(dirPath, entry.name);
+    const entryPath = path8.join(dirPath, entry.name);
     if (shouldIgnoreRepoEntry(entryPath)) continue;
     lines.push(`${"  ".repeat(depth)}- ${entry.name}${entry.isDirectory() ? "/" : ""}`);
     if (entry.isDirectory() && depth < maxDepth) {
@@ -14745,14 +14974,14 @@ function stateSafeName3(name) {
   return name.replace(/[^a-zA-Z0-9_-]/g, "_");
 }
 function getOffloadedOutputDir(taskName, stateDir) {
-  return path8.join(stateDir || getMarathonStateDir(), stateSafeName3(taskName), "outputs");
+  return path9.join(stateDir || getMarathonStateDir(), stateSafeName3(taskName), "outputs");
 }
 function isPathWithinRoot(targetPath, rootPath) {
-  const relativePath = path8.relative(rootPath, targetPath);
-  return relativePath === "" || !relativePath.startsWith("..") && !path8.isAbsolute(relativePath);
+  const relativePath = path9.relative(rootPath, targetPath);
+  return relativePath === "" || !relativePath.startsWith("..") && !path9.isAbsolute(relativePath);
 }
 function resolveCanonicalToolPath(toolPath, allowMissing) {
-  const absolutePath = path8.resolve(toolPath);
+  const absolutePath = path9.resolve(toolPath);
   if (fs9.existsSync(absolutePath)) {
     return {
       canonicalPath: fs9.realpathSync.native(absolutePath),
@@ -14763,22 +14992,22 @@ function resolveCanonicalToolPath(toolPath, allowMissing) {
   const missingSegments = [];
   let currentPath = absolutePath;
   while (!fs9.existsSync(currentPath)) {
-    const parentPath = path8.dirname(currentPath);
+    const parentPath = path9.dirname(currentPath);
     if (parentPath === currentPath) return null;
-    missingSegments.unshift(path8.basename(currentPath));
+    missingSegments.unshift(path9.basename(currentPath));
     currentPath = parentPath;
   }
   return {
-    canonicalPath: path8.join(fs9.realpathSync.native(currentPath), ...missingSegments),
+    canonicalPath: path9.join(fs9.realpathSync.native(currentPath), ...missingSegments),
     exists: false
   };
 }
 function canonicalizeAllowedRoot(rootPath) {
-  return resolveCanonicalToolPath(rootPath, true)?.canonicalPath || path8.resolve(rootPath);
+  return resolveCanonicalToolPath(rootPath, true)?.canonicalPath || path9.resolve(rootPath);
 }
 function findBlockedWorkspaceSegment(targetPath, workspaceRoot) {
   if (!isPathWithinRoot(targetPath, workspaceRoot)) return void 0;
-  const relativePath = path8.relative(workspaceRoot, targetPath).replace(/\\/g, "/");
+  const relativePath = path9.relative(workspaceRoot, targetPath).replace(/\\/g, "/");
   if (!relativePath) return void 0;
   return relativePath.split("/").find((segment) => DIRECT_TOOL_BLOCKED_SEGMENTS.has(segment));
 }
@@ -14871,7 +15100,7 @@ function createDefaultLocalTools(context) {
         if (fs9.existsSync(resolvedPath.resolvedPath) && fs9.statSync(resolvedPath.resolvedPath).isDirectory()) {
           return `Error: Path is a directory: ${String(args.path || "")}`;
         }
-        const dir = path8.dirname(resolvedPath.resolvedPath);
+        const dir = path9.dirname(resolvedPath.resolvedPath);
         fs9.mkdirSync(dir, { recursive: true });
         fs9.writeFileSync(resolvedPath.resolvedPath, content);
         return "ok";
@@ -14888,7 +15117,7 @@ function createDefaultLocalTools(context) {
           requireDirectory: true
         });
         if (!resolvedPath.ok) return `Error: ${resolvedPath.error}`;
-        return fs9.readdirSync(resolvedPath.resolvedPath, { withFileTypes: true }).filter((entry) => !shouldIgnoreRepoEntry(path8.join(resolvedPath.resolvedPath, entry.name))).map((entry) => entry.name).join("\n");
+        return fs9.readdirSync(resolvedPath.resolvedPath, { withFileTypes: true }).filter((entry) => !shouldIgnoreRepoEntry(path9.join(resolvedPath.resolvedPath, entry.name))).map((entry) => entry.name).join("\n");
       }
     },
     search_repo: {
@@ -15053,7 +15282,7 @@ function createCheckpointedWriteFileTool(taskName, stateDir) {
       if (!resolvedPath.ok) return `Error: ${resolvedPath.error}`;
       const content = String(args.content || "");
       ensureMarathonFileCheckpoint(taskName, resolvedPath.resolvedPath, stateDir);
-      const dir = path8.dirname(resolvedPath.resolvedPath);
+      const dir = path9.dirname(resolvedPath.resolvedPath);
       fs9.mkdirSync(dir, { recursive: true });
       fs9.writeFileSync(resolvedPath.resolvedPath, content);
       return "ok";
@@ -15102,7 +15331,7 @@ function createReadOffloadedOutputTool(taskName, stateDir) {
       if (!/^[a-zA-Z0-9_-]+$/.test(outputId)) {
         return `Error: invalid offloaded output id: ${outputId}`;
       }
-      const outputPath = path8.join(getOffloadedOutputDir(taskName, stateDir), `${outputId}.txt`);
+      const outputPath = path9.join(getOffloadedOutputDir(taskName, stateDir), `${outputId}.txt`);
       if (!fs9.existsSync(outputPath) || !fs9.statSync(outputPath).isFile()) {
         return `Error: offloaded output not found: ${outputId}`;
       }
@@ -15265,7 +15494,7 @@ function createLoopDetector(options = {}) {
       cachedLoopInfo = null;
       dirty = false;
     },
-    getSteeringMessage() {
+    getCheckpointMessage() {
       const info = this.getLoopInfo();
       if (!info) return "";
       return [
@@ -15284,7 +15513,7 @@ function createLoopDetector(options = {}) {
 
 // src/marathon/context-offload.ts
 import * as fs10 from "fs";
-import * as path9 from "path";
+import * as path10 from "path";
 var DEFAULT_OUTPUT_THRESHOLD = 2e3;
 var DEFAULT_PREVIEW_LENGTH = 200;
 function buildOffloadedOutputId(toolName) {
@@ -15316,13 +15545,13 @@ function offloadToolOutput(taskName, toolName, output, options = {}, stateDir) {
     return { offloaded: false, content: output };
   }
   const outputId = buildOffloadedOutputId(toolName);
-  const dir = path9.join(
+  const dir = path10.join(
     stateDir || defaultStateDir3(),
     stateSafeName4(taskName),
     "outputs"
   );
   const fileName = `${outputId}.txt`;
-  const filePath = path9.join(dir, fileName);
+  const filePath = path10.join(dir, fileName);
   fs10.mkdirSync(dir, { recursive: true });
   fs10.writeFileSync(filePath, output, "utf-8");
   const preview = output.slice(0, previewLength).replace(/\n/g, " ");
@@ -15497,42 +15726,17 @@ function resolveAutoCompactTokenThreshold(modelContextLength, rawThreshold, stra
 
 // src/marathon/recipes.ts
 import * as fs11 from "fs";
-import * as path10 from "path";
-var RECIPES_DIR = ".marathon/recipes";
-function loadRecipe(nameOrPath, cwd) {
-  const baseCwd = cwd || process.cwd();
-  const candidates = [
-    // Exact path
-    path10.resolve(baseCwd, nameOrPath),
-    // .marathon/recipes/<name>.json
-    path10.resolve(baseCwd, RECIPES_DIR, `${nameOrPath}.json`),
-    // .marathon/recipes/<name>/recipe.json
-    path10.resolve(baseCwd, RECIPES_DIR, nameOrPath, "recipe.json")
-  ];
-  for (const candidate of candidates) {
-    if (!fs11.existsSync(candidate)) continue;
-    try {
-      const raw = fs11.readFileSync(candidate, "utf-8");
-      const parsed = JSON.parse(raw);
-      if (parsed.meta?.name && parsed.meta?.version) {
-        return parsed;
-      }
-    } catch {
-      continue;
-    }
-  }
-  return null;
-}
+import * as path11 from "path";
 var RULES_DIR = ".marathon/rules";
 function loadRules(cwd) {
   const baseCwd = cwd || process.cwd();
-  const rulesDir = path10.resolve(baseCwd, RULES_DIR);
+  const rulesDir = path11.resolve(baseCwd, RULES_DIR);
   if (!fs11.existsSync(rulesDir)) return [];
   const rules = [];
   try {
     const entries = fs11.readdirSync(rulesDir).filter((f) => f.endsWith(".md"));
     for (const entry of entries) {
-      const filePath = path10.join(rulesDir, entry);
+      const filePath = path11.join(rulesDir, entry);
       try {
         const raw = fs11.readFileSync(filePath, "utf-8");
         const parsed = parseRuleFile(raw);
@@ -15567,26 +15771,154 @@ function extractYamlArray(yaml, key) {
   if (!match) return [];
   return match[1].split(",").map((s) => s.trim().replace(/^["']|["']$/g, "")).filter(Boolean);
 }
-function resolveModelForPhase(phase, recipe, cliOverrides) {
+function resolveModelForPhase(phase, cliOverrides, milestoneModels) {
+  if (phase && milestoneModels?.[phase]) {
+    return milestoneModels[phase];
+  }
   if (phase === "research" || phase === "planning") {
     if (cliOverrides.planningModel) return cliOverrides.planningModel;
   }
   if (phase === "execution") {
     if (cliOverrides.executionModel) return cliOverrides.executionModel;
   }
-  if (recipe?.model) {
-    if (phase === "research" && recipe.model.research) return recipe.model.research;
-    if (phase === "planning" && recipe.model.planning) return recipe.model.planning;
-    if (phase === "execution" && recipe.model.execution) return recipe.model.execution;
-  }
   return cliOverrides.defaultModel;
 }
 
+// src/marathon/playbook-loader.ts
+import * as fs12 from "fs";
+import * as path12 from "path";
+import * as os4 from "os";
+import { parse as parseYaml } from "yaml";
+var PLAYBOOKS_DIR = ".runtype/marathons/playbooks";
+function getCandidatePaths(nameOrPath, cwd) {
+  const home = os4.homedir();
+  return [
+    // Exact path
+    path12.resolve(cwd, nameOrPath),
+    // Repo-level
+    path12.resolve(cwd, PLAYBOOKS_DIR, `${nameOrPath}.yaml`),
+    path12.resolve(cwd, PLAYBOOKS_DIR, `${nameOrPath}.yml`),
+    path12.resolve(cwd, PLAYBOOKS_DIR, `${nameOrPath}.json`),
+    // User-level
+    path12.resolve(home, PLAYBOOKS_DIR, `${nameOrPath}.yaml`),
+    path12.resolve(home, PLAYBOOKS_DIR, `${nameOrPath}.yml`),
+    path12.resolve(home, PLAYBOOKS_DIR, `${nameOrPath}.json`)
+  ];
+}
+function parsePlaybookFile(filePath) {
+  const raw = fs12.readFileSync(filePath, "utf-8");
+  const ext = path12.extname(filePath).toLowerCase();
+  if (ext === ".json") {
+    return JSON.parse(raw);
+  }
+  return parseYaml(raw);
+}
+function validatePlaybook(config2, filePath) {
+  if (!config2.name) {
+    throw new Error(`Playbook at ${filePath} is missing required 'name' field`);
+  }
+  if (!config2.milestones || config2.milestones.length === 0) {
+    throw new Error(`Playbook '${config2.name}' must have at least one milestone`);
+  }
+  for (const milestone of config2.milestones) {
+    if (!milestone.name) {
+      throw new Error(`Playbook '${config2.name}': each milestone must have a 'name'`);
+    }
+    if (!milestone.instructions) {
+      throw new Error(`Playbook '${config2.name}': milestone '${milestone.name}' is missing 'instructions'`);
+    }
+  }
+}
+function interpolate(template, state) {
+  return template.replace(/\{\{(\w+)\}\}/g, (_match, key) => {
+    const value = state[key];
+    if (value === void 0 || value === null) return `{{${key}}}`;
+    return String(value);
+  });
+}
+function buildIsComplete(criteria) {
+  if (!criteria) return () => false;
+  switch (criteria.type) {
+    case "evidence":
+      return (ctx) => {
+        const minFiles = criteria.minReadFiles ?? 1;
+        return (ctx.state.recentReadPaths?.length ?? 0) >= minFiles;
+      };
+    case "sessions": {
+      let baselineSessionCount;
+      return (ctx) => {
+        const minSessions = criteria.minSessions ?? 1;
+        if (baselineSessionCount === void 0) {
+          baselineSessionCount = ctx.state.sessions.length;
+        }
+        return ctx.state.sessions.length - baselineSessionCount >= minSessions;
+      };
+    }
+    case "planWritten":
+      return (ctx) => {
+        return ctx.trace.planWritten;
+      };
+    case "never":
+    default:
+      return () => false;
+  }
+}
+function convertToWorkflow(config2) {
+  const phases = config2.milestones.map((milestone) => ({
+    name: milestone.name,
+    description: milestone.description,
+    buildInstructions(state) {
+      const header = `--- Workflow Phase: ${milestone.name} ---`;
+      const desc = milestone.description ? `
+${milestone.description}` : "";
+      const instructions = interpolate(milestone.instructions, state);
+      return `${header}${desc}
+${instructions}`;
+    },
+    buildToolGuidance(_state) {
+      return milestone.toolGuidance ?? [];
+    },
+    isComplete: buildIsComplete(milestone.completionCriteria),
+    // Default to rejecting TASK_COMPLETE unless the playbook explicitly allows it.
+    // The SDK accepts completion by default when canAcceptCompletion is undefined,
+    // which would let the model end the marathon prematurely in early phases.
+    canAcceptCompletion: milestone.canAcceptCompletion !== void 0 ? () => milestone.canAcceptCompletion : () => false
+  }));
+  return {
+    name: config2.name,
+    phases
+  };
+}
+function loadPlaybook(nameOrPath, cwd) {
+  const baseCwd = cwd || process.cwd();
+  const candidates = getCandidatePaths(nameOrPath, baseCwd);
+  for (const candidate of candidates) {
+    if (!fs12.existsSync(candidate)) continue;
+    const config2 = parsePlaybookFile(candidate);
+    validatePlaybook(config2, candidate);
+    const milestoneModels = {};
+    for (const m of config2.milestones) {
+      if (m.model) milestoneModels[m.name] = m.model;
+    }
+    return {
+      workflow: convertToWorkflow(config2),
+      milestones: config2.milestones.map((m) => m.name),
+      milestoneModels: Object.keys(milestoneModels).length > 0 ? milestoneModels : void 0,
+      verification: config2.verification,
+      rules: config2.rules
+    };
+  }
+  throw new Error(
+    `Playbook '${nameOrPath}' not found. Searched:
+${candidates.map((c) => `  ${c}`).join("\n")}`
+  );
+}
+
 // src/commands/agents-task.ts
 var import_builtin_tools_registry = __toESM(require_builtin_tools_registry(), 1);
 var import_provider_routing = __toESM(require_provider_routing(), 1);
-function shouldRequestResumeSteering(status, resumeMessage, noSteer, originalMessage, continuations) {
-  if (status !== "paused" || noSteer) return false;
+function shouldRequestResumeCheckpoint(status, resumeMessage, noCheckpoint, originalMessage, continuations) {
+  if (status !== "paused" || noCheckpoint) return false;
   const normalizedResumeMessage = resumeMessage?.trim();
   if (!normalizedResumeMessage) return true;
   const normalizedOriginalMessage = originalMessage?.trim();
@@ -15600,7 +15932,7 @@ function shouldRequestResumeSteering(status, resumeMessage, noSteer, originalMes
   }
   return false;
 }
-function buildResumeSteeringRecap(state, snapshots) {
+function buildResumeCheckpointRecap(state, snapshots) {
   const latestSnapshot = snapshots[snapshots.length - 1];
   const derivedTokens = state.sessions?.reduce(
     (totals, session) => ({
@@ -15780,15 +16112,6 @@ async function taskAction(agent, options) {
     console.error(chalk16.red(error instanceof Error ? error.message : String(error)));
     process.exit(1);
   }
-  let recipe = null;
-  if (options.recipe) {
-    recipe = loadRecipe(options.recipe);
-    if (!recipe) {
-      console.error(chalk16.red(`Recipe not found: "${options.recipe}"`));
-      console.log(chalk16.gray("  Place recipes in .marathon/recipes/<name>.json"));
-      process.exit(1);
-    }
-  }
   const rules = loadRules();
   const rulesContext = rules.length > 0 ? rules.map((r) => r.content).join("\n\n---\n\n") : "";
   const allModels = [
@@ -15796,10 +16119,7 @@ async function taskAction(agent, options) {
       [
         options.model,
         options.planningModel,
-        options.executionModel,
-        recipe?.model?.planning,
-        recipe?.model?.execution,
-        recipe?.model?.research
+        options.executionModel
       ].filter((m) => Boolean(m))
     )
   ];
@@ -15841,7 +16161,7 @@ async function taskAction(agent, options) {
     waitForUiExit = renderedShell.waitUntilExit;
     rerenderUi = renderedShell.rerender;
     unmountUi = renderedShell.unmount;
-    await new Promise((resolve6) => setTimeout(resolve6, 0));
+    await new Promise((resolve7) => setTimeout(resolve7, 0));
     if (!startupShellRef.current) {
       exitAltScreen();
       unmountUi?.();
@@ -15962,7 +16282,7 @@ async function taskAction(agent, options) {
       forcedResumeFilePath = stateResolution.filePath;
     } else {
       resumeRequested = false;
-      if (options.fresh && fs12.existsSync(filePath)) {
+      if (options.fresh && fs13.existsSync(filePath)) {
         if (useStartupShell) {
           setStartupStatus("starting fresh");
         } else {
@@ -15989,7 +16309,7 @@ async function taskAction(agent, options) {
   let persistedSessionSnapshots = [];
   let resumeState;
   let resumeLoadedState = null;
-  let shouldPromptResumeSteering = false;
+  let shouldPromptResumeCheckpoint = false;
   let resumeHistoryWarning;
   let eventLogWriter;
   if (resumeRequested) {
@@ -16038,15 +16358,15 @@ async function taskAction(agent, options) {
     resumeLoadedState = existing;
     resumeHistoryWarning = buildResumeHistoryWarning(existing);
     const resumeMessage = typeof options.resume === "string" ? options.resume : options.goal;
-    shouldPromptResumeSteering = shouldRequestResumeSteering(
+    shouldPromptResumeCheckpoint = shouldRequestResumeCheckpoint(
       existing.status,
       resumeMessage,
-      options.noSteer ?? false,
+      options.noCheckpoint ?? false,
       existing.originalMessage,
       existing.continuations
     );
     previousMessages = existing.messages ?? [];
-    continuationMessage = shouldPromptResumeSteering ? void 0 : resumeMessage;
+    continuationMessage = shouldPromptResumeCheckpoint ? void 0 : resumeMessage;
     useCompact = options.compact ?? false;
     priorContinuations = [...existing.continuations ?? []];
     resumeState = extractRunTaskResumeState(existing);
@@ -16071,19 +16391,64 @@ async function taskAction(agent, options) {
       }
     }
   }
+  let playbookWorkflow;
+  let playbookMilestones;
+  let playbookMilestoneModels;
+  if (options.playbook) {
+    const result = loadPlaybook(options.playbook);
+    playbookWorkflow = result.workflow;
+    playbookMilestones = result.milestones;
+    playbookMilestoneModels = result.milestoneModels;
+  }
   if (useStartupShell && !options.model?.trim()) {
-    let startupModelOptions = buildMarathonStartupModelOptions(configuredModels, availableModels);
-    if (startupModelOptions.length === 0) {
-      startupModelOptions = DEFAULT_MODELS;
-    }
-    const initialStartupModel = agentConfigModel || defaultConfiguredModel || startupModelOptions[0]?.value;
-    if (startupModelOptions.length > 0 && initialStartupModel && startupShellRef.current) {
-      setStartupStatus("selecting model");
-      options.model = await startupShellRef.current.requestModelChoice(
-        initialStartupModel,
-        startupModelOptions
-      );
-      setStartupStatus(`model ready: ${options.model}`);
+    if (playbookMilestoneModels && Object.keys(playbookMilestoneModels).length > 0 && startupShellRef.current) {
+      let editableModels = { ...playbookMilestoneModels };
+      let confirmed = false;
+      while (!confirmed) {
+        setStartupStatus("reviewing playbook models");
+        const confirmResult = await startupShellRef.current.requestPlaybookModelConfirm(
+          options.playbook,
+          editableModels
+        );
+        if (confirmResult.action === "confirm") {
+          playbookMilestoneModels = confirmResult.milestoneModels ?? editableModels;
+          const firstMilestoneModel = Object.values(playbookMilestoneModels)[0];
+          if (firstMilestoneModel) options.model = firstMilestoneModel;
+          confirmed = true;
+        } else if (confirmResult.action === "edit" && confirmResult.editMilestone) {
+          let startupModelOptions = buildMarathonStartupModelOptions(configuredModels, availableModels);
+          if (startupModelOptions.length === 0) {
+            startupModelOptions = DEFAULT_MODELS;
+          }
+          const currentMilestoneModel = editableModels[confirmResult.editMilestone];
+          const pickedModel = await startupShellRef.current.requestModelChoice(
+            currentMilestoneModel,
+            startupModelOptions
+          );
+          editableModels = {
+            ...confirmResult.milestoneModels ?? editableModels,
+            [confirmResult.editMilestone]: pickedModel
+          };
+        } else {
+          playbookMilestoneModels = void 0;
+          confirmed = true;
+        }
+      }
+    }
+    if (!playbookMilestoneModels) {
+      let startupModelOptions = buildMarathonStartupModelOptions(configuredModels, availableModels);
+      if (startupModelOptions.length === 0) {
+        startupModelOptions = DEFAULT_MODELS;
+      }
+      const initialStartupModel = agentConfigModel || defaultConfiguredModel || startupModelOptions[0]?.value;
+      if (startupModelOptions.length > 0 && initialStartupModel && startupShellRef.current) {
+        setStartupStatus("selecting model");
+        options.model = await startupShellRef.current.requestModelChoice(
+          initialStartupModel,
+          startupModelOptions
+        );
+        setStartupStatus(`model ready: ${options.model}`);
+      }
     }
   }
   try {
@@ -16109,23 +16474,25 @@ async function taskAction(agent, options) {
   const remainingCost = maxCost ? maxCost - priorCost : void 0;
   const baseMessage = options.goal || (resumeRequested ? "Continue the task." : "");
   const sandboxPrompt = parsedSandbox ? createSandboxInstructions(parsedSandbox) : "";
-  const resolvedWorkflow = detectDeployWorkflow(baseMessage, parsedSandbox, resumeState);
+  const resolvedWorkflow = playbookWorkflow ?? detectDeployWorkflow(baseMessage, parsedSandbox, resumeState);
+  const DEFAULT_MILESTONE_NAMES = ["research", "planning", "execution"];
+  const EXTERNAL_MILESTONE_NAMES = ["research", "report"];
+  const detectedVariant = resumeState?.workflowVariant ?? defaultWorkflow.classifyVariant?.(baseMessage);
+  const defaultMilestones = detectedVariant === "external" ? EXTERNAL_MILESTONE_NAMES : DEFAULT_MILESTONE_NAMES;
+  const workflowMilestones = playbookMilestones ?? (resolvedWorkflow ? resolvedWorkflow.phases.map((p) => p.name) : defaultMilestones);
   let taskMessage = baseMessage;
   if (sandboxPrompt && !resolvedWorkflow) taskMessage = `${taskMessage}
 
 ${sandboxPrompt}`;
-  if (recipe?.rules) taskMessage = `${taskMessage}
-
-${recipe.rules}`;
   if (rulesContext) taskMessage = `${taskMessage}
 
 ${rulesContext}`;
   const currentPhase = resumeState?.workflowPhase;
-  const resolvedModel = resolveModelForPhase(currentPhase, recipe, {
+  const resolvedModel = resolveModelForPhase(currentPhase, {
     planningModel: options.planningModel,
     executionModel: options.executionModel,
     defaultModel: options.model
-  });
+  }, playbookMilestoneModels);
   if (resolvedModel) options.model = resolvedModel;
   let localTools = buildLocalTools(client, parsedSandbox, options, {
     taskName,
@@ -16186,12 +16553,12 @@ ${rulesContext}`;
     }
   }
   let toolsEnabled = true;
-  const steeringHasConfigChanges = (result) => Boolean(result.model) || result.tools === true || result.sandbox !== void 0;
-  const rebuildSteeringTools = () => buildLocalTools(client, parsedSandbox, options, {
+  const checkpointHasConfigChanges = (result) => Boolean(result.model) || result.tools === true || result.sandbox !== void 0;
+  const rebuildCheckpointTools = () => buildLocalTools(client, parsedSandbox, options, {
     taskName,
     stateDir: options.stateDir
   });
-  const applySteeringConfig = (result) => {
+  const applyCheckpointConfig = (result) => {
     if (result.model) {
       options.model = result.model;
     }
@@ -16205,12 +16572,12 @@ ${rulesContext}`;
         }
       }
       if (toolsEnabled) {
-        localTools = rebuildSteeringTools();
+        localTools = rebuildCheckpointTools();
       }
     }
     if (result.tools) {
       toolsEnabled = !toolsEnabled;
-      localTools = toolsEnabled ? rebuildSteeringTools() : void 0;
+      localTools = toolsEnabled ? rebuildCheckpointTools() : void 0;
     }
   };
   const loopDetector = createLoopDetector();
@@ -16235,8 +16602,10 @@ ${rulesContext}`;
       stateFilePath: filePath,
       debug: options.debug,
       plainText: options.plainText ?? false,
-      noSteer: options.noSteer ?? false,
-      steeringTimeout: parseInt(options.steerTimeout || "10", 10),
+      noCheckpoint: options.noCheckpoint ?? false,
+      checkpointTimeout: parseInt(options.checkpointTimeout || "10", 10),
+      workflowMilestones: workflowMilestones.length > 0 ? workflowMilestones : void 0,
+      currentMilestone: detectedVariant === "external" && resumeState?.workflowPhase === "research" && resumeLoadedState?.planWritten ? "report" : resumeState?.workflowPhase ?? workflowMilestones[0],
       dashboardUrl: marathonDashboardBaseUrl,
       billingUrl: `${marathonDashboardBaseUrl}/settings/billing`,
       onSaveState: (payload) => {
@@ -16268,6 +16637,7 @@ Saving state... done. Session saved to ${filePath}`);
       },
       streamRef
     };
+    setMarathonTitle();
     if (useStartupShell) {
       setStartupStatus("preparing marathon");
       rerenderUi?.(
@@ -16286,7 +16656,7 @@ Saving state... done. Session saved to ${filePath}`);
       waitForUiExit = renderedApp.waitUntilExit;
       unmountUi = renderedApp.unmount;
     }
-    await new Promise((resolve6) => setTimeout(resolve6, 0));
+    await new Promise((resolve7) => setTimeout(resolve7, 0));
     const streamActions = streamRef.current;
     if (!streamActions) {
       exitAltScreen();
@@ -16300,14 +16670,14 @@ Saving state... done. Session saved to ${filePath}`);
     if (persistedSessionSnapshots.length > 0) {
       streamActions.hydrateSessionSnapshots(persistedSessionSnapshots);
     }
-    if (resumeLoadedState && shouldPromptResumeSteering) {
-      const recap = buildResumeSteeringRecap(resumeLoadedState, persistedSessionSnapshots);
+    if (resumeLoadedState && shouldPromptResumeCheckpoint) {
+      const recap = buildResumeCheckpointRecap(resumeLoadedState, persistedSessionSnapshots);
       if (resumeHistoryWarning) {
         recap.historyWarning = resumeHistoryWarning;
       }
-      const steeringResult = await streamActions.requestSteering(recap);
-      applySteeringConfig(steeringResult);
-      switch (steeringResult.action) {
+      const checkpointResult = await streamActions.requestCheckpoint(recap);
+      applyCheckpointConfig(checkpointResult);
+      switch (checkpointResult.action) {
         case "stop":
           streamActions.exit();
           await waitForUiExit?.();
@@ -16316,9 +16686,9 @@ Saving state... done. Session saved to ${filePath}`);
           console.log(chalk16.gray(`Resume cancelled. Local state unchanged at ${filePath}`));
           return;
         case "steer":
-          if (steeringResult.message) {
-            taskMessage = steeringResult.message;
-            continuationMessage = steeringResult.message;
+          if (checkpointResult.message) {
+            taskMessage = checkpointResult.message;
+            continuationMessage = checkpointResult.message;
             useCompact = false;
           }
           break;
@@ -16364,12 +16734,12 @@ Saving state... done. Session saved to ${filePath}`);
       const currentRemainingCost = remainingCost ? remainingCost - accumulatedCost : void 0;
       const phaseModel = resolveModelForPhase(
         resumeState?.workflowPhase,
-        recipe,
         {
           planningModel: options.planningModel,
           executionModel: options.executionModel,
           defaultModel: options.model
-        }
+        },
+        playbookMilestoneModels
       );
       const effectiveModelForContext = phaseModel || options.model || agentConfigModel || defaultConfiguredModel;
       const compactStrategy = resolveCompactStrategyForModel(effectiveModelForContext);
@@ -16389,7 +16759,7 @@ Saving state... done. Session saved to ${filePath}`);
         trackProgress: options.track ? taskName : void 0,
         ...resolvedToolIds.length > 0 ? { toolIds: resolvedToolIds } : {},
         ...resolvedWorkflow ? { workflow: resolvedWorkflow } : {},
-        // Continuation context (only set on resume or after steering restart)
+        // Continuation context (only set on resume or after checkpoint restart)
         ...previousMessages.length > 0 ? {
           previousMessages,
           continuationMessage,
@@ -16409,7 +16779,7 @@ Saving state... done. Session saved to ${filePath}`);
           };
           if (event.phase === "start") {
             currentActions.startContextCompaction(absoluteEvent);
-            await new Promise((resolve6) => setTimeout(resolve6, 0));
+            await new Promise((resolve7) => setTimeout(resolve7, 0));
             return;
           }
           currentActions.finishContextCompaction(absoluteEvent);
@@ -16466,18 +16836,24 @@ Saving state... done. Session saved to ${filePath}`);
           resumeState = extractRunTaskResumeState(adjustedState);
           lastSessionMessages = state.messages ?? [];
           saveState(filePath, adjustedState, { stripSnapshotEvents: !!eventLogWriter });
+          if (resumeState?.workflowPhase) {
+            const displayMilestone = detectedVariant === "external" && resumeState.workflowPhase === "research" && adjustedState.planWritten ? "report" : resumeState.workflowPhase;
+            streamRef.current?.updateMilestone(displayMilestone);
+          }
+          let modelChangedOnPhaseTransition = false;
           if (resumeState?.workflowPhase) {
             const newPhaseModel = resolveModelForPhase(
               resumeState.workflowPhase,
-              recipe,
               {
                 planningModel: options.planningModel,
                 executionModel: options.executionModel,
                 defaultModel: options.model
-              }
+              },
+              playbookMilestoneModels
             );
             if (newPhaseModel && newPhaseModel !== options.model) {
               options.model = newPhaseModel;
+              modelChangedOnPhaseTransition = true;
             }
           }
           if (state.recentActionKeys && state.recentActionKeys.length > 0) {
@@ -16485,7 +16861,11 @@ Saving state... done. Session saved to ${filePath}`);
               loopDetector.recordAction(key);
             }
           }
-          if (options.noSteer) return;
+          if (modelChangedOnPhaseTransition) {
+            shouldContinue = true;
+            return false;
+          }
+          if (options.noCheckpoint) return;
           if (state.status !== "running") return;
           if (!currentActions) return;
           const recap = {
@@ -16496,15 +16876,15 @@ Saving state... done. Session saved to ${filePath}`);
             cost: state.totalCost,
             outputPreview: adjustedState.lastOutput.slice(0, 100)
           };
-          const steeringResult = await currentActions.requestSteering(recap);
-          applySteeringConfig(steeringResult);
-          switch (steeringResult.action) {
+          const checkpointResult = await currentActions.requestCheckpoint(recap);
+          applyCheckpointConfig(checkpointResult);
+          switch (checkpointResult.action) {
             case "stop":
               return false;
             // Tells SDK to stop the loop
             case "steer":
-              if (steeringResult.message) {
-                taskMessage = steeringResult.message;
+              if (checkpointResult.message) {
+                taskMessage = checkpointResult.message;
                 shouldContinue = true;
                 return false;
               }
@@ -16577,6 +16957,9 @@ Saving state... done. Session saved to ${filePath}`);
         };
       }
       lastResult = result2;
+      if (result2.status === "complete") {
+        streamRef.current?.updateMilestone("complete");
+      }
       if (shouldContinue) {
         previousMessages = lastSessionMessages;
         continuationMessage = taskMessage;
@@ -16584,7 +16967,7 @@ Saving state... done. Session saved to ${filePath}`);
         resumeState = extractRunTaskResumeState(lastKnownState);
       }
       if (result2.status === "complete" || result2.status === "budget_exceeded" || result2.status === "max_sessions") {
-        if (options.noSteer) break;
+        if (options.noCheckpoint) break;
         const currentActions = streamRef.current;
         if (!currentActions) break;
         let exitTerminal = false;
@@ -16599,13 +16982,13 @@ Saving state... done. Session saved to ${filePath}`);
             cost: accumulatedCost,
             outputPreview: terminalPreview.slice(0, 100)
           };
-          const steeringResult = await currentActions.requestSteering(recap, true);
-          applySteeringConfig(steeringResult);
-          switch (steeringResult.action) {
+          const checkpointResult = await currentActions.requestCheckpoint(recap, true);
+          applyCheckpointConfig(checkpointResult);
+          switch (checkpointResult.action) {
             case "steer":
-              if (steeringResult.message) {
+              if (checkpointResult.message) {
                 currentActions.resetForNewSession();
-                taskMessage = steeringResult.message;
+                taskMessage = checkpointResult.message;
                 previousMessages = lastSessionMessages;
                 continuationMessage = taskMessage;
                 useCompact = false;
@@ -16615,7 +16998,7 @@ Saving state... done. Session saved to ${filePath}`);
               exitTerminal = true;
               break;
             case "continue":
-              if (steeringHasConfigChanges(steeringResult)) {
+              if (checkpointHasConfigChanges(checkpointResult)) {
                 break;
               }
               currentActions.exit();
@@ -16860,7 +17243,7 @@ function detectDeployWorkflow(message, sandboxProvider, resumeState) {
   return void 0;
 }
 function applyTaskOptions(cmd) {
-  return cmd.argument("<agent>", "Agent ID or name").option("-g, --goal <text>", "Goal message for the agent").option("--max-sessions <n>", "Maximum sessions", "50").option("--max-cost <n>", "Budget in USD").option("--model <modelId>", "Model ID to use (overrides agent config)").option("--name <name>", "Task name (used for state file, defaults to agent name)").option("--session <name>", "Resume a specific session by name").option("--state-dir <path>", "Directory for state files (default: ~/.runtype/projects/<hash>/marathons/)").option("--resume [message]", "Resume from existing local state, optionally with a new message").option("--fresh", "Start a new run and ignore any existing local state for this task").option("--compact", "Force compact-summary resume mode instead of replaying full history").option("--compact-strategy <strategy>", "Compaction strategy: auto (default), provider_native, or summary_fallback").option("--compact-threshold <value>", "Auto-compact when estimated context crosses this threshold (default: 80% fallback, 90% native; accepts percent like 90% or absolute token count like 120000)").option("--compact-instructions <text>", "Extra instructions for what a compact summary must preserve").option("--no-auto-compact", "Disable automatic context-aware history compaction").option("--track", "Sync progress to a Runtype record (visible in dashboard)").option("--debug", "Show debug output from each session").option("--json", "Output final result as JSON").option("--sandbox <provider>", "Enable sandbox code execution tool (cloudflare-worker, quickjs, or daytona)").option("--no-local-tools", "Disable built-in local tool execution (read_file, write_file, list_directory)").option("-t, --tools <tools...>", "Enable built-in tools (e.g., exa, firecrawl, dalle, openai_web_search, anthropic_web_search)").option("--plain-text", "Disable markdown rendering in output").option("--no-steer", "Run all iterations without steering pauses (fully autonomous)").option("--steer-timeout <seconds>", "Auto-continue timeout in seconds (default: 10)", "10").option("--planning-model <modelId>", "Model to use during research/planning phases").option("--execution-model <modelId>", "Model to use during execution phase").option("--recipe <name>", "Load a workflow recipe from .marathon/recipes/").option("--offload-threshold <chars>", 'Offload tool outputs larger than this to files (default: 100000; use "off" or "0" to disable guardrails)').option("--tool-context <mode>", "Tool result storage: hot-tail (default), observation-mask, or full-inline").option("--tool-window <window>", 'Compaction window: "session" (default) or a number for last-N tool results (e.g. 10)').option("--runner-char <char>", "Custom runner emoji (default: \u{1F3C3})").option("--finish-char <char>", "Custom finish line emoji (default: \u{1F3C1})").option("--no-runner", "Hide the runner emoji from the header border").option("--no-finish", "Hide the finish line emoji from the header border").action(taskAction);
+  return cmd.argument("<agent>", "Agent ID or name").option("-g, --goal <text>", "Goal message for the agent").option("--max-sessions <n>", "Maximum sessions", "50").option("--max-cost <n>", "Budget in USD").option("--model <modelId>", "Model ID to use (overrides agent config)").option("--name <name>", "Task name (used for state file, defaults to agent name)").option("--session <name>", "Resume a specific session by name").option("--state-dir <path>", "Directory for state files (default: ~/.runtype/projects/<hash>/marathons/)").option("--resume [message]", "Resume from existing local state, optionally with a new message").option("--fresh", "Start a new run and ignore any existing local state for this task").option("--compact", "Force compact-summary resume mode instead of replaying full history").option("--compact-strategy <strategy>", "Compaction strategy: auto (default), provider_native, or summary_fallback").option("--compact-threshold <value>", "Auto-compact when estimated context crosses this threshold (default: 80% fallback, 90% native; accepts percent like 90% or absolute token count like 120000)").option("--compact-instructions <text>", "Extra instructions for what a compact summary must preserve").option("--no-auto-compact", "Disable automatic context-aware history compaction").option("--track", "Sync progress to a Runtype record (visible in dashboard)").option("--debug", "Show debug output from each session").option("--json", "Output final result as JSON").option("--sandbox <provider>", "Enable sandbox code execution tool (cloudflare-worker, quickjs, or daytona)").option("--no-local-tools", "Disable built-in local tool execution (read_file, write_file, list_directory)").option("-t, --tools <tools...>", "Enable built-in tools (e.g., exa, firecrawl, dalle, openai_web_search, anthropic_web_search)").option("--plain-text", "Disable markdown rendering in output").option("--no-checkpoint", "Run all iterations without checkpoint pauses (fully autonomous)").option("--checkpoint-timeout <seconds>", "Auto-continue timeout in seconds (default: 10)", "10").option("--planning-model <modelId>", "Model to use during research/planning phases").option("--execution-model <modelId>", "Model to use during execution phase").option("--playbook <name>", "Load a playbook from .runtype/marathons/playbooks/").option("--offload-threshold <chars>", 'Offload tool outputs larger than this to files (default: 100000; use "off" or "0" to disable guardrails)').option("--tool-context <mode>", "Tool result storage: hot-tail (default), observation-mask, or full-inline").option("--tool-window <window>", 'Compaction window: "session" (default) or a number for last-N tool results (e.g. 10)').option("--runner-char <char>", "Custom runner emoji (default: \u{1F3C3})").option("--finish-char <char>", "Custom finish line emoji (default: \u{1F3C1})").option("--no-runner", "Hide the runner emoji from the header border").option("--no-finish", "Hide the finish line emoji from the header border").action(taskAction);
 }
 var taskCommand = applyTaskOptions(
   new Command10("task").description("Run a multi-session agent task")
@@ -17783,14 +18166,14 @@ import React13 from "react";
 import { render as render13 } from "ink";
 import { useState as useState27, useEffect as useEffect25 } from "react";
 import { Text as Text30 } from "ink";
-import { readFileSync as readFileSync12 } from "fs";
+import { readFileSync as readFileSync13 } from "fs";
 var evalCommand = new Command14("eval").description("Manage evaluations");
 evalCommand.command("submit").description("Submit an eval batch").requiredOption("-f, --flow <id>", "Flow ID to evaluate").requiredOption("-r, --records <file>", "JSON file with record IDs").option("-n, --name <name>", "Eval batch name").option("--json", "Output as JSON").option("--tty", "Force TTY mode").option("--no-tty", "Force non-TTY mode").action(async (options) => {
   const apiKey = await ensureAuth();
   if (!apiKey) return;
   let recordIds;
   try {
-    const content = readFileSync12(options.records, "utf-8");
+    const content = readFileSync13(options.records, "utf-8");
     const parsed = JSON.parse(content);
     recordIds = Array.isArray(parsed) ? parsed : parsed.recordIds || parsed.records || [];
   } catch (error) {
@@ -18348,13 +18731,13 @@ apiKeysCommand.command("delete <id>").description("Delete an API key").option("-
     await waitUntilExit2();
     return;
   }
-  const confirmed = await new Promise((resolve6) => {
+  const confirmed = await new Promise((resolve7) => {
     const { unmount } = render14(
       React14.createElement(ConfirmPrompt, {
         message: `Delete API key ${id}?`,
         defaultValue: false,
         onConfirm: (result) => {
-          resolve6(result);
+          resolve7(result);
           unmount();
         }
       })
@@ -18459,8 +18842,8 @@ apiKeysCommand.command("analytics").description("Show API key usage analytics").
   const client = new ApiClient(apiKey);
   if (!isTTY(options) || options.json) {
     try {
-      const path11 = options.key ? `/api-keys/${options.key}/analytics` : "/api-keys/analytics";
-      const data = await client.get(path11);
+      const path13 = options.key ? `/api-keys/${options.key}/analytics` : "/api-keys/analytics";
+      const data = await client.get(path13);
       printJson(data);
     } catch (error) {
       const message = error instanceof Error ? error.message : "Unknown error";
@@ -18477,8 +18860,8 @@ apiKeysCommand.command("analytics").description("Show API key usage analytics").
     useEffect26(() => {
       const run = async () => {
         try {
-          const path11 = options.key ? `/api-keys/${options.key}/analytics` : "/api-keys/analytics";
-          const data = await client.get(path11);
+          const path13 = options.key ? `/api-keys/${options.key}/analytics` : "/api-keys/analytics";
+          const data = await client.get(path13);
           printJson(data);
           setSuccess(true);
           setLoading(false);
@@ -19264,6 +19647,7 @@ function maybeNotifyAboutCliUpdate(args, options = {}) {
 
 // src/index.ts
 loadEnv();
+setCliTitle();
 var program = new Command19();
 program.name("runtype").description("CLI for Runtype AI Platform").version(getCliVersion()).option("-v, --verbose", "Enable verbose output").option("--api-url <url>", "Override API URL").option("--json", "Output in JSON format");
 program.addCommand(initCommand);