@contentful/experience-design-system-cli 2.37.1-dev-build-2eb3abd8.0 → 2.37.1-dev-build-9d1e87d0.0

package/dist/app.js

@@ -837,7 +837,7 @@ async function runAgent(options) {
     promptLen: prompt.length,
     promptHead: prompt.slice(0, 500)
   });
-  return new Promise((resolve27) => {
+  return new Promise((resolve28) => {
     const bedrockEnv = bedrock ? BEDROCK_ENV_BY_AGENT[agent] : void 0;
     const child = spawn(binary, args, {
       stdio: ["pipe", "pipe", "pipe"],
@@ -886,7 +886,7 @@ async function runAgent(options) {
         stderrLen: stderr.length,
         stderrTail: stderr.slice(-1e3)
       });
-      resolve27(result);
+      resolve28(result);
     });
   });
 }
@@ -908,7 +908,7 @@ async function checkAgentAuth(agent) {
     return "not-found";
   if (agent !== "claude")
     return "ok";
-  return new Promise((resolve27) => {
+  return new Promise((resolve28) => {
     const child = spawn2(binary, ["auth", "status", "--json"], { stdio: ["ignore", "pipe", "pipe"] });
     let stdout = "";
     let done = false;
@@ -917,7 +917,7 @@ async function checkAgentAuth(agent) {
         return;
       done = true;
       child.kill("SIGTERM");
-      resolve27("unauthenticated");
+      resolve28("unauthenticated");
     }, 5e3);
     child.stdout?.on("data", (chunk) => {
       stdout += chunk.toString();
@@ -928,14 +928,14 @@ async function checkAgentAuth(agent) {
       done = true;
       clearTimeout(timer);
       if (code !== 0) {
-        resolve27("unauthenticated");
+        resolve28("unauthenticated");
         return;
       }
       try {
         const status = JSON.parse(stdout);
-        resolve27(status.loggedIn ? "ok" : "unauthenticated");
+        resolve28(status.loggedIn ? "ok" : "unauthenticated");
       } catch {
-        resolve27("unauthenticated");
+        resolve28("unauthenticated");
       }
     });
   });
@@ -945,9 +945,9 @@ async function binaryIsOnPath(binary) {
     const fs = await import("node:fs/promises");
     return fs.access(binary).then(() => true, () => false);
   }
-  return new Promise((resolve27) => {
+  return new Promise((resolve28) => {
     const child = spawn2(process.platform === "win32" ? "where" : "which", [binary], { stdio: "ignore" });
-    child.on("close", (code) => resolve27(code === 0));
+    child.on("close", (code) => resolve28(code === 0));
   });
 }
 var init_check_agent_auth = __esm({
@@ -2329,8 +2329,8 @@ var init_debug_store = __esm({
 });
 
 // packages/experience-design-system-cli/app.tsx
-import { join as join25 } from "node:path";
-import { useEffect as useEffect25, useState as useState32 } from "react";
+import { join as join26 } from "node:path";
+import { useEffect as useEffect28, useState as useState37 } from "react";
 
 // packages/experience-design-system-cli/src/tui/home/home.tsx
 import { useEffect as useEffect2, useState as useState2 } from "react";
@@ -2431,17 +2431,18 @@ var SUBTITLE = "Let's import your design system into Contentful";
 var MIN_TERMINAL_WIDTH = 164;
 var START_ITEMS = [
   { label: "Import", screen: "import" },
+  { label: "Upgrade Version", screen: "upgrade" },
   { label: "Settings", screen: "settings" },
   { label: "Help", screen: "help" }
 ];
-function versionStatus(upgradeCheck) {
+function upgradeItemDisplay(upgradeCheck) {
   if (upgradeCheck?.status === "update-available") {
-    return { text: ` (upgrade available v${upgradeCheck.latest})`, color: PALETTE.warning };
+    return { label: `Upgrade Version (v${upgradeCheck.latest} available)`, color: PALETTE.warning };
   }
   if (upgradeCheck?.status === "up-to-date") {
-    return { text: " (up to date)", color: PALETTE.muted };
+    return { label: "Upgrade Version (up to date)", color: PALETTE.muted };
   }
-  return void 0;
+  return { label: "Upgrade Version" };
 }
 function HomeScreen({ onNavigate }) {
   const [focusIdx, setFocusIdx] = useState2(0);
@@ -2449,7 +2450,7 @@ function HomeScreen({ onNavigate }) {
   const { exit } = useApp();
   const terminalWidth = useTerminalWidth();
   const tooNarrow = terminalWidth < MIN_TERMINAL_WIDTH;
-  const status = versionStatus(upgradeCheck);
+  const upgradeDisabled = upgradeCheck?.status === "up-to-date";
   useEffect2(() => {
     checkForUpgrade().then(setUpgradeCheck).catch(() => setUpgradeCheck({ status: "error" }));
   }, []);
@@ -2469,6 +2470,7 @@ function HomeScreen({ onNavigate }) {
     }
     if (key.return) {
       const item = START_ITEMS[focusIdx];
+      if (item.screen === "upgrade" && upgradeDisabled) return;
       onNavigate(item.screen);
       return;
     }
@@ -2486,16 +2488,26 @@ function HomeScreen({ onNavigate }) {
       /* @__PURE__ */ jsx2(Text2, { color: PALETTE.muted, children: SUBTITLE }),
       /* @__PURE__ */ jsxs(Text2, { color: PALETTE.muted, children: [
         "v",
-        VERSION,
-        status && /* @__PURE__ */ jsx2(Text2, { color: status.color, children: status.text })
+        VERSION
       ] })
     ] }),
     /* @__PURE__ */ jsx2(Box, { marginTop: 1, justifyContent: "center", children: /* @__PURE__ */ jsx2(Box, { flexDirection: "column", children: START_ITEMS.map((item, i) => {
       const focused = i === focusIdx;
-      return /* @__PURE__ */ jsxs(Text2, { bold: focused, color: focused ? PALETTE.accent : void 0, children: [
-        focused ? `${FOCUS_MARKER} ` : "  ",
+      const isUpgradeItem = item.screen === "upgrade";
+      const display = isUpgradeItem ? upgradeItemDisplay(upgradeCheck) : { label: item.label };
+      const dimmed = isUpgradeItem && upgradeDisabled;
+      return /* @__PURE__ */ jsxs(
+        Text2,
+        {
+          bold: focused && !dimmed,
+          color: dimmed ? PALETTE.muted : focused ? PALETTE.accent : display.color,
+          children: [
+            focused ? `${FOCUS_MARKER} ` : "  ",
+            display.label
+          ]
+        },
         item.label
-      ] }, item.label);
+      );
     }) }) }),
     /* @__PURE__ */ jsx2(Box, { marginTop: 1, justifyContent: "center", children: /* @__PURE__ */ jsx2(
       ControlHints,
@@ -8441,10 +8453,10 @@ function extractVueSlotsFromSetup(options) {
   if (!body)
     return [];
   const slotsByName = /* @__PURE__ */ new Map();
-  for (const access6 of body.getDescendantsOfKind(SyntaxKind5.PropertyAccessExpression)) {
-    if (access6.getExpression().getText() !== slotsName)
+  for (const access7 of body.getDescendantsOfKind(SyntaxKind5.PropertyAccessExpression)) {
+    if (access7.getExpression().getText() !== slotsName)
       continue;
-    const slotName = access6.getName();
+    const slotName = access7.getName();
     if (!slotsByName.has(slotName)) {
       slotsByName.set(slotName, {
         name: slotName,
@@ -13834,7 +13846,7 @@ function errorMessage(error) {
   return error instanceof Error && error.message ? error.message : String(error);
 }
 function defaultSleep(delayMs) {
-  return new Promise((resolve27) => setTimeout(resolve27, delayMs));
+  return new Promise((resolve28) => setTimeout(resolve28, delayMs));
 }
 
 // packages/experience-design-system-backend-pipeline/dist/src/steps/apply/src/helpers/sanitize-preview.js
@@ -14075,7 +14087,7 @@ var ApiClient = class {
         const progress = maxAttempts > 1 ? attempt / (maxAttempts - 1) : 0;
         const baseDelay = intervalMs + (maxIntervalMs - intervalMs) * progress;
         const jitter = Math.random() * baseDelay * 0.15;
-        await new Promise((resolve27) => setTimeout(resolve27, baseDelay + jitter));
+        await new Promise((resolve28) => setTimeout(resolve28, baseDelay + jitter));
       }
     }
     throw new Error(`Operation ${operationId} timed out after ${maxAttempts} attempts`);
@@ -14560,6 +14572,7 @@ function readTokensFromPath2(request) {
 init_agents();
 init_agent_name();
 init_models();
+init_binaries();
 init_is_agent_name();
 init_agent_supports_bedrock();
 init_check_agent_auth();
@@ -15118,11 +15131,11 @@ function setCommandContext(context) {
   mergeContext(state.pending.context, context);
   mergeContext(state.pending.completion, context);
 }
-function enrichCommandResult(fields) {
+function enrichCommandResult(fields2) {
   if (!state.pending)
     return;
-  Object.assign(state.pending.completion, fields);
-  mergeContext(state.pending.context, fields);
+  Object.assign(state.pending.completion, fields2);
+  mergeContext(state.pending.context, fields2);
 }
 
 // packages/experience-design-system-backend-pipeline/dist/src/analytics/os.js
@@ -16384,7 +16397,7 @@ async function retryDatabaseWrite(operation, attempts = 8) {
       const message = error instanceof Error ? error.message : String(error);
       if (!/database is locked|database is busy/i.test(message) || attempt >= attempts)
         throw error;
-      await new Promise((resolve27) => setTimeout(resolve27, Math.min(250 * attempt, 2e3)));
+      await new Promise((resolve28) => setTimeout(resolve28, Math.min(250 * attempt, 2e3)));
     }
   }
 }
@@ -22331,16 +22344,16 @@ function SlotRow({
   ] });
 }
 function propFields(prop) {
-  const fields = ["description", "required", "type"];
+  const fields2 = ["description", "required", "type"];
   if (prop.type === "token") {
-    fields.push("tokenKind");
+    fields2.push("tokenKind");
   }
-  if (prop.type === "enum") fields.push("values");
+  if (prop.type === "enum") fields2.push("values");
   if (prop.type !== "richtext" && prop.type !== "media" && prop.type !== "link") {
-    fields.push("default");
+    fields2.push("default");
   }
-  if (prop.type === "token" && prop.category === "design") fields.push("allowed");
-  return fields;
+  if (prop.type === "token" && prop.category === "design") fields2.push("allowed");
+  return fields2;
 }
 var SLOT_FIELDS = ["description", "required", "allowedComponents"];
 function simulateGraphWithCandidate(projectSlotGraph, selfName, currentSlots, targetSlotName, candidate) {
@@ -22879,8 +22892,8 @@ function FieldEditor({
       return;
     }
     if (focusLevel === "field") {
-      const fields = inSlots ? SLOT_FIELDS : currentProp ? propFields(currentProp) : [];
-      const currentFieldIdx = fields.indexOf(activeField);
+      const fields2 = inSlots ? SLOT_FIELDS : currentProp ? propFields(currentProp) : [];
+      const currentFieldIdx = fields2.indexOf(activeField);
       const isValuesNav = activeField === "values" || activeField === "allowedComponents";
       const arrowUp = key.upArrow;
       const arrowDown = key.downArrow;
@@ -22894,10 +22907,10 @@ function FieldEditor({
         const navPrevious = arrowUp || arrowLeft;
         const navNext = arrowDown || arrowRight || input === "j";
         const navBack = navPrevious || input === "k";
-        if ((navBack || navNext) && fields.length > 0) {
-          const lastIdx = fields.length - 1;
+        if ((navBack || navNext) && fields2.length > 0) {
+          const lastIdx = fields2.length - 1;
           const targetIdx = navNext ? currentFieldIdx >= lastIdx ? 0 : currentFieldIdx + 1 : currentFieldIdx <= 0 ? lastIdx : currentFieldIdx - 1;
-          const next = fields[targetIdx];
+          const next = fields2[targetIdx];
           setActiveField(next);
           if (next === "description") {
             const desc = inSlots ? currentSlot?.description ?? "" : currentProp?.description ?? "";
@@ -28018,7 +28031,7 @@ var realSaveDeps = () => ({
   writeFile: (path5, contents) => writeFile7(path5, contents),
   appendRun,
   buildSourceFingerprint,
-  sleep: (ms) => new Promise((resolve27) => setTimeout(resolve27, ms)),
+  sleep: (ms) => new Promise((resolve28) => setTimeout(resolve28, ms)),
   warn: (message) => process.stderr.write(message)
 });
 async function runPrintFiles(input, deps, onPatch) {
@@ -28408,12 +28421,44 @@ init_config();
 init_debug_store();
 init_debug_mode_store();
 init_version();
+
+// packages/experience-design-system-cli/src/tui/help/file-locations.ts
+import { join as join25, resolve as resolve27 } from "node:path";
+function describeFileLocations({
+  contentfulBaseDir,
+  debugModeEnabled,
+  currentSessionDir: currentSessionDir2
+}) {
+  if (!debugModeEnabled) {
+    return {
+      debugLogs: "none while Debug Mode is off",
+      importFiles: `${join25("<project>", ".contentful")}/ (tokens.json, components.json)`
+    };
+  }
+  const base = contentfulBaseDir ? resolve27(contentfulBaseDir) : "<project>";
+  const session = currentSessionDir2 ?? join25(base, ".contentful", "<date>-session-<n>");
+  return {
+    debugLogs: join25(session, "debug"),
+    importFiles: `${join25(session, "dsi-import-<n>")}/ (tokens.json, components.json)`
+  };
+}
+
+// packages/experience-design-system-cli/src/tui/help/help-info.ts
 async function readHelpInfo() {
-  const debugMode = await readDebugModeSetting();
+  const [debugMode, settings] = await Promise.all([readDebugModeSetting(), readSettings2()]);
+  const base = settings["contentfulBaseDir"];
+  const locations = describeFileLocations({
+    contentfulBaseDir: typeof base === "string" ? base : "",
+    debugModeEnabled: debugMode.enabled,
+    currentSessionDir: currentSessionDir()
+  });
   return {
     storage: [
       { label: "Config folder", value: configRoot2() },
-      { label: "Settings file", value: configFilePath2() }
+      { label: "Settings file", value: configFilePath2() },
+      { label: "Agent settings", value: `${configFilePath2()} (keys: agent, agentModel, agents)` },
+      { label: "Debug logs", value: locations.debugLogs },
+      { label: "Import files", value: locations.importFiles }
     ],
     troubleshooting: [
       { label: "CLI version", value: readPackageVersion() },
@@ -28434,7 +28479,7 @@ function Section({ title, rows }) {
   return /* @__PURE__ */ jsxs43(Box42, { flexDirection: "column", children: [
     /* @__PURE__ */ jsx53(Text44, { bold: true, color: PALETTE.accent, children: title }),
     rows.map((row) => /* @__PURE__ */ jsxs43(Box42, { gap: 1, children: [
-      /* @__PURE__ */ jsx53(Box42, { width: 14, flexShrink: 0, children: /* @__PURE__ */ jsx53(Text44, { color: PALETTE.muted, children: row.label }) }),
+      /* @__PURE__ */ jsx53(Box42, { width: 16, flexShrink: 0, children: /* @__PURE__ */ jsx53(Text44, { color: PALETTE.muted, children: row.label }) }),
       /* @__PURE__ */ jsx53(Text44, { children: row.value })
     ] }, row.label))
   ] });
@@ -28534,15 +28579,694 @@ function SettingsScreen({
 }
 
 // packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ContentfulConfigScreen.tsx
-import { useEffect as useEffect22, useState as useState29 } from "react";
-import { Box as Box44, Text as Text46, useInput as useInput11 } from "ink";
-import TextInput4 from "ink-text-input";
+import { useState as useState33 } from "react";
+import { Box as Box48, Text as Text51, useInput as useInput13 } from "ink";
+
+// packages/experience-design-system-cli/src/tui/settings/agents/AgentsScreen.tsx
+import { useEffect as useEffect23, useState as useState31 } from "react";
+import { Box as Box46, Text as Text49, useInput as useInput12 } from "ink";
+init_debug_store();
 
 // packages/experience-design-system-cli/src/tui/settings/utils/v1-store.ts
 init_config();
 var readV1Store = readSettings2;
 var writeV1Store = writeSettings2;
 
+// packages/experience-design-system-cli/src/tui/settings/agents/agent-store.ts
+var DEFAULT_AGENT3 = "claude";
+var AGENT_LABELS = {
+  claude: "Claude Code",
+  codex: "OpenAI Codex",
+  opencode: "OpenCode",
+  cursor: "Cursor",
+  copilot: "GitHub Copilot"
+};
+var asString = (value) => typeof value === "string" ? value : "";
+function emptyAgents() {
+  return Object.fromEntries(AGENT_NAMES.map((name) => [name, { model: "", binary: "" }]));
+}
+async function readAgentConfig() {
+  const store = await readV1Store();
+  const stored = asString(store["agent"]);
+  const defaultAgent = isAgentName(stored) ? stored : DEFAULT_AGENT3;
+  const agents = emptyAgents();
+  const saved = store["agents"];
+  if (saved && typeof saved === "object") {
+    for (const name of AGENT_NAMES) {
+      const entry = saved[name];
+      if (entry && typeof entry === "object") {
+        const fields2 = entry;
+        agents[name] = { model: asString(fields2["model"]), binary: asString(fields2["binary"]) };
+      }
+    }
+  }
+  const legacyModel = asString(store["agentModel"]);
+  if (legacyModel && !agents[defaultAgent].model)
+    agents[defaultAgent] = { ...agents[defaultAgent], model: legacyModel };
+  return { defaultAgent, agents };
+}
+async function writeAgentConfig(config) {
+  const existing = await readV1Store();
+  const merged = { ...existing };
+  const agents = {};
+  for (const name of AGENT_NAMES) {
+    const model = config.agents[name].model.trim();
+    const binary = config.agents[name].binary.trim();
+    if (model || binary) agents[name] = { ...model ? { model } : {}, ...binary ? { binary } : {} };
+  }
+  merged["agent"] = config.defaultAgent;
+  const defaultModel = agents[config.defaultAgent]?.model;
+  if (defaultModel) merged["agentModel"] = defaultModel;
+  else delete merged["agentModel"];
+  if (Object.keys(agents).length > 0) merged["agents"] = agents;
+  else delete merged["agents"];
+  await writeV1Store(merged);
+}
+
+// packages/experience-design-system-cli/src/tui/settings/agents/agent-status.ts
+import { execFile as execFile2 } from "node:child_process";
+import { access as access6, constants } from "node:fs/promises";
+var VERSION_TIMEOUT_MS = 5e3;
+var PROMPT_TIMEOUT_MS = 6e4;
+var TEST_PROMPT = "Reply with the single word: ok";
+var INSTALL_HINTS = {
+  claude: "npm install -g @anthropic-ai/claude-code",
+  codex: "npm install -g @openai/codex",
+  opencode: "npm install -g opencode-ai",
+  cursor: "install Cursor\u2019s `cursor-agent` command",
+  copilot: "npm install -g @github/copilot"
+};
+var LOGIN_HINTS = {
+  claude: "run `claude login`",
+  codex: "set OPENAI_API_KEY, or sign in with a ChatGPT account",
+  opencode: "run `opencode auth`",
+  cursor: "sign in from Cursor",
+  copilot: "run `copilot` and sign in"
+};
+function effectiveBinary(name, savedBinary) {
+  return savedBinary.trim() || AGENT_BINARIES[name];
+}
+function defaultModelLabel(name) {
+  const model = DEFAULT_MODELS[name];
+  return model && model !== "Auto" ? model : "chosen by the agent";
+}
+var fail3 = (step, detail) => ({ step, ok: false, detail });
+var pass = (step, detail) => ({ step, ok: true, detail });
+function resolveOnPath(binary) {
+  if (binary.includes("/")) {
+    return access6(binary, constants.X_OK).then(
+      () => binary,
+      () => null
+    );
+  }
+  return new Promise((resolve28) => {
+    execFile2(
+      process.platform === "win32" ? "where" : "which",
+      [binary],
+      (error, stdout) => resolve28(error ? null : stdout.split("\n")[0]?.trim() ?? null)
+    );
+  });
+}
+function readVersion(binary) {
+  return new Promise((resolve28) => {
+    execFile2(binary, ["--version"], { timeout: VERSION_TIMEOUT_MS }, (error, stdout) => {
+      const line = stdout.split("\n")[0]?.trim() ?? "";
+      if (!error && line) resolve28(pass("version", line));
+      else resolve28(fail3("version", "runs, but did not report a version"));
+    });
+  });
+}
+async function inspect(name, binary) {
+  const target = effectiveBinary(name, binary);
+  const found = await resolveOnPath(target);
+  if (!found) return { checks: [fail3("path", `\`${target}\` was not found or is not executable`)], found: null };
+  const checks = [pass("path", found)];
+  checks.push(await readVersion(found));
+  if (name === "claude") {
+    const auth = await withBinaryEnv(name, found, () => checkAgentAuth(name));
+    checks.push(
+      auth === "ok" ? pass("login", "logged in") : fail3("login", auth === "not-found" ? "binary not found" : `not logged in: ${LOGIN_HINTS.claude}`)
+    );
+  }
+  return { checks, found };
+}
+async function inspectAgent(name, binary) {
+  return (await inspect(name, binary)).checks;
+}
+async function testAgent(name, binary, model) {
+  const { checks, found } = await inspect(name, binary);
+  if (!found || !checks.every((check) => check.step === "version" || check.ok)) return checks;
+  const started = Date.now();
+  const result = await withBinaryEnv(
+    name,
+    found,
+    () => createLocalCliAgentInvoker().invoke({
+      agent: name,
+      ...model.trim() ? { model: model.trim() } : {},
+      prompt: TEST_PROMPT,
+      timeoutMs: PROMPT_TIMEOUT_MS
+    })
+  );
+  const seconds = ((Date.now() - started) / 1e3).toFixed(1);
+  if (result.timedOut) {
+    return [...checks, { ...fail3("prompt", `no answer within ${PROMPT_TIMEOUT_MS / 1e3}s`), timedOut: true }];
+  }
+  if (result.exitCode !== 0) {
+    const reason = result.stderr.trim().split("\n").pop()?.slice(0, 160) || `exited with code ${result.exitCode}`;
+    return [...checks, fail3("prompt", reason)];
+  }
+  return [...checks, pass("prompt", `answered in ${seconds}s`)];
+}
+function statusFromChecks(name, checks, savedBinary) {
+  if (checks.length === 0) return "checking";
+  if (checks.some((check) => check.step === "path" && !check.ok)) {
+    return savedBinary.trim() ? "not-found" : "not-configured";
+  }
+  const prompt = checks.find((check) => check.step === "prompt");
+  if (prompt) {
+    if (prompt.ok) return "ready";
+    return prompt.timedOut ? "timed-out" : "test-failed";
+  }
+  const login = checks.find((check) => check.step === "login");
+  if (login) return login.ok ? "ready" : "not-logged-in";
+  return name === "claude" ? "ready" : "unknown";
+}
+function setupHint(name, status) {
+  if (status === "not-configured") return `${INSTALL_HINTS[name]}, or set its command path in settings`;
+  if (status === "not-found") return `${INSTALL_HINTS[name]}, or correct the command path in settings`;
+  if (status === "not-logged-in") return LOGIN_HINTS[name];
+  if (status === "test-failed") return `read the test message; if it is a login problem, ${LOGIN_HINTS[name]}`;
+  if (status === "timed-out") return "it may be slow or waiting for input; run the test again, or try it in a terminal";
+  if (status === "unknown") return "run a full test to confirm it is logged in";
+  return "";
+}
+function testOutcome(checks) {
+  const prompt = checks?.find((check) => check.step === "prompt");
+  if (!prompt) return void 0;
+  if (prompt.ok) return { ok: true, text: `Test passed: ${prompt.detail}` };
+  if (prompt.timedOut) return { ok: false, text: `Test timed out: ${prompt.detail}` };
+  return { ok: false, text: `Test failed: ${prompt.detail}` };
+}
+var LIST_STATUS = {
+  checking: { symbol: "\u2026", text: "checking", tone: "muted" },
+  ready: { symbol: "\u25CF", text: "ready", tone: "ok" },
+  "not-configured": { symbol: "\u25CB", text: "not installed", tone: "muted" },
+  "not-found": { symbol: "\u25CB", text: "not installed", tone: "bad" },
+  "not-logged-in": { symbol: "\u25D0", text: "not logged in", tone: "bad" },
+  "test-failed": { symbol: "\u2717", text: "test failed", tone: "bad" },
+  "timed-out": { symbol: "\u2717", text: "test timed out", tone: "bad" },
+  unknown: { symbol: "\u25D0", text: "installed, login unknown", tone: "muted" }
+};
+function modelLine(name, savedModel) {
+  const model = savedModel.trim();
+  return model ? model : `${defaultModelLabel(name)} (built-in default)`;
+}
+function baseRows(name, checks, savedBinary) {
+  const path5 = checks.find((check) => check.step === "path");
+  const version = checks.find((check) => check.step === "version");
+  const hint = setupHint(name, statusFromChecks(name, checks, savedBinary));
+  const setup = hint ? { label: "Setup", value: hint, tone: "muted" } : void 0;
+  if (!path5?.ok) {
+    const saved = savedBinary.trim() !== "";
+    const command = {
+      label: "Command",
+      value: saved ? path5?.detail ?? "not found" : "not configured (not on the PATH)",
+      tone: saved ? "bad" : "muted"
+    };
+    return { command, version: void 0, setup, found: false };
+  }
+  return {
+    command: { label: "Command", value: path5.detail, tone: "ok" },
+    version: {
+      label: "Version",
+      value: version?.ok ? version.detail : "could not be read",
+      tone: version?.ok ? "ok" : "muted"
+    },
+    setup,
+    found: true
+  };
+}
+var checking = [{ label: "Command", value: "checking...", tone: "muted" }];
+function panelRows(name, checks, settings) {
+  if (!checks) return checking;
+  const { command, version, setup, found } = baseRows(name, checks, settings.binary);
+  const model = { label: "Model", value: modelLine(name, settings.model), tone: "muted" };
+  return [command, ...found ? [...version?.tone === "ok" ? [version] : [], model] : [], ...setup ? [setup] : []];
+}
+function statusRows(name, checks, savedBinary) {
+  if (!checks) return checking;
+  const { command, version, setup, found } = baseRows(name, checks, savedBinary);
+  if (!found) return [command];
+  const login = checks.find((check) => check.step === "login");
+  const prompt = checks.find((check) => check.step === "prompt");
+  let loginRow;
+  if (login) {
+    loginRow = { label: "Login", value: login.detail, tone: login.ok ? "ok" : "bad" };
+  } else if (prompt) {
+    loginRow = {
+      label: "Login",
+      value: prompt.ok ? "confirmed by the test" : prompt.timedOut ? "unknown (the test timed out)" : "see the test result",
+      tone: prompt.ok ? "ok" : prompt.timedOut ? "muted" : "bad"
+    };
+  } else {
+    loginRow = { label: "Login", value: "not checked (use Run test)", tone: "muted" };
+  }
+  const testRow = prompt ? [{ label: "Test", value: prompt.detail, tone: prompt.ok ? "ok" : "bad" }] : [];
+  return [command, ...version ? [version] : [], loginRow, ...testRow, ...setup ? [setup] : []];
+}
+async function withBinaryEnv(name, binary, run) {
+  const key = `EDS_AGENT_BINARY_${name.toUpperCase()}`;
+  const previous = process.env[key];
+  process.env[key] = binary;
+  try {
+    return await run();
+  } finally {
+    if (previous === void 0) delete process.env[key];
+    else process.env[key] = previous;
+  }
+}
+
+// packages/experience-design-system-cli/src/tui/settings/agents/AgentDetail.tsx
+import { useEffect as useEffect22, useState as useState30 } from "react";
+import { Box as Box45, Text as Text48 } from "ink";
+
+// packages/experience-design-system-cli/src/tui/settings/shared/FieldForm.tsx
+import { useState as useState29 } from "react";
+import { Box as Box44, Text as Text46, useInput as useInput11 } from "ink";
+import TextInput4 from "ink-text-input";
+import { Fragment as Fragment17, jsx as jsx55, jsxs as jsxs45 } from "react/jsx-runtime";
+function FieldForm({
+  title,
+  subtitle,
+  fields: fields2,
+  values,
+  onChange,
+  onSave,
+  onQuit,
+  actions = [],
+  notice,
+  busy = false,
+  children
+}) {
+  const [active, setActive] = useState29(0);
+  const [editing, setEditing] = useState29(false);
+  const [valueBeforeEdit, setValueBeforeEdit] = useState29("");
+  const rowCount = fields2.length + actions.length;
+  const labelWidth = Math.max(
+    ...fields2.map((field) => field.label.length),
+    ...actions.map((action) => action.label.length)
+  );
+  const currentField = active < fields2.length ? fields2[active] : void 0;
+  const currentAction = currentField ? void 0 : actions[active - fields2.length];
+  useInput11((input, key) => {
+    if (busy) return;
+    if (editing) {
+      if (key.escape && currentField) {
+        onChange(currentField.key, valueBeforeEdit);
+        setEditing(false);
+      }
+      return;
+    }
+    if (key.escape || input === "q") {
+      onQuit();
+      return;
+    }
+    if (input === "s") {
+      onSave();
+      return;
+    }
+    if (input === "c" && currentField) {
+      onChange(currentField.key, "");
+      return;
+    }
+    if (key.tab || key.downArrow) {
+      setActive((i) => (i + 1) % rowCount);
+      return;
+    }
+    if (key.upArrow) {
+      setActive((i) => (i - 1 + rowCount) % rowCount);
+      return;
+    }
+    if (key.return) {
+      if (currentField) {
+        setValueBeforeEdit(values[currentField.key]);
+        setEditing(true);
+      } else {
+        currentAction?.onRun();
+      }
+    }
+  });
+  const pointer = (isActive) => /* @__PURE__ */ jsx55(Text46, { color: isActive ? PALETTE.accent : void 0, children: isActive ? "\u276F" : " " });
+  return /* @__PURE__ */ jsxs45(Box44, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx55(Text46, { bold: true, children: title }),
+    subtitle && /* @__PURE__ */ jsx55(Text46, { color: PALETTE.muted, children: subtitle }),
+    /* @__PURE__ */ jsx55(Text46, { children: " " }),
+    /* @__PURE__ */ jsxs45(Box44, { flexDirection: "column", children: [
+      fields2.map((field, index) => {
+        const isActive = index === active;
+        const value = values[field.key];
+        const display = field.masked ? "\u2022".repeat(value.length) : value;
+        return /* @__PURE__ */ jsxs45(Box44, { gap: 1, children: [
+          pointer(isActive),
+          /* @__PURE__ */ jsx55(Box44, { width: labelWidth, flexShrink: 0, children: /* @__PURE__ */ jsx55(Text46, { bold: isActive, color: isActive ? PALETTE.accent : PALETTE.muted, children: field.label }) }),
+          isActive && editing ? /* @__PURE__ */ jsx55(
+            TextInput4,
+            {
+              value,
+              onChange: (next) => onChange(field.key, next),
+              onSubmit: () => setEditing(false),
+              mask: field.masked ? "\u2022" : void 0
+            }
+          ) : /* @__PURE__ */ jsx55(Text46, { bold: !!display, children: display || (field.hint ? "" : /* @__PURE__ */ jsx55(Text46, { color: PALETTE.muted, children: "(empty)" })) }),
+          field.hint && /* @__PURE__ */ jsx55(Text46, { color: PALETTE.muted, children: field.hint })
+        ] }, field.key);
+      }),
+      actions.map((action, index) => {
+        const isActive = fields2.length + index === active;
+        return /* @__PURE__ */ jsxs45(Box44, { gap: 1, children: [
+          pointer(isActive),
+          /* @__PURE__ */ jsx55(Box44, { width: labelWidth, flexShrink: 0, children: /* @__PURE__ */ jsx55(Text46, { bold: isActive, color: isActive ? PALETTE.accent : PALETTE.muted, children: action.label }) }),
+          /* @__PURE__ */ jsx55(Text46, { color: action.running ? PALETTE.accent : PALETTE.muted, children: action.running ? action.runningText ?? "running..." : action.description })
+        ] }, action.label);
+      })
+    ] }),
+    notice && /* @__PURE__ */ jsxs45(Fragment17, { children: [
+      /* @__PURE__ */ jsx55(Text46, { children: " " }),
+      /* @__PURE__ */ jsxs45(Text46, { color: notice.kind === "success" ? PALETTE.success : PALETTE.error, children: [
+        notice.kind === "success" ? "\u2713" : "\u2717",
+        " ",
+        notice.text
+      ] })
+    ] }),
+    children,
+    /* @__PURE__ */ jsx55(Text46, { children: " " }),
+    /* @__PURE__ */ jsx55(
+      ControlHints,
+      {
+        hints: editing ? [
+          { keys: "type", label: "edit" },
+          { keys: "\u2190/\u2192", label: "move cursor" },
+          { keys: "\u23CE", label: "done" },
+          { keys: "Esc", label: "cancel edit" }
+        ] : [
+          { keys: "\u2191/\u2193", label: "move" },
+          { keys: "\u23CE", label: currentAction ? currentAction.hint : "edit" },
+          ...currentField ? [{ keys: "c", label: "clear" }] : [],
+          { keys: "s", label: "save" },
+          { keys: "Esc/q", label: "back without saving" }
+        ]
+      }
+    )
+  ] });
+}
+
+// packages/experience-design-system-cli/src/tui/settings/agents/AgentStatusBadge.tsx
+import { Text as Text47 } from "ink";
+import { jsx as jsx56 } from "react/jsx-runtime";
+var TONE_COLOR = {
+  ok: PALETTE.success,
+  bad: PALETTE.error,
+  muted: PALETTE.muted
+};
+function AgentStatusBadge({
+  name,
+  checks,
+  binary
+}) {
+  const { symbol, text, tone } = LIST_STATUS[checks ? statusFromChecks(name, checks, binary) : "checking"];
+  return /* @__PURE__ */ jsx56(Text47, { color: TONE_COLOR[tone], children: `${symbol} ${text}` });
+}
+
+// packages/experience-design-system-cli/src/tui/settings/agents/apply-binary-overrides.ts
+var shellValues = /* @__PURE__ */ new Map();
+function applyBinaryOverrides(config) {
+  for (const name of AGENT_NAMES) {
+    const key = `EDS_AGENT_BINARY_${name.toUpperCase()}`;
+    const binary = config.agents[name].binary.trim();
+    if (binary) {
+      if (!shellValues.has(key)) shellValues.set(key, process.env[key]);
+      process.env[key] = binary;
+    } else if (shellValues.has(key)) {
+      const shellValue = shellValues.get(key);
+      if (shellValue === void 0) delete process.env[key];
+      else process.env[key] = shellValue;
+      shellValues.delete(key);
+    }
+  }
+}
+
+// packages/experience-design-system-cli/src/tui/settings/agents/AgentDetail.tsx
+import { jsx as jsx57, jsxs as jsxs46 } from "react/jsx-runtime";
+var fields = (name) => [
+  { key: "binary", label: "Command path", hint: `(empty: \`${AGENT_BINARIES[name]}\` from the PATH)` },
+  { key: "model", label: "Model", hint: `(empty: ${defaultModelLabel(name)})` }
+];
+var LABEL_WIDTH = "Command path".length;
+var LABEL_GAP = 2;
+var POINTER_WIDTH = 2;
+function Row2({ label, children }) {
+  return /* @__PURE__ */ jsxs46(Box45, { children: [
+    /* @__PURE__ */ jsx57(Box45, { width: POINTER_WIDTH + LABEL_WIDTH + LABEL_GAP, flexShrink: 0, children: /* @__PURE__ */ jsx57(Text48, { color: PALETTE.muted, children: label }) }),
+    children
+  ] });
+}
+function StatusHeading() {
+  return /* @__PURE__ */ jsxs46(Box45, { gap: 1, children: [
+    /* @__PURE__ */ jsx57(Text48, { bold: true, color: PALETTE.muted, children: "STATUS" }),
+    /* @__PURE__ */ jsx57(Text48, { color: PALETTE.muted, children: "\xB7 read only" })
+  ] });
+}
+function AgentDetail({
+  name,
+  config,
+  setConfig,
+  onBack
+}) {
+  const settings = config.agents[name];
+  const [saving, setSaving] = useState30(false);
+  const [testing, setTesting] = useState30(false);
+  const [notice, setNotice] = useState30(null);
+  const [checks, setChecks] = useState30(void 0);
+  useEffect22(() => {
+    let active = true;
+    setChecks(void 0);
+    void inspectAgent(name, settings.binary).then((result) => active && setChecks(result));
+    return () => {
+      active = false;
+    };
+  }, [name, settings.binary]);
+  const save = () => {
+    setSaving(true);
+    setNotice(null);
+    writeAgentConfig(config).then(() => {
+      applyBinaryOverrides(config);
+      setNotice({ kind: "success", text: `Saved: ${AGENT_LABELS[name]} settings are written to config.json` });
+    }).catch(
+      (err) => setNotice({ kind: "error", text: `Not saved: ${err instanceof Error ? err.message : String(err)}` })
+    ).finally(() => setSaving(false));
+  };
+  const runTest = () => {
+    setTesting(true);
+    setNotice(null);
+    testAgent(name, settings.binary, settings.model).then((result) => {
+      setChecks(result);
+      const outcome = testOutcome(result);
+      setNotice(
+        outcome ? { kind: outcome.ok ? "success" : "error", text: outcome.text } : { kind: "error", text: "Test not run: the agent could not be started (see Status)" }
+      );
+    }).catch(
+      (err) => setNotice({ kind: "error", text: `Test could not run: ${err instanceof Error ? err.message : String(err)}` })
+    ).finally(() => setTesting(false));
+  };
+  const action = {
+    label: "Run test",
+    description: "sends one small prompt (uses a few tokens)",
+    running: testing,
+    hint: "run test",
+    onRun: runTest
+  };
+  return /* @__PURE__ */ jsx57(
+    FieldForm,
+    {
+      title: AGENT_LABELS[name],
+      subtitle: config.defaultAgent === name ? "This is the default agent." : `Runs the \`${AGENT_BINARIES[name]}\` command.`,
+      fields: fields(name),
+      values: { binary: settings.binary, model: settings.model },
+      onChange: (key, value) => {
+        setConfig({ ...config, agents: { ...config.agents, [name]: { ...settings, [key]: value } } });
+        setNotice(null);
+      },
+      onSave: save,
+      onQuit: onBack,
+      actions: [action],
+      notice: testing ? null : notice,
+      busy: saving || testing,
+      children: /* @__PURE__ */ jsxs46(Box45, { flexDirection: "column", marginTop: 1, children: [
+        /* @__PURE__ */ jsx57(StatusHeading, {}),
+        statusRows(name, checks, settings.binary).map((row) => /* @__PURE__ */ jsx57(Row2, { label: row.label, children: /* @__PURE__ */ jsx57(Text48, { color: TONE_COLOR[row.tone], children: row.value }) }, row.label))
+      ] })
+    }
+  );
+}
+
+// packages/experience-design-system-cli/src/tui/settings/agents/AgentsScreen.tsx
+import { Fragment as Fragment18, jsx as jsx58, jsxs as jsxs47 } from "react/jsx-runtime";
+var NAME_WIDTH = 16;
+var PANEL_LABEL_WIDTH = "Command".length;
+function AgentsScreen({ onDone }) {
+  const [config, setConfig] = useState31(null);
+  const [focus, setFocus] = useState31(0);
+  const [open, setOpen] = useState31(null);
+  const [notice, setNotice] = useState31(null);
+  const [saving, setSaving] = useState31(false);
+  const [checks, setChecks] = useState31({});
+  const inspectAll = (loaded) => {
+    for (const name of AGENT_NAMES) {
+      void inspectAgent(name, loaded.agents[name].binary).then(
+        (result) => setChecks((previous) => ({ ...previous, [name]: result }))
+      );
+    }
+  };
+  useEffect23(() => {
+    void readAgentConfig().then((loaded) => {
+      setConfig(loaded);
+      inspectAll(loaded);
+      startDebugRun({
+        flow: "settings/agents",
+        step: "01-agents",
+        menuOption: "Configuration > Agents",
+        inputs: { default_agent: loaded.defaultAgent }
+      });
+    });
+  }, []);
+  const makeDefault = (name) => {
+    if (!config || saving) return;
+    if (name === config.defaultAgent) {
+      setNotice({ kind: "success", text: `${AGENT_LABELS[name]} is already the default agent` });
+      return;
+    }
+    setSaving(true);
+    setNotice(null);
+    writeAgentConfig({ ...config, defaultAgent: name }).then(() => {
+      setConfig((current) => current ? { ...current, defaultAgent: name } : current);
+      setNotice({ kind: "success", text: `Default agent is now ${AGENT_LABELS[name]}` });
+    }).catch(
+      (err) => setNotice({
+        kind: "error",
+        text: `Default agent not changed: ${err instanceof Error ? err.message : String(err)}`
+      })
+    ).finally(() => setSaving(false));
+  };
+  useInput12((input, key) => {
+    if (!config || open || saving) return;
+    const focused = AGENT_NAMES[focus];
+    if (key.upArrow || key.downArrow || key.tab) setNotice(null);
+    if (key.upArrow) {
+      setFocus((i) => (i - 1 + AGENT_NAMES.length) % AGENT_NAMES.length);
+      return;
+    }
+    if (key.downArrow || key.tab) {
+      setFocus((i) => (i + 1) % AGENT_NAMES.length);
+      return;
+    }
+    if (key.return) {
+      makeDefault(focused);
+      return;
+    }
+    if (key.rightArrow) {
+      setNotice(null);
+      setOpen(focused);
+      return;
+    }
+    if (key.escape || input === "q") {
+      void finishDebugRun({ outputs: { default_agent: config.defaultAgent }, status: "success", exitMethod: "saved" });
+      onDone();
+    }
+  });
+  if (!config) {
+    return /* @__PURE__ */ jsxs47(Box46, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+      /* @__PURE__ */ jsx58(Text49, { bold: true, children: "Agents" }),
+      /* @__PURE__ */ jsx58(Text49, { children: " " }),
+      /* @__PURE__ */ jsx58(Text49, { color: PALETTE.accent, children: "Loading..." })
+    ] });
+  }
+  if (open) {
+    return /* @__PURE__ */ jsx58(
+      AgentDetail,
+      {
+        name: open,
+        config,
+        setConfig,
+        onBack: () => {
+          setOpen(null);
+          void readAgentConfig().then((saved) => {
+            setConfig(saved);
+            inspectAll(saved);
+          });
+        }
+      }
+    );
+  }
+  const focusedAgent = AGENT_NAMES[focus];
+  return /* @__PURE__ */ jsxs47(Box46, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx58(Text49, { bold: true, children: "Agents" }),
+    /* @__PURE__ */ jsx58(Text49, { color: PALETTE.muted, children: "The coding agent the CLI runs, and what was found for each one." }),
+    /* @__PURE__ */ jsx58(Text49, { children: " " }),
+    /* @__PURE__ */ jsxs47(Box46, { gap: 1, children: [
+      /* @__PURE__ */ jsx58(Text49, { color: PALETTE.muted, children: "Default agent" }),
+      /* @__PURE__ */ jsx58(Text49, { bold: true, children: AGENT_LABELS[config.defaultAgent] }),
+      saving && /* @__PURE__ */ jsx58(Text49, { color: PALETTE.accent, children: "\u2026 saving" })
+    ] }),
+    /* @__PURE__ */ jsxs47(Box46, { marginTop: 1, gap: 1, children: [
+      /* @__PURE__ */ jsx58(Text49, { children: " " }),
+      /* @__PURE__ */ jsx58(Text49, { children: " " }),
+      /* @__PURE__ */ jsx58(Box46, { width: NAME_WIDTH, flexShrink: 0, children: /* @__PURE__ */ jsx58(Text49, { color: PALETTE.muted, children: "AGENT" }) }),
+      /* @__PURE__ */ jsx58(Text49, { color: PALETTE.muted, children: "STATUS" })
+    ] }),
+    AGENT_NAMES.map((name) => {
+      const isFocused = focusedAgent === name;
+      return /* @__PURE__ */ jsxs47(Box46, { gap: 1, children: [
+        /* @__PURE__ */ jsx58(Text49, { color: isFocused ? PALETTE.accent : void 0, children: isFocused ? "\u276F" : " " }),
+        /* @__PURE__ */ jsx58(Text49, { color: PALETTE.success, children: name === config.defaultAgent ? "\u2605" : " " }),
+        /* @__PURE__ */ jsx58(Box46, { width: NAME_WIDTH, flexShrink: 0, children: /* @__PURE__ */ jsx58(Text49, { bold: isFocused, color: isFocused ? PALETTE.accent : void 0, children: AGENT_LABELS[name] }) }),
+        /* @__PURE__ */ jsx58(AgentStatusBadge, { name, checks: checks[name], binary: config.agents[name].binary })
+      ] }, name);
+    }),
+    /* @__PURE__ */ jsxs47(Box46, { flexDirection: "column", marginTop: 1, children: [
+      /* @__PURE__ */ jsx58(Text49, { color: PALETTE.muted, children: `\u2500 ${AGENT_LABELS[focusedAgent]} ${"\u2500".repeat(30)}` }),
+      panelRows(focusedAgent, checks[focusedAgent], config.agents[focusedAgent]).map((row) => /* @__PURE__ */ jsxs47(Box46, { gap: 1, paddingLeft: 1, children: [
+        /* @__PURE__ */ jsx58(Box46, { width: PANEL_LABEL_WIDTH, flexShrink: 0, children: /* @__PURE__ */ jsx58(Text49, { color: PALETTE.muted, children: row.label }) }),
+        /* @__PURE__ */ jsx58(Text49, { color: TONE_COLOR[row.tone], children: row.value })
+      ] }, row.label))
+    ] }),
+    notice && /* @__PURE__ */ jsxs47(Fragment18, { children: [
+      /* @__PURE__ */ jsx58(Text49, { children: " " }),
+      /* @__PURE__ */ jsxs47(Text49, { bold: true, color: notice.kind === "success" ? PALETTE.success : PALETTE.error, children: [
+        notice.kind === "success" ? "\u2713" : "\u2717",
+        " ",
+        notice.text
+      ] })
+    ] }),
+    /* @__PURE__ */ jsx58(Text49, { children: " " }),
+    /* @__PURE__ */ jsx58(
+      ControlHints,
+      {
+        hints: [
+          { keys: "\u2191/\u2193", label: "move" },
+          { keys: "\u23CE", label: "make default" },
+          { keys: "\u2192", label: "settings and test" },
+          { keys: "Esc/q", label: "back" }
+        ]
+      }
+    )
+  ] });
+}
+
+// packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ProjectConfigScreen.tsx
+import { useEffect as useEffect24, useState as useState32 } from "react";
+import { Box as Box47, Text as Text50 } from "ink";
+init_debug_store();
+
 // packages/experience-design-system-cli/src/tui/settings/contentful-configuration/config-store.ts
 async function readCredentials() {
   const store = await readV1Store();
@@ -28568,17 +29292,16 @@ async function writeCredentials(config) {
   await writeV1Store(merged);
 }
 
-// packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ContentfulConfigScreen.tsx
-init_debug_store();
-import { Fragment as Fragment17, jsx as jsx55, jsxs as jsxs45 } from "react/jsx-runtime";
-var FIELD_ORDER = [
-  "spaceId",
-  "environmentId",
-  "cmaToken",
-  "host",
-  "defaultComponentDir",
-  "defaultTokenFile",
-  "contentfulBaseDir"
+// packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ProjectConfigScreen.tsx
+import { jsx as jsx59, jsxs as jsxs48 } from "react/jsx-runtime";
+var FIELDS2 = [
+  { key: "spaceId", label: "Space ID" },
+  { key: "environmentId", label: "Environment ID" },
+  { key: "cmaToken", label: "CMA Token", masked: true },
+  { key: "host", label: "API Host" },
+  { key: "defaultComponentDir", label: "Default component directory" },
+  { key: "defaultTokenFile", label: "Default token file" },
+  { key: "contentfulBaseDir", label: "Root Project Directory", hint: "(where .contentful goes)" }
 ];
 function debugFields(config) {
   return {
@@ -28591,156 +29314,114 @@ function debugFields(config) {
     contentful_base_dir: config?.contentfulBaseDir ?? ""
   };
 }
-var FIELD_LABELS = {
-  spaceId: "Space ID",
-  environmentId: "Environment ID",
-  cmaToken: "CMA Token",
-  host: "API Host",
-  defaultComponentDir: "Default component directory",
-  defaultTokenFile: "Default token file",
-  contentfulBaseDir: "Root Project Directory"
-};
-var FIELD_HINTS = {
-  contentfulBaseDir: "(where .contentful goes)"
-};
-var LABEL_WIDTH = Math.max(...Object.values(FIELD_LABELS).map((label) => label.length));
-function ConfigurationScreen({ onDone }) {
-  const [stage, setStage] = useState29("loading");
-  const [config, setConfig] = useState29(null);
-  const [activeField, setActiveField] = useState29("spaceId");
-  const [notice, setNotice] = useState29(null);
-  const [lastSaved, setLastSaved] = useState29(null);
-  const [editing, setEditing] = useState29(false);
-  const [valueBeforeEdit, setValueBeforeEdit] = useState29("");
-  useEffect22(() => {
-    readCredentials().then((cfg) => {
+var valuesOf = (config) => Object.fromEntries(FIELDS2.map(({ key }) => [key, config[key] || ""]));
+function ProjectConfigScreen({ onDone }) {
+  const [config, setConfig] = useState32(null);
+  const [saving, setSaving] = useState32(false);
+  const [notice, setNotice] = useState32(null);
+  const [lastSaved, setLastSaved] = useState32(null);
+  useEffect24(() => {
+    void readCredentials().then((cfg) => {
       setConfig(cfg);
-      setStage("form");
       startDebugRun({
         flow: "settings/contentful-configuration",
         step: "01-configuration",
-        menuOption: "Configuration",
+        menuOption: "Configuration > Project",
         inputs: debugFields(cfg)
       });
     });
   }, []);
-  function fieldValue(field) {
-    if (!config) return "";
-    return config[field] || "";
-  }
-  function setFieldValue(field, value) {
-    if (!config) return;
-    setConfig({ ...config, [field]: value });
-    setNotice(null);
+  if (!config) {
+    return /* @__PURE__ */ jsxs48(Box47, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+      /* @__PURE__ */ jsx59(Text50, { bold: true, children: "Project" }),
+      /* @__PURE__ */ jsx59(Text50, { children: " " }),
+      /* @__PURE__ */ jsx59(Text50, { color: PALETTE.accent, children: "Loading..." })
+    ] });
   }
-  function handleSave() {
-    if (!config) return;
-    setStage("saving");
+  const save = () => {
+    setSaving(true);
     setNotice(null);
     writeCredentials(config).then(() => {
       setLastSaved(config);
       if (config.contentfulBaseDir) void startDebugSessionIn(config.contentfulBaseDir, { replace: true });
-      setNotice({ kind: "success", text: "Configuration saved" });
-      setStage("form");
+      setNotice({ kind: "success", text: "Project settings saved" });
     }).catch((err) => {
       setNotice({ kind: "error", text: err instanceof Error ? err.message : "Failed to save" });
-      setStage("form");
-    });
-  }
-  function quit() {
+    }).finally(() => setSaving(false));
+  };
+  const quit = () => {
     void finishDebugRun(
       lastSaved ? { outputs: debugFields(lastSaved), status: "success", exitMethod: "saved" } : { outputs: {}, status: "success", exitMethod: "discarded" }
     );
     onDone();
-  }
-  useInput11((input, key) => {
-    if (stage === "loading" || stage === "saving") return;
-    if (editing) {
-      if (key.escape) {
-        setFieldValue(activeField, valueBeforeEdit);
-        setEditing(false);
-      }
-      return;
-    }
-    if (key.escape || input === "q") {
-      quit();
-      return;
-    }
-    if (input === "s") {
-      handleSave();
-      return;
-    }
-    if (input === "c") {
-      setFieldValue(activeField, "");
-      return;
+  };
+  return /* @__PURE__ */ jsx59(
+    FieldForm,
+    {
+      title: "Project",
+      subtitle: "The Contentful space and where the CLI keeps its files.",
+      fields: FIELDS2,
+      values: valuesOf(config),
+      onChange: (key, value) => {
+        setConfig({ ...config, [key]: value });
+        setNotice(null);
+      },
+      onSave: save,
+      onQuit: quit,
+      notice,
+      busy: saving
     }
-    if (key.tab || key.downArrow) {
-      const idx = FIELD_ORDER.indexOf(activeField);
-      setActiveField(FIELD_ORDER[(idx + 1) % FIELD_ORDER.length]);
+  );
+}
+
+// packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ContentfulConfigScreen.tsx
+import { jsx as jsx60, jsxs as jsxs49 } from "react/jsx-runtime";
+var SECTIONS = [
+  {
+    id: "project",
+    label: "Project",
+    description: "Contentful space, credentials, defaults and where .contentful goes"
+  },
+  { id: "agents", label: "Agents", description: "Which coding agent the CLI uses, and each agent\u2019s settings" }
+];
+function ConfigurationScreen({ onDone }) {
+  const [focus, setFocus] = useState33(0);
+  const [open, setOpen] = useState33(null);
+  const close = () => setOpen(null);
+  useInput13((input, key) => {
+    if (open) return;
+    if (key.upArrow) {
+      setFocus((i) => (i - 1 + SECTIONS.length) % SECTIONS.length);
       return;
     }
-    if (key.upArrow) {
-      const idx = FIELD_ORDER.indexOf(activeField);
-      setActiveField(FIELD_ORDER[(idx - 1 + FIELD_ORDER.length) % FIELD_ORDER.length]);
+    if (key.downArrow || key.tab) {
+      setFocus((i) => (i + 1) % SECTIONS.length);
       return;
     }
     if (key.return) {
-      setValueBeforeEdit(fieldValue(activeField));
-      setEditing(true);
+      setOpen(SECTIONS[focus].id);
+      return;
     }
+    if (key.escape || input === "q") onDone();
   });
-  if (stage === "loading") {
-    return /* @__PURE__ */ jsxs45(Box44, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-      /* @__PURE__ */ jsx55(Text46, { bold: true, children: "Configuration" }),
-      /* @__PURE__ */ jsx55(Text46, { children: " " }),
-      /* @__PURE__ */ jsx55(Text46, { color: PALETTE.accent, children: "Loading..." })
-    ] });
-  }
-  return /* @__PURE__ */ jsxs45(Box44, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx55(Text46, { bold: true, children: "Configuration" }),
-    /* @__PURE__ */ jsx55(Text46, { children: " " }),
-    /* @__PURE__ */ jsx55(Box44, { flexDirection: "column", children: FIELD_ORDER.map((field) => {
-      const isActive = activeField === field;
-      const value = fieldValue(field);
-      const display = field === "cmaToken" ? "\u2022".repeat(value.length) : value;
-      return /* @__PURE__ */ jsxs45(Box44, { gap: 1, children: [
-        /* @__PURE__ */ jsx55(Text46, { color: isActive ? PALETTE.accent : void 0, children: isActive ? "\u276F" : " " }),
-        /* @__PURE__ */ jsx55(Box44, { width: LABEL_WIDTH, flexShrink: 0, children: /* @__PURE__ */ jsx55(Text46, { bold: isActive, color: isActive ? PALETTE.accent : PALETTE.muted, children: FIELD_LABELS[field] }) }),
-        isActive && editing ? /* @__PURE__ */ jsx55(
-          TextInput4,
-          {
-            value,
-            onChange: (next) => setFieldValue(field, next),
-            onSubmit: () => setEditing(false),
-            mask: field === "cmaToken" ? "\u2022" : void 0
-          }
-        ) : /* @__PURE__ */ jsx55(Text46, { bold: !!display, children: display || (FIELD_HINTS[field] ? "" : /* @__PURE__ */ jsx55(Text46, { color: PALETTE.muted, children: "(empty)" })) }),
-        FIELD_HINTS[field] && /* @__PURE__ */ jsx55(Text46, { color: PALETTE.muted, children: FIELD_HINTS[field] })
-      ] }, field);
-    }) }),
-    notice && /* @__PURE__ */ jsxs45(Fragment17, { children: [
-      /* @__PURE__ */ jsx55(Text46, { children: " " }),
-      /* @__PURE__ */ jsxs45(Text46, { color: notice.kind === "success" ? PALETTE.success : PALETTE.error, children: [
-        notice.kind === "success" ? "\u2713" : "\u2717",
-        " ",
-        notice.text
-      ] })
-    ] }),
-    /* @__PURE__ */ jsx55(Text46, { children: " " }),
-    /* @__PURE__ */ jsx55(
+  if (open === "project") return /* @__PURE__ */ jsx60(ProjectConfigScreen, { onDone: close });
+  if (open === "agents") return /* @__PURE__ */ jsx60(AgentsScreen, { onDone: close });
+  return /* @__PURE__ */ jsxs49(Box48, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx60(Text51, { bold: true, children: "Configuration" }),
+    /* @__PURE__ */ jsx60(Text51, { children: " " }),
+    SECTIONS.map((section, index) => /* @__PURE__ */ jsxs49(Box48, { gap: 1, children: [
+      /* @__PURE__ */ jsx60(Text51, { color: index === focus ? PALETTE.accent : void 0, children: index === focus ? "\u276F" : " " }),
+      /* @__PURE__ */ jsx60(Box48, { width: 9, flexShrink: 0, children: /* @__PURE__ */ jsx60(Text51, { bold: index === focus, color: index === focus ? PALETTE.accent : void 0, children: section.label }) }),
+      /* @__PURE__ */ jsx60(Text51, { color: PALETTE.muted, children: section.description })
+    ] }, section.id)),
+    /* @__PURE__ */ jsx60(Text51, { children: " " }),
+    /* @__PURE__ */ jsx60(
       ControlHints,
       {
-        hints: editing ? [
-          { keys: "type", label: "edit" },
-          { keys: "\u2190/\u2192", label: "move cursor" },
-          { keys: "\u23CE", label: "done" },
-          { keys: "Esc", label: "cancel edit" }
-        ] : [
+        hints: [
           { keys: "\u2191/\u2193", label: "move" },
-          { keys: "\u23CE", label: "edit" },
-          { keys: "c", label: "clear" },
-          { keys: "s", label: "save" },
-          { keys: "Esc/q", label: "quit without saving" }
+          { keys: "\u23CE", label: "open" },
+          { keys: "Esc/q", label: "back" }
         ]
       }
     )
@@ -28748,8 +29429,8 @@ function ConfigurationScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/screen.tsx
-import { useEffect as useEffect23, useState as useState30 } from "react";
-import { Box as Box45, Text as Text47, useInput as useInput12 } from "ink";
+import { useEffect as useEffect25, useState as useState34 } from "react";
+import { Box as Box49, Text as Text52, useInput as useInput14 } from "ink";
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/analytics-store.ts
 async function readAnalyticsSetting() {
@@ -28768,11 +29449,11 @@ async function writeAnalyticsSetting(setting) {
 
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/screen.tsx
 init_debug_store();
-import { Fragment as Fragment18, jsx as jsx56, jsxs as jsxs46 } from "react/jsx-runtime";
+import { Fragment as Fragment19, jsx as jsx61, jsxs as jsxs50 } from "react/jsx-runtime";
 function OptInAnalyticsScreen({ onDone }) {
-  const [loading, setLoading] = useState30(true);
-  const [enabled, setEnabled] = useState30(true);
-  useEffect23(() => {
+  const [loading, setLoading] = useState34(true);
+  const [enabled, setEnabled] = useState34(true);
+  useEffect25(() => {
     readAnalyticsSetting().then((setting) => {
       setEnabled(setting.enabled);
       setLoading(false);
@@ -28784,7 +29465,7 @@ function OptInAnalyticsScreen({ onDone }) {
       });
     });
   }, []);
-  useInput12((input, key) => {
+  useInput14((input, key) => {
     if (loading) return;
     if (key.return || input === " ") {
       setEnabled((current) => {
@@ -28799,21 +29480,21 @@ function OptInAnalyticsScreen({ onDone }) {
       onDone();
     }
   });
-  return /* @__PURE__ */ jsxs46(Box45, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx56(Text47, { bold: true, children: "Settings \u203A Opt-in Analytics" }),
-    /* @__PURE__ */ jsx56(Text47, { children: " " }),
-    loading ? /* @__PURE__ */ jsx56(Text47, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs46(Fragment18, { children: [
-      /* @__PURE__ */ jsxs46(Text47, { children: [
+  return /* @__PURE__ */ jsxs50(Box49, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx61(Text52, { bold: true, children: "Settings \u203A Opt-in Analytics" }),
+    /* @__PURE__ */ jsx61(Text52, { children: " " }),
+    loading ? /* @__PURE__ */ jsx61(Text52, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs50(Fragment19, { children: [
+      /* @__PURE__ */ jsxs50(Text52, { children: [
         "Share anonymous usage data:",
         " ",
-        /* @__PURE__ */ jsx56(Text47, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
+        /* @__PURE__ */ jsx61(Text52, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
       ] }),
-      /* @__PURE__ */ jsx56(Text47, { children: " " }),
-      /* @__PURE__ */ jsx56(Text47, { color: PALETTE.muted, children: "Shares which CLI commands are used and where imports succeed or fail." }),
-      /* @__PURE__ */ jsx56(Text47, { color: PALETTE.muted, children: "Never includes source code, file paths, credentials, or authored content." })
+      /* @__PURE__ */ jsx61(Text52, { children: " " }),
+      /* @__PURE__ */ jsx61(Text52, { color: PALETTE.muted, children: "Shares which CLI commands are used and where imports succeed or fail." }),
+      /* @__PURE__ */ jsx61(Text52, { color: PALETTE.muted, children: "Never includes source code, file paths, credentials, or authored content." })
     ] }),
-    /* @__PURE__ */ jsx56(Text47, { children: " " }),
-    /* @__PURE__ */ jsx56(
+    /* @__PURE__ */ jsx61(Text52, { children: " " }),
+    /* @__PURE__ */ jsx61(
       ControlHints,
       {
         hints: [
@@ -28825,16 +29506,89 @@ function OptInAnalyticsScreen({ onDone }) {
   ] });
 }
 
+// packages/experience-design-system-cli/src/tui/upgrade/PageContainer.tsx
+import { useEffect as useEffect26, useState as useState35 } from "react";
+import { Box as Box50, Text as Text53, useInput as useInput15 } from "ink";
+init_version();
+init_debug_store();
+import { jsx as jsx62, jsxs as jsxs51 } from "react/jsx-runtime";
+var UPGRADE_COMMANDS = ["git pull", "pnpm install", "pnpm build"];
+function UpgradeScreen({ onDone }) {
+  const [upgradeCheck, setUpgradeCheck] = useState35();
+  useEffect26(() => {
+    startDebugRun({
+      flow: "upgrade",
+      step: "01-upgrade",
+      menuOption: "Upgrade",
+      inputs: { currentVersion: readPackageVersion() }
+    });
+    checkForUpgrade().then(setUpgradeCheck).catch(() => setUpgradeCheck({ status: "error" }));
+  }, []);
+  useInput15((_input, key) => {
+    if (key.return) {
+      void finishDebugRun({
+        outputs: upgradeCheck ?? {},
+        status: upgradeCheck?.status === "error" ? "error" : "success",
+        exitMethod: "saved"
+      });
+      onDone();
+      return;
+    }
+  });
+  return /* @__PURE__ */ jsxs51(Box50, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx62(Text53, { bold: true, children: "Upgrade" }),
+    /* @__PURE__ */ jsx62(Text53, { children: " " }),
+    renderBody(upgradeCheck),
+    /* @__PURE__ */ jsx62(Text53, { children: " " }),
+    /* @__PURE__ */ jsxs51(Text53, { bold: true, color: PALETTE.accent, children: [
+      FOCUS_MARKER,
+      " Go Back"
+    ] })
+  ] });
+}
+function renderBody(upgradeCheck) {
+  if (!upgradeCheck) {
+    return /* @__PURE__ */ jsx62(Text53, { color: PALETTE.muted, children: "Checking for updates\u2026" });
+  }
+  if (upgradeCheck.status === "error") {
+    return /* @__PURE__ */ jsx62(Text53, { color: PALETTE.warning, children: "Couldn't check for updates \u2014 check your network connection and try again." });
+  }
+  if (upgradeCheck.status === "up-to-date") {
+    return /* @__PURE__ */ jsxs51(Text53, { color: PALETTE.success, children: [
+      "You're already on the latest version (v",
+      upgradeCheck.current,
+      ")."
+    ] });
+  }
+  return /* @__PURE__ */ jsxs51(Box50, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs51(Text53, { color: PALETTE.muted, children: [
+      /* @__PURE__ */ jsxs51(Text53, { bold: true, color: PALETTE.success, children: [
+        "v",
+        upgradeCheck.latest
+      ] }),
+      " ",
+      "is available (you're on ",
+      /* @__PURE__ */ jsxs51(Text53, { bold: true, children: [
+        "v",
+        upgradeCheck.current
+      ] }),
+      "). Exit this program, cd into the root of your local clone of contentful/experience-design-system-sdk-public, then run:"
+    ] }),
+    /* @__PURE__ */ jsx62(Text53, { children: " " }),
+    /* @__PURE__ */ jsx62(Box50, { flexDirection: "column", borderStyle: "round", borderColor: PALETTE.border, paddingX: 1, children: UPGRADE_COMMANDS.map((cmd) => /* @__PURE__ */ jsx62(Text53, { bold: true, children: cmd }, cmd)) })
+  ] });
+}
+
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/screen.tsx
-import { useEffect as useEffect24, useState as useState31 } from "react";
-import { Box as Box46, Text as Text48, useInput as useInput13 } from "ink";
+import { useEffect as useEffect27, useState as useState36 } from "react";
+import { Box as Box51, Text as Text54, useInput as useInput16 } from "ink";
 init_debug_mode_store();
 init_debug_store();
-import { jsx as jsx57, jsxs as jsxs47 } from "react/jsx-runtime";
+import { jsx as jsx63, jsxs as jsxs52 } from "react/jsx-runtime";
 function DebugModeScreen({ onDone }) {
-  const [loading, setLoading] = useState31(true);
-  const [enabled, setEnabled] = useState31(true);
-  useEffect24(() => {
+  const [loading, setLoading] = useState36(true);
+  const [enabled, setEnabled] = useState36(true);
+  useEffect27(() => {
     readDebugModeSetting().then((setting) => {
       setEnabled(setting.enabled);
       setLoading(false);
@@ -28846,7 +29600,7 @@ function DebugModeScreen({ onDone }) {
       });
     });
   }, []);
-  useInput13((input, key) => {
+  useInput16((input, key) => {
     if (loading) return;
     if (key.return || input === " ") {
       setEnabled((current) => {
@@ -28861,16 +29615,16 @@ function DebugModeScreen({ onDone }) {
       onDone();
     }
   });
-  return /* @__PURE__ */ jsxs47(Box46, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx57(Text48, { bold: true, children: "Settings \u203A Debug Mode" }),
-    /* @__PURE__ */ jsx57(Text48, { children: " " }),
-    loading ? /* @__PURE__ */ jsx57(Text48, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs47(Text48, { children: [
+  return /* @__PURE__ */ jsxs52(Box51, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx63(Text54, { bold: true, children: "Settings \u203A Debug Mode" }),
+    /* @__PURE__ */ jsx63(Text54, { children: " " }),
+    loading ? /* @__PURE__ */ jsx63(Text54, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs52(Text54, { children: [
       "Debug logging:",
       " ",
-      /* @__PURE__ */ jsx57(Text48, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
+      /* @__PURE__ */ jsx63(Text54, { bold: true, color: enabled ? PALETTE.success : PALETTE.muted, children: enabled ? "On" : "Off" })
     ] }),
-    /* @__PURE__ */ jsx57(Text48, { children: " " }),
-    /* @__PURE__ */ jsx57(
+    /* @__PURE__ */ jsx63(Text54, { children: " " }),
+    /* @__PURE__ */ jsx63(
       ControlHints,
       {
         hints: [
@@ -28883,18 +29637,18 @@ function DebugModeScreen({ onDone }) {
 }
 
 // packages/experience-design-system-cli/app.tsx
-import { Fragment as Fragment19, jsx as jsx58 } from "react/jsx-runtime";
+import { Fragment as Fragment20, jsx as jsx64 } from "react/jsx-runtime";
 function App({ importOptions, inkClear }) {
-  const [screen, setScreen] = useState32("start");
-  const [importExitCode, setImportExitCode] = useState32();
+  const [screen, setScreen] = useState37("start");
+  const [importExitCode, setImportExitCode] = useState37();
   const showImportResult = importExitCode !== void 0;
-  const [projectPath, setProjectPath] = useState32();
-  const [tokensPath, setTokensPath] = useState32();
-  const [scannedFiles, setScannedFiles] = useState32();
-  const [pendingLaunch, setPendingLaunch] = useState32();
-  const [extractionRun, setExtractionRun] = useState32();
+  const [projectPath, setProjectPath] = useState37();
+  const [tokensPath, setTokensPath] = useState37();
+  const [scannedFiles, setScannedFiles] = useState37();
+  const [pendingLaunch, setPendingLaunch] = useState37();
+  const [extractionRun, setExtractionRun] = useState37();
   const extraction = useExtraction(extractionRun?.input);
-  const [scopeRun, setScopeRun] = useState32();
+  const [scopeRun, setScopeRun] = useState37();
   const scopeFlow = useScopeGateFlow(
     scopeRun && {
       sessionId: scopeRun.extraction.sessionId,
@@ -28909,12 +29663,12 @@ function App({ importOptions, inkClear }) {
       }
     }
   );
-  const [generationInput, setGenerationInput] = useState32();
+  const [generationInput, setGenerationInput] = useState37();
   const generation = useGeneration(generationInput);
-  const [flowStart, setFlowStart] = useState32();
+  const [flowStart, setFlowStart] = useState37();
   const flow = useFlow(flowStart, { beforeStepChange: inkClear });
-  const [importDefaults, setImportDefaults] = useState32();
-  useEffect25(() => {
+  const [importDefaults, setImportDefaults] = useState37();
+  useEffect28(() => {
     if (screen !== "import") {
       setImportDefaults(void 0);
       return;
@@ -28932,7 +29686,7 @@ function App({ importOptions, inkClear }) {
     const launch = { projectPath: projectPath2, tokens, filePaths, ...importOptions };
     const state2 = await inspectTokens({
       rawTokensPath: tokens,
-      contentfulDir: join25(resolveUserPath(projectPath2), ".contentful"),
+      contentfulDir: join26(resolveUserPath(projectPath2), ".contentful"),
       cache: importOptions.cache
     });
     if (state2.kind === "cached") {
@@ -28974,12 +29728,12 @@ function App({ importOptions, inkClear }) {
       }
     });
   };
-  useEffect25(() => {
+  useEffect28(() => {
     if (!extractionRun || extraction?.status !== "done" || !extraction.result.ok) return;
     setExtractionRun(void 0);
     setScopeRun({ ...extractionRun, extraction: extraction.result.extraction });
   }, [extraction, extractionRun]);
-  useEffect25(() => {
+  useEffect28(() => {
     if (!scopeRun || scopeFlow?.status !== "confirmed" || generationInput) return;
     const { extraction: produced, input, generatePromptPath } = scopeRun;
     setGenerationInput({
@@ -28997,7 +29751,7 @@ function App({ importOptions, inkClear }) {
       ...generatePromptPath ? { generatePromptPath } : {}
     });
   }, [scopeFlow, scopeRun, generationInput]);
-  useEffect25(() => {
+  useEffect28(() => {
     if (!scopeRun || generation?.status !== "done" || !generation.result.ok) return;
     const { credentialsSkipped, tokenStrategy, extraction: produced, input, generatePromptPath } = scopeRun;
     inkClear();
@@ -29040,9 +29794,9 @@ function App({ importOptions, inkClear }) {
   };
   switch (screen) {
     case "import":
-      if (showImportResult) return /* @__PURE__ */ jsx58(ImportScreen, { exitCode: importExitCode, onDone: finishImportResult });
+      if (showImportResult) return /* @__PURE__ */ jsx64(ImportScreen, { exitCode: importExitCode, onDone: finishImportResult });
       if (flow && flowStart) {
-        return /* @__PURE__ */ jsx58(
+        return /* @__PURE__ */ jsx64(
           FlowScreen,
           {
             state: flow.state,
@@ -29052,12 +29806,12 @@ function App({ importOptions, inkClear }) {
           }
         );
       }
-      if (importDefaults === void 0) return /* @__PURE__ */ jsx58(Fragment19, {});
+      if (importDefaults === void 0) return /* @__PURE__ */ jsx64(Fragment20, {});
       if (projectPath === void 0) {
-        return /* @__PURE__ */ jsx58(WelcomeScreen, { onContinue: setProjectPath, onQuit: leaveImport, initialPath: importDefaults.componentDir });
+        return /* @__PURE__ */ jsx64(WelcomeScreen, { onContinue: setProjectPath, onQuit: leaveImport, initialPath: importDefaults.componentDir });
       }
       if (tokensPath === void 0) {
-        return /* @__PURE__ */ jsx58(
+        return /* @__PURE__ */ jsx64(
           TokenInputScreen,
           {
             initialPath: importDefaults.tokenFile,
@@ -29067,7 +29821,7 @@ function App({ importOptions, inkClear }) {
         );
       }
       if (scannedFiles === void 0) {
-        return /* @__PURE__ */ jsx58(
+        return /* @__PURE__ */ jsx64(
           PathValidationScreen,
           {
             projectPath,
@@ -29079,10 +29833,10 @@ function App({ importOptions, inkClear }) {
       }
       if (extractionRun) {
         if (extraction?.status === "done" && !extraction.result.ok) {
-          return /* @__PURE__ */ jsx58(ErrorStep, { stepName: extraction.result.step, message: extraction.result.message, onExit: leaveImport });
+          return /* @__PURE__ */ jsx64(ErrorStep, { stepName: extraction.result.step, message: extraction.result.message, onExit: leaveImport });
         }
         if (extraction?.status === "running") {
-          return /* @__PURE__ */ jsx58(
+          return /* @__PURE__ */ jsx64(
             ExtractionScreen,
             {
               progress: extraction.progress,
@@ -29091,14 +29845,14 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx58(Fragment19, {});
+        return /* @__PURE__ */ jsx64(Fragment20, {});
       }
       if (scopeRun && scopeFlow) {
         if (scopeFlow.status === "failed") {
-          return /* @__PURE__ */ jsx58(ErrorStep, { stepName: "scope gate", message: scopeFlow.message, onExit: leaveImport });
+          return /* @__PURE__ */ jsx64(ErrorStep, { stepName: "scope gate", message: scopeFlow.message, onExit: leaveImport });
         }
         if (scopeFlow.status === "deciding") {
-          return /* @__PURE__ */ jsx58(
+          return /* @__PURE__ */ jsx64(
             ScopeGateScreen,
             {
               components: scopeFlow.load.components,
@@ -29108,7 +29862,7 @@ function App({ importOptions, inkClear }) {
           );
         }
         if (generation?.status === "done" && !generation.result.ok) {
-          return /* @__PURE__ */ jsx58(ErrorStep, { stepName: generation.result.step, message: generation.result.message, onExit: leaveImport });
+          return /* @__PURE__ */ jsx64(ErrorStep, { stepName: generation.result.step, message: generation.result.message, onExit: leaveImport });
         }
         if (generation?.status === "running") {
           const hasRawTokens = scopeRun.input.rawTokensPath !== "";
@@ -29116,7 +29870,7 @@ function App({ importOptions, inkClear }) {
             hasRawTokens,
             mapTokensEligible: generation.progress.mapTokensEligible
           });
-          return /* @__PURE__ */ jsx58(
+          return /* @__PURE__ */ jsx64(
             GenerationScreen,
             {
               progress: generation.progress,
@@ -29128,10 +29882,10 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx58(Fragment19, {});
+        return /* @__PURE__ */ jsx64(Fragment20, {});
       }
       if (pendingLaunch?.cached) {
-        return /* @__PURE__ */ jsx58(
+        return /* @__PURE__ */ jsx64(
           TokenReuseScreen,
           {
             tokensPath: pendingLaunch.cached.tokensPath,
@@ -29142,7 +29896,7 @@ function App({ importOptions, inkClear }) {
           }
         );
       }
-      return /* @__PURE__ */ jsx58(
+      return /* @__PURE__ */ jsx64(
         CredentialsScreen,
         {
           initial: importDefaults.credentials,
@@ -29151,17 +29905,19 @@ function App({ importOptions, inkClear }) {
         }
       );
     case "help":
-      return /* @__PURE__ */ jsx58(HelpScreen, { onDone: goToStart });
+      return /* @__PURE__ */ jsx64(HelpScreen, { onDone: goToStart });
+    case "upgrade":
+      return /* @__PURE__ */ jsx64(UpgradeScreen, { onDone: goToStart });
     case "settings":
-      return /* @__PURE__ */ jsx58(SettingsScreen, { onNavigate: setScreen, onBack: goToStart });
+      return /* @__PURE__ */ jsx64(SettingsScreen, { onNavigate: setScreen, onBack: goToStart });
     case "settings-configuration":
-      return /* @__PURE__ */ jsx58(ConfigurationScreen, { onDone: goToSettings });
+      return /* @__PURE__ */ jsx64(ConfigurationScreen, { onDone: goToSettings });
     case "settings-opt-in-analytics":
-      return /* @__PURE__ */ jsx58(OptInAnalyticsScreen, { onDone: goToSettings });
+      return /* @__PURE__ */ jsx64(OptInAnalyticsScreen, { onDone: goToSettings });
     case "settings-debug-mode":
-      return /* @__PURE__ */ jsx58(DebugModeScreen, { onDone: goToSettings });
+      return /* @__PURE__ */ jsx64(DebugModeScreen, { onDone: goToSettings });
     case "start":
-      return /* @__PURE__ */ jsx58(HomeScreen, { onNavigate: setScreen });
+      return /* @__PURE__ */ jsx64(HomeScreen, { onNavigate: setScreen });
   }
 }
 async function runApp(renderApp, importOptions) {
@@ -29169,7 +29925,7 @@ async function runApp(renderApp, importOptions) {
     instance.clear?.();
     process.stdout.write("\x1B[H\x1B[0J");
   };
-  const instance = renderApp(/* @__PURE__ */ jsx58(App, { importOptions, inkClear }));
+  const instance = renderApp(/* @__PURE__ */ jsx64(App, { importOptions, inkClear }));
   await instance.waitUntilExit();
 }
 export {