eve 0.7.4 → 0.8.1

package/dist/src/cli/dev/tui/setup-flow.d.ts

@@ -1,35 +1,97 @@
+import type { ChannelSetupChoice, ChannelSetupChoiceOptions } from "#setup/cli/index.js";
 import type { SelectNotice } from "#setup/prompter.js";
 import type { SetupPanelOption } from "./setup-panel.js";
+export type SetupEditableSelectResult = {
+    kind: "selected";
+    value: string;
+} | {
+    kind: "edited";
+    value: string;
+    text: string;
+};
+interface SetupSelectRequestBase {
+    message: string;
+    options: readonly SetupPanelOption[];
+    notices?: readonly SelectNotice[];
+}
+interface SetupSingleSelectRequest extends SetupSelectRequestBase {
+    kind: "single" | "stacked" | "task-list";
+    initialValue?: string;
+}
+interface SetupSearchSelectRequest extends SetupSelectRequestBase {
+    kind: "search";
+    initialValue?: string;
+    placeholder?: string;
+}
+interface SetupMultiSelectRequest extends SetupSelectRequestBase {
+    kind: "multi";
+    initialValues?: readonly string[];
+    required: boolean;
+}
+interface SetupSearchableMultiSelectRequest extends SetupSelectRequestBase {
+    kind: "searchable-multi";
+    initialValues?: readonly string[];
+    placeholder?: string;
+    required: boolean;
+}
+/**
+ * A setup select's complete interaction grammar. The discriminant prevents
+ * callers from combining incompatible modes such as multi-select plus a
+ * single-select layout.
+ */
+export type SetupSelectRequest = SetupSingleSelectRequest | SetupSearchSelectRequest | SetupMultiSelectRequest | SetupSearchableMultiSelectRequest;
 export interface SetupFlowRenderer {
     begin(title: string): void;
     end(options?: {
         preserveDiagnostics?: boolean;
     }): void;
-    readSelect(options: {
+    readSelect(options: SetupSelectRequest): Promise<readonly string[] | undefined>;
+    readEditableSelect(options: {
         message: string;
         options: readonly SetupPanelOption[];
-        multiple: boolean;
-        search: boolean;
-        required: boolean;
         initialValue?: string;
-        initialValues?: readonly string[];
-        placeholder?: string;
-        layout?: "stacked";
-        notices?: readonly SelectNotice[];
-    }): Promise<readonly string[] | undefined>;
+        editable: {
+            value: string;
+            defaultValue: string;
+            formatHint: (value: string) => string;
+            validate?: (value: string) => string | undefined;
+        };
+    }): Promise<SetupEditableSelectResult | undefined>;
     readText(options: {
         message: string;
         placeholder?: string;
         defaultValue?: string;
         mask?: boolean;
         validate?: (value: string) => string | undefined;
+        notices?: readonly SelectNotice[];
     }): Promise<string | undefined>;
     readAcknowledge(options: {
         message: string;
         lines: readonly string[];
     }): Promise<void>;
+    /**
+     * Presents an inert context row and a separate action menu beside the live
+     * flow spinner. Returns the choice plus a `close()` that dismisses the menu
+     * when a concurrent wait resolves first. Used by the Slack install wait for
+     * "Try again" / "Cancel": the poll keeps running while the prompt is up, and
+     * whichever settles first wins.
+     */
+    readChoice(options: ChannelSetupChoiceOptions): ChannelSetupChoice;
     setStatus(text: string | undefined): void;
     renderLine(text: string, tone: "info" | "success" | "warning" | "error"): void;
     renderOutput(text: string): void;
+    /**
+     * Arms a key trap for the flow's working state — the status spinner between
+     * questions, where no prompt is consuming keys. Ctrl-C or Esc resolves the
+     * promise so the command can abandon an in-flight flow (e.g. a parked
+     * `vercel connect create` browser OAuth). Open questions own their keys; the
+     * trap covers only the gaps. `dispose` releases the trap; the promise then
+     * never resolves.
+     */
+    waitForInterrupt(): {
+        promise: Promise<void>;
+        dispose(): void;
+    };
 }
-export type SetupFlowPrompterRenderer = Pick<SetupFlowRenderer, "readSelect" | "readText" | "readAcknowledge" | "setStatus" | "renderLine" | "renderOutput">;
+export type SetupFlowPrompterRenderer = Pick<SetupFlowRenderer, "readSelect" | "readEditableSelect" | "readText" | "readAcknowledge" | "readChoice" | "setStatus" | "renderLine" | "renderOutput">;
+export {};

package/dist/src/cli/dev/tui/setup-issues.js

@@ -1 +1 @@
-import{join}from"node:path";import{pathExists}from"#setup/path-exists.js";const BOOT_DETECTIONS=[{id:`model-provider`,async detect({appRoot:n,env:r}){return r.AI_GATEWAY_API_KEY||r.VERCEL_OIDC_TOKEN?[]:await pathExists(join(n,`.vercel`,`project.json`))?[{label:`AI Gateway credentials missing`,command:`/model`}]:[{label:`model provider not linked`,command:`/model`}]}}];async function detectSetupIssues(e,t=BOOT_DETECTIONS){return(await Promise.all(t.map(async t=>{try{return await t.detect(e)}catch{return[]}}))).flat()}function formatSetupIssuesLine(e){let t=e.length===1?`setup issue`:`setup issues`,n=e.map(e=>`${e.label} · ${e.command}`).join(`, `);return`${e.length} ${t}: ${n}`}export{BOOT_DETECTIONS,detectSetupIssues,formatSetupIssuesLine};
+import{join}from"node:path";import{pathExists}from"#setup/path-exists.js";const BOOT_DETECTIONS=[{id:`model-provider`,async detect({appRoot:n,env:r,info:i}){return i?.agent.model.routing?.kind===`external`||r.AI_GATEWAY_API_KEY||r.VERCEL_OIDC_TOKEN?[]:await pathExists(join(n,`.vercel`,`project.json`))?[{label:`AI Gateway credentials missing`,command:`/model`}]:[{label:`model provider not linked`,command:`/model`}]}}];async function detectSetupIssues(e,t=BOOT_DETECTIONS){return(await Promise.all(t.map(async t=>{try{return await t.detect(e)}catch{return[]}}))).flat()}function formatSetupIssuesLine(e){let t=e.length===1?`setup issue`:`setup issues`,n=e.map(e=>`${e.label} · ${e.command}`).join(`, `);return`${e.length} ${t}: ${n}`}export{BOOT_DETECTIONS,detectSetupIssues,formatSetupIssuesLine};

package/dist/src/cli/dev/tui/setup-panel.d.ts

@@ -9,38 +9,79 @@
  * assert on strings.
  *
  * Column grammar: the panel adds a one-space left margin to every row under
- * the rule, so gutter glyphs (cursor, spinner, tone marks) sit at column 1
- * and written text always starts at column 3. The question renderers stay
- * margin-free (glyphs 0, text 2) — the margin is applied once, in
- * {@link renderFlowPanel}, so every question variant lines up by
- * construction.
+ * the rule, while each section contributes two more spaces. Titles, spinners,
+ * notices, filter prompts, and option-state glyphs therefore all begin at
+ * column 3.
  */
-import type { PromptOption } from "#setup/cli/index.js";
+import type { ChannelSetupAction, PromptOption } from "#setup/cli/index.js";
 import { type SelectState } from "#setup/cli/select-state.js";
 import type { SelectNotice } from "#setup/prompter.js";
 import { type LineState } from "./line-editor.js";
 import type { Theme } from "./theme.js";
 /** One row of a setup select panel; the shared prompt-option shape. */
 export type SetupPanelOption = PromptOption<string>;
-export interface SetupSelectPanelState {
+interface SetupQuestionPanelBase {
     message: string;
-    options: readonly SetupPanelOption[];
-    multiple: boolean;
-    search: boolean;
-    placeholder?: string;
-    select: SelectState;
     error?: string;
-    /** "stacked" puts each hint on its own line with blank rows between options. */
-    layout?: "stacked";
     /** Outcome lines from earlier menu laps, shown beneath the options. */
     notices?: readonly SelectNotice[];
 }
+interface SetupSelectPanelBase extends SetupQuestionPanelBase {
+    options: readonly SetupPanelOption[];
+    select: SelectState;
+}
+interface SetupEditableRow {
+    /**
+     * The row whose hint is a live rename field. Hovering it (cursor on the row)
+     * makes it editable directly — typing and backspace edit the name in place —
+     * so the editor's text and a blinking caret render only on that row.
+     */
+    optionValue: string;
+    editor: LineState;
+    defaultValue: string;
+    formatHint: (value: string) => string;
+    caretVisible: boolean;
+}
+/**
+ * Select presentation variants. The discriminant owns the interaction grammar
+ * so feature combinations are deliberate rather than resolved by conditional
+ * precedence inside the renderer.
+ */
+type SetupOptionSelectPanelState = (SetupSelectPanelBase & {
+    kind: "single";
+}) | (SetupSelectPanelBase & {
+    kind: "search";
+    placeholder?: string;
+}) | (SetupSelectPanelBase & {
+    kind: "multi";
+}) | (SetupSelectPanelBase & {
+    kind: "searchable-multi";
+    placeholder?: string;
+}) | (SetupSelectPanelBase & {
+    kind: "stacked";
+}) | (SetupSelectPanelBase & {
+    kind: "task-list";
+}) | (SetupSelectPanelBase & {
+    kind: "editable";
+    edit: SetupEditableRow;
+});
+interface SetupActionsPanelState {
+    kind: "actions";
+    /** Inert explanation rendered above, and separately from, the action group. */
+    context: string;
+    actions: readonly ChannelSetupAction[];
+    /** No action is focused until the user moves into the action group. */
+    cursor: number | undefined;
+}
+export type SetupSelectPanelState = SetupOptionSelectPanelState | SetupActionsPanelState;
 export interface SetupTextPanelState {
     message: string;
     editor: LineState;
     placeholder?: string;
     mask: boolean;
     error?: string;
+    /** Context lines shown above the message; gone once the question settles. */
+    notices?: readonly SelectNotice[];
 }
 export interface SetupAcknowledgePanelState {
     message: string;
@@ -50,27 +91,43 @@ export interface SetupAcknowledgePanelState {
 export interface FlowPanelLine {
     text: string;
     tone: "info" | "success" | "warning" | "error";
+    /**
+     * Subprocess output a warning/error settle pulled in as its evidence.
+     * Renders like any info line in the panel, but survives the panel close
+     * alongside the diagnostic it explains (a plain info line does not).
+     */
+    evidence?: boolean;
 }
-/** The whole bordered section: title, recent progress, question or status. */
-export interface FlowPanelState {
-    /** The invoked command, e.g. "/deploy". Empty renders no title row. */
-    title: string;
-    lines: readonly FlowPanelLine[];
-    /** Ephemeral status shown when no question is active. */
+export type FlowPanelContent = {
+    kind: "question";
+    rows: readonly string[];
+    /** The install wait keeps its spinner above the concurrent actions. */
     status?: {
         text: string;
         frame: string;
     };
-    /**
-     * The latest subprocess output line — a transient preview replaced on every
-     * write, mirroring the rail-log's command preview. Shown dim under the
-     * status (or alone behind the spinner) and never persisted.
-     */
+} | {
+    kind: "status";
+    status: {
+        text: string;
+        frame: string;
+    };
+    /** Latest child-process output shown transiently beneath the status. */
     preview?: string;
-    /** The current spinner frame, for the preview/idle pulse rows. */
-    frame?: string;
-    /** The active question's rows (a select or text section). */
-    question?: readonly string[];
+} | {
+    kind: "preview";
+    text: string;
+    frame: string;
+} | {
+    kind: "idle";
+    frame: string;
+};
+/** The whole bordered section: title, recent progress, and one explicit mode. */
+export interface FlowPanelState {
+    /** The invoked command, e.g. "/deploy". Empty renders no title row. */
+    title: string;
+    lines: readonly FlowPanelLine[];
+    content: FlowPanelContent;
 }
 /**
  * Paints the bordered flow panel. Everything a running command produces lives
@@ -80,18 +137,12 @@ export interface FlowPanelState {
  */
 export declare function renderFlowPanel(state: FlowPanelState, theme: Theme, width: number): string[];
 /**
- * Paints a select question section (for the flow panel). The cursor row's
- * `description` rides on a dim line beneath it; a searchable question windows
- * the option list around the cursor (a leading run of `featured` options
- * sizes the unfiltered viewport) and advertises the rest with a count footer.
+ * Paints a selection section for the flow panel. Ordinary selects use the
+ * shared option reducer; concurrent actions render an explicit context row and
+ * independent action group. A searchable select windows the option list around
+ * the cursor and advertises the rest with a count footer.
  */
 export declare function renderSelectQuestion(state: SetupSelectPanelState, theme: Theme, width: number): string[];
-/** True when a select question numbers its rows (and accepts digit jumps). */
-export declare function numbersSelectRows(state: {
-    multiple: boolean;
-    search: boolean;
-    options: readonly SetupPanelOption[];
-}): boolean;
 /** Paints a text question section: message, a caret-bearing input line, hints. */
 export declare function renderTextQuestion(state: SetupTextPanelState, theme: Theme, width: number, caretVisible: boolean): string[];
 /**
@@ -101,3 +152,4 @@ export declare function renderTextQuestion(state: SetupTextPanelState, theme: Th
  * footer advertises only enter.
  */
 export declare function renderAcknowledgeQuestion(state: SetupAcknowledgePanelState, theme: Theme, width: number): string[];
+export {};

package/dist/src/cli/dev/tui/setup-panel.js

@@ -1 +1,3 @@
-import{sliceVisible,visibleLength}from"./terminal-text.js";import{visibleLine}from"./line-editor.js";import{filterOptions,submitRowIndex}from"#setup/cli/select-state.js";function clip(n,r){return visibleLength(n)>r?sliceVisible(n,r):n}function questionFooter(e,t){let n=t.colors;return[``,`  ${n.dim(n.italic(e.join(` ${t.glyph.dot} `)))}`]}const BOLD_OR_DIM_CLOSE=`\x1B[22m`;function dimWithEmphasis(e,t){return t.colors.dim(e.replaceAll(BOLD_OR_DIM_CLOSE,`${BOLD_OR_DIM_CLOSE}`))}function toneGlyph(e,t){let n=t.colors;switch(e){case`success`:return n.green(t.glyph.success);case`warning`:return n.yellow(t.glyph.warning);case`error`:return n.red(t.glyph.error);case`info`:return n.dim(t.glyph.dot)}}function renderFlowPanel(e,t,n){let r=t.colors,i=[r.dim(t.glyph.hrule.repeat(Math.max(1,n)))];e.title.length>0&&i.push(`  ${r.blue(r.bold(e.title))}`),i.push(``);let a=e.lines.slice(-6);for(let e of a){let n=e.tone===`info`?r.dim(e.text):e.text;i.push(`${toneGlyph(e.tone,t)} ${n}`)}return a.length>0&&i.push(``),e.question===void 0?e.status===void 0?e.preview===void 0?i.push(`${r.yellow(e.frame??``)} ${r.dim(`Working…`)}`):i.push(`${r.yellow(e.frame??``)} ${r.dim(e.preview)}`):(i.push(`${r.yellow(e.status.frame)} ${r.dim(e.status.text)}`),e.preview!==void 0&&i.push(`  ${r.dim(e.preview)}`)):i.push(...e.question),i.map((e,t)=>t===0||e.length===0?clip(e,n):clip(` ${e}`,n))}function optionRow(e){let{option:t,theme:n}=e,r=n.colors,i=e.isCursor?r.cyan(n.glyph.prompt):` `,a=e.number===void 0?``:`${e.number}. `,o=e.checkbox?`${t.locked?r.dim(`◼`):e.isChecked?r.green(`◼`):r.dim(`◻`)} `:``,s=t.label;t.disabled?s=r.dim(`${s}${t.disabledReason?` (${t.disabledReason})`:``}`):t.locked?s=r.dim(`${s}${t.lockedReason?` (${t.lockedReason})`:``}`):e.isCursor&&(s=r.blue(s));let c=t.hint?r.dim(` ${n.glyph.dot} ${t.hint}`):``;return`${i} ${a}${o}${s}${c}`}function renderSelectQuestion(e,t,n){let a=t.colors,o=e.search?filterOptions(e.options,e.select.filter):e.options,s=e.multiple?submitRowIndex(o):-1,c=e.select.cursor,l=[`  ${a.bold(e.message)}`,``],u=numbersSelectRows(e);if(e.search){let n=e.select.filter.length>0?e.select.filter+a.dim(t.glyph.caret):e.placeholder===void 0?a.dim(t.glyph.caret):a.dim(e.placeholder);l.push(`  ${n}`,``)}let d=0;for(;o[d]?.featured;)d+=1;let f=e.search&&e.select.filter===``&&d>0?Math.min(d,8):e.search?8:o.length,p=Math.max(0,Math.min(c-Math.floor(f/2),Math.max(0,o.length-f))),m=Math.min(p+f,o.length);o.length===0&&l.push(`  ${a.dim(`(no matches)`)}`);for(let n=p;n<m;n+=1){let r=o[n],i=n===c,s=e.layout===`stacked`,d=r;if(s&&r.hint!==void 0){let{hint:e,...t}=r;d=t}let f={option:d,isCursor:i,isChecked:e.multiple&&e.select.selected.has(r.value),checkbox:e.multiple,theme:t};if(u&&(f.number=n+1),l.push(optionRow(f)),s&&r.hint!==void 0){let e=` `.repeat(2+(u?`${n+1}. `.length:0));l.push(`${e}${dimWithEmphasis(r.hint,t)}`)}i&&r.description&&!r.disabled&&l.push(`      ${a.dim(r.description)}`),s&&n<m-1&&l.push(``)}if(e.multiple&&s>=0){let e=c===s,n=e?a.cyan(t.glyph.prompt):` `,r=e?a.blue(a.bold(`Submit`)):`Submit`;l.push(``,`${n} ${r}`)}if(o.length>m-p&&l.push(`  ${a.dim(`↑↓ ${o.length} options, showing ${p+1}–${m}`)}`),e.notices!==void 0&&e.notices.length>0){l.push(``);for(let n of e.notices){let e=n.tone===`info`?a.dim(n.text):n.text;l.push(`  ${toneGlyph(n.tone,t)} ${e}`)}}e.error!==void 0&&l.push(``,`  ${a.red(e.error)}`);let h=[];return e.search&&h.push(`type to filter`),h.push(`↑/↓ move`),h.push(e.multiple?`space to toggle`:`enter to select`),e.multiple&&h.push(`enter on Submit to confirm`),h.push(`esc to cancel`),l.push(...questionFooter(h,t)),l.map(e=>clip(e,n))}function numbersSelectRows(e){return!e.multiple&&!e.search&&e.options.length>1}function renderTextQuestion(e,t,r,i){let a=t.colors,o=[`  ${a.bold(e.message)}`,``],s=Math.max(4,r-4),{before:c,after:l}=visibleLine(e.mask?{text:`•`.repeat(e.editor.text.length),cursor:e.editor.cursor}:{text:e.editor.text,cursor:e.editor.cursor},s,t.glyph.ellipsis),u=i?a.cyan(t.glyph.caret):` `,d=e.editor.text.length===0&&e.placeholder!==void 0?`${u}${a.dim(e.placeholder)}`:`${c}${u}${l}`;return o.push(`  ${d}`),e.error!==void 0&&o.push(``,`  ${a.red(e.error)}`),o.push(...questionFooter([`enter to submit`,`esc to cancel`],t)),o.map(e=>clip(e,r))}function renderAcknowledgeQuestion(e,t,n){let r=t.colors,i=[`  ${r.bold(e.message)}`];if(e.lines.length>0){i.push(``);for(let t of e.lines)i.push(`  ${r.dim(t)}`)}return i.push(...questionFooter([`enter to continue`],t)),i.map(e=>clip(e,n))}export{numbersSelectRows,renderAcknowledgeQuestion,renderFlowPanel,renderSelectQuestion,renderTextQuestion};
+import{sliceVisible,visibleLength,wrapVisibleLine}from"./terminal-text.js";import{visibleLine}from"./line-editor.js";import{renderOptionRow,resolveOptionRowState}from"#setup/cli/option-row.js";import{filterOptions,submitRowIndex}from"#setup/cli/select-state.js";function clip(n,r){if(visibleLength(n)<=r)return n;let i=sliceVisible(n,r);return i.includes(`\x1B[`)?`${i}\x1b[0m`:i}function questionFooter(e,t){let n=t.colors;return[``,`  ${n.dim(n.italic(e.join(` ${t.glyph.dot} `)))}`]}const BOLD_OR_DIM_CLOSE=`\x1B[22m`;function dimWithEmphasis(e,t){return t.colors.dim(e.replaceAll(BOLD_OR_DIM_CLOSE,`${BOLD_OR_DIM_CLOSE}`))}function toneGlyph(e,t){let n=t.colors;switch(e){case`success`:return n.green(t.glyph.success);case`warning`:return n.yellow(t.glyph.warning);case`error`:return n.red(t.glyph.error);case`info`:return n.dim(t.glyph.dot)}}function renderFlowPanel(e,t,n){let r=t.colors,i=[r.dim(t.glyph.hrule.repeat(Math.max(1,n)))];e.title.length>0&&i.push(`  ${r.bold(e.title)}`),i.push(``);let a=e.lines.slice(-6);for(let e of a){let n=e.tone===`info`?r.dim(e.text):e.text;i.push(`  ${toneGlyph(e.tone,t)} ${n}`)}switch(a.length>0&&i.push(``),e.content.kind){case`question`:e.content.status!==void 0&&i.push(`  ${r.yellow(e.content.status.frame)} ${r.dim(e.content.status.text)}`,``),i.push(...e.content.rows);break;case`status`:i.push(`  ${r.yellow(e.content.status.frame)} ${r.dim(e.content.status.text)}`),e.content.preview!==void 0&&i.push(`    ${r.dim(e.content.preview)}`);break;case`preview`:i.push(`  ${r.yellow(e.content.frame)} ${r.dim(e.content.text)}`);break;case`idle`:i.push(`  ${r.yellow(e.content.frame)} ${r.dim(`Working…`)}`);break}return i.map((e,t)=>t===0||e.length===0?clip(e,n):clip(` ${e}`,n))}function optionRow(e){let{option:t,theme:n}=e;return renderOptionRow({colors:n.colors,glyphs:{pointer:n.glyph.pointer,success:n.glyph.success,placeholder:n.glyph.option,dot:n.glyph.dot},label:t.label,hint:t.hint,focusHint:t.focusHint,accent:t.accent,isCursor:e.isCursor,state:resolveOptionRowState(t,e.isChecked),placeholder:e.placeholder,hintPadding:e.hintPadding})}function selectPresentation(e){switch(e.kind){case`single`:return{selection:`single`,filter:void 0,layout:`plain`,edit:void 0};case`search`:return{selection:`single`,filter:{placeholder:e.placeholder},layout:`plain`,edit:void 0};case`multi`:return{selection:`multiple`,filter:void 0,layout:`plain`,edit:void 0};case`searchable-multi`:return{selection:`multiple`,filter:{placeholder:e.placeholder},layout:`plain`,edit:void 0};case`stacked`:return{selection:`single`,filter:void 0,layout:`stacked`,edit:void 0};case`task-list`:return{selection:`single`,filter:void 0,layout:`task-list`,edit:void 0};case`editable`:return{selection:`single`,filter:void 0,layout:`task-list`,edit:e.edit}}}function selectMessageRows(e,t,n){if(e===``)return[];let r=e.split(`
+`).map((e,r)=>`  ${t===`stacked`||r>0?n.colors.bold(e):e}`);return r.push(``),r}function searchFilter(e,t,n){return e.length>0?e+n.colors.dim(n.glyph.caret):t===void 0?n.colors.dim(n.glyph.caret):n.colors.dim(`> ${t}`)}function selectViewSize(e){return e.search?e.filter===``&&e.featuredLead>0?Math.min(e.featuredLead,8):8:e.optionCount}function noticeBody(e,t,n){return e.tone===`info`?n.colors.dim(e.text):e.tone===`success`&&t===`task-list`?n.colors.bold(e.text):e.text}function editableOption(e,t,n,r){if(!t||n?.optionValue!==e.value)return e;let i=n.editor.text||n.defaultValue,a=n.editor.text.length===0?i.length:n.editor.cursor,o=n.caretVisible?r.colors.cyan(r.glyph.caret):``,s=`${i.slice(0,a)}${o}${i.slice(a)}`;return{...e,hint:n.formatHint(s)}}function optionWithoutStackedHint(e,t){if(t!==`stacked`||e.hint===void 0)return{option:e,stackedHint:void 0};let{hint:n,...r}=e;return{option:r,stackedHint:n}}function optionUsesPlaceholder(e,t,n){let r=e.filter!==void 0,i=e.layout===`task-list`&&t===n-1,a=e.selection===`multiple`,o=e.layout!==`plain`;return!r&&!i&&(a||o)}function appendSelectOptionRows(e){let{rows:t,state:n,presentation:r,visible:i,start:a,end:o,cursor:s,visibleLabelWidth:c,theme:l}=e,u=l.colors;for(let e=a;e<o;e+=1){let d=i[e],f=e===s;r.layout===`task-list`&&e===o-1&&e>a&&t.push(``);let{option:p,stackedHint:m}=optionWithoutStackedHint(editableOption(d,f,r.edit,l),r.layout);t.push(`  ${optionRow({option:p,isCursor:f,isChecked:r.selection===`multiple`&&n.select.selected.has(d.value),placeholder:optionUsesPlaceholder(r,e,i.length),hintPadding:c-d.label.length,theme:l})}`),m!==void 0&&t.push(`${` `.repeat(4)}${dimWithEmphasis(m,l)}`),d.description!==void 0&&(d.disabled===!0||f)&&t.push(`    ${u.dim(d.description)}`),r.layout===`stacked`&&e<o-1&&t.push(``)}}function appendSubmitRow(e,t,n,r){if(n<0)return;let i=t===n,a=i?r.colors.cyan(r.glyph.pointer):` `,o=i?r.colors.cyan(r.colors.bold(`Submit`)):`Submit`;e.push(``,`  ${a} ${o}`)}function appendSelectNotices(e,r,i,a,o){if(!(r===void 0||r.length===0)){e.push(``);for(let s of r){let r=toneGlyph(s.tone,a),c=` `.repeat(visibleLength(r)+1),l=Math.max(1,o-2-visibleLength(r)-1),u=wrapVisibleLine(s.text,l);for(let[t,n]of u.entries()){let o=noticeBody({...s,text:n},i,a);e.push(t===0?`  ${r} ${o}`:`  ${c}${o}`)}}}}function selectFooterHints(e,t,n){let r=[];return e.edit!==void 0&&t[n]?.value===e.edit.optionValue&&r.push(`type to rename`),e.filter!==void 0&&r.push(`type to filter`),r.push(`↑/↓ move`),r.push(e.selection===`multiple`?`space to toggle`:`enter to select`),e.selection===`multiple`&&r.push(`enter on Submit to confirm`),r.push(`esc to cancel`),r}function renderActionQuestion(e,t,n){let r=[`  ${t.colors.dim(`${t.glyph.dot} ${e.context}`)}`,``];for(let[n,i]of e.actions.entries())r.push(`  ${optionRow({option:i,isCursor:n===e.cursor,isChecked:!1,placeholder:!0,hintPadding:0,theme:t})}`);return r.push(...questionFooter([`↑/↓ move`,`enter to select`,`esc to cancel`],t)),r.map(e=>clip(e,n))}function renderSelectQuestion(e,t,n){if(e.kind===`actions`)return renderActionQuestion(e,t,n);let r=t.colors,i=selectPresentation(e),a=i.filter?filterOptions(e.options,e.select.filter):e.options,c=i.selection===`multiple`?submitRowIndex(a):-1,l=e.select.cursor,u=selectMessageRows(e.message,i.layout,t);i.filter!==void 0&&u.push(`  ${searchFilter(e.select.filter,i.filter.placeholder,t)}`);let d=0;for(;a[d]?.featured;)d+=1;let f=selectViewSize({search:i.filter!==void 0,filter:e.select.filter,featuredLead:d,optionCount:a.length}),p=Math.max(0,Math.min(l-Math.floor(f/2),Math.max(0,a.length-f))),m=Math.min(p+f,a.length),h=a.slice(p,m).filter(e=>e.hint!==void 0||e.focusHint!==void 0).reduce((e,t)=>Math.max(e,t.label.length),0);return a.length===0&&u.push(`  ${r.dim(`(no matches)`)}`),appendSelectOptionRows({rows:u,state:e,presentation:i,visible:a,start:p,end:m,cursor:l,visibleLabelWidth:h,theme:t}),appendSubmitRow(u,l,c,t),a.length>m-p&&u.push(`  ${r.dim(`↑↓ ${a.length} options, showing ${p+1}–${m}`)}`),appendSelectNotices(u,e.notices,i.layout,t,n),e.error!==void 0&&u.push(``,`  ${r.red(e.error)}`),u.push(...questionFooter(selectFooterHints(i,a,l),t)),u.map(e=>clip(e,n))}function renderTextQuestion(e,t,n,i){let a=t.colors,o=[];for(let n of e.notices??[]){let e=n.tone===`info`?a.dim(n.text):n.text;o.push(`${toneGlyph(n.tone,t)} ${e}`)}o.push(...e.message.split(`
+`).map(e=>`  ${a.bold(e)}`));let s=Math.max(4,n-4),{before:c,after:l}=visibleLine(e.mask?{text:`•`.repeat(e.editor.text.length),cursor:e.editor.cursor}:{text:e.editor.text,cursor:e.editor.cursor},s,t.glyph.ellipsis),u=i?a.cyan(t.glyph.caret):` `,d=e.editor.text.length===0&&e.placeholder!==void 0?`${u}${a.dim(e.placeholder)}`:`${c}${u}${l}`;return o.push(`  ${d}`),e.error!==void 0&&o.push(``,`  ${a.red(e.error)}`),o.push(...questionFooter([`enter to submit`,`esc to cancel`],t)),o.map(e=>clip(e,n))}function renderAcknowledgeQuestion(e,t,n){let r=t.colors,i=[`  ${r.bold(e.message)}`];if(e.lines.length>0){i.push(``);for(let t of e.lines)i.push(`  ${r.dim(t)}`)}return i.push(...questionFooter([`enter to continue`],t)),i.map(e=>clip(e,n))}export{renderAcknowledgeQuestion,renderFlowPanel,renderSelectQuestion,renderTextQuestion};

package/dist/src/cli/dev/tui/setup-selection-input.d.ts

@@ -0,0 +1,48 @@
+import type { PromptOption } from "#setup/cli/index.js";
+import { type SelectState } from "#setup/cli/select-state.js";
+import type { TerminalKey } from "./stream-format.js";
+/** Shared navigation grammar for setup selects, actions, and editable selects. */
+export type SetupSelectionIntent = {
+    kind: "cancel";
+} | {
+    kind: "move";
+    direction: "up" | "down";
+} | {
+    kind: "repaint";
+} | {
+    kind: "submit";
+};
+/** Maps terminal keys to the intents every setup selection surface shares. */
+export declare function setupSelectionIntent(key: TerminalKey): SetupSelectionIntent | undefined;
+export type SetupSelectInputResult = {
+    kind: "cancel";
+} | {
+    kind: "repaint";
+} | {
+    kind: "update";
+    select: SelectState;
+} | {
+    kind: "submit";
+    values: readonly string[];
+} | {
+    kind: "error";
+    message: string;
+} | {
+    kind: "ignore";
+};
+interface SetupSelectInput {
+    key: TerminalKey;
+    options: readonly PromptOption<string>[];
+    select: SelectState;
+}
+type SetupSingleSelectInput = SetupSelectInput & {
+    kind: "single" | "stacked" | "task-list" | "search";
+};
+type SetupMultiSelectInput = SetupSelectInput & {
+    kind: "multi" | "searchable-multi";
+    required: boolean;
+};
+type SetupSelectInputState = SetupSingleSelectInput | SetupMultiSelectInput;
+/** Pure key transition for a setup select; rendering and lifecycle stay outside. */
+export declare function reduceSetupSelectInput(input: SetupSelectInputState): SetupSelectInputResult;
+export {};

package/dist/src/cli/dev/tui/setup-selection-input.js

@@ -0,0 +1 @@
+import{filterOptions,orderedSelection,reduceSelect,selectValueAtCursor,submitRowIndex}from"#setup/cli/select-state.js";function setupSelectionIntent(e){switch(e.type){case`ctrl-c`:case`escape`:return{kind:`cancel`};case`up`:return{kind:`move`,direction:`up`};case`down`:return{kind:`move`,direction:`down`};case`ctrl-r`:return{kind:`repaint`};case`enter`:return{kind:`submit`};default:return}}function isMultiSelect(e){return e.kind===`multi`||e.kind===`searchable-multi`}function isSearchableSelect(e){return e.kind===`search`||e.kind===`searchable-multi`}function updatedSelect(e,t){return{kind:`update`,select:reduceSelect(e.select,t,{options:e.options,submitRow:isMultiSelect(e)})}}function submitSetupSelect(n){let a=isSearchableSelect(n)?filterOptions(n.options,n.select.filter):[...n.options];if(isMultiSelect(n))return n.select.cursor===submitRowIndex(a)?n.required&&n.select.selected.size===0?{kind:`error`,message:`Select at least one option, then submit.`}:{kind:`submit`,values:orderedSelection(n.options,n.select.selected)}:updatedSelect(n,{type:`toggle`});let o=selectValueAtCursor(a,n.select.cursor);return o===void 0?a[n.select.cursor]?.completed?{kind:`ignore`}:{kind:`error`,message:`Type to match an option, then press enter.`}:{kind:`submit`,values:[o]}}function editSetupSelect(e){switch(e.key.type){case`backspace`:return isSearchableSelect(e)?updatedSelect(e,{type:`backspace`}):{kind:`ignore`};case`character`:{if(isMultiSelect(e)&&e.key.value===` `)return updatedSelect(e,{type:`toggle`});if(!isSearchableSelect(e))return{kind:`ignore`};let t=e.select,r={options:e.options,submitRow:isMultiSelect(e)};for(let i of e.key.value)i>=` `&&i!==``&&(t=reduceSelect(t,{type:`char`,char:i},r));return{kind:`update`,select:t}}default:return{kind:`ignore`}}}function reduceSetupSelectInput(e){let t=setupSelectionIntent(e.key);switch(t?.kind){case`cancel`:return{kind:`cancel`};case`repaint`:return{kind:`repaint`};case`move`:return updatedSelect(e,{type:t.direction});case`submit`:return submitSetupSelect(e);case void 0:return editSetupSelect(e)}}export{reduceSetupSelectInput,setupSelectionIntent};

package/dist/src/cli/dev/tui/status-line.d.ts

@@ -1,10 +1,13 @@
 import type { Theme } from "./theme.js";
 import type { VercelStatusSnapshot } from "./vercel-status.js";
+import type { ModelEndpointStatus } from "#shared/model-endpoint-status.js";
 export interface StatusLineInput {
     /** Resolved model slug, e.g. "anthropic/claude-sonnet-4-6"; absent when `/eve/v1/info` failed. */
     model?: string;
     /** Preformatted token-flow segment (formatTokenFlow output), e.g. `⁕ ↑ 394.4K ↓ 4.3K`. */
     tokens?: string;
+    /** Model endpoint readiness: external, or AI Gateway connected/not-connected. */
+    endpoint?: ModelEndpointStatus;
     /** Workspace-scoped Vercel state; identity absent while unlinked or still resolving. */
     vercel?: VercelStatusSnapshot;
     theme: Theme;
@@ -13,13 +16,16 @@ export interface StatusLineInput {
 /**
  * Builds the dev TUI's persistent one-row status line:
  *
- * `model  ·  tokens  ·  ▲ project (team)  ·  deploy pending`
+ * `model  ·  tokens  ·  AI Gateway (project)  ·  /deploy pending`
  *
- * Everything renders dim except the yellow pending-deploy marker — the one
- * segment that asks for action. On narrow widths segments degrade in a fixed
- * order — team suffix, then the project segment, then the model — keeping the
- * live, actionable signals (tokens, pending deploy) longest; the model and
- * project identity remain recoverable from the agent header in scrollback.
- * Returns undefined when no segment has content so callers skip the row.
+ * The model-endpoint segment folds in the linked project name when connected
+ * (`AI Gateway (project)`), drops to a bare `AI Gateway` when connected without
+ * a linked project, and goes yellow with a `⚠` when the gateway has no usable
+ * credential. Everything else renders dim except the yellow action signals (a
+ * pending deploy, the not-connected gateway). On narrow widths segments degrade
+ * in order, the endpoint first and then the model, keeping tokens and the
+ * pending-deploy marker longest. Both stay recoverable from the agent header in
+ * scrollback. Returns undefined when no segment has content so callers skip the
+ * row.
  */
 export declare function buildStatusLine(input: StatusLineInput): string | undefined;

package/dist/src/cli/dev/tui/status-line.js

@@ -1 +1 @@
-import{sliceVisible,visibleLength}from"./terminal-text.js";function buildStatusLine(t){let{theme:n,width:r}=t,i=n.colors,a=t.model===void 0?void 0:i.dim(t.model),o=t.tokens===void 0?void 0:i.dim(t.tokens),s=t.vercel?.pendingDeploy?i.yellow(`deploy pending`):void 0,c=t.vercel?.identity,l=c===void 0?void 0:i.dim(`${n.glyph.brand} ${c.projectName}`),u=c?.teamName===void 0?l:i.dim(`${n.glyph.brand} ${c.projectName} (${c.teamName})`),d=`  ${i.dim(n.glyph.dot)}  `,compose=e=>e.filter(e=>e!==void 0).join(d),f=[compose([a,o,u,s]),compose([a,o,l,s]),compose([a,o,s]),compose([o,s])];if(f[0].length!==0){for(let e of f)if(e.length>0&&visibleLength(e)<=r)return e;return sliceVisible(f.findLast(e=>e.length>0),r)}}export{buildStatusLine};
+import{sliceVisible,visibleLength}from"./terminal-text.js";function buildStatusLine(t){let{theme:n,width:r}=t,i=n.colors,a=t.model===void 0?void 0:i.dim(t.model),o=t.tokens===void 0?void 0:i.dim(t.tokens),s=t.vercel?.pendingDeploy?i.yellow(`/deploy pending`):void 0,c=t.vercel?.identity?.projectName,l=t.endpoint===void 0?void 0:t.endpoint.kind===`external`?i.dim(`External endpoint`):t.endpoint.connected?i.dim(c===void 0?`AI Gateway`:`AI Gateway (${c})`):i.yellow(`${n.glyph.warning} AI Gateway`),u=`  ${i.dim(n.glyph.dot)}  `,compose=e=>e.filter(e=>e!==void 0).join(u),d=[compose([a,o,l,s]),compose([a,o,s]),compose([o,s])];if(d[0].length!==0){for(let e of d)if(e.length>0&&visibleLength(e)<=r)return e;return sliceVisible(d.findLast(e=>e.length>0),r)}}export{buildStatusLine};

package/dist/src/cli/dev/tui/stream-format.d.ts

@@ -57,6 +57,8 @@ export interface KeyToken {
     /** The buffer ends mid-sequence; wait for more bytes before decoding. */
     incomplete?: boolean;
 }
+/** Removes C0 control characters and DEL from text intended for the prompt. */
+export declare function stripPromptControlCharacters(text: string): string;
 /**
  * Decodes the next key from a raw input buffer, returning how many characters
  * it consumed so a caller can reassemble escape sequences that arrive split

package/dist/src/cli/dev/tui/stream-format.js

@@ -1,2 +1,2 @@
-const CSI_FINAL=/[\u0040-\u007e]/u;function nextKey(t){let n=t[0];if(n===void 0)return{consumed:0,incomplete:!0};if(n===`\x1B`){if(t.length===1)return{consumed:0,incomplete:!0};let n=t[1];if(n===`O`)return t.length<3?{consumed:0,incomplete:!0}:{key:parseKey(Buffer.from(t.slice(0,3))),consumed:3};if(n===`[`){for(let n=2;n<t.length;n+=1)if(CSI_FINAL.test(t[n]))return{key:parseKey(Buffer.from(t.slice(0,n+1))),consumed:n+1};return{consumed:0,incomplete:!0}}return{key:{type:`escape`},consumed:1}}if(n<` `||n===``)return{key:parseKey(Buffer.from(n)),consumed:1};let r=1;for(;r<t.length;){let e=t[r];if(e===`\x1B`||e<` `||e===``)break;r+=1}return{key:parseKey(Buffer.from(t.slice(0,r))),consumed:r}}function parseKey(e){let t=e.toString(`utf8`);switch(t){case`
`:return{type:`ctrl-a`};case``:return{type:`ctrl-e`};case``:return{type:`ctrl-d`};case`\v`:return{type:`ctrl-k`};case`\f`:return{type:`ctrl-l`};case``:return{type:`ctrl-r`};case``:return{type:`ctrl-u`};case``:return{type:`ctrl-w`};case``:return{type:`ctrl-c`};case`\r`:case`
-`:return{type:`enter`};case``:case`\b`:return{type:`backspace`};case`\x1B[A`:case`\x1BOA`:return{type:`up`};case`\x1B[B`:case`\x1BOB`:return{type:`down`};case`\x1B[C`:case`\x1BOC`:return{type:`right`};case`\x1B[D`:case`\x1BOD`:return{type:`left`};case`\x1B[H`:case`\x1BOH`:case`\x1B[1~`:return{type:`home`};case`\x1B[F`:case`\x1BOF`:case`\x1B[4~`:return{type:`end`};case`\x1B[3~`:return{type:`delete`};case`	`:return{type:`tab`};case`\x1B`:return{type:`escape`};default:{let e=``;for(let n of t)n>=` `&&n!==``&&(e+=n);return e.length>0?{type:`character`,value:e}:{type:`ignore`}}}}async function*takeUntil(e,t){let n=e[Symbol.asyncIterator](),r=t.then(()=>({done:!0,value:void 0}));try{for(;;){let e=n.next();e.catch(()=>{});let t=await Promise.race([e,r]);if(t.done)break;yield t.value}}finally{n.return?.()?.catch(()=>{})}}function formatCompactTokenCount(e){if(e<1e3)return`${e}`;let t=e<1e6?e/1e3:e/1e6,n=e<1e6?`K`:`M`;return`${t.toFixed(1).replace(/\.0$/,``)}${n}`}function formatTokenFlow(e,t){let n=formatCompactTokenCount(e.inputTokens),r=formatCompactTokenCount(e.outputTokens),i=`${t.tokens} ${t.arrowUp} ${n} ${t.arrowDown} ${r}`,a=formatContextPercentage(e.inputTokens,e.contextSize);return a==null?i:`${i} ${a}`}function formatContextPercentage(e,t){if(!(t==null||t<=0||!Number.isFinite(t)))return`${Math.round(e/t*100).toLocaleString()}%`}function formatAssistantResponseStats(e,t){if(t===`tokensPerSecond`)return formatTokensPerSecond(e.tokensPerSecond);if(e.outputTokens!=null)return`${e.outputTokens.toLocaleString()} output tokens`}function formatTokensPerSecond(e){if(e!=null)return`${formatNumber(e)} tok/s`}function formatNumber(e){return Number.isInteger(e)?e.toLocaleString():e.toLocaleString(void 0,{maximumFractionDigits:1})}export{formatAssistantResponseStats,formatCompactTokenCount,formatTokenFlow,nextKey,parseKey,takeUntil};
+const CSI_FINAL=/[\u0040-\u007e]/u;function stripPromptControlCharacters(e){let t=``;for(let n of e)n>=` `&&n!==``&&(t+=n);return t}function nextKey(t){let n=t[0];if(n===void 0)return{consumed:0,incomplete:!0};if(n===`\x1B`){if(t.length===1)return{consumed:0,incomplete:!0};let n=t[1];if(n===`O`)return t.length<3?{consumed:0,incomplete:!0}:{key:parseKey(Buffer.from(t.slice(0,3))),consumed:3};if(n===`[`){for(let n=2;n<t.length;n+=1)if(CSI_FINAL.test(t[n]))return{key:parseKey(Buffer.from(t.slice(0,n+1))),consumed:n+1};return{consumed:0,incomplete:!0}}return{key:{type:`escape`},consumed:1}}if(n<` `||n===``)return{key:parseKey(Buffer.from(n)),consumed:1};let r=1;for(;r<t.length;){let e=t[r];if(e===`\x1B`||e<` `||e===``)break;r+=1}return{key:parseKey(Buffer.from(t.slice(0,r))),consumed:r}}function parseKey(e){let t=e.toString(`utf8`);switch(t){case`
`:return{type:`ctrl-a`};case``:return{type:`ctrl-e`};case``:return{type:`ctrl-d`};case`\v`:return{type:`ctrl-k`};case`\f`:return{type:`ctrl-l`};case``:return{type:`ctrl-r`};case``:return{type:`ctrl-u`};case``:return{type:`ctrl-w`};case``:return{type:`ctrl-c`};case`\r`:case`
+`:return{type:`enter`};case``:case`\b`:return{type:`backspace`};case`\x1B[A`:case`\x1BOA`:return{type:`up`};case`\x1B[B`:case`\x1BOB`:return{type:`down`};case`\x1B[C`:case`\x1BOC`:return{type:`right`};case`\x1B[D`:case`\x1BOD`:return{type:`left`};case`\x1B[H`:case`\x1BOH`:case`\x1B[1~`:return{type:`home`};case`\x1B[F`:case`\x1BOF`:case`\x1B[4~`:return{type:`end`};case`\x1B[3~`:return{type:`delete`};case`	`:return{type:`tab`};case`\x1B`:return{type:`escape`};default:{let e=stripPromptControlCharacters(t);return e.length>0?{type:`character`,value:e}:{type:`ignore`}}}}async function*takeUntil(e,t){let n=e[Symbol.asyncIterator](),r=t.then(()=>({done:!0,value:void 0}));try{for(;;){let e=n.next();e.catch(()=>{});let t=await Promise.race([e,r]);if(t.done)break;yield t.value}}finally{n.return?.()?.catch(()=>{})}}function formatCompactTokenCount(e){if(e<1e3)return`${e}`;let t=e<1e6?e/1e3:e/1e6,n=e<1e6?`K`:`M`;return`${t.toFixed(1).replace(/\.0$/,``)}${n}`}function formatTokenFlow(e,t){let n=formatCompactTokenCount(e.inputTokens),r=formatCompactTokenCount(e.outputTokens),i=`${t.tokens} ${t.arrowUp} ${n} ${t.arrowDown} ${r}`,a=formatContextPercentage(e.inputTokens,e.contextSize);return a==null?i:`${i} ${a}`}function formatContextPercentage(e,t){if(!(t==null||t<=0||!Number.isFinite(t)))return`${Math.round(e/t*100).toLocaleString()}%`}function formatAssistantResponseStats(e,t){if(t===`tokensPerSecond`)return formatTokensPerSecond(e.tokensPerSecond);if(e.outputTokens!=null)return`${e.outputTokens.toLocaleString()} output tokens`}function formatTokensPerSecond(e){if(e!=null)return`${formatNumber(e)} tok/s`}function formatNumber(e){return Number.isInteger(e)?e.toLocaleString():e.toLocaleString(void 0,{maximumFractionDigits:1})}export{formatAssistantResponseStats,formatCompactTokenCount,formatTokenFlow,nextKey,parseKey,stripPromptControlCharacters,takeUntil};

package/dist/src/cli/dev/tui/terminal-renderer.d.ts

@@ -47,8 +47,10 @@ export declare class TerminalRenderer implements AgentTUIRenderer {
     /**
      * Commits the startup agent header (brand mark + resolved configuration) to
      * scrollback before the first prompt. Later calls (dev HMR refreshing fields
-     * such as the resolved model) commit a fresh header beneath the existing
-     * transcript; committed scrollback is never cleared or replayed.
+     * such as the agent name) commit a fresh header beneath the existing
+     * transcript only when the rendered header actually changed — every source
+     * reload re-sends it, and an identical banner repeated per reload is noise.
+     * Committed scrollback is never cleared or replayed.
      */
     renderAgentHeader(options: AgentHeaderOptions): void;
     readPrompt(options?: AgentTUISessionOptions): Promise<string>;
@@ -68,6 +70,7 @@ export declare class TerminalRenderer implements AgentTUIRenderer {
      * text is blank.
      */
     renderNotice(text: string): void;
+    renderSandboxLog(text: string): void;
     /**
      * Commits the boot-time setup attention line (yellow `⚠`, commands blue),
      * shown once after the agent header when boot detection finds issues.