@contentful/experience-design-system-cli 2.37.1-dev-build-7314a760.0 → 2.37.1-dev-build-be7b0e35.0

package/dist/index.js

@@ -1500,7 +1500,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"],
@@ -1549,7 +1549,7 @@ async function runAgent(options) {
         stderrLen: stderr.length,
         stderrTail: stderr.slice(-1e3)
       });
-      resolve27(result);
+      resolve28(result);
     });
   });
 }
@@ -1571,7 +1571,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;
@@ -1580,7 +1580,7 @@ async function checkAgentAuth(agent) {
         return;
       done = true;
       child.kill("SIGTERM");
-      resolve27("unauthenticated");
+      resolve28("unauthenticated");
     }, 5e3);
     child.stdout?.on("data", (chunk) => {
       stdout += chunk.toString();
@@ -1591,14 +1591,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");
       }
     });
   });
@@ -1608,9 +1608,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({
@@ -7916,10 +7916,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,
@@ -14333,7 +14333,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));
 }
 var MAX_RETRY_AFTER_MS;
 var init_http_utils = __esm({
@@ -14609,7 +14609,7 @@ var init_api_client = __esm({
             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`);
@@ -18527,7 +18527,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)));
     }
   }
 }
@@ -19446,6 +19446,7 @@ var init_src4 = __esm({
     init_agents();
     init_agent_name();
     init_models();
+    init_binaries();
     init_is_agent_name();
     init_agent_supports_bedrock();
     init_check_agent_auth();
@@ -19565,6 +19566,97 @@ var init_v1_store = __esm({
   }
 });
 
+// packages/experience-design-system-cli/src/tui/settings/agents/agent-store.ts
+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 fields = entry;
+        agents[name] = { model: asString(fields["model"]), binary: asString(fields["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);
+}
+var DEFAULT_AGENT3, AGENT_LABELS, AGENT_HINTS, asString;
+var init_agent_store = __esm({
+  "packages/experience-design-system-cli/src/tui/settings/agents/agent-store.ts"() {
+    "use strict";
+    init_src4();
+    init_v1_store();
+    DEFAULT_AGENT3 = "claude";
+    AGENT_LABELS = {
+      claude: "Claude Code",
+      codex: "OpenAI Codex",
+      opencode: "OpenCode",
+      cursor: "Cursor",
+      copilot: "GitHub Copilot"
+    };
+    AGENT_HINTS = {
+      claude: "claude",
+      codex: "codex",
+      opencode: "opencode",
+      cursor: "cursor-agent",
+      copilot: "copilot"
+    };
+    asString = (value) => typeof value === "string" ? value : "";
+  }
+});
+
+// packages/experience-design-system-cli/src/tui/settings/agents/apply-binary-overrides.ts
+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);
+    }
+  }
+}
+var shellValues;
+var init_apply_binary_overrides = __esm({
+  "packages/experience-design-system-cli/src/tui/settings/agents/apply-binary-overrides.ts"() {
+    "use strict";
+    init_src4();
+    shellValues = /* @__PURE__ */ new Map();
+  }
+});
+
 // packages/experience-design-system-cli/src/tui/settings/opt-in-analytics/analytics-store.ts
 async function readAnalyticsSetting() {
   const store = await readV1Store();
@@ -32273,7 +32365,7 @@ var init_save = __esm({
       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)
     });
   }
@@ -32824,13 +32916,48 @@ var init_debug_store = __esm({
   }
 });
 
+// packages/experience-design-system-cli/src/tui/help/file-locations.ts
+import { join as join26, resolve as resolve27 } from "node:path";
+function describeFileLocations({
+  contentfulBaseDir,
+  debugModeEnabled,
+  currentSessionDir: currentSessionDir2
+}) {
+  if (!debugModeEnabled) {
+    return {
+      debugLogs: "none while Debug Mode is off",
+      importFiles: `${join26("<project>", ".contentful")}/ (tokens.json, components.json)`
+    };
+  }
+  const base = contentfulBaseDir ? resolve27(contentfulBaseDir) : "<project>";
+  const session = currentSessionDir2 ?? join26(base, ".contentful", "<date>-session-<n>");
+  return {
+    debugLogs: join26(session, "debug"),
+    importFiles: `${join26(session, "dsi-import-<n>")}/ (tokens.json, components.json)`
+  };
+}
+var init_file_locations = __esm({
+  "packages/experience-design-system-cli/src/tui/help/file-locations.ts"() {
+    "use strict";
+  }
+});
+
 // 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() },
@@ -32851,6 +32978,7 @@ var init_help_info = __esm({
     init_debug_store();
     init_debug_mode_store();
     init_version();
+    init_file_locations();
   }
 });
 
@@ -32862,7 +32990,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))
   ] });
@@ -32977,6 +33105,730 @@ var init_PageContainer3 = __esm({
   }
 });
 
+// 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";
+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";
+}
+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 inspectAgent(name, binary) {
+  const target = effectiveBinary(name, binary);
+  const found = await resolveOnPath(target);
+  if (!found) return [fail3("path", `\`${target}\` was not found or is not executable`)];
+  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;
+}
+async function testAgent(name, binary, model) {
+  const checks = await inspectAgent(name, binary);
+  if (!checks.every((check) => check.step === "version" || check.ok)) return checks;
+  const target = effectiveBinary(name, binary);
+  const found = await resolveOnPath(target) ?? target;
+  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}` };
+}
+function modelLine(name, savedModel) {
+  const model = savedModel.trim();
+  return model ? model : `${defaultModelLabel(name)} (built-in default)`;
+}
+function panelRows(name, checks, settings) {
+  if (!checks) return [{ label: "Command", value: "checking...", tone: "muted" }];
+  const status = statusFromChecks(name, checks, settings.binary);
+  const path5 = checks.find((check) => check.step === "path");
+  if (!path5?.ok) {
+    const rows2 = [
+      {
+        label: "Command",
+        value: settings.binary.trim() ? path5?.detail ?? "not found" : "not found on your PATH",
+        tone: settings.binary.trim() ? "bad" : "muted"
+      }
+    ];
+    const hint2 = setupHint(name, status);
+    if (hint2) rows2.push({ label: "Setup", value: hint2, tone: "muted" });
+    return rows2;
+  }
+  const rows = [{ label: "Command", value: path5.detail, tone: "ok" }];
+  const version = checks.find((check) => check.step === "version");
+  if (version?.ok) rows.push({ label: "Version", value: version.detail, tone: "ok" });
+  rows.push({ label: "Model", value: modelLine(name, settings.model), tone: "muted" });
+  const hint = setupHint(name, status);
+  if (hint) rows.push({ label: "Setup", value: hint, tone: "muted" });
+  return rows;
+}
+function statusRows(_name, checks, savedBinary) {
+  if (!checks) return [{ label: "Command", value: "checking...", tone: "muted" }];
+  const find = (step) => checks.find((check) => check.step === step);
+  const path5 = find("path");
+  if (!path5?.ok) {
+    if (savedBinary.trim()) return [{ label: "Command", value: path5?.detail ?? "not found", tone: "bad" }];
+    return [{ label: "Command", value: "not configured (not on the PATH)", tone: "muted" }];
+  }
+  const rows = [{ label: "Command", value: path5.detail, tone: "ok" }];
+  const version = find("version");
+  if (version) {
+    rows.push({
+      label: "Version",
+      value: version.ok ? version.detail : "could not be read",
+      tone: version.ok ? "ok" : "muted"
+    });
+  }
+  const login = find("login");
+  const prompt = find("prompt");
+  if (login) {
+    rows.push({ label: "Login", value: login.detail, tone: login.ok ? "ok" : "bad" });
+  } else if (prompt) {
+    rows.push({
+      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 {
+    rows.push({ label: "Login", value: "not checked (use Run test)", tone: "muted" });
+  }
+  if (prompt) rows.push({ label: "Test", value: prompt.detail, tone: prompt.ok ? "ok" : "bad" });
+  return rows;
+}
+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;
+  }
+}
+var VERSION_TIMEOUT_MS, PROMPT_TIMEOUT_MS, TEST_PROMPT, INSTALL_HINTS, LOGIN_HINTS, fail3, pass, LIST_STATUS;
+var init_agent_status = __esm({
+  "packages/experience-design-system-cli/src/tui/settings/agents/agent-status.ts"() {
+    "use strict";
+    init_src4();
+    VERSION_TIMEOUT_MS = 5e3;
+    PROMPT_TIMEOUT_MS = 6e4;
+    TEST_PROMPT = "Reply with the single word: ok";
+    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"
+    };
+    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"
+    };
+    fail3 = (step, detail) => ({ step, ok: false, detail });
+    pass = (step, detail) => ({ step, ok: true, detail });
+    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" }
+    };
+  }
+});
+
+// packages/experience-design-system-cli/src/tui/settings/agents/AgentStatusBadge.tsx
+import { Text as Text46 } from "ink";
+import { jsx as jsx55 } from "react/jsx-runtime";
+function AgentStatusBadge({
+  name,
+  checks,
+  binary
+}) {
+  const { symbol, text, tone } = LIST_STATUS[checks ? statusFromChecks(name, checks, binary) : "checking"];
+  return /* @__PURE__ */ jsx55(Text46, { color: TONE_COLOR[tone], children: `${symbol} ${text}` });
+}
+var TONE_COLOR;
+var init_AgentStatusBadge = __esm({
+  "packages/experience-design-system-cli/src/tui/settings/agents/AgentStatusBadge.tsx"() {
+    "use strict";
+    init_theme();
+    init_agent_status();
+    TONE_COLOR = {
+      ok: PALETTE.success,
+      bad: PALETTE.error,
+      muted: PALETTE.muted
+    };
+  }
+});
+
+// packages/experience-design-system-cli/src/tui/settings/agents/AgentDetail.tsx
+import { useEffect as useEffect22, useState as useState29 } from "react";
+import { Box as Box44, Text as Text47, useInput as useInput11 } from "ink";
+import TextInput4 from "ink-text-input";
+import { jsx as jsx56, jsxs as jsxs45 } from "react/jsx-runtime";
+function Row2({
+  pointer,
+  label,
+  labelProps,
+  children
+}) {
+  return /* @__PURE__ */ jsxs45(Box44, { children: [
+    /* @__PURE__ */ jsx56(Box44, { width: POINTER_WIDTH, flexShrink: 0, children: pointer }),
+    /* @__PURE__ */ jsx56(Box44, { width: LABEL_WIDTH + LABEL_GAP, flexShrink: 0, children: /* @__PURE__ */ jsx56(Text47, { color: PALETTE.muted, ...labelProps, children: label }) }),
+    children
+  ] });
+}
+function Section2({
+  title,
+  note,
+  interactive = false,
+  children
+}) {
+  return /* @__PURE__ */ jsxs45(Box44, { flexDirection: "column", marginTop: 1, children: [
+    /* @__PURE__ */ jsxs45(Box44, { gap: 1, children: [
+      /* @__PURE__ */ jsx56(Text47, { bold: true, color: interactive ? PALETTE.accent : PALETTE.muted, children: title }),
+      /* @__PURE__ */ jsx56(Text47, { color: PALETTE.muted, children: `\xB7 ${note}` })
+    ] }),
+    children
+  ] });
+}
+function AgentDetail({
+  name,
+  config,
+  setConfig,
+  onBack
+}) {
+  const settings = config.agents[name];
+  const [focusIndex, setFocusIndex] = useState29(0);
+  const [editing, setEditing] = useState29(false);
+  const [valueBeforeEdit, setValueBeforeEdit] = useState29("");
+  const [saving, setSaving] = useState29(false);
+  const [testing, setTesting] = useState29(false);
+  const [notice, setNotice] = useState29(null);
+  const [checks, setChecks] = useState29(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 setField = (field, value) => {
+    setConfig({ ...config, agents: { ...config.agents, [name]: { ...settings, [field]: value } } });
+    setNotice(null);
+  };
+  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 focused = FOCUS_ORDER[focusIndex];
+  const focusedField = focused === "test" ? null : focused;
+  useInput11((input, key) => {
+    if (saving || testing) return;
+    if (editing) {
+      if (key.escape && focusedField) {
+        setField(focusedField, valueBeforeEdit);
+        setEditing(false);
+      }
+      return;
+    }
+    if (key.escape || input === "q") {
+      onBack();
+      return;
+    }
+    if (input === "s") {
+      save();
+      return;
+    }
+    if (key.upArrow) {
+      setFocusIndex((i) => (i - 1 + FOCUS_ORDER.length) % FOCUS_ORDER.length);
+      return;
+    }
+    if (key.downArrow || key.tab) {
+      setFocusIndex((i) => (i + 1) % FOCUS_ORDER.length);
+      return;
+    }
+    if (input === "c" && focusedField) {
+      setField(focusedField, "");
+      return;
+    }
+    if (key.return) {
+      if (focusedField) {
+        setValueBeforeEdit(settings[focusedField]);
+        setEditing(true);
+      } else {
+        runTest();
+      }
+    }
+  });
+  const status = checks ? statusFromChecks(name, checks, settings.binary) : "checking";
+  const hint = setupHint(name, status);
+  const pointer = (isFocused) => /* @__PURE__ */ jsx56(Text47, { color: isFocused ? PALETTE.accent : void 0, children: isFocused ? "\u276F" : " " });
+  return /* @__PURE__ */ jsxs45(Box44, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx56(Text47, { bold: true, children: AGENT_LABELS[name] }),
+    /* @__PURE__ */ jsx56(Text47, { color: PALETTE.muted, children: config.defaultAgent === name ? "This is the default agent." : `Runs the \`${AGENT_HINTS[name]}\` command.` }),
+    (notice || testing || saving) && /* @__PURE__ */ jsx56(Box44, { marginTop: 1, children: testing || saving ? /* @__PURE__ */ jsx56(Text47, { color: PALETTE.accent, children: testing ? "\u2026 Running the test (up to 60s)" : "\u2026 Saving" }) : notice && /* @__PURE__ */ jsxs45(Text47, { bold: true, color: notice.kind === "success" ? PALETTE.success : PALETTE.error, children: [
+      notice.kind === "success" ? "\u2713" : "\u2717",
+      " ",
+      notice.text
+    ] }) }),
+    /* @__PURE__ */ jsxs45(Section2, { title: "CONFIGURE", note: "you can change these", interactive: true, children: [
+      FIELDS2.map((field) => {
+        const isFocused = focused === field;
+        const value = settings[field];
+        const display = isFocused && editing ? /* @__PURE__ */ jsx56(TextInput4, { value, onChange: (next) => setField(field, next), onSubmit: () => setEditing(false) }) : value ? /* @__PURE__ */ jsx56(Text47, { bold: true, children: value }) : /* @__PURE__ */ jsx56(Text47, { color: PALETTE.muted, children: fieldHint(name, field) });
+        return /* @__PURE__ */ jsx56(
+          Row2,
+          {
+            pointer: pointer(isFocused),
+            label: FIELD_LABEL[field],
+            labelProps: { bold: isFocused, color: isFocused ? PALETTE.accent : PALETTE.muted },
+            children: display
+          },
+          field
+        );
+      }),
+      /* @__PURE__ */ jsx56(
+        Row2,
+        {
+          pointer: pointer(focused === "test"),
+          label: "Run test",
+          labelProps: { bold: focused === "test", color: focused === "test" ? PALETTE.accent : PALETTE.muted },
+          children: /* @__PURE__ */ jsx56(Text47, { color: testing ? PALETTE.accent : PALETTE.muted, children: testing ? "running..." : "sends one small prompt (uses a few tokens)" })
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsxs45(Section2, { title: "STATUS", note: "read only", children: [
+      statusRows(name, checks, settings.binary).map((row) => /* @__PURE__ */ jsx56(Row2, { pointer: null, label: row.label, children: /* @__PURE__ */ jsx56(Text47, { color: TONE_COLOR[row.tone], children: row.value }) }, row.label)),
+      hint && /* @__PURE__ */ jsx56(Row2, { pointer: null, label: "Setup", children: /* @__PURE__ */ jsx56(Text47, { color: PALETTE.muted, children: hint }) })
+    ] }),
+    /* @__PURE__ */ jsx56(Text47, { children: " " }),
+    /* @__PURE__ */ jsx56(
+      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: focusedField ? "edit" : "run test" },
+          ...focusedField ? [{ keys: "c", label: "clear" }] : [],
+          { keys: "s", label: "save" },
+          { keys: "Esc/q", label: "back without saving" }
+        ]
+      }
+    )
+  ] });
+}
+var FOCUS_ORDER, FIELDS2, FIELD_LABEL, LABEL_WIDTH, LABEL_GAP, POINTER_WIDTH, fieldHint;
+var init_AgentDetail = __esm({
+  "packages/experience-design-system-cli/src/tui/settings/agents/AgentDetail.tsx"() {
+    "use strict";
+    init_theme();
+    init_control_hints();
+    init_agent_store();
+    init_agent_status();
+    init_AgentStatusBadge();
+    init_apply_binary_overrides();
+    FOCUS_ORDER = ["binary", "model", "test"];
+    FIELDS2 = ["binary", "model"];
+    FIELD_LABEL = { binary: "Command path", model: "Model" };
+    LABEL_WIDTH = "Command path".length;
+    LABEL_GAP = 2;
+    POINTER_WIDTH = 2;
+    fieldHint = (name, field) => field === "binary" ? `(empty: \`${AGENT_HINTS[name]}\` from the PATH)` : `(empty: ${defaultModelLabel(name)})`;
+  }
+});
+
+// packages/experience-design-system-cli/src/tui/settings/agents/AgentScreens.tsx
+import { useEffect as useEffect23, useState as useState30 } from "react";
+import { Box as Box45, Text as Text48, useInput as useInput12 } from "ink";
+import { Fragment as Fragment17, jsx as jsx57, jsxs as jsxs46 } from "react/jsx-runtime";
+function AgentsScreen({ onDone }) {
+  const [config, setConfig] = useState30(null);
+  const [focus, setFocus] = useState30(0);
+  const [open, setOpen] = useState30(null);
+  const [notice, setNotice] = useState30(null);
+  const [saving, setSaving] = useState30(false);
+  const [checks, setChecks] = useState30({});
+  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__ */ jsxs46(Box45, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+      /* @__PURE__ */ jsx57(Text48, { bold: true, children: "Agents" }),
+      /* @__PURE__ */ jsx57(Text48, { children: " " }),
+      /* @__PURE__ */ jsx57(Text48, { color: PALETTE.accent, children: "Loading..." })
+    ] });
+  }
+  if (open) {
+    return /* @__PURE__ */ jsx57(
+      AgentDetail,
+      {
+        name: open,
+        config,
+        setConfig,
+        onBack: () => {
+          setOpen(null);
+          void readAgentConfig().then((saved) => {
+            setConfig(saved);
+            inspectAll(saved);
+          });
+        }
+      }
+    );
+  }
+  const focusedAgent = AGENT_NAMES[focus];
+  return /* @__PURE__ */ jsxs46(Box45, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx57(Text48, { bold: true, children: "Agents" }),
+    /* @__PURE__ */ jsx57(Text48, { color: PALETTE.muted, children: "The coding agent the CLI runs, and what was found for each one." }),
+    /* @__PURE__ */ jsx57(Text48, { children: " " }),
+    /* @__PURE__ */ jsxs46(Box45, { gap: 1, children: [
+      /* @__PURE__ */ jsx57(Text48, { color: PALETTE.muted, children: "Default agent" }),
+      /* @__PURE__ */ jsx57(Text48, { bold: true, children: AGENT_LABELS[config.defaultAgent] }),
+      saving && /* @__PURE__ */ jsx57(Text48, { color: PALETTE.accent, children: "\u2026 saving" })
+    ] }),
+    /* @__PURE__ */ jsxs46(Box45, { marginTop: 1, gap: 1, children: [
+      /* @__PURE__ */ jsx57(Text48, { children: " " }),
+      /* @__PURE__ */ jsx57(Text48, { children: " " }),
+      /* @__PURE__ */ jsx57(Box45, { width: NAME_WIDTH, flexShrink: 0, children: /* @__PURE__ */ jsx57(Text48, { color: PALETTE.muted, children: "AGENT" }) }),
+      /* @__PURE__ */ jsx57(Text48, { color: PALETTE.muted, children: "STATUS" })
+    ] }),
+    AGENT_NAMES.map((name) => {
+      const isFocused = focusedAgent === name;
+      return /* @__PURE__ */ jsxs46(Box45, { gap: 1, children: [
+        /* @__PURE__ */ jsx57(Text48, { color: isFocused ? PALETTE.accent : void 0, children: isFocused ? "\u276F" : " " }),
+        /* @__PURE__ */ jsx57(Text48, { color: PALETTE.success, children: name === config.defaultAgent ? "\u2605" : " " }),
+        /* @__PURE__ */ jsx57(Box45, { width: NAME_WIDTH, flexShrink: 0, children: /* @__PURE__ */ jsx57(Text48, { bold: isFocused, color: isFocused ? PALETTE.accent : void 0, children: AGENT_LABELS[name] }) }),
+        /* @__PURE__ */ jsx57(AgentStatusBadge, { name, checks: checks[name], binary: config.agents[name].binary })
+      ] }, name);
+    }),
+    /* @__PURE__ */ jsxs46(Box45, { flexDirection: "column", marginTop: 1, children: [
+      /* @__PURE__ */ jsx57(Text48, { color: PALETTE.muted, children: `\u2500 ${AGENT_LABELS[focusedAgent]} ${"\u2500".repeat(30)}` }),
+      panelRows(focusedAgent, checks[focusedAgent], config.agents[focusedAgent]).map((row) => /* @__PURE__ */ jsxs46(Box45, { gap: 1, paddingLeft: 1, children: [
+        /* @__PURE__ */ jsx57(Box45, { width: PANEL_LABEL_WIDTH, flexShrink: 0, children: /* @__PURE__ */ jsx57(Text48, { color: PALETTE.muted, children: row.label }) }),
+        /* @__PURE__ */ jsx57(Text48, { color: TONE_COLOR[row.tone], children: row.value })
+      ] }, row.label))
+    ] }),
+    notice && /* @__PURE__ */ jsxs46(Fragment17, { children: [
+      /* @__PURE__ */ jsx57(Text48, { children: " " }),
+      /* @__PURE__ */ jsxs46(Text48, { bold: true, color: notice.kind === "success" ? PALETTE.success : PALETTE.error, children: [
+        notice.kind === "success" ? "\u2713" : "\u2717",
+        " ",
+        notice.text
+      ] })
+    ] }),
+    /* @__PURE__ */ jsx57(Text48, { children: " " }),
+    /* @__PURE__ */ jsx57(
+      ControlHints,
+      {
+        hints: [
+          { keys: "\u2191/\u2193", label: "move" },
+          { keys: "\u23CE", label: "make default" },
+          { keys: "\u2192", label: "settings and test" },
+          { keys: "Esc/q", label: "back" }
+        ]
+      }
+    )
+  ] });
+}
+var NAME_WIDTH, PANEL_LABEL_WIDTH;
+var init_AgentScreens = __esm({
+  "packages/experience-design-system-cli/src/tui/settings/agents/AgentScreens.tsx"() {
+    "use strict";
+    init_src4();
+    init_theme();
+    init_control_hints();
+    init_debug_store();
+    init_agent_store();
+    init_agent_status();
+    init_AgentDetail();
+    init_AgentStatusBadge();
+    NAME_WIDTH = 16;
+    PANEL_LABEL_WIDTH = "Command".length;
+  }
+});
+
+// packages/experience-design-system-cli/src/tui/settings/shared/FieldForm.tsx
+import { useState as useState31 } from "react";
+import { Box as Box46, Text as Text49, useInput as useInput13 } from "ink";
+import TextInput5 from "ink-text-input";
+import { Fragment as Fragment18, jsx as jsx58, jsxs as jsxs47 } from "react/jsx-runtime";
+function FieldForm({
+  title,
+  subtitle,
+  fields,
+  values,
+  onChange,
+  onSave,
+  onQuit,
+  notice,
+  busy = false,
+  footer
+}) {
+  const [active, setActive] = useState31(0);
+  const [editing, setEditing] = useState31(false);
+  const [valueBeforeEdit, setValueBeforeEdit] = useState31("");
+  const labelWidth = Math.max(...fields.map((field) => field.label.length));
+  const current = fields[active];
+  useInput13((input, key) => {
+    if (busy) return;
+    if (editing) {
+      if (key.escape) {
+        onChange(current.key, valueBeforeEdit);
+        setEditing(false);
+      }
+      return;
+    }
+    if (key.escape || input === "q") {
+      onQuit();
+      return;
+    }
+    if (input === "s") {
+      onSave();
+      return;
+    }
+    if (input === "c") {
+      onChange(current.key, "");
+      return;
+    }
+    if (key.tab || key.downArrow) {
+      setActive((i) => (i + 1) % fields.length);
+      return;
+    }
+    if (key.upArrow) {
+      setActive((i) => (i - 1 + fields.length) % fields.length);
+      return;
+    }
+    if (key.return) {
+      setValueBeforeEdit(values[current.key]);
+      setEditing(true);
+    }
+  });
+  return /* @__PURE__ */ jsxs47(Box46, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
+    /* @__PURE__ */ jsx58(Text49, { bold: true, children: title }),
+    subtitle && /* @__PURE__ */ jsx58(Text49, { color: PALETTE.muted, children: subtitle }),
+    /* @__PURE__ */ jsx58(Text49, { children: " " }),
+    /* @__PURE__ */ jsx58(Box46, { flexDirection: "column", children: fields.map((field, index) => {
+      const isActive = index === active;
+      const value = values[field.key];
+      const display = field.masked ? "\u2022".repeat(value.length) : value;
+      return /* @__PURE__ */ jsxs47(Box46, { gap: 1, children: [
+        /* @__PURE__ */ jsx58(Text49, { color: isActive ? PALETTE.accent : void 0, children: isActive ? "\u276F" : " " }),
+        /* @__PURE__ */ jsx58(Box46, { width: labelWidth, flexShrink: 0, children: /* @__PURE__ */ jsx58(Text49, { bold: isActive, color: isActive ? PALETTE.accent : PALETTE.muted, children: field.label }) }),
+        isActive && editing ? /* @__PURE__ */ jsx58(
+          TextInput5,
+          {
+            value,
+            onChange: (next) => onChange(field.key, next),
+            onSubmit: () => setEditing(false),
+            mask: field.masked ? "\u2022" : void 0
+          }
+        ) : /* @__PURE__ */ jsx58(Text49, { bold: !!display, children: display || (field.hint ? "" : /* @__PURE__ */ jsx58(Text49, { color: PALETTE.muted, children: "(empty)" })) }),
+        field.hint && /* @__PURE__ */ jsx58(Text49, { color: PALETTE.muted, children: field.hint })
+      ] }, field.key);
+    }) }),
+    notice && /* @__PURE__ */ jsxs47(Fragment18, { children: [
+      /* @__PURE__ */ jsx58(Text49, { children: " " }),
+      /* @__PURE__ */ jsxs47(Text49, { color: notice.kind === "success" ? PALETTE.success : PALETTE.error, children: [
+        notice.kind === "success" ? "\u2713" : "\u2717",
+        " ",
+        notice.text
+      ] })
+    ] }),
+    footer,
+    /* @__PURE__ */ jsx58(Text49, { children: " " }),
+    /* @__PURE__ */ jsx58(
+      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: "edit" },
+          { keys: "c", label: "clear" },
+          { keys: "s", label: "save" },
+          { keys: "Esc/q", label: "back without saving" }
+        ]
+      }
+    )
+  ] });
+}
+var init_FieldForm = __esm({
+  "packages/experience-design-system-cli/src/tui/settings/shared/FieldForm.tsx"() {
+    "use strict";
+    init_theme();
+    init_control_hints();
+  }
+});
+
 // packages/experience-design-system-cli/src/tui/settings/contentful-configuration/config-store.ts
 async function readCredentials() {
   const store = await readV1Store();
@@ -33008,11 +33860,10 @@ var init_config_store = __esm({
   }
 });
 
-// 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 { Fragment as Fragment17, jsx as jsx55, jsxs as jsxs45 } from "react/jsx-runtime";
+// 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";
+import { jsx as jsx59, jsxs as jsxs48 } from "react/jsx-runtime";
 function debugFields(config) {
   return {
     space_id: config?.spaceId ?? "",
@@ -33024,189 +33875,159 @@ function debugFields(config) {
     contentful_base_dir: config?.contentfulBaseDir ?? ""
   };
 }
-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) => {
+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: FIELDS3,
+      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]);
+  );
+}
+var FIELDS3, valuesOf;
+var init_ProjectConfigScreen = __esm({
+  "packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ProjectConfigScreen.tsx"() {
+    "use strict";
+    init_theme();
+    init_debug_store();
+    init_FieldForm();
+    init_config_store();
+    FIELDS3 = [
+      { 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)" }
+    ];
+    valuesOf = (config) => Object.fromEntries(FIELDS3.map(({ key }) => [key, config[key] || ""]));
+  }
+});
+
+// packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ContentfulConfigScreen.tsx
+import { useState as useState33 } from "react";
+import { Box as Box48, Text as Text51, useInput as useInput14 } from "ink";
+import { jsx as jsx60, jsxs as jsxs49 } from "react/jsx-runtime";
+function ConfigurationScreen({ onDone }) {
+  const [focus, setFocus] = useState33(0);
+  const [open, setOpen] = useState33(null);
+  const close = () => setOpen(null);
+  useInput14((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" }
         ]
       }
     )
   ] });
 }
-var FIELD_ORDER, FIELD_LABELS, FIELD_HINTS, LABEL_WIDTH;
+var SECTIONS;
 var init_ContentfulConfigScreen = __esm({
   "packages/experience-design-system-cli/src/tui/settings/contentful-configuration/ContentfulConfigScreen.tsx"() {
     "use strict";
     init_theme();
-    init_config_store();
-    init_debug_store();
     init_control_hints();
-    FIELD_ORDER = [
-      "spaceId",
-      "environmentId",
-      "cmaToken",
-      "host",
-      "defaultComponentDir",
-      "defaultTokenFile",
-      "contentfulBaseDir"
+    init_AgentScreens();
+    init_ProjectConfigScreen();
+    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" }
     ];
-    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"
-    };
-    FIELD_HINTS = {
-      contentfulBaseDir: "(where .contentful goes)"
-    };
-    LABEL_WIDTH = Math.max(...Object.values(FIELD_LABELS).map((label) => label.length));
   }
 });
 
 // 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 { Fragment as Fragment18, jsx as jsx56, jsxs as jsxs46 } from "react/jsx-runtime";
+import { useEffect as useEffect25, useState as useState34 } from "react";
+import { Box as Box49, Text as Text52, useInput as useInput15 } from "ink";
+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);
@@ -33218,7 +34039,7 @@ function OptInAnalyticsScreen({ onDone }) {
       });
     });
   }, []);
-  useInput12((input, key) => {
+  useInput15((input, key) => {
     if (loading) return;
     if (key.return || input === " ") {
       setEnabled((current) => {
@@ -33233,21 +34054,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: [
@@ -33269,12 +34090,12 @@ var init_screen11 = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/upgrade/PageContainer.tsx
-import { useEffect as useEffect24, useState as useState31 } from "react";
-import { Box as Box46, Text as Text48, useInput as useInput13 } from "ink";
-import { jsx as jsx57, jsxs as jsxs47 } from "react/jsx-runtime";
+import { useEffect as useEffect26, useState as useState35 } from "react";
+import { Box as Box50, Text as Text53, useInput as useInput16 } from "ink";
+import { jsx as jsx62, jsxs as jsxs51 } from "react/jsx-runtime";
 function UpgradeScreen({ onDone }) {
-  const [upgradeCheck, setUpgradeCheck] = useState31();
-  useEffect24(() => {
+  const [upgradeCheck, setUpgradeCheck] = useState35();
+  useEffect26(() => {
     startDebugRun({
       flow: "upgrade",
       step: "01-upgrade",
@@ -33283,7 +34104,7 @@ function UpgradeScreen({ onDone }) {
     });
     checkForUpgrade().then(setUpgradeCheck).catch(() => setUpgradeCheck({ status: "error" }));
   }, []);
-  useInput13((_input, key) => {
+  useInput16((_input, key) => {
     if (key.return) {
       void finishDebugRun({
         outputs: upgradeCheck ?? {},
@@ -33294,12 +34115,12 @@ function UpgradeScreen({ onDone }) {
       return;
     }
   });
-  return /* @__PURE__ */ jsxs47(Box46, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx57(Text48, { bold: true, children: "Upgrade" }),
-    /* @__PURE__ */ jsx57(Text48, { children: " " }),
+  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__ */ jsx57(Text48, { children: " " }),
-    /* @__PURE__ */ jsxs47(Text48, { bold: true, color: PALETTE.accent, children: [
+    /* @__PURE__ */ jsx62(Text53, { children: " " }),
+    /* @__PURE__ */ jsxs51(Text53, { bold: true, color: PALETTE.accent, children: [
       FOCUS_MARKER,
       " Go Back"
     ] })
@@ -33307,34 +34128,34 @@ function UpgradeScreen({ onDone }) {
 }
 function renderBody(upgradeCheck) {
   if (!upgradeCheck) {
-    return /* @__PURE__ */ jsx57(Text48, { color: PALETTE.muted, children: "Checking for updates\u2026" });
+    return /* @__PURE__ */ jsx62(Text53, { color: PALETTE.muted, children: "Checking for updates\u2026" });
   }
   if (upgradeCheck.status === "error") {
-    return /* @__PURE__ */ jsx57(Text48, { color: PALETTE.warning, children: "Couldn't check for updates \u2014 check your network connection and try again." });
+    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__ */ jsxs47(Text48, { color: PALETTE.success, children: [
+    return /* @__PURE__ */ jsxs51(Text53, { color: PALETTE.success, children: [
       "You're already on the latest version (v",
       upgradeCheck.current,
       ")."
     ] });
   }
-  return /* @__PURE__ */ jsxs47(Box46, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsxs47(Text48, { color: PALETTE.muted, children: [
-      /* @__PURE__ */ jsxs47(Text48, { bold: true, color: PALETTE.success, children: [
+  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__ */ jsxs47(Text48, { bold: true, children: [
+      /* @__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__ */ jsx57(Text48, { children: " " }),
-    /* @__PURE__ */ jsx57(Box46, { flexDirection: "column", borderStyle: "round", borderColor: PALETTE.border, paddingX: 1, children: UPGRADE_COMMANDS.map((cmd) => /* @__PURE__ */ jsx57(Text48, { bold: true, children: cmd }, cmd)) })
+    /* @__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)) })
   ] });
 }
 var UPGRADE_COMMANDS;
@@ -33350,13 +34171,13 @@ var init_PageContainer4 = __esm({
 });
 
 // packages/experience-design-system-cli/src/tui/settings/debug-mode/screen.tsx
-import { useEffect as useEffect25, useState as useState32 } from "react";
-import { Box as Box47, Text as Text49, useInput as useInput14 } from "ink";
-import { jsx as jsx58, jsxs as jsxs48 } from "react/jsx-runtime";
+import { useEffect as useEffect27, useState as useState36 } from "react";
+import { Box as Box51, Text as Text54, useInput as useInput17 } from "ink";
+import { jsx as jsx63, jsxs as jsxs52 } from "react/jsx-runtime";
 function DebugModeScreen({ onDone }) {
-  const [loading, setLoading] = useState32(true);
-  const [enabled, setEnabled] = useState32(true);
-  useEffect25(() => {
+  const [loading, setLoading] = useState36(true);
+  const [enabled, setEnabled] = useState36(true);
+  useEffect27(() => {
     readDebugModeSetting().then((setting) => {
       setEnabled(setting.enabled);
       setLoading(false);
@@ -33368,7 +34189,7 @@ function DebugModeScreen({ onDone }) {
       });
     });
   }, []);
-  useInput14((input, key) => {
+  useInput17((input, key) => {
     if (loading) return;
     if (key.return || input === " ") {
       setEnabled((current) => {
@@ -33383,16 +34204,16 @@ function DebugModeScreen({ onDone }) {
       onDone();
     }
   });
-  return /* @__PURE__ */ jsxs48(Box47, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [
-    /* @__PURE__ */ jsx58(Text49, { bold: true, children: "Settings \u203A Debug Mode" }),
-    /* @__PURE__ */ jsx58(Text49, { children: " " }),
-    loading ? /* @__PURE__ */ jsx58(Text49, { color: PALETTE.muted, children: "Loading\u2026" }) : /* @__PURE__ */ jsxs48(Text49, { 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__ */ jsx58(Text49, { 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__ */ jsx58(Text49, { children: " " }),
-    /* @__PURE__ */ jsx58(
+    /* @__PURE__ */ jsx63(Text54, { children: " " }),
+    /* @__PURE__ */ jsx63(
       ControlHints,
       {
         hints: [
@@ -33418,20 +34239,20 @@ var app_exports = {};
 __export(app_exports, {
   runApp: () => runApp
 });
-import { join as join26 } from "node:path";
-import { useEffect as useEffect26, useState as useState33 } from "react";
-import { Fragment as Fragment19, jsx as jsx59 } from "react/jsx-runtime";
+import { join as join27 } from "node:path";
+import { useEffect as useEffect28, useState as useState37 } from "react";
+import { Fragment as Fragment20, jsx as jsx64 } from "react/jsx-runtime";
 function App({ importOptions, inkClear }) {
-  const [screen, setScreen] = useState33("start");
-  const [importExitCode, setImportExitCode] = useState33();
+  const [screen, setScreen] = useState37("start");
+  const [importExitCode, setImportExitCode] = useState37();
   const showImportResult = importExitCode !== void 0;
-  const [projectPath, setProjectPath] = useState33();
-  const [tokensPath, setTokensPath] = useState33();
-  const [scannedFiles, setScannedFiles] = useState33();
-  const [pendingLaunch, setPendingLaunch] = useState33();
-  const [extractionRun, setExtractionRun] = useState33();
+  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] = useState33();
+  const [scopeRun, setScopeRun] = useState37();
   const scopeFlow = useScopeGateFlow(
     scopeRun && {
       sessionId: scopeRun.extraction.sessionId,
@@ -33446,12 +34267,12 @@ function App({ importOptions, inkClear }) {
       }
     }
   );
-  const [generationInput, setGenerationInput] = useState33();
+  const [generationInput, setGenerationInput] = useState37();
   const generation = useGeneration(generationInput);
-  const [flowStart, setFlowStart] = useState33();
+  const [flowStart, setFlowStart] = useState37();
   const flow = useFlow(flowStart, { beforeStepChange: inkClear });
-  const [importDefaults, setImportDefaults] = useState33();
-  useEffect26(() => {
+  const [importDefaults, setImportDefaults] = useState37();
+  useEffect28(() => {
     if (screen !== "import") {
       setImportDefaults(void 0);
       return;
@@ -33469,7 +34290,7 @@ function App({ importOptions, inkClear }) {
     const launch = { projectPath: projectPath2, tokens, filePaths, ...importOptions };
     const state2 = await inspectTokens({
       rawTokensPath: tokens,
-      contentfulDir: join26(resolveUserPath(projectPath2), ".contentful"),
+      contentfulDir: join27(resolveUserPath(projectPath2), ".contentful"),
       cache: importOptions.cache
     });
     if (state2.kind === "cached") {
@@ -33511,12 +34332,12 @@ function App({ importOptions, inkClear }) {
       }
     });
   };
-  useEffect26(() => {
+  useEffect28(() => {
     if (!extractionRun || extraction?.status !== "done" || !extraction.result.ok) return;
     setExtractionRun(void 0);
     setScopeRun({ ...extractionRun, extraction: extraction.result.extraction });
   }, [extraction, extractionRun]);
-  useEffect26(() => {
+  useEffect28(() => {
     if (!scopeRun || scopeFlow?.status !== "confirmed" || generationInput) return;
     const { extraction: produced, input, generatePromptPath } = scopeRun;
     setGenerationInput({
@@ -33534,7 +34355,7 @@ function App({ importOptions, inkClear }) {
       ...generatePromptPath ? { generatePromptPath } : {}
     });
   }, [scopeFlow, scopeRun, generationInput]);
-  useEffect26(() => {
+  useEffect28(() => {
     if (!scopeRun || generation?.status !== "done" || !generation.result.ok) return;
     const { credentialsSkipped, tokenStrategy, extraction: produced, input, generatePromptPath } = scopeRun;
     inkClear();
@@ -33577,9 +34398,9 @@ function App({ importOptions, inkClear }) {
   };
   switch (screen) {
     case "import":
-      if (showImportResult) return /* @__PURE__ */ jsx59(ImportScreen, { exitCode: importExitCode, onDone: finishImportResult });
+      if (showImportResult) return /* @__PURE__ */ jsx64(ImportScreen, { exitCode: importExitCode, onDone: finishImportResult });
       if (flow && flowStart) {
-        return /* @__PURE__ */ jsx59(
+        return /* @__PURE__ */ jsx64(
           FlowScreen,
           {
             state: flow.state,
@@ -33589,12 +34410,12 @@ function App({ importOptions, inkClear }) {
           }
         );
       }
-      if (importDefaults === void 0) return /* @__PURE__ */ jsx59(Fragment19, {});
+      if (importDefaults === void 0) return /* @__PURE__ */ jsx64(Fragment20, {});
       if (projectPath === void 0) {
-        return /* @__PURE__ */ jsx59(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__ */ jsx59(
+        return /* @__PURE__ */ jsx64(
           TokenInputScreen,
           {
             initialPath: importDefaults.tokenFile,
@@ -33604,7 +34425,7 @@ function App({ importOptions, inkClear }) {
         );
       }
       if (scannedFiles === void 0) {
-        return /* @__PURE__ */ jsx59(
+        return /* @__PURE__ */ jsx64(
           PathValidationScreen,
           {
             projectPath,
@@ -33616,10 +34437,10 @@ function App({ importOptions, inkClear }) {
       }
       if (extractionRun) {
         if (extraction?.status === "done" && !extraction.result.ok) {
-          return /* @__PURE__ */ jsx59(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__ */ jsx59(
+          return /* @__PURE__ */ jsx64(
             ExtractionScreen,
             {
               progress: extraction.progress,
@@ -33628,14 +34449,14 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx59(Fragment19, {});
+        return /* @__PURE__ */ jsx64(Fragment20, {});
       }
       if (scopeRun && scopeFlow) {
         if (scopeFlow.status === "failed") {
-          return /* @__PURE__ */ jsx59(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__ */ jsx59(
+          return /* @__PURE__ */ jsx64(
             ScopeGateScreen,
             {
               components: scopeFlow.load.components,
@@ -33645,7 +34466,7 @@ function App({ importOptions, inkClear }) {
           );
         }
         if (generation?.status === "done" && !generation.result.ok) {
-          return /* @__PURE__ */ jsx59(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 !== "";
@@ -33653,7 +34474,7 @@ function App({ importOptions, inkClear }) {
             hasRawTokens,
             mapTokensEligible: generation.progress.mapTokensEligible
           });
-          return /* @__PURE__ */ jsx59(
+          return /* @__PURE__ */ jsx64(
             GenerationScreen,
             {
               progress: generation.progress,
@@ -33665,10 +34486,10 @@ function App({ importOptions, inkClear }) {
             }
           );
         }
-        return /* @__PURE__ */ jsx59(Fragment19, {});
+        return /* @__PURE__ */ jsx64(Fragment20, {});
       }
       if (pendingLaunch?.cached) {
-        return /* @__PURE__ */ jsx59(
+        return /* @__PURE__ */ jsx64(
           TokenReuseScreen,
           {
             tokensPath: pendingLaunch.cached.tokensPath,
@@ -33679,7 +34500,7 @@ function App({ importOptions, inkClear }) {
           }
         );
       }
-      return /* @__PURE__ */ jsx59(
+      return /* @__PURE__ */ jsx64(
         CredentialsScreen,
         {
           initial: importDefaults.credentials,
@@ -33688,19 +34509,19 @@ function App({ importOptions, inkClear }) {
         }
       );
     case "help":
-      return /* @__PURE__ */ jsx59(HelpScreen, { onDone: goToStart });
+      return /* @__PURE__ */ jsx64(HelpScreen, { onDone: goToStart });
     case "upgrade":
-      return /* @__PURE__ */ jsx59(UpgradeScreen, { onDone: goToStart });
+      return /* @__PURE__ */ jsx64(UpgradeScreen, { onDone: goToStart });
     case "settings":
-      return /* @__PURE__ */ jsx59(SettingsScreen, { onNavigate: setScreen, onBack: goToStart });
+      return /* @__PURE__ */ jsx64(SettingsScreen, { onNavigate: setScreen, onBack: goToStart });
     case "settings-configuration":
-      return /* @__PURE__ */ jsx59(ConfigurationScreen, { onDone: goToSettings });
+      return /* @__PURE__ */ jsx64(ConfigurationScreen, { onDone: goToSettings });
     case "settings-opt-in-analytics":
-      return /* @__PURE__ */ jsx59(OptInAnalyticsScreen, { onDone: goToSettings });
+      return /* @__PURE__ */ jsx64(OptInAnalyticsScreen, { onDone: goToSettings });
     case "settings-debug-mode":
-      return /* @__PURE__ */ jsx59(DebugModeScreen, { onDone: goToSettings });
+      return /* @__PURE__ */ jsx64(DebugModeScreen, { onDone: goToSettings });
     case "start":
-      return /* @__PURE__ */ jsx59(HomeScreen, { onNavigate: setScreen });
+      return /* @__PURE__ */ jsx64(HomeScreen, { onNavigate: setScreen });
   }
 }
 async function runApp(renderApp, importOptions) {
@@ -33708,7 +34529,7 @@ async function runApp(renderApp, importOptions) {
     instance.clear?.();
     process.stdout.write("\x1B[H\x1B[0J");
   };
-  const instance = renderApp(/* @__PURE__ */ jsx59(App, { importOptions, inkClear }));
+  const instance = renderApp(/* @__PURE__ */ jsx64(App, { importOptions, inkClear }));
   await instance.waitUntilExit();
 }
 var init_app = __esm({
@@ -33743,7 +34564,7 @@ var init_app = __esm({
 // packages/experience-design-system-cli/program.ts
 init_src4();
 import { readFileSync as readFileSync9 } from "node:fs";
-import { join as join27 } from "node:path";
+import { join as join28 } from "node:path";
 import { Command } from "commander";
 
 // packages/experience-design-system-cli/src/commands/import-options.ts
@@ -33771,14 +34592,14 @@ function runDevWatch(args) {
     process.stderr.write("--watch only works from a checkout of the repo (scripts/dev.mjs is not in the package).\n");
     return Promise.resolve(1);
   }
-  return new Promise((resolve27) => {
+  return new Promise((resolve28) => {
     const child = spawn3(process.execPath, [script, ...args], { stdio: "inherit" });
     process.on("SIGINT", () => void 0);
-    child.on("exit", (code) => resolve27(code ?? 0));
+    child.on("exit", (code) => resolve28(code ?? 0));
     child.on("error", (err) => {
       process.stderr.write(`${err.message}
 `);
-      resolve27(1);
+      resolve28(1);
     });
   });
 }
@@ -33803,11 +34624,13 @@ function registerImportCommand(program, openTui) {
 }
 
 // packages/experience-design-system-cli/program.ts
+init_agent_store();
+init_apply_binary_overrides();
 init_analytics_store();
 init_package_root();
 var pkg = JSON.parse(
   readFileSync9(
-    join27(findPackageRoot(import.meta.url, "@contentful/experience-design-system-cli"), "package.json"),
+    join28(findPackageRoot(import.meta.url, "@contentful/experience-design-system-cli"), "package.json"),
     "utf8"
   )
 );
@@ -33824,6 +34647,7 @@ function createProgram() {
     const commandChain = chain.join(" ") || actionCommand.name();
     const { enabled } = await readAnalyticsSetting();
     setPersistedAnalyticsDisabled(!enabled);
+    await readAgentConfig().then(applyBinaryOverrides, () => void 0);
     setCliVersion(pkg.version);
     noteCommandStart(commandChain);
   });
@@ -33847,7 +34671,7 @@ init_config();
 init_package_root();
 import { existsSync as existsSync11 } from "node:fs";
 import { mkdir as mkdir10, readFile as readFile19, rename as rename3, rmdir, unlink } from "node:fs/promises";
-import { dirname as dirname16, join as join28 } from "node:path";
+import { dirname as dirname16, join as join29 } from "node:path";
 var PACKAGE_NAME3 = "@contentful/experience-design-system-cli";
 async function readJson(path5) {
   try {
@@ -33858,9 +34682,9 @@ async function readJson(path5) {
 }
 async function migrateOldConfig() {
   try {
-    const oldCredentials = join28(oldConfigDir2(), "credentials.json");
-    const oldRuns = join28(oldConfigDir2(), "runs.json");
-    const oldDebugMode = join28(
+    const oldCredentials = join29(oldConfigDir2(), "credentials.json");
+    const oldRuns = join29(oldConfigDir2(), "runs.json");
+    const oldDebugMode = join29(
       findPackageRoot(import.meta.url, PACKAGE_NAME3),
       ".contentful",
       "config",