@ouro.bot/cli 0.1.0-alpha.445 → 0.1.0-alpha.447

package/README.md

@@ -99,7 +99,7 @@ Task docs do not live in this repo anymore. Planning and doing docs live in the
 - Vault unlock material is local machine state. Prefer macOS Keychain, Windows DPAPI, or Linux Secret Service; plaintext fallback is allowed only by explicit human choice.
 - New vault unlock secrets are confirmed before use and rejected if they do not meet the minimum strength requirements.
 - Provider and runtime credentials are loaded into process memory at startup/auth/unlock/refresh and reused. The remote vault is not queried for every model or sense request.
-- Human TTY commands share one CLI surface family: bare `ouro` opens the home deck, `ouro up`/`ouro connect`/`ouro auth verify`/`ouro repair` reuse the same readiness truth, and `ouro help`/`ouro whoami`/`ouro versions`/`ouro hatch` render from the same Ouro-branded board layer.
+- Human TTY commands share one CLI surface family: bare `ouro` opens the home deck, `ouro up` uses the boot checklist, `ouro connect`/`ouro auth verify`/`ouro repair` reuse the same readiness truth, and `ouro help`/`ouro whoami`/`ouro versions`/`ouro hatch` render through the same Ouro-branded wizard/guide language instead of raw transcript walls.
 - Human-facing CLI commands that can wait on browser auth, vault IO, daemon startup, daemon restart, provider checks, or connector setup use a shared progress checklist. If a cursor may blink for more than a few seconds, the command should print or animate the current step instead of going quiet.
 - CLI commands that mutate bundle config, such as vault setup or `ouro connect bluebubbles`, run bundle sync after the change when `sync.enabled` is true and report a compact `bundle sync:` line.
 - The daemon discovers bundles dynamically from `~/AgentBundles`.

package/changelog.json

@@ -1,6 +1,22 @@
 {
   "_note": "This changelog is maintained as part of the PR/version-bump workflow. Agent-curated, not auto-generated. Agents read this file directly via read_file to understand what changed between versions.",
   "versions": [
+    {
+      "version": "0.1.0-alpha.447",
+      "changes": [
+        "`ouro connect` now checks only the providers selected for the current agent lanes during preflight, and those live reads avoid mutating the older provider snapshot cache. That keeps the command focused on what this machine actually needs instead of paying whole-vault latency for unrelated provider records.",
+        "Structured vault reads for `providers/*` and `runtime/config` now reuse one short-lived Bitwarden item listing per store instance and skip redundant `bw sync` calls while the local Bitwarden cache is fresh, cutting repeated vault startup work without adding any disk credential cache.",
+        "The connections screen now lets the fresh live provider check outrank stale local credential visibility, so a provider that just passed appears ready and a provider that just failed shows the real live-check failure instead of falling back to misleading `credentials missing` guidance. `@ouro.bot/cli` and the `ouro.bot` wrapper are version-synced for the connect preflight latency release."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.446",
+      "changes": [
+        "`ouro connect`, the home deck, readiness repair prompts, and the interactive repair queue now render through one shared wizard language instead of a mix of framed panels and transcript walls. Humans can choose by number or name, see one recommended next step, and keep the same visual footing across setup and repair.",
+        "Connector, auth, vault, hatch, and other info-heavy command flows now use a matching guide surface with the same Ouro masthead, ruled sections, and `Next moves` treatment, so the CLI stops jumping between unrelated visual grammars as soon as a command leaves the root menu.",
+        "The new surfaces stay truthful to the underlying work: connect still runs the shared live provider verification path before rendering, repair prompts surface the real next command without dead air, and new renderer plus command-layer coverage lock the wizard/guide family into the shipped CLI."
+      ]
+    },
     {
       "version": "0.1.0-alpha.445",
       "changes": [

package/dist/heart/daemon/agent-config-check.js

@@ -330,12 +330,20 @@ function selectedProviderPlan(agentName, state) {
         ...["outward", "inner"].map((lane) => `- ${laneAudienceLabel(lane)}: ${bindingLabel(state.lanes[lane])}`),
     ].join("\n");
 }
+function selectedProvidersForState(state) {
+    return [...new Set(["outward", "inner"].map((lane) => state.lanes[lane].provider))];
+}
 function mapVaultRefreshProgress(agentName, onProgress) {
     return (message) => {
         if (message.startsWith("reading vault items for ")) {
             onProgress(`${agentName}: opening saved provider credentials in the vault`);
             return;
         }
+        const providerRead = message.match(/^reading ([a-z0-9-]+) credentials\.\.\.$/i);
+        if (providerRead) {
+            onProgress(`${agentName}: reading saved ${providerRead[1]} credentials`);
+            return;
+        }
         if (message === "parsing provider credentials...") {
             onProgress(`${agentName}: organizing saved provider credentials`);
         }
@@ -381,7 +389,12 @@ async function checkAgentConfigWithProviderHealth(agentName, bundlesRoot, deps =
         return { ok: true };
     deps.onProgress?.(selectedProviderPlan(agentName, stateResult.state));
     const ping = deps.pingProvider ?? (await Promise.resolve().then(() => __importStar(require("../provider-ping")))).pingProvider;
-    const poolResult = await (0, provider_credentials_1.refreshProviderCredentialPool)(agentName, deps.onProgress ? { onProgress: mapVaultRefreshProgress(agentName, deps.onProgress) } : undefined);
+    const providers = selectedProvidersForState(stateResult.state);
+    const poolResult = await (0, provider_credentials_1.refreshProviderCredentialPool)(agentName, {
+        ...(deps.onProgress ? { onProgress: mapVaultRefreshProgress(agentName, deps.onProgress) } : {}),
+        providers,
+        skipCache: true,
+    });
     const pingGroups = new Map();
     const lanes = ["outward", "inner"];
     for (const lane of lanes) {

package/dist/heart/daemon/agentic-repair.js

@@ -52,6 +52,8 @@ function makeInteractiveRepairDeps(deps) {
         runAuthFlow: deps.runAuthFlow ?? (async () => undefined),
         runVaultUnlock: deps.runVaultUnlock,
         skipQueueSummary: deps.skipQueueSummary,
+        isTTY: deps.isTTY,
+        stdoutColumns: deps.stdoutColumns,
     };
 }
 async function runDeterministicRepair(degraded, deps) {

package/dist/heart/daemon/cli-exec.js

@@ -2060,11 +2060,33 @@ async function buildConnectMenu(agent, deps, onProgress) {
     onProgress?.("loading this machine's settings");
     const machineRuntime = await (0, runtime_credentials_1.refreshMachineRuntimeCredentialConfig)(agent, currentMachineId(deps), { preserveCachedOnFailure: true });
     const { teamsEnabled, blueBubblesEnabled } = readConnectBaySenseFlags(agent, deps);
-    let perplexityStatus;
-    let perplexityDetailLines;
     const perplexityApiKey = runtimeConfig.ok
         ? readRuntimeConfigString(runtimeConfig.config, "integrations.perplexityApiKey")
         : null;
+    const embeddingsApiKey = runtimeConfig.ok
+        ? readRuntimeConfigString(runtimeConfig.config, "integrations.openaiEmbeddingsApiKey")
+        : null;
+    const shouldVerifyPerplexity = runtimeConfig.ok && !!perplexityApiKey;
+    const shouldVerifyEmbeddings = runtimeConfig.ok && !!embeddingsApiKey;
+    let perplexityVerification;
+    let embeddingsVerification;
+    if (shouldVerifyPerplexity && shouldVerifyEmbeddings) {
+        onProgress?.("verifying Perplexity search and memory embeddings");
+        [perplexityVerification, embeddingsVerification] = await Promise.all([
+            (0, runtime_capability_check_1.verifyPerplexityCapability)(perplexityApiKey),
+            (0, runtime_capability_check_1.verifyEmbeddingsCapability)(embeddingsApiKey),
+        ]);
+    }
+    else if (shouldVerifyPerplexity) {
+        onProgress?.("verifying Perplexity search");
+        perplexityVerification = await (0, runtime_capability_check_1.verifyPerplexityCapability)(perplexityApiKey);
+    }
+    else if (shouldVerifyEmbeddings) {
+        onProgress?.("verifying memory embeddings");
+        embeddingsVerification = await (0, runtime_capability_check_1.verifyEmbeddingsCapability)(embeddingsApiKey);
+    }
+    let perplexityStatus;
+    let perplexityDetailLines;
     if (!runtimeConfig.ok) {
         perplexityStatus = runtimeConfigReadStatus(runtimeConfig);
         perplexityDetailLines = [];
@@ -2074,16 +2096,15 @@ async function buildConnectMenu(agent, deps, onProgress) {
         perplexityDetailLines = ["no API key saved yet"];
     }
     else {
-        onProgress?.("verifying Perplexity search");
-        const verification = await (0, runtime_capability_check_1.verifyPerplexityCapability)(perplexityApiKey);
-        perplexityStatus = verification.ok ? "ready" : "needs attention";
-        perplexityDetailLines = [verification.ok ? "verified live just now" : `live check failed: ${verification.summary}`];
+        perplexityStatus = perplexityVerification?.ok ? "ready" : "needs attention";
+        perplexityDetailLines = [
+            perplexityVerification?.ok
+                ? "verified live just now"
+                : `live check failed: ${perplexityVerification.summary}`,
+        ];
     }
     let embeddingsStatus;
     let embeddingsDetailLines;
-    const embeddingsApiKey = runtimeConfig.ok
-        ? readRuntimeConfigString(runtimeConfig.config, "integrations.openaiEmbeddingsApiKey")
-        : null;
     if (!runtimeConfig.ok) {
         embeddingsStatus = runtimeConfigReadStatus(runtimeConfig);
         embeddingsDetailLines = [];
@@ -2093,10 +2114,12 @@ async function buildConnectMenu(agent, deps, onProgress) {
         embeddingsDetailLines = ["no API key saved yet"];
     }
     else {
-        onProgress?.("verifying memory embeddings");
-        const verification = await (0, runtime_capability_check_1.verifyEmbeddingsCapability)(embeddingsApiKey);
-        embeddingsStatus = verification.ok ? "ready" : "needs attention";
-        embeddingsDetailLines = [verification.ok ? "verified live just now" : `live check failed: ${verification.summary}`];
+        embeddingsStatus = embeddingsVerification?.ok ? "ready" : "needs attention";
+        embeddingsDetailLines = [
+            embeddingsVerification?.ok
+                ? "verified live just now"
+                : `live check failed: ${embeddingsVerification.summary}`,
+        ];
     }
     const teamsStatus = runtimeConfig.ok
         ? hasRuntimeConfigValue(runtimeConfig.config, "teams.clientId")
@@ -4316,6 +4339,8 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
                             await executeVaultUnlock({ kind: "vault.unlock", agent }, deps);
                         },
                         skipQueueSummary: true,
+                        isTTY: deps.isTTY ?? process.stdout.isTTY === true,
+                        stdoutColumns: deps.stdoutColumns ?? process.stdout.columns,
                     });
                     if (repairResult.repairsAttempted) {
                         repairsAttempted = true;

package/dist/heart/daemon/connect-bay.js

@@ -17,52 +17,6 @@ const CONNECT_STATUS_PRIORITY = {
     ready: 6,
     attached: 6,
 };
-const RESET = "\x1b[0m";
-const BOLD = "\x1b[1m";
-const TEAL = "\x1b[38;2;78;201;176m";
-const GREEN = "\x1b[38;2;46;204;64m";
-const GOLD = "\x1b[38;2;230;190;50m";
-const BONE = "\x1b[38;2;238;242;234m";
-const MIST = "\x1b[38;2;165;184;168m";
-const ANSI_RE = /\x1b\[[0-9;]*m/g;
-function stripAnsi(text) {
-    return text.replace(ANSI_RE, "");
-}
-function visibleLength(text) {
-    return stripAnsi(text).length;
-}
-function padAnsi(text, width) {
-    const missing = Math.max(0, width - visibleLength(text));
-    return `${text}${" ".repeat(missing)}`;
-}
-function wrapPlain(text, width) {
-    const normalized = text.trim();
-    if (!normalized)
-        return [""];
-    const words = normalized.split(/\s+/);
-    const lines = [];
-    let current = "";
-    for (const word of words) {
-        if (!current) {
-            current = word;
-            continue;
-        }
-        const candidate = `${current} ${word}`;
-        if (candidate.length <= width) {
-            current = candidate;
-            continue;
-        }
-        lines.push(current);
-        current = word;
-    }
-    lines.push(current);
-    return lines;
-}
-function tty(text, color, bold = false) {
-    if (bold)
-        return `${color}${BOLD}${text}${RESET}`;
-    return `${color}${text}${RESET}`;
-}
 function escapeRegExp(value) {
     return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
@@ -130,216 +84,102 @@ function resolveProviderHealthCommand(providerHealth, status) {
     }
     return undefined;
 }
-function isProblemStatus(status) {
-    return status !== "ready" && status !== "attached";
-}
-function statusChip(status) {
-    const symbol = status === "ready" || status === "attached"
-        ? "●"
-        : status === "not attached"
-            ? "◌"
-            : "◆";
-    const label = `${symbol} ${status}`;
-    if (status === "ready" || status === "attached")
-        return tty(label, GREEN, true);
-    if (status === "not attached")
-        return tty(label, MIST);
-    return tty(label, GOLD, true);
-}
-function sectionTitle(title, width) {
-    const plain = `╭─ ${title} `;
-    const rule = "─".repeat(Math.max(0, width - plain.length - 1));
-    return `${tty("╭─ ", TEAL)}${tty(title, BONE, true)}${tty(` ${rule}╮`, TEAL)}`;
-}
-function bottomRule(width) {
-    const line = `╰${"─".repeat(Math.max(0, width - 2))}╯`;
-    return tty(line, TEAL);
+function providerHealthTargetLane(providerHealth) {
+    const issue = providerHealth?.issue;
+    const actionLane = issue?.actions
+        .map((action) => "lane" in action && action.lane ? action.lane : undefined)
+        .find((lane) => lane === "outward" || lane === "inner");
+    if (actionLane)
+        return actionLane;
+    const text = [issue?.summary, issue?.detail, providerHealth?.error]
+        .filter(Boolean)
+        .join(" ")
+        .toLowerCase();
+    if (/\boutward provider\b/.test(text) || /\boutward lane\b/.test(text))
+        return "outward";
+    if (/\binner provider\b/.test(text) || /\binner lane\b/.test(text))
+        return "inner";
+    return undefined;
 }
-function bodyLine(text, width) {
-    const padded = padAnsi(text, Math.max(0, width - 4));
-    return `${tty("│ ", TEAL)}${padded}${tty(" │", TEAL)}`;
+function providerHealthAppliesToLane(providerHealth, lane) {
+    const targetLane = providerHealthTargetLane(providerHealth);
+    return !targetLane || targetLane === lane.lane;
 }
-function panel(title, body, width) {
-    const lines = [sectionTitle(title, width)];
-    for (const line of body) {
-        lines.push(bodyLine(line, width));
+function providerHealthDetail(providerHealth, status) {
+    if (status === "locked")
+        return "vault locked on this machine";
+    if (status === "needs credentials")
+        return "credentials missing";
+    if (status === "needs setup") {
+        return providerHealth?.issue?.detail ?? providerHealth?.error ?? "needs setup";
     }
-    lines.push(bottomRule(width));
-    return lines;
+    const detail = providerHealth?.issue?.detail ?? providerHealth?.error;
+    if (!detail)
+        return "live check needs attention";
+    return /failed live check/i.test(detail) ? detail : `failed live check: ${detail}`;
 }
-function renderHeader(agent, width) {
-    return panel(`${agent} connections`, [
-        tty("Set up or review one capability at a time.", BONE, true),
-        tty("Everything on this screen was checked live just now.", MIST),
-    ], width);
-}
-function nextMoveBody(entry) {
-    if (!entry) {
-        return [
-            tty("Everything here is ready.", BONE, true),
-            tty("Pick what you want to review or refresh.", MIST),
-        ];
-    }
-    const lines = [
-        `${entry.name}  ${statusChip(entry.status)}`,
-    ];
-    if (entry.nextNote)
-        lines.push(entry.nextNote);
-    if (entry.nextAction)
-        lines.push(tty(entry.nextAction, MIST));
-    return lines;
+function isProblemStatus(status) {
+    return status !== "ready" && status !== "attached";
 }
-function renderProviderBody(entry, width) {
-    const lines = [
-        `${entry.option}  ${entry.name}  ${statusChip(entry.status)}`,
-    ];
-    const lanes = entry.laneSummaries ?? [];
-    for (const [index, lane] of lanes.entries()) {
-        if (index > 0)
-            lines.push("");
-        const laneLabel = lane.lane === "outward" ? "Outward lane" : "Inner lane";
-        lines.push(tty(laneLabel, BONE, true));
-        lines.push(lane.title);
-        lines.push(isProblemStatus(lane.status) ? lane.detail : tty(lane.detail, MIST));
-    }
-    if (lanes.length === 0) {
-        for (const detail of entry.detailLines ?? [])
-            lines.push(detail);
-    }
-    return normalizeWrappedBody(lines, width);
+function providerEntrySummary(entry) {
+    return entry.description ?? "Selected provider lanes for this machine.";
 }
-function renderCapabilityBody(entries, width) {
+function providerEntryDetailLines(entry) {
     const lines = [];
-    for (const [index, entry] of entries.entries()) {
-        if (index > 0)
-            lines.push("");
-        lines.push(`${entry.option}  ${entry.name}  ${statusChip(entry.status)}`);
-        if (entry.description) {
-            lines.push(isProblemStatus(entry.status) ? entry.description : tty(entry.description, MIST));
-        }
-        for (const detail of entry.detailLines ?? []) {
-            lines.push(detail);
-        }
+    if (entry.nextNote && !/^(Outward|Inner) lane: /.test(entry.nextNote)) {
+        lines.push(entry.nextNote);
     }
-    return normalizeWrappedBody(lines, width);
-}
-function normalizeWrappedBody(lines, width) {
-    const wrapped = [];
-    for (const line of lines) {
-        if (!line) {
-            wrapped.push("");
-            continue;
-        }
-        const plain = stripAnsi(line);
-        if (plain.length <= width - 4) {
-            wrapped.push(line);
-            continue;
+    if (entry.laneSummaries && entry.laneSummaries.length > 0) {
+        for (const lane of entry.laneSummaries) {
+            const laneLabel = lane.lane === "outward" ? "Outward lane" : "Inner lane";
+            lines.push(`${laneLabel}: ${lane.title} — ${lane.detail}`);
         }
-        const segments = wrapPlain(plain, width - 4);
-        wrapped.push(...segments);
+        return lines;
     }
-    return wrapped;
+    return [...lines, ...(entry.detailLines ?? [])];
 }
-function stackPanels(panels) {
-    const lines = [];
-    for (const [index, panelLines] of panels.entries()) {
-        if (index > 0)
-            lines.push("");
-        lines.push(...panelLines);
-    }
-    return lines;
-}
-function combineColumns(left, right, leftWidth, rightWidth, gap = 2) {
-    const total = Math.max(left.length, right.length);
-    const lines = [];
-    for (let index = 0; index < total; index += 1) {
-        const leftLine = left[index] ?? " ".repeat(leftWidth);
-        const rightLine = right[index] ?? " ".repeat(rightWidth);
-        lines.push(`${padAnsi(leftLine, leftWidth)}${" ".repeat(gap)}${padAnsi(rightLine, rightWidth)}`);
-    }
-    return lines;
-}
-function renderTtyBay(entries, options) {
-    const columns = Math.max(options.columns ?? 108, 72);
-    const fullWidth = Math.max(56, columns - 2);
-    const masthead = (0, terminal_ui_1.renderOuroMasthead)({
-        isTTY: true,
-        columns,
-        subtitle: "Set up connections one step at a time.",
-    }).trimEnd();
-    const header = renderHeader(options.agent, fullWidth);
-    const nextEntry = entries.find((entry) => isProblemStatus(entry.status));
-    const providerEntry = entries.find((entry) => entry.section === "Providers");
-    const portableEntries = entries.filter((entry) => entry.section === "Portable");
-    const machineEntries = entries.filter((entry) => entry.section === "This machine");
-    const wide = columns >= 118;
-    const footer = [
-        tty("Choose a number, or type the capability name.", MIST),
-        options.prompt,
+function capabilityEntryDetailLines(entry) {
+    return [
+        ...(entry.detailLines ?? []),
+        ...(entry.nextNote ? [entry.nextNote] : []),
     ];
-    if (!wide) {
-        const panels = [
-            header,
-            panel("Recommended next step", nextMoveBody(nextEntry), fullWidth),
-            panel("Providers", renderProviderBody(providerEntry, fullWidth), fullWidth),
-            panel("Portable", renderCapabilityBody(portableEntries, fullWidth), fullWidth),
-            panel("This machine", renderCapabilityBody(machineEntries, fullWidth), fullWidth),
-        ];
-        return [masthead, "", ...stackPanels(panels), "", ...footer].join("\n");
-    }
-    const gap = 2;
-    const leftWidth = Math.max(52, Math.floor((fullWidth - gap) / 2));
-    const rightWidth = Math.max(40, fullWidth - gap - leftWidth);
-    const topRow = combineColumns(panel("Recommended next step", nextMoveBody(nextEntry), leftWidth), panel("This machine", renderCapabilityBody(machineEntries, rightWidth), rightWidth), leftWidth, rightWidth, gap);
-    const bottomRow = combineColumns(panel("Providers", renderProviderBody(providerEntry, leftWidth), leftWidth), panel("Portable", renderCapabilityBody(portableEntries, rightWidth), rightWidth), leftWidth, rightWidth, gap);
-    return [masthead, "", ...header, "", ...topRow, "", ...bottomRow, "", ...footer].join("\n");
 }
-function renderNonTtyBay(entries, options) {
+function entryToWizardItem(entry) {
+    return {
+        key: entry.option,
+        label: entry.name,
+        status: entry.status,
+        ...(entry.section === "Providers"
+            ? { summary: providerEntrySummary(entry) }
+            : entry.description
+                ? { summary: entry.description }
+                : {}),
+        detailLines: entry.section === "Providers"
+            ? providerEntryDetailLines(entry)
+            : capabilityEntryDetailLines(entry),
+        ...(entry.nextAction ? { command: entry.nextAction } : {}),
+    };
+}
+function nextStepFor(entries) {
     const nextEntry = entries.find((entry) => isProblemStatus(entry.status));
-    const lines = [
-        `${options.agent} connections`,
-        "Set up or review one capability at a time. Provider status was checked live just now.",
-        "",
-        "Recommended next step",
-        "---------------------",
-    ];
     if (!nextEntry) {
-        lines.push("Everything here is ready. Pick what you want to review or refresh.");
-    }
-    else {
-        lines.push(`${nextEntry.name} - ${nextEntry.status}`);
-        if (nextEntry.nextNote)
-            lines.push(nextEntry.nextNote);
-        if (nextEntry.nextAction)
-            lines.push(`run: ${nextEntry.nextAction}`);
-    }
-    lines.push("");
-    for (const section of ["Providers", "Portable", "This machine"]) {
-        lines.push(section);
-        lines.push("-".repeat(Math.max(6, section.length + 4)));
-        for (const entry of entries.filter((candidate) => candidate.section === section)) {
-            lines.push(`${entry.option}. ${entry.name} [${entry.status}]`);
-            if (entry.laneSummaries && entry.laneSummaries.length > 0) {
-                for (const lane of entry.laneSummaries) {
-                    const laneLabel = lane.lane === "outward" ? "Outward lane" : "Inner lane";
-                    lines.push(`   ${laneLabel}: ${lane.title}`);
-                    lines.push(`     ${lane.detail}`);
-                }
-            }
-            else {
-                for (const detail of entry.detailLines ?? [])
-                    lines.push(`   ${detail}`);
-            }
-            if (entry.description)
-                lines.push(`   ${entry.description}`);
-            lines.push("");
-        }
+        return {
+            label: "Everything here is already connected.",
+            detail: "Pick any capability if you want to review it, refresh it, or change its setup.",
+        };
     }
-    lines.push("6. Not now");
-    lines.push("");
-    lines.push("Choose a number, or type the capability name.");
-    lines.push(options.prompt);
-    return lines.join("\n");
+    return {
+        label: `Start with ${nextEntry.name}.`,
+        detail: nextEntry.nextNote ?? nextEntry.description ?? `Status: ${nextEntry.status}.`,
+        command: nextEntry.nextAction,
+    };
+}
+function sectionToWizard(entries, section, summary) {
+    return {
+        title: section,
+        summary,
+        items: entries.filter((entry) => entry.section === section).map((entry) => entryToWizardItem(entry)),
+    };
 }
 function summarizeProviderLane(agent, lane, providerHealth) {
     const providerHealthStatus = resolveProviderHealthStatus(providerHealth);
@@ -354,6 +194,23 @@ function summarizeProviderLane(agent, lane, providerHealth) {
         };
     }
     const fallbackAction = providerHealthCommand ?? lane.credential.repairCommand;
+    if (providerHealth?.ok) {
+        return {
+            lane: lane.lane,
+            status: "ready",
+            title: `${lane.provider} / ${lane.model}`,
+            detail: "ready",
+        };
+    }
+    if (providerHealthStatus && providerHealthAppliesToLane(providerHealth, lane)) {
+        return {
+            lane: lane.lane,
+            status: providerHealthStatus,
+            title: `${lane.provider} / ${lane.model}`,
+            detail: providerHealthDetail(providerHealth, providerHealthStatus),
+            action: fallbackAction,
+        };
+    }
     if (lane.credential.status === "missing") {
         return {
             lane: lane.lane,
@@ -372,14 +229,6 @@ function summarizeProviderLane(agent, lane, providerHealth) {
             action: fallbackAction,
         };
     }
-    if (providerHealth?.ok) {
-        return {
-            lane: lane.lane,
-            status: "ready",
-            title: `${lane.provider} / ${lane.model}`,
-            detail: "ready",
-        };
-    }
     if (lane.readiness.status === "failed") {
         return {
             lane: lane.lane,
@@ -450,7 +299,25 @@ function renderConnectBay(entries, options) {
             columns: options.columns ?? null,
         },
     });
-    if (!options.isTTY)
-        return renderNonTtyBay(entries, options);
-    return renderTtyBay(entries, options);
+    return (0, terminal_ui_1.renderTerminalWizard)({
+        isTTY: options.isTTY,
+        columns: options.columns,
+        masthead: {
+            subtitle: "Set up connections one step at a time.",
+        },
+        title: `Connect ${options.agent}`,
+        summary: "Choose one capability to bring online. Each row tells you whether Ouro checked it live just now or is showing saved setup on this machine.",
+        nextStep: nextStepFor(entries),
+        sections: [
+            sectionToWizard(entries, "Providers", "Selected outward and inner lanes for this machine."),
+            sectionToWizard(entries, "Portable", "These travel with the agent bundle when their secrets are portable."),
+            sectionToWizard(entries, "This machine", "These depend on local attachments or machine-specific setup."),
+        ],
+        footerLines: [
+            "6. Not now",
+            "Choose a number, or type the capability name.",
+        ],
+        prompt: options.prompt,
+        suppressEvent: true,
+    });
 }