eve 0.6.0-beta.9 → 0.7.2

package/dist/src/setup/boxes/resolve-target.d.ts

@@ -1,6 +1,6 @@
 import { isEveProject } from "#setup/scaffold/index.js";
+import { type Asker } from "../ask.js";
 import { pathExists } from "../path-exists.js";
-import type { Prompter } from "../prompter.js";
 import { type ResolvedProjectPath, type SetupState } from "../state.js";
 import type { SetupBox } from "../step.js";
 /** Injected for tests; defaults to the real filesystem probes. */
@@ -9,17 +9,33 @@ export interface ResolveTargetDeps {
     isEveProject: typeof isEveProject;
 }
 export interface ResolveTargetOptions {
-    /** Used only by `gatherInteractive`; headless runs ignore it. */
-    prompter: Prompter;
-    /** Skip the name prompt and use this value. */
+    /** Resolves the name and directory questions; the composed stack decides how. */
+    asker: Asker;
+    /**
+     * Interactive-only notice surface for the duplicate-directory re-ask loop.
+     * Narrower than the prompter it forwards to; goes away when notices get a
+     * channel of their own.
+     */
+    notify(message: string): void;
+    /**
+     * Skip the name question and use this value. Stays a factory option (not a
+     * `withAnswers` rung) so it keeps short-circuiting before any ask while
+     * still being validated, exactly as the dual-face box did.
+     */
     presetName?: string;
     /** Parent directory the project folder is created inside. Defaults to cwd. */
     targetDirectory?: string;
     /** Force scaffolding into the target directory instead of a `./<name>` child. */
     inPlace?: boolean;
+    /**
+     * Treat an existing `./<name>` that is already an Eve project as resumable
+     * instead of refusing it. Composed on for headless runs so re-runs converge;
+     * interactive runs keep refusing so a human notices the collision.
+     */
+    resumeExisting?: boolean;
     deps?: ResolveTargetDeps;
 }
-/** The name + directory decision both gather faces produce. */
+/** The name + directory decision gather produces. */
 export interface ResolveTargetInput {
     agentName: string;
     inPlace: boolean;
@@ -33,9 +49,10 @@ export interface ResolveTargetPayload {
 /**
  * THE TARGET BOX (Q1 + Q2): resolve the agent name (the shared identity for
  * the directory and the Vercel project) and decide whether to scaffold in
- * place or into a new `./<name>` child. The current-vs-new prompt only fires
+ * place or into a new `./<name>` child. The current-vs-new question only fires
  * when the target directory already looks like a project; otherwise creating a
- * new directory is the announced default. A headless gather resumes an
- * existing Eve project directory instead of refusing it, so re-runs converge.
+ * new directory is the announced default. A headless re-run resumes an
+ * existing Eve project directory instead of refusing it (composed via
+ * `resumeExisting`), so re-runs converge.
  */
 export declare function resolveTarget(options: ResolveTargetOptions): SetupBox<SetupState, ResolveTargetInput, ResolveTargetPayload>;

package/dist/src/setup/boxes/resolve-target.js

@@ -1 +1 @@
-import{CURRENT_DIRECTORY_PROJECT_NAME}from"../state.js";import{HeadlessPromptError}from"../headless.js";import{pathExists}from"../path-exists.js";import{basename,join,resolve}from"node:path";import{isEveProject}from"#setup/scaffold/index.js";const PROJECT_NAME_REGEX=/^(?!.*---)[a-z0-9-_.]+$/,DEFAULT_PROJECT_NAME=`my-agent`,NAME_PROMPT_MESSAGE=`What's your agent's name?`;function isValidProjectName(e){return PROJECT_NAME_REGEX.test(e)&&e.length>0&&e.length<=100}function validateProjectName(e){let t=e.trim();if(t.length===0)return`Project name cannot be empty.`;if(t===`..`)return`Project name cannot be '..'.`;if(!isValidProjectName(t))return`Project name can only contain up to 100 lowercase letters, digits, and the characters '.', '_', '-'.`}function validatePresetName(e){let t=e.trim(),n=validateProjectName(t);if(n)throw Error(n);return t}async function promptAgentName(e,t){return t===void 0?(await e.text({message:NAME_PROMPT_MESSAGE,placeholder:DEFAULT_PROJECT_NAME,defaultValue:DEFAULT_PROJECT_NAME,validate:e=>validateProjectName(e.trim()||DEFAULT_PROJECT_NAME)})).trim()||DEFAULT_PROJECT_NAME:validatePresetName(t)}function deriveInPlaceProjectName(e){let t=resolve(e??process.cwd()),n=basename(t);if(validateProjectName(n)!==void 0)throw Error(`Cannot infer a valid project name from "${t}". Pass --target-dir with a valid basename, or scaffold into a renamed directory.`);return n}function resolveTarget(i){let a=i.deps??{pathExists,isEveProject},parent=()=>resolve(i.targetDirectory??process.cwd()),inPlaceBasename=()=>basename(parent());async function assertNewDirectoryAvailable(t,n){if(t===CURRENT_DIRECTORY_PROJECT_NAME)return;let r=resolve(parent(),t);if(await a.pathExists(r)&&!(n&&await a.isEveProject(r)))throw Error(`Directory "${t}" already exists. Choose a different name.`)}async function looksLikeProject(e){let[t,n]=await Promise.all([a.pathExists(join(e,`package.json`)),a.pathExists(join(e,`.vercel`))]);return t||n}async function promptFreeDirectoryName(t,n){let r=n;for(;;){if(r===CURRENT_DIRECTORY_PROJECT_NAME||!await a.pathExists(resolve(parent(),r)))return r;t.note(`Directory "${r}" already exists. Choose a different name.`),r=await promptAgentName(t)}}function inPlaceInput(){return{agentName:i.presetName===void 0?deriveInPlaceProjectName(i.targetDirectory):validatePresetName(i.presetName),inPlace:!0}}return{id:`resolve-target`,async gatherInteractive(){if(i.inPlace)return i.presetName===void 0&&validateProjectName(inPlaceBasename())!==void 0?{kind:`done`,input:{agentName:await promptAgentName(i.prompter),inPlace:!0}}:{kind:`done`,input:inPlaceInput()};let e=i.prompter,t=await promptAgentName(e,i.presetName);return i.presetName===void 0&&await looksLikeProject(parent())&&await e.select({message:`This directory already looks like a project. Where should the agent live?`,options:[{value:`current`,label:`Scaffold into this directory`},{value:`new`,label:`Create a new directory ./${t}`}],initialValue:`new`})===`current`?{kind:`done`,input:{agentName:t,inPlace:!0}}:i.presetName===void 0?{kind:`done`,input:{agentName:await promptFreeDirectoryName(e,t),inPlace:!1}}:(await assertNewDirectoryAvailable(t,!1),{kind:`done`,input:{agentName:t,inPlace:!1}})},async gatherHeadless(){if(i.inPlace)return inPlaceInput();if(i.presetName===void 0)throw new HeadlessPromptError(NAME_PROMPT_MESSAGE);let e=validatePresetName(i.presetName);return await assertNewDirectoryAvailable(e,!0),{agentName:e,inPlace:!1}},async perform({input:t}){let n=t.inPlace?CURRENT_DIRECTORY_PROJECT_NAME:t.agentName;return{agentName:t.agentName,projectPath:{kind:`resolved`,inPlace:t.inPlace,path:resolve(parent(),n)}}},apply(e,t){return{...e,agentName:t.agentName,projectPath:t.projectPath}}}}export{resolveTarget};
+import{SkippedSignal,select,text}from"../ask.js";import{CURRENT_DIRECTORY_PROJECT_NAME}from"../state.js";import{pathExists}from"../path-exists.js";import{parseProjectName,validateProjectName}from"../project-name.js";import{basename,join,resolve}from"node:path";import{isEveProject}from"#setup/scaffold/index.js";const DEFAULT_PROJECT_NAME=`my-agent`;function validatePresetName(e){return parseProjectName(e)}async function askAgentName(e,t){return(await e.ask(text({key:`name`,message:`What's your agent's name?`,placeholder:DEFAULT_PROJECT_NAME,recommended:DEFAULT_PROJECT_NAME,validate:e=>validateProjectName(e.trim()||DEFAULT_PROJECT_NAME)??null,required:t}))).trim()||DEFAULT_PROJECT_NAME}function deriveInPlaceProjectName(e){let t=resolve(e??process.cwd()),n=basename(t);if(validateProjectName(n)!==void 0)throw Error(`Cannot infer a valid project name from "${t}". Pass --target-dir with a valid basename, or scaffold into a renamed directory.`);return n}function resolveTarget(n){let i=n.deps??{pathExists,isEveProject},parent=()=>resolve(n.targetDirectory??process.cwd()),inPlaceBasename=()=>basename(parent());async function assertNewDirectoryAvailable(e){if(e===CURRENT_DIRECTORY_PROJECT_NAME)return;let t=resolve(parent(),e);if(await i.pathExists(t)&&!(n.resumeExisting===!0&&await i.isEveProject(t)))throw Error(`Directory "${e}" already exists. Choose a different name.`)}async function looksLikeProject(e){let[t,n]=await Promise.all([i.pathExists(join(e,`package.json`)),i.pathExists(join(e,`.vercel`))]);return t||n}async function askFreeDirectoryName(e){let t=e;for(;;){if(t===CURRENT_DIRECTORY_PROJECT_NAME||!await i.pathExists(resolve(parent(),t)))return t;n.notify(`Directory "${t}" already exists. Choose a different name.`),t=await askAgentName(n.asker,!0)}}function inPlaceInput(){return{agentName:n.presetName===void 0?deriveInPlaceProjectName(n.targetDirectory):validatePresetName(n.presetName),inPlace:!0}}return{id:`resolve-target`,async gather(){if(n.inPlace){if(n.presetName===void 0&&validateProjectName(inPlaceBasename())!==void 0)try{return{agentName:await askAgentName(n.asker,!1),inPlace:!0}}catch(t){if(!(t instanceof SkippedSignal))throw t}return inPlaceInput()}if(n.presetName!==void 0){let e=validatePresetName(n.presetName);return await assertNewDirectoryAvailable(e),{agentName:e,inPlace:!1}}let r=await askAgentName(n.asker,!0);return await looksLikeProject(parent())&&await n.asker.ask(select({key:`target-directory`,message:`This directory already looks like a project. Where should the agent live?`,options:[{id:`current`,label:`Scaffold into this directory`,value:`current`},{id:`new`,label:`Create a new directory ./${r}`,value:`new`}],recommended:`new`,required:!0}))===`current`?{agentName:r,inPlace:!0}:{agentName:await askFreeDirectoryName(r),inPlace:!1}},async perform({input:e}){let t=e.inPlace?CURRENT_DIRECTORY_PROJECT_NAME:e.agentName;return{agentName:e.agentName,projectPath:{kind:`resolved`,inPlace:e.inPlace,path:resolve(parent(),t)}}},apply(e,t){return{...e,agentName:t.agentName,projectPath:t.projectPath}}}}export{resolveTarget};

package/dist/src/setup/boxes/scaffold.d.ts

@@ -15,20 +15,26 @@ export interface ScaffoldOptions {
     targetDirectory?: string;
     /** Allow the in-place scaffold to replace Eve scaffold files that already exist. */
     overwriteExisting?: boolean;
+    /**
+     * Headless mode: a headless re-run over an existing Eve project skips
+     * scaffolding (idempotent re-entry); an interactive run always scaffolds and
+     * lets `scaffoldBaseProject` own the in-place conflict rules. The box prompts
+     * for nothing, so this dispatch comes from the composition site.
+     */
+    headless?: boolean;
     deps?: ScaffoldDeps;
 }
 /**
- * Which gather face produced the input. A headless re-run over an existing Eve
- * project skips scaffolding (idempotent re-entry); an interactive run always
- * scaffolds and lets `scaffoldBaseProject` own the in-place conflict rules.
+ * Whether the run is headless. A headless re-run over an existing Eve project
+ * skips scaffolding (idempotent re-entry); an interactive run always scaffolds.
  */
 export interface ScaffoldInput {
     headless: boolean;
 }
 /**
  * THE SCAFFOLD BOX: writes the base agent template into the path resolved by
- * the target box. It prompts for nothing; the gather faces only record which
- * mode ran, because a headless re-run on an already-scaffolded Eve project
- * skips the write and continues setup instead of failing.
+ * the target box. It prompts for nothing; the gather only records which mode
+ * ran, because a headless re-run on an already-scaffolded Eve project skips the
+ * write and continues setup instead of failing.
  */
 export declare function scaffold(options: ScaffoldOptions): SetupBox<SetupState, ScaffoldInput, string>;

package/dist/src/setup/boxes/scaffold.js

@@ -1 +1 @@
-import{CURRENT_DIRECTORY_PROJECT_NAME,requireProjectPath}from"../state.js";import{isEveProject,scaffoldBaseProject}from"#setup/scaffold/index.js";function scaffold(i){let a=i.deps??{scaffoldBaseProject,isEveProject};return{id:`scaffold`,async gatherInteractive(){return{kind:`done`,input:{headless:!1}}},async gatherHeadless(){return{headless:!0}},async perform({state:n,input:r}){let{prompter:o}=i,s=n.projectPath.inPlace?CURRENT_DIRECTORY_PROJECT_NAME:n.agentName,c=requireProjectPath(n);if(r.headless&&!i.overwriteExisting&&await a.isEveProject(c))return o.log.message(`Existing Eve project detected; continuing setup...`),c;o.log.message(`Scaffolding project files...`);let l=await a.scaffoldBaseProject({projectName:s,model:n.modelId,byokProvider:n.modelWiring===`self`,targetDirectory:i.targetDirectory,overwriteExisting:i.overwriteExisting,onOverwriteFile:e=>o.log.warning(`Overwrote ${e}`),evePackageVersion:i.evePackageVersion});return o.log.success(`Scaffolded project at ${l}`),l},apply(e,t){return{...e,projectPath:{kind:`resolved`,inPlace:e.projectPath.inPlace,path:t}}}}}export{scaffold};
+import{CURRENT_DIRECTORY_PROJECT_NAME,requireProjectPath}from"../state.js";import{isEveProject,scaffoldBaseProject}from"#setup/scaffold/index.js";function scaffold(i){let a=i.deps??{scaffoldBaseProject,isEveProject};return{id:`scaffold`,async gather(){return{headless:i.headless??!1}},async perform({state:n,input:r}){let{prompter:o}=i,s=n.projectPath.inPlace?CURRENT_DIRECTORY_PROJECT_NAME:n.agentName,c=requireProjectPath(n);if(r.headless&&!i.overwriteExisting&&await a.isEveProject(c))return o.log.message(`Existing Eve project detected; continuing setup...`),c;o.log.message(`Scaffolding project files...`);let l=await a.scaffoldBaseProject({projectName:s,model:n.modelId,byokProvider:n.modelWiring===`self`,targetDirectory:i.targetDirectory,overwriteExisting:i.overwriteExisting,onOverwriteFile:e=>o.log.warning(`Overwrote ${e}`),evePackageVersion:i.evePackageVersion});return o.log.success(`Scaffolded project at ${l}`),l},apply(e,t){return{...e,projectPath:{kind:`resolved`,inPlace:e.projectPath.inPlace,path:t}}}}}export{scaffold};

package/dist/src/setup/boxes/select-channels.d.ts

@@ -1,21 +1,50 @@
 import { type ChannelKind } from "#setup/scaffold/index.js";
-import type { Prompter } from "../prompter.js";
+import type { DisabledChannelReasons } from "#setup/cli/index.js";
+import type { Asker } from "../ask.js";
 import { type SetupState } from "../state.js";
 import type { SetupBox } from "../step.js";
+/** The channel question, shared with the dev TUI's /channels action list. */
+export declare const CHANNELS_PROMPT_MESSAGE = "Where will you chat with your agent?";
 export interface SelectChannelsOptions {
-    /** Used only by `gatherInteractive`; headless runs ignore it. */
-    prompter: Prompter;
-    /** Skip the picker and use these channels (headless or flag-driven runs). */
+    /** Resolves the channels question; the composed stack decides how. */
+    asker: Asker;
+    /**
+     * Resolve to these channels without asking. Stays a factory option (not a
+     * `withAnswers` rung) so it keeps short-circuiting the picker exactly as the
+     * dual-face box did, while still passing the Slack/Vercel gate and
+     * `validateSelection` like a picked selection.
+     */
     presetChannels?: ChannelKind[];
+    /**
+     * Picker shape, chosen explicitly because the variants differ in whether a
+     * selection is required, whether the REPL row is shown, and how Slack is
+     * gated. The "channels-add" picker allows an empty submission and keeps Slack
+     * selectable from an unlinked directory because its add-channels box can run
+     * an interactive `vercel link` on demand.
+     */
+    variant: "onboarding" | "in-project" | "channels-add";
+    /**
+     * Reasons for channel kinds that cannot be added to this project (existing
+     * registrations); matching rows render disabled with the reason.
+     */
+    disabledChannelReasons?: DisabledChannelReasons;
+    /**
+     * Rejects a selection before any later box runs effects. Runs on both the
+     * asked and the preset path, so a flag-driven selection is validated exactly
+     * like a picked one. A throw aborts the run.
+     */
+    validateSelection?(channels: readonly ChannelKind[]): Promise<void> | void;
 }
 /**
  * THE CHANNELS BOX: interview-phase channel picker. Choosing channels is human
  * input, so it runs before any filesystem work; the channels box scaffolds the
- * chosen channels afterward from `state.channelSelection`. Slack is gated when
- * the run is not deploying to Vercel, since it needs a linked project.
+ * chosen channels afterward from `state.channelSelection`. During onboarding
+ * the deployment decision has not been made yet, so Slack is never gated here:
+ * picking it is what makes the later provisioning box resolve to Vercel. Only
+ * the in-project variant gates Slack, on the detected on-disk link.
  *
- * The picker is required and always carries a locked, pre-selected CLI REPL row,
- * so an empty selection is impossible: every agent can at least be chatted with
- * locally in the terminal. Web and Slack stack on top of it.
+ * The onboarding picker is required and always carries a locked, pre-selected
+ * Terminal UI row, so an empty selection is impossible: every agent can at least be
+ * chatted with locally in the terminal. Web and Slack stack on top of it.
  */
 export declare function selectChannels(options: SelectChannelsOptions): SetupBox<SetupState, ChannelKind[], ChannelKind[]>;

package/dist/src/setup/boxes/select-channels.js

@@ -1 +1 @@
-import{hasVercelProject}from"../state.js";import{HeadlessPromptError}from"../headless.js";import{SCAFFOLDABLE_CHANNELS}from"#setup/scaffold/index.js";const CHANNELS_PROMPT_MESSAGE=`Select channels`;function selectChannels(r){function assertSlackHasVercel(e,t){if(e&&t.includes(`slack`))throw Error(`Slack requires a Vercel project. Re-run and choose to deploy to Vercel to add Slack.`)}return{id:`select-channels`,async gatherInteractive({state:t}){let i=!hasVercelProject(t);if(r.presetChannels!==void 0)return assertSlackHasVercel(i,r.presetChannels),{kind:`done`,input:r.presetChannels};let a=SCAFFOLDABLE_CHANNELS.map(e=>i&&e.kind===`slack`?{value:e.kind,label:e.label,disabled:!0,disabledReason:`needs a Vercel project`}:{value:e.kind,label:e.label,hint:e.hint}),o={value:`tui`,label:`CLI REPL`,locked:!0,lockedReason:`always available`},s=await r.prompter.select({multiple:!0,message:CHANNELS_PROMPT_MESSAGE,options:[...a,o],required:!0});return assertSlackHasVercel(i,s),{kind:`done`,input:s.filter(e=>e!==`tui`)}},async gatherHeadless({state:n}){if(r.presetChannels===void 0)throw new HeadlessPromptError(CHANNELS_PROMPT_MESSAGE);return assertSlackHasVercel(!hasVercelProject(n),r.presetChannels),r.presetChannels},async perform({input:e}){return e},apply(e,t){return{...e,channelSelection:t}}}}export{selectChannels};
+import{hasVercelProject}from"../state.js";import{SCAFFOLDABLE_CHANNELS}from"#setup/scaffold/index.js";const CHANNELS_PROMPT_MESSAGE=`Where will you chat with your agent?`;function selectChannels(n){let r=n.variant===`channels-add`,i=n.variant===`in-project`;function assertSlackHasVercel(e,t){if(e&&t.includes(`slack`))throw Error("Slack requires a Vercel project. Link this directory (`vercel link`) and re-run to add Slack.")}function slackLacksVercel(t){return i&&!hasVercelProject(t)}return{id:`select-channels`,async gather({state:e}){let i=slackLacksVercel(e);if(n.presetChannels!==void 0)return assertSlackHasVercel(i,n.presetChannels),await n.validateSelection?.(n.presetChannels),n.presetChannels;let a=SCAFFOLDABLE_CHANNELS.map(e=>{let t=n.disabledChannelReasons?.[e.kind];return t===void 0?i&&e.kind===`slack`?{id:e.kind,value:e.kind,label:e.label,disabled:!0,disabledReason:`needs a Vercel project`}:{id:e.kind,value:e.kind,label:e.label,hint:e.hint}:{id:e.kind,value:e.kind,label:e.label,hint:e.hint,disabled:!0,disabledReason:t}}),o={id:`tui`,value:`tui`,label:`Terminal UI`,locked:!0,lockedReason:`always available`},s=await n.asker.askMany({key:`channels`,message:CHANNELS_PROMPT_MESSAGE,options:r?a:[...a,o],required:!0,requireSelection:!r});assertSlackHasVercel(i,s);let c=s.filter(e=>e!==`tui`);return await n.validateSelection?.(c),c},async perform({input:e}){return e},apply(e,t){return{...e,channelSelection:t}}}}export{CHANNELS_PROMPT_MESSAGE,selectChannels};

package/dist/src/setup/boxes/select-chat.d.ts

@@ -1,4 +1,4 @@
-import type { Prompter, SelectOption } from "../prompter.js";
+import { type Asker, type SelectOption } from "../ask.js";
 import type { ChannelKind, ChatPreference, SetupState } from "../state.js";
 import type { SetupBox } from "../step.js";
 /** The scaffolded facts the chat option list is derived from. */
@@ -11,24 +11,28 @@ export interface ChatPreferenceContext {
 /**
  * Builds the chat-preference option list. Channel-backed options come
  * first (in the order Web -> Slack) when available, then the framework
- * built-ins (CLI REPL, API), then the explicit skip option last. Exported
+ * built-ins (Terminal UI, API), then the explicit skip option last. Exported
  * for the unit test.
  */
 export declare function buildChatPreferenceOptions(args: ChatPreferenceContext): SelectOption<ChatPreference>[];
 export interface SelectChatOptions {
-    /** Used only by `gatherInteractive`; headless runs ignore it. */
-    prompter: Prompter;
+    /** Resolves the chat question; the composed stack decides how. */
+    asker: Asker;
     /**
-     * Skip the prompt and use this value. The headless default ("skip") lives at
-     * the composition site, not here, so a missing headless preset fails fast.
+     * Resolve to this value without asking. The headless default ("skip") lives
+     * at the composition site, not here, so a missing headless preset fails
+     * fast. Stays a factory option (not a `withAnswers` rung) because a preset
+     * must keep bypassing the option list, which hides choices the current
+     * state did not scaffold, exactly as the dual-face box did.
      */
     presetPreference?: ChatPreference;
 }
 /**
- * THE CHAT BOX: final prompt of the create flow. Asks where the user wants to
- * chat with their agent. Options are dynamic on what was scaffolded earlier.
- * Web Chat appears only if `web` is in the scaffolded channels, Slack appears
- * only if `slack` was scaffolded AND the bot was attached during the
- * "Select channels" step. REPL, API, and Skip are always present.
+ * THE CHAT BOX: final prompt of the create flow. Asks one required "chat"
+ * select through the box's asker: where the user wants to chat with their
+ * agent. Options are dynamic on what was scaffolded earlier. Web Chat appears
+ * only if `web` is in the scaffolded channels, Slack appears only if `slack`
+ * was scaffolded AND the bot was attached during the channel setup step.
+ * REPL, API, and Skip are always present.
  */
 export declare function selectChat(options: SelectChatOptions): SetupBox<SetupState, ChatPreference, ChatPreference>;

package/dist/src/setup/boxes/select-chat.js

@@ -1 +1 @@
-import{HeadlessPromptError}from"../headless.js";const CHAT_PROMPT_MESSAGE=`Start a chat with your agent now`;function buildChatPreferenceOptions(e){let t=[];return e.availableChannels.includes(`web`)&&t.push({value:`web`,label:`Web chat`,hint:`next.js`}),e.availableChannels.includes(`slack`)&&e.slackbotAttached&&t.push({value:`slack`,label:`Slack`,hint:`open workspace`}),t.push({value:`repl`,label:`CLI REPL`}),t.push({value:`api`,label:`API`}),t.push({value:`skip`,label:`Skip and chat later`}),t}function pickInitialPreference(e){if(e.availableChannels.includes(`web`))return`web`;if(e.availableChannels.includes(`slack`)&&e.slackbotAttached)return`slack`}function selectChat(n){return{id:`select-chat`,async gatherInteractive({state:e}){if(n.presetPreference!==void 0)return{kind:`done`,input:n.presetPreference};let r={availableChannels:[...e.channels],slackbotAttached:e.slackbotAttached};return{kind:`done`,input:await n.prompter.select({message:CHAT_PROMPT_MESSAGE,options:buildChatPreferenceOptions(r),initialValue:pickInitialPreference(r)})}},async gatherHeadless(){if(n.presetPreference!==void 0)return n.presetPreference;throw new HeadlessPromptError(CHAT_PROMPT_MESSAGE)},async perform({input:e}){return e},apply(e,t){return{...e,chat:t}}}}export{buildChatPreferenceOptions,selectChat};
+import{select}from"../ask.js";function buildChatPreferenceOptions(e){let option=(e,t,n)=>({id:e,label:t,value:e,hint:n}),t=[];return e.availableChannels.includes(`web`)&&t.push(option(`web`,`Web chat`,`next.js`)),e.availableChannels.includes(`slack`)&&e.slackbotAttached&&t.push(option(`slack`,`Slack`,`open workspace`)),t.push(option(`repl`,`Terminal UI`)),t.push(option(`api`,`API`)),t.push(option(`skip`,`Skip and chat later`)),t}function pickInitialPreference(e){if(e.availableChannels.includes(`web`))return`web`;if(e.availableChannels.includes(`slack`)&&e.slackbotAttached)return`slack`}function selectChat(t){return{id:`select-chat`,async gather({state:n}){if(t.presetPreference!==void 0)return t.presetPreference;let r={availableChannels:[...n.channels],slackbotAttached:n.slackbotAttached};return t.asker.ask(select({key:`chat`,message:`Start a chat with your agent now`,options:buildChatPreferenceOptions(r),recommended:pickInitialPreference(r),required:!0}))},async perform({input:e}){return e},apply(e,t){return{...e,chat:t}}}}export{buildChatPreferenceOptions,selectChat};

package/dist/src/setup/boxes/select-connections.d.ts

@@ -0,0 +1,30 @@
+import type { ConnectionSelectOption } from "#setup/cli/index.js";
+import { type Asker } from "../ask.js";
+import type { ConnectionPlan, SetupState } from "../state.js";
+import type { SetupBox } from "../step.js";
+export declare const CONNECT_REQUIRES_VERCEL = "Authenticates through Vercel Connect, which needs a Vercel project. Re-run and choose to deploy to Vercel.";
+export interface SelectConnectionsOptions {
+    /** Resolves the picker and custom sub-questions; the composed stack decides how. */
+    asker: Asker;
+    /**
+     * Headless mode: skips the picker entirely unless `presetConnections` were
+     * requested. Fixed at composition time (the same place the asker base is
+     * chosen), since `gather` cannot read the mode off the asker.
+     */
+    headless?: boolean;
+    /** Skip the picker and plan exactly these catalog slugs. */
+    presetConnections?: string[];
+}
+/** Exported for tests: the picker rows derived from the curated catalog. */
+export declare function buildCatalogOptions(disabledReasons: Readonly<Record<string, string>>): ConnectionSelectOption[];
+/**
+ * THE CONNECTION SELECTION BOX: part of the interview phase, before any
+ * filesystem write. Offers the connection catalog (plus a custom MCP / OpenAPI
+ * escape hatch through preset slugs) and resolves every prompt into
+ * fully-specified {@link ConnectionPlan}s recorded on the state; the
+ * add-connections box executes them after the scaffold and link. The full
+ * catalog is selectable: the deployment decision comes later in the interview,
+ * and the provisioning box resolves to Vercel when a Connect-backed selection
+ * needs a project.
+ */
+export declare function selectConnections(options: SelectConnectionsOptions): SetupBox<SetupState, ConnectionPlan[], ConnectionPlan[]>;

package/dist/src/setup/boxes/select-connections.js

@@ -0,0 +1 @@
+import{select,text}from"../ask.js";import{CONNECTION_CATALOG,CUSTOM_CONNECTION_SLUG,SUPPORTED_PROTOCOLS,catalogSlugs,effectiveProtocols,getCatalogEntry,isValidConnectionSlug}from"#setup/scaffold/index.js";import{connectorServiceForEntry}from"#setup/scaffold/connections/catalog.js";const CONNECT_REQUIRES_VERCEL=`Authenticates through Vercel Connect, which needs a Vercel project. Re-run and choose to deploy to Vercel.`,PROTOCOL_LABELS={mcp:`MCP`,openapi:`OpenAPI`};function buildCatalogOptions(e){return CONNECTION_CATALOG.map(t=>{let n=e[t.slug];return n===void 0?{value:t.slug,label:t.label,hint:t.hint}:{value:t.slug,label:t.label,hint:t.hint,disabled:!0,disabledReason:n}})}function unknownSlugError(e){return Error(`Unknown connection "${e}". Known: ${catalogSlugs().join(`, `)}, or pass a custom name with a definition.`)}function assertSupportedProtocols(e,t){if(e.length===0)throw Error(`No supported protocol for "${t}". Supported: ${SUPPORTED_PROTOCOLS.join(`, `)}.`)}async function resolveProtocolInteractive(t,n,r){let i=effectiveProtocols(n);return assertSupportedProtocols(i,r),i.length===1?i[0]:t.ask(select({key:`protocol:${r}`,message:`Protocol for ${r}`,options:i.map(e=>({id:e,value:e,label:PROTOCOL_LABELS[e]}))}))}function resolveProtocolHeadless(e,t){let n=effectiveProtocols(e);if(assertSupportedProtocols(n,t),n.length>1)throw Error(`Connection "${t}" supports multiple protocols (${n.join(`, `)}). Pass --protocol to choose one.`);return n[0]}function deriveProvision(e,t){if(e.auth?.kind!==`connect`)return{kind:`none`};let n=connectorServiceForEntry({mcp:e.mcp,auth:e.auth});return n===void 0?{kind:`connect-manual`}:t?{kind:`command-hint`,service:n}:{kind:`connect`,service:n}}async function promptCustomSlug(e){return e.ask(text({key:`connection-name`,message:`Connection name`,placeholder:`mycorp`,validate:e=>{let t=e.trim();return t.length===0?`A name is required.`:isValidConnectionSlug(t)?null:`Start with a lowercase letter; use only lowercase letters, digits, and hyphens (max 64 characters).`}}))}async function planCustomInteractive(e,n){let r=await resolveProtocolInteractive(e,void 0,n),i=await e.ask(text({key:`description:${n}`,message:`Description for ${n}`,placeholder:`What this connection exposes`}));if(r===`mcp`){let a={slug:n,description:i,protocols:[`mcp`],mcp:{url:(await e.ask(text({key:`mcp-url:${n}`,message:`MCP server URL for ${n}`,placeholder:`https://mcp.example.com/sse`,validate:e=>e.trim().length===0?`A URL is required.`:null}))).trim()},auth:{kind:`connect`,connector:n}};return{slug:n,protocol:r,entry:a,provision:deriveProvision(a,!1)}}let a=await e.ask(text({key:`openapi-spec:${n}`,message:`OpenAPI spec URL for ${n}`,placeholder:`https://api.example.com/openapi.json`,validate:e=>e.trim().length===0?`A spec URL is required.`:null})),o=await e.ask(text({key:`openapi-base-url:${n}`,message:`Base URL for ${n} (optional)`,placeholder:`https://api.example.com`})),s={slug:n,description:i,protocols:[`openapi`],openapi:o.trim().length>0?{spec:a.trim(),baseUrl:o.trim()}:{spec:a.trim()},auth:{kind:`connect`,connector:n}};return{slug:n,protocol:r,entry:s,provision:deriveProvision(s,!1)}}async function planSelectionInteractive(e,t){if(t===CUSTOM_CONNECTION_SLUG)return planCustomInteractive(e,(await promptCustomSlug(e)).trim());let n=getCatalogEntry(t);if(n!==void 0)return{slug:t,protocol:await resolveProtocolInteractive(e,n.protocols,t),entry:n,provision:deriveProvision(n,!1)};if(!isValidConnectionSlug(t))throw unknownSlugError(t);return planCustomInteractive(e,t)}function planPresetHeadless(e){if(e===CUSTOM_CONNECTION_SLUG)throw Error(`Custom connection requires interactive input or a preset definition.`);let t=getCatalogEntry(e);if(t!==void 0)return{slug:e,protocol:resolveProtocolHeadless(t.protocols,e),entry:t,provision:deriveProvision(t,!0)};throw isValidConnectionSlug(e)?Error(`Custom connection "${e}" requires interactive input or a preset definition.`):unknownSlugError(e)}function selectConnections(e){return{id:`select-connections`,async gather(){let t=e.headless??!1,n=e.presetConnections??[];if(t)return n.map(e=>planPresetHeadless(e));let r;if(n.length>0)r=[...n];else{let t=buildCatalogOptions({}).map(e=>({id:String(e.value),value:String(e.value),label:e.label,hint:e.hint,disabled:e.disabled,disabledReason:e.disabledReason}));r=await e.asker.askMany({key:`connection`,message:`What should your agent connect to?`,options:t})}let i=[];for(let t of r)i.push(await planSelectionInteractive(e.asker,t));return i},async perform({input:e}){return e},apply(e,t){return{...e,connectionSelection:t}}}}export{CONNECT_REQUIRES_VERCEL,buildCatalogOptions,selectConnections};

package/dist/src/setup/boxes/select-model.d.ts

@@ -1,12 +1,6 @@
-import type { Prompter } from "../prompter.js";
+import { type Asker } from "../ask.js";
 import type { SetupState } from "../state.js";
 import type { SetupBox } from "../step.js";
-/**
- * Model baked into the scaffold when the model prompt is skipped (the
- * "wire your own provider" path). The `byok` template wires the Anthropic
- * provider, so this is an Anthropic model.
- */
-export declare const DEFAULT_MODEL_ID = "anthropic/claude-opus-4.8";
 /** One model entry from the AI Gateway catalog response. */
 export interface GatewayCatalogModel {
     id: string;
@@ -15,14 +9,21 @@ export interface GatewayCatalogModel {
     owned_by: string;
     tags?: readonly string[];
 }
+/** Fetches the raw AI Gateway catalog. The default for {@link SelectModelDeps}. */
+export declare function fetchGatewayCatalog(): Promise<GatewayCatalogModel[]>;
 /** Injected for tests; defaults to the real AI Gateway catalog fetch. */
 export interface SelectModelDeps {
     fetchModels: () => Promise<GatewayCatalogModel[]>;
 }
 export interface SelectModelOptions {
-    /** Used only by `gatherInteractive`; headless runs ignore it. */
-    prompter: Prompter;
-    /** Skip the prompt and return this value if provided. */
+    /** Resolves the model question; the composed stack decides how. */
+    asker: Asker;
+    /**
+     * Resolve to this value without fetching the catalog or asking. Stays a
+     * factory option (not a `withAnswers` rung) because a preset must keep
+     * short-circuiting the catalog fetch and must keep accepting ids the
+     * filtered catalog does not list, exactly as the dual-face box did.
+     */
     presetModel?: string;
     /**
      * Pre-select this model in the picker so enter confirms it. Falls back to the
@@ -33,9 +34,12 @@ export interface SelectModelOptions {
 }
 /**
  * THE MODEL BOX: pick the default model baked into `agent/agent.ts`. The
- * interactive face fetches the AI Gateway catalog and offers a searchable
- * picker; the headless face requires a preset. Wiring your own provider
- * (`modelWiring === "self"`) skips the model prompt entirely: the byok scaffold
- * pins a default model the user can edit afterward.
+ * gather fetches the AI Gateway catalog and asks one required "model" select
+ * through the box's asker, so an interactive stack offers a searchable picker
+ * while a headless stack refuses structurally when no preset answered it.
+ * The model is the first thing the interview decides about the agent itself;
+ * how the credential is wired (gateway vs your own provider key) is the
+ * provisioning box's later decision, and the byok scaffold derives its
+ * provider block from whatever model was picked here.
  */
 export declare function selectModel(options: SelectModelOptions): SetupBox<SetupState, string, string>;

package/dist/src/setup/boxes/select-model.js

@@ -1 +1 @@
-import{HeadlessPromptError}from"../headless.js";const POPULAR_PROVIDERS=[`anthropic`,`openai`,`google`],MODEL_PROMPT_MESSAGE=`Which model should your agent use?`,DEFAULT_MODEL_ID=`anthropic/claude-opus-4.8`,FALLBACK_MODELS=[{value:DEFAULT_MODEL_ID,label:`Claude Opus 4.8`,hint:`Anthropic`},{value:`anthropic/claude-sonnet-4.6`,label:`Claude Sonnet 4.6`,hint:`Anthropic`},{value:`openai/gpt-4.1-mini`,label:`GPT-4.1 mini`,hint:`OpenAI`},{value:`openai/gpt-5-mini`,label:`GPT-5 mini`,hint:`OpenAI`},{value:`google/gemini-2.5-flash`,label:`Gemini 2.5 Flash`,hint:`Google`}];function providerLabel(e){return e.length===0?``:e.charAt(0).toUpperCase()+e.slice(1)}function providerPriority(e){let n=POPULAR_PROVIDERS.indexOf(e);return n===-1?POPULAR_PROVIDERS.length:n}async function fetchGatewayCatalog(){let e=new AbortController,t=setTimeout(()=>e.abort(),5e3);try{return(await(await fetch(`https://ai-gateway.vercel.sh/v1/models`,{signal:e.signal})).json()).data}finally{clearTimeout(t)}}async function buildModelOptions(e){try{let t=(await e()).filter(e=>e.type===`language`&&(e.tags??[]).includes(`web-search`)).map(e=>{let t=e.id.split(`/`)[0]??``;return{value:e.id,label:e.name,hint:providerLabel(t),provider:t}}).sort((e,t)=>{let n=providerPriority(e.provider)-providerPriority(t.provider);if(n!==0)return n;let r=e.provider.localeCompare(t.provider);return r===0?e.label.localeCompare(t.label):r});return t.length===0?FALLBACK_MODELS:t.map(({value:e,label:t,hint:n})=>({value:e,label:t,hint:n}))}catch{return FALLBACK_MODELS}}function selectModel(t){let i=t.deps??{fetchModels:fetchGatewayCatalog};function presetFor(e){if(e.modelWiring===`self`)return DEFAULT_MODEL_ID;if(t.presetModel!==void 0&&t.presetModel.length>0)return t.presetModel}return{id:`select-model`,async gatherInteractive({state:e}){let r=presetFor(e);if(r!==void 0)return{kind:`done`,input:r};let a=await buildModelOptions(i.fetchModels),o=t.defaultModel!==void 0&&a.some(e=>e.value===t.defaultModel)?t.defaultModel:a[0]?.value;return{kind:`done`,input:await t.prompter.select({message:MODEL_PROMPT_MESSAGE,search:!0,placeholder:`type to filter (e.g. 'claude', 'gpt', 'gemini')`,options:a,initialValue:o})}},async gatherHeadless({state:t}){let r=presetFor(t);if(r!==void 0)return r;throw new HeadlessPromptError(MODEL_PROMPT_MESSAGE)},async perform({input:e}){return e},apply(e,t){return{...e,modelId:t}}}}export{DEFAULT_MODEL_ID,selectModel};
+import{select}from"../ask.js";import{DEFAULT_AGENT_MODEL_ID}from"#shared/default-agent-model.js";const POPULAR_PROVIDERS=[`anthropic`,`openai`,`google`];function modelOption(e,t,n){return{id:e,label:t,value:e,hint:n,featured:!0}}const FEATURED_MODEL_IDS=[DEFAULT_AGENT_MODEL_ID,`anthropic/claude-opus-4.8`,`openai/gpt-5.5`,`google/gemini-3.5`],FALLBACK_MODELS=[modelOption(DEFAULT_AGENT_MODEL_ID,`Claude Sonnet 4.6`,`Anthropic`),modelOption(`anthropic/claude-opus-4.8`,`Claude Opus 4.8`,`Anthropic`),modelOption(`openai/gpt-5.5`,`GPT-5.5`,`OpenAI`),modelOption(`google/gemini-3.5`,`Gemini 3.5`,`Google`)];function providerLabel(e){return e.length===0?``:e.charAt(0).toUpperCase()+e.slice(1)}function providerPriority(e){let t=POPULAR_PROVIDERS.indexOf(e);return t===-1?POPULAR_PROVIDERS.length:t}async function fetchGatewayCatalog(){let e=new AbortController,t=setTimeout(()=>e.abort(),5e3);try{return(await(await fetch(`https://ai-gateway.vercel.sh/v1/models`,{signal:e.signal})).json()).data}finally{clearTimeout(t)}}function featuredPriority(e){let t=FEATURED_MODEL_IDS.indexOf(e);return t===-1?FEATURED_MODEL_IDS.length:t}async function buildModelOptions(e){try{let t=(await e()).filter(e=>e.type===`language`&&(e.tags??[]).includes(`web-search`)).map(e=>{let t=e.id.split(`/`)[0]??``;return{value:e.id,label:e.name,hint:providerLabel(t),provider:t}}).sort((e,t)=>{let n=featuredPriority(e.value)-featuredPriority(t.value);if(n!==0)return n;let r=providerPriority(e.provider)-providerPriority(t.provider);if(r!==0)return r;let i=e.provider.localeCompare(t.provider);return i===0?e.label.localeCompare(t.label):i});return t.length===0?FALLBACK_MODELS:t.map(({value:e,label:t,hint:n})=>({id:e,label:t,value:e,hint:n,featured:FEATURED_MODEL_IDS.includes(e)||void 0}))}catch{return FALLBACK_MODELS}}function selectModel(n){let r=n.deps??{fetchModels:fetchGatewayCatalog};return{id:`select-model`,async gather(){let i=n.presetModel;if(i!==void 0&&i.length>0)return i;let a=await buildModelOptions(r.fetchModels),o=n.defaultModel!==void 0&&a.some(e=>e.value===n.defaultModel)?n.defaultModel:a.some(e=>e.value===DEFAULT_AGENT_MODEL_ID)?DEFAULT_AGENT_MODEL_ID:a[0]?.value;return n.asker.ask(select({key:`model`,message:`Which model should your agent use?`,options:a,recommended:o,required:!0,search:!0,placeholder:`type to filter (e.g. 'claude', 'gpt', 'gemini')`}))},async perform({input:e}){return e},apply(e,t){return{...e,modelId:t}}}}export{fetchGatewayCatalog,selectModel};

package/dist/src/setup/boxes/select-setup-mode.d.ts

@@ -0,0 +1,32 @@
+import { type Asker } from "../ask.js";
+import type { SetupMode, SetupState } from "../state.js";
+import type { SetupBox } from "../step.js";
+export interface SelectSetupModeOptions {
+    /** Resolves the mode question; the composed stack decides how. */
+    asker: Asker;
+    /**
+     * Skip the mode question and use this value. Stays a factory option (not a
+     * `withAnswers` rung) so it short-circuits before any ask, which is what
+     * lets a headless `--one-shot` run resolve without a terminal.
+     */
+    presetMode?: SetupMode;
+    /**
+     * Model baked into a one-shot scaffold instead of {@link DEFAULT_AGENT_MODEL_ID}.
+     * Threaded from the same `--model` preset the model box consumes, so the
+     * flag keeps working when the model box is skipped.
+     */
+    presetModel?: string;
+}
+/** The mode plus the model a one-shot run pins, since the model box is skipped. */
+export interface SelectSetupModePayload {
+    mode: SetupMode;
+    modelId?: string;
+}
+/**
+ * THE SETUP-MODE BOX: decide whether the run is the complete onboarding flow
+ * or a one-shot scaffold. One-shot pins the default model here because every
+ * later interview box (including the model picker) is gated off. The question
+ * is skippable, so a headless stack without a preset resolves to "complete"
+ * and current headless behavior is unchanged.
+ */
+export declare function selectSetupMode(options: SelectSetupModeOptions): SetupBox<SetupState, SetupMode, SelectSetupModePayload>;

package/dist/src/setup/boxes/select-setup-mode.js

@@ -0,0 +1 @@
+import{SkippedSignal,select}from"../ask.js";import{DEFAULT_AGENT_MODEL_ID}from"#shared/default-agent-model.js";function selectSetupMode(n){return{id:`select-setup-mode`,async gather(){if(n.presetMode!==void 0)return n.presetMode;try{return await n.asker.ask(select({key:`setup-mode`,message:`How much should we set up now?`,options:[{id:`complete`,label:`Complete setup`,value:`complete`,hint:`model, channels, connections, deploy`},{id:`one-shot`,label:`One-shot`,value:`one-shot`,hint:`just write the project files`}],recommended:`complete`}))}catch(t){if(t instanceof SkippedSignal)return`complete`;throw t}},async perform({input:e}){return e===`one-shot`?{mode:e,modelId:n.presetModel??DEFAULT_AGENT_MODEL_ID}:{mode:e}},apply(e,t){return{...e,setupMode:t.mode,modelId:t.modelId??e.modelId}}}}export{selectSetupMode};

package/dist/src/setup/channel-add-conflicts.d.ts

@@ -0,0 +1,28 @@
+import { type ChannelKind } from "#setup/scaffold/index.js";
+import type { DisabledChannelReasons } from "#setup/cli/index.js";
+/**
+ * Existing authored registrations that affect the scaffolded channel picker
+ * or would conflict with a generated channel module.
+ */
+export interface ExistingChannelRegistrations {
+    readonly disabledChannelReasons: DisabledChannelReasons;
+    readonly webRouteOwners: readonly string[];
+    readonly slackOwners: readonly string[];
+    /**
+     * Whether the Next.js Web Chat app is already in place (the project depends
+     * on `next`). Owning the session route alone (`webRouteOwners`) does not
+     * imply the app: every scaffolded agent has `agent/channels/eve.ts` for the
+     * dev REPL, while the app only arrives via `--web` or the web scaffold.
+     */
+    readonly webAppPresent: boolean;
+}
+/**
+ * Inspects compiled authored channels so custom filenames still disable the
+ * scaffold option for the channel behavior they register.
+ */
+export declare function inspectExistingChannelRegistrations(projectRoot: string): Promise<ExistingChannelRegistrations>;
+/**
+ * Rejects scaffolding when another authored module already owns behavior
+ * emitted by the generated channel module.
+ */
+export declare function assertCanAddSelectedChannels(selectedChannels: readonly ChannelKind[], registrations: ExistingChannelRegistrations): void;

package/dist/src/setup/channel-add-conflicts.js

@@ -0,0 +1 @@
+import{EVE_CREATE_SESSION_ROUTE_PATH}from"#protocol/routes.js";import{join}from"node:path";import{compileChannelDefinition}from"#compiler/normalize-channel.js";import{discoverAgent}from"#discover/discover-agent.js";import{isNextJsProject}from"#setup/scaffold/index.js";const SCAFFOLDED_WEB_CHANNEL_LOGICAL_PATH=`channels/eve.ts`;async function inspectExistingChannelRegistrations(a){let o=join(a,`agent`),[{manifest:s},c]=await Promise.all([discoverAgent({agentRoot:o,appRoot:a}),isNextJsProject(a)]),l=new Set,u=new Set;for(let t of s.channels){let r=await compileChannelDefinition(o,t),i=Array.isArray(r)?r:[r];for(let n of i)n.kind===`channel`&&(n.method===`POST`&&n.urlPath===EVE_CREATE_SESSION_ROUTE_PATH&&l.add(t.logicalPath),n.adapterKind===`slack`&&u.add(t.logicalPath))}let d={};return[...l].some(e=>e!==SCAFFOLDED_WEB_CHANNEL_LOGICAL_PATH)&&(d.web=`POST ${EVE_CREATE_SESSION_ROUTE_PATH} already registered`),u.size>0&&(d.slack=`Slack channel already registered`),{disabledChannelReasons:d,webRouteOwners:[...l],slackOwners:[...u],webAppPresent:c}}function assertCanAddSelectedChannels(t,n){if(t.includes(`web`)){let t=n.webRouteOwners.find(e=>e!==SCAFFOLDED_WEB_CHANNEL_LOGICAL_PATH);if(t!==void 0)throw Error(`Cannot scaffold Web Chat because agent/${t} already defines POST ${EVE_CREATE_SESSION_ROUTE_PATH}. Web Chat scaffolds the same Eve session routes.`)}if(t.includes(`slack`)){let e=n.slackOwners.find(e=>e!==`channels/slack.ts`);if(e!==void 0)throw Error(`Cannot scaffold Slack because agent/${e} already defines a Slack channel. Slack scaffolding would register the channel again.`)}}export{assertCanAddSelectedChannels,inspectExistingChannelRegistrations};

package/dist/src/setup/cli/channel-setup-prompter.d.ts

@@ -0,0 +1,23 @@
+import type { ChannelKind } from "../scaffold/update/channels.js";
+/** Reasons that make scaffoldable channel kinds unavailable in a picker. */
+export type DisabledChannelReasons = Readonly<Partial<Record<ChannelKind, string>>>;
+/** Status and subprocess output operations used by shared setup flows. */
+export interface ChannelSetupLog {
+    message(text: string): void;
+    info(text: string): void;
+    success(text: string): void;
+    warning(text: string): void;
+    error(text: string): void;
+    /** Updates the transient detail beneath the current status while a child command runs. */
+    commandOutput(text: string): void;
+    /**
+     * Starts an ephemeral progress indicator for an async wait, returning a
+     * handle whose `stop()` clears it without leaving a transcript line.
+     * Mirrors `Prompter["log"]["spinner"]`; optional so plain and headless logs
+     * (which have no live status surface) can omit it and callers fall back to
+     * a persisted message.
+     */
+    spinner?(message: string): {
+        stop(): void;
+    };
+}

package/dist/src/setup/cli/channel-setup-prompter.js

@@ -0,0 +1 @@
+export{};

package/dist/src/setup/cli/connection-add-prompter.d.ts

@@ -0,0 +1,8 @@
+/** A selectable connection shown in the onboarding picker. */
+export interface ConnectionSelectOption {
+    value: string;
+    label: string;
+    hint?: string;
+    disabled?: boolean;
+    disabledReason?: string;
+}

package/dist/src/setup/cli/connection-add-prompter.js

@@ -0,0 +1 @@
+export{};

package/dist/src/setup/{scaffold/cli → cli}/index.d.ts

@@ -1,7 +1,8 @@
-export { ChannelAddCancelledError, createChannelAddPrompter, type ChannelAddPrompter, } from "./channel-add-prompter.js";
-export { ConnectionAddCancelledError, createConnectionAddPrompter, type ConnectionAddPrompter, type ConnectionSelectOption, type ConnectionSetupSelectOption, type ConnectionTextPrompt, } from "./connection-add-prompter.js";
-export { type ChannelPrompt, type ChannelSelectOption, type ChannelSetupLog, type ChannelSetupPrompter, type ChannelSetupPromptValue, type ChannelSetupSelectOption, type DisabledChannelReasons, type DisabledChannelSelectOption, type EnabledChannelSelectOption, } from "./channel-setup-prompter.js";
+export { type ConnectionSelectOption } from "./connection-add-prompter.js";
+export { type ChannelSetupLog, type DisabledChannelReasons } from "./channel-setup-prompter.js";
 export { createPromptCommandOutput, type PromptCommandLog } from "./command-output.js";
 export { runSelectComponent, SelectComponent, type SelectGuard } from "./select-component.js";
+export { createSelectOptionCodec, type SelectOptionCodec } from "./select-option-codec.js";
 export { CORNER, RAIL, bulletFor, cornerFor, formatPromptCancellation, formatPromptHeader, formatPromptOpener, formatPromptOutro, formatPromptSubmission, formatRailLine, railFor, renderMultiselectPrompt, renderOptionRow, renderSearchableSelect, renderSelectPrompt, type PromptColors, type PromptOption, type PromptState, type PromptValue, } from "./prompt-ui.js";
 export { createRailLog, type RailLog, type RailLogOptions, type RailSpinner } from "./rail-log.js";
+export { whimsyFor, WHIMSY_POOLS, type WhimsyTask } from "./whimsy.js";

package/dist/src/setup/cli/index.js

@@ -0,0 +1 @@
+import{createPromptCommandOutput}from"./command-output.js";import{CORNER,RAIL,bulletFor,cornerFor,formatPromptCancellation,formatPromptHeader,formatPromptOpener,formatPromptOutro,formatPromptSubmission,formatRailLine,railFor,renderMultiselectPrompt,renderOptionRow,renderSearchableSelect,renderSelectPrompt}from"./prompt-ui.js";import{createSelectOptionCodec}from"./select-option-codec.js";import{SelectComponent,runSelectComponent}from"./select-component.js";import{createRailLog}from"./rail-log.js";import{WHIMSY_POOLS,whimsyFor}from"./whimsy.js";export{CORNER,RAIL,SelectComponent,WHIMSY_POOLS,bulletFor,cornerFor,createPromptCommandOutput,createRailLog,createSelectOptionCodec,formatPromptCancellation,formatPromptHeader,formatPromptOpener,formatPromptOutro,formatPromptSubmission,formatRailLine,railFor,renderMultiselectPrompt,renderOptionRow,renderSearchableSelect,renderSelectPrompt,runSelectComponent,whimsyFor};

package/dist/src/setup/{scaffold/cli → cli}/prompt-ui.d.ts

@@ -38,6 +38,13 @@ export interface PromptOption<T extends PromptValue> {
     locked?: boolean;
     /** Parenthetical shown after a locked row's label, e.g. "always available". */
     lockedReason?: string;
+    /**
+     * A leading run of featured options forms a searchable picker's default
+     * viewport: with no filter typed, only they are in view, and scrolling or
+     * filtering reaches the rest of the list. Featured options must be sorted
+     * to the front. Meaningless without `search`.
+     */
+    featured?: boolean;
 }
 /** Vertical rail glyph used by the onboarding-style terminal UI. */
 export declare const RAIL = "\u2502";
@@ -86,6 +93,8 @@ export declare function renderMultiselectPrompt<T extends PromptValue>(input: {
     options: readonly PromptOption<T>[];
     selectedValues: readonly T[];
     state: PromptState;
+    /** Submit-row label, e.g. "Skip" while an optional checklist is empty. */
+    submitLabel?: string;
 }): string;
 /** Renders the shared single-select interaction used by channel setup. */
 export declare function renderSelectPrompt<T extends PromptValue>(input: {
@@ -99,19 +108,20 @@ export declare function renderSelectPrompt<T extends PromptValue>(input: {
     state: PromptState;
 }): string;
 /**
- * Renders one option row as a single glyph column followed by the label. The
- * glyph is a check (`✓`) on a chosen row, a cursor arrow (`›`) on a multi-select
- * cursor row that is not yet chosen, otherwise blank. A chosen row keeps its
- * check even under the cursor (the bright label marks the cursor), so the check
- * always wins over the arrow. Single-select never sets `withCursorArrow` and so
- * shows checks only. One glyph column keeps every picker's labels flush.
+ * Renders one option row. A single-select row (`checkbox: false`) is a cursor
+ * arrow column followed by the label: a subtle `›` marks the highlighted row
+ * and every other row leads with a blank. A multi-select row
+ * (`checkbox: true`) adds a checkbox column after the arrow: `◼` (green) when
+ * chosen, `◻` (dim) when not, so the marked state and the cursor read
+ * independently — `› ◻ label` is the cursor on an unchosen row.
  *
- * A disabled row drops its glyph and strikes through its dimmed label so the
+ * A disabled row drops its glyphs and strikes through its dimmed label so the
  * unavailability reads at a glance, then trails `disabledReason` in parentheses.
  * A locked row is the inverse: mandatory rather than unavailable, so it keeps a
- * dimmed check and a dimmed, un-struck label, then trails `lockedReason`. Both
- * reasons stay visible at all times, unlike `hint`, which only shows under the
- * cursor, because the cursor skips disabled and locked rows alike.
+ * dimmed checked box (or check, in a single-select) and a dimmed, un-struck
+ * label, then trails `lockedReason`. Both reasons stay visible at all times,
+ * unlike `hint`, which only shows under the cursor, because the cursor skips
+ * disabled and locked rows alike.
  */
 export declare function renderOptionRow(input: {
     colors: PromptColors;
@@ -119,19 +129,31 @@ export declare function renderOptionRow(input: {
     hint?: string;
     isCursor: boolean;
     isChecked: boolean;
-    withCursorArrow: boolean;
+    /** Multi-select style: arrow column plus checkbox column. */
+    checkbox: boolean;
     disabled?: boolean;
     disabledReason?: string;
     locked?: boolean;
     lockedReason?: string;
 }): string;
+/**
+ * Renders the virtual Submit row that closes every multi-select list. It has
+ * no checkbox — its bold label sits in the checkbox column, trails a green
+ * check, and brightens under the cursor; enter confirms the checklist only
+ * from here. The label reads "Skip" while an optional checklist has nothing
+ * picked (the caller computes that), so an empty confirm is honest about what
+ * it does. Callers put a blank rail line above it to set it apart from the
+ * options.
+ */
+export declare function renderSubmitRow(isCursor: boolean, colors: PromptColors, label?: string): string;
 /**
  * Renders the type-ahead select interaction: a filter line, a scrolling window
  * of options, and a mode-aware help line. Single-select marks the highlighted
- * row with a check and submits it on enter; multi-select adds the cursor arrow
- * and toggles rows with space. `options` is the already-filtered visible list
- * (with `cursor` indexing it); `submitDisplay` is the precomputed answer shown
- * once a choice is made.
+ * row with the cursor arrow and submits it on enter; multi-select adds the
+ * checkbox column, toggles rows with space or enter, and confirms from the
+ * pinned Submit row (cursor index `options.length`). `options` is the
+ * already-filtered visible list (with `cursor` indexing it); `submitDisplay`
+ * is the precomputed answer shown once a choice is made.
  */
 export declare function renderSearchableSelect<T extends PromptValue>(input: {
     colors: PromptColors;
@@ -148,4 +170,6 @@ export declare function renderSearchableSelect<T extends PromptValue>(input: {
     footerNote?: string;
     error?: string;
     viewSize?: number;
+    /** Submit-row label, e.g. "Skip" while an optional checklist is empty. */
+    submitLabel?: string;
 }): string;