eve 0.28.0 → 0.29.0

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

@@ -1,49 +0,0 @@
-import { type ChannelKind } from "#setup/scaffold/index.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 {
-    /** 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 and whether the REPL row is shown. The
-     * "channels-add" picker allows an empty submission and keeps Slack selectable
-     * because capability planning later chooses Connect or environment credentials.
-     */
-    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`. 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 legacy in-project variant gates Slack on the detected on-disk link.
- *
- * 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 +0,0 @@
-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,38 +0,0 @@
-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. */
-export interface ChatPreferenceContext {
-    /** Channels scaffolded earlier in the flow; controls option visibility. */
-    availableChannels: ChannelKind[];
-    /** Whether the Slack app was attached to the channel route and is ready to use. */
-    slackbotAttached: boolean;
-}
-/**
- * Builds the chat-preference option list. Channel-backed options come
- * first (in the order Web -> Slack) when available, then the framework
- * 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 {
-    /** Resolves the chat question; the composed stack decides how. */
-    asker: Asker;
-    /**
-     * 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 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 +0,0 @@
-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

@@ -1,30 +0,0 @@
-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

@@ -1 +0,0 @@
-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/mcp`,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-setup-mode.d.ts

@@ -1,32 +0,0 @@
-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

@@ -1 +0,0 @@
-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-setup-deployment.d.ts

@@ -1,11 +0,0 @@
-import type { DeployProjectDeps } from "./boxes/deploy-project.js";
-import type { ChannelSetupUi } from "./channel-setup-ui.js";
-import { type SetupState } from "./state.js";
-/** Offers and, when accepted, performs deployment after channel setup completes. */
-export declare function deployChannelSetup(input: {
-    state: SetupState;
-    ui: ChannelSetupUi;
-    signal?: AbortSignal;
-    presetDeploy?: boolean;
-    deps?: DeployProjectDeps;
-}): Promise<SetupState>;

package/dist/src/setup/channel-setup-deployment.js

@@ -1 +0,0 @@
-import{snapshotSetupState}from"./state.js";import{deployProject}from"./boxes/deploy-project.js";import{runInteractive}from"./runner.js";async function deployChannelSetup(t){if(!(t.presetDeploy??await t.ui.confirm({key:`deploy-channels`,message:`Deploy this project to Vercel now?`,recommended:!0})))return t.ui.nextSteps(["Run `eve deploy` to deploy when ready."]),t.state;let n=await runInteractive([deployProject({prompter:t.ui.prompter,ensureLinkedProject:`interactive-vercel-link`,deps:t.deps})],t.state,{write:e=>t.ui.prompter.log.message(e)},{snapshot:snapshotSetupState,signal:t.signal});return n.kind===`done`?n.state:t.state}export{deployChannelSetup};

package/dist/src/setup/channel-setup-environment.js

@@ -1 +0,0 @@
-function describeChannelSetupEnvironment(e){if(e.vercel.kind===`available`)switch(e.vercel.project.kind){case`deployed`:return`Found an authenticated Vercel account and deployed project (${e.vercel.project.productionUrl}).`;case`linked`:return`Found an authenticated Vercel account and linked project.`;case`unresolved`:return`Found an authenticated Vercel account; this directory is not linked to a project.`}switch(e.vercel.reason){case`logged-out`:return`No authenticated Vercel account found; using portable channel setup.`;case`cli-missing`:return`Vercel CLI not found; using portable channel setup.`;case`unavailable`:return`Could not verify the Vercel account; using portable channel setup.`}}function channelSetupEnvironment(e,t){return e===`authenticated`?{vercel:{kind:`available`,project:t}}:{vercel:{kind:`unavailable`,reason:e}}}export{channelSetupEnvironment,describeChannelSetupEnvironment};

package/dist/src/setup/channel-setup-integration.js

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

package/dist/src/setup/channel-setup-integrations.js

@@ -1 +0,0 @@
-import{SLACK_CHANNEL_SETUP}from"./channel-setup-slack.js";import{WEB_CHANNEL_SETUP}from"./channel-setup-web.js";import{createChannelSetupUi}from"./channel-setup-ui.js";const CHANNEL_SETUP_INTEGRATIONS=[WEB_CHANNEL_SETUP,SLACK_CHANNEL_SETUP];function channelSetupIntegration(e){let t=CHANNEL_SETUP_INTEGRATIONS.find(t=>t.kind===e);if(t===void 0)throw Error(`No channel setup integration for "${e}".`);return t}export{CHANNEL_SETUP_INTEGRATIONS,channelSetupIntegration,createChannelSetupUi};

package/dist/src/setup/channel-setup-runner.js

@@ -1 +0,0 @@
-import{snapshotSetupState}from"./state.js";import{addChannels}from"./boxes/add-channels.js";import{runInteractive}from"./runner.js";async function runChannelSetup(t,n){let r=await runInteractive([addChannels({asker:t.ui.asker,prompter:t.ui.prompter,headless:t.headless,presetCreateSlackbot:t.presetCreateSlackbot,force:t.force,configureVercelServices:n.configureVercelServices,slackCredentials:n.slackCredentials,ensureLinkedProject:n.ensureLinkedProject,skipDependencyMutation:t.skipDependencyMutation,deps:t.deps})],t.state,{write:e=>t.ui.prompter.log.message(e)},{snapshot:snapshotSetupState,signal:t.signal});return r.kind===`done`?{kind:`done`,state:r.state}:{kind:`cancelled`}}export{runChannelSetup};

package/dist/src/setup/channel-setup-slack.js

@@ -1 +0,0 @@
-import{WizardCancelledError}from"./step.js";import{runChannelSetup}from"./channel-setup-runner.js";async function choosePortableCredentials(t){if(t.environment.vercel.kind===`available`)return`vercel-connect`;if(t.presetPortableCredentials!==void 0)return t.presetPortableCredentials?`environment`:`vercel-connect`;try{return await t.ui.prompter.select({message:`How would you like to configure Slack?`,options:[{value:`vercel`,label:`Set up Vercel Connect`,hint:`Sign in and link this project`},{value:`portable`,label:`Use portable credentials`,hint:`Read Slack tokens from environment variables`}]})===`portable`?`environment`:`vercel-connect`}catch(t){if(t instanceof WizardCancelledError)return`cancelled`;throw t}}const SLACK_CHANNEL_SETUP={kind:`slack`,label:`Slack`,hint:`Slack app mentions and DMs`,async setup(e){let n=await choosePortableCredentials(e);if(n===`cancelled`)return{kind:`cancelled`};let r=await runChannelSetup(e,n===`environment`?{slackCredentials:`environment`}:{slackCredentials:`vercel-connect`,ensureLinkedProject:`interactive-vercel-link`});return r.kind===`done`&&n===`environment`&&r.state.channels.includes(`slack`)&&e.ui.nextSteps([`Set SLACK_BOT_TOKEN and SLACK_SIGNING_SECRET in .env.local (listed in .env.example).`,`Configure your Slack app to send events to /eve/v1/slack on your public agent URL.`]),r}};export{SLACK_CHANNEL_SETUP};

package/dist/src/setup/channel-setup-ui.js

@@ -1,2 +0,0 @@
-import{SkippedSignal,confirm}from"./ask.js";function createChannelSetupUi(n){return{...n,async confirm(r){try{return await n.asker.ask(confirm(r))}catch(t){if(t instanceof SkippedSignal)return!1;throw t}},nextSteps(e){e.length!==0&&n.prompter.note(e.join(`
-`),`Next steps`,{tone:`success`})}}}export{createChannelSetupUi};

package/dist/src/setup/channel-setup-web.js

@@ -1 +0,0 @@
-import{runChannelSetup}from"./channel-setup-runner.js";const WEB_CHANNEL_SETUP={kind:`web`,label:`Web Chat`,hint:`Browser-based chat interface`,setup(e){return runChannelSetup(e,{configureVercelServices:e.environment.vercel.kind===`available`})}};export{WEB_CHANNEL_SETUP};

package/dist/src/setup/flows/channels.d.ts

@@ -1,57 +0,0 @@
-import type { AddCommandOptions } from "#cli/commands/registry.js";
-import type { AddChannelsDeps } from "../boxes/add-channels.js";
-import { inspectExistingChannelRegistrations } from "../channel-add-conflicts.js";
-import { detectDeployment } from "../project-resolution.js";
-import type { Prompter } from "../prompter.js";
-import { getVercelAuthStatus } from "../vercel-project.js";
-/** Injected for tests; defaults to the real detection and box effects. */
-export interface ChannelsFlowDeps {
-    detectDeployment: typeof detectDeployment;
-    inspectExistingChannelRegistrations: typeof inspectExistingChannelRegistrations;
-    getVercelAuthStatus: typeof getVercelAuthStatus;
-    addChannels?: AddChannelsDeps;
-    installRegistryItem(appRoot: string, item: string, options?: AddCommandOptions): Promise<void>;
-}
-export type ChannelsFlowResult = {
-    kind: "done";
-    addedChannels: readonly string[];
-} | {
-    /**
-     * The user chose "Deploy and chat" on the post-Slack "See it live"
-     * prompt. The caller deploys, then points them at this workspace.
-     */
-    kind: "deploy-and-chat";
-    addedChannels: readonly string[];
-    chat: {
-        chatUrl?: string;
-        workspaceName?: string;
-    };
-} | {
-    kind: "cancelled";
-} | {
-    kind: "failed";
-    addedChannels: readonly string[];
-    message: string;
-};
-/** Title for Slack's optional deploy-and-chat continuation. */
-export declare const SEE_IT_LIVE_MESSAGE = "See it live";
-/**
- * THE CHANNELS FLOW for the dev TUI's `/channels`: a task list that loops.
- * Pick an unregistered channel, run its add sub-flow (Slack provisioning
- * included), and land back on the repainted list with that channel checked;
- * "Done" or Esc leaves. Filesystem effects can land before the runner applies
- * their in-memory payload, so every cancelled or failed sub-flow re-inspects
- * authored registrations and preserves a channel that became durable. Esc on
- * the list after something was added reports the additions exactly like Done;
- * only an empty exit folds to cancelled.
- *
- * The outer loop owns only picker lifecycle, conflict validation, and durable
- * re-inspection. Each selected integration owns its prompts, provisioning,
- * scaffold choices, deployment continuation, and next-step guidance.
- */
-export declare function runChannelsFlow(input: {
-    appRoot: string;
-    prompter: Prompter;
-    signal?: AbortSignal;
-    deps?: Partial<ChannelsFlowDeps>;
-}): Promise<ChannelsFlowResult>;

package/dist/src/setup/flows/channels.js

@@ -1 +0,0 @@
-import{interactiveAsker}from"../ask.js";import{detectDeployment,projectResolutionFromDeployment}from"../project-resolution.js";import{createDefaultSetupState}from"../state.js";import{WizardCancelledError}from"../step.js";import{withSpinner}from"../with-spinner.js";import{getVercelAuthStatus}from"../vercel-project.js";import{CHANNELS_PROMPT_MESSAGE}from"../boxes/select-channels.js";import{assertCanAddSelectedChannels,inspectExistingChannelRegistrations}from"../channel-add-conflicts.js";import{channelSetupEnvironment}from"../channel-setup-environment.js";import{createChannelSetupUi}from"../channel-setup-ui.js";import{CHANNEL_SETUP_INTEGRATIONS,channelSetupIntegration}from"../channel-setup-integrations.js";import{toErrorMessage}from"#shared/errors.js";const SEE_IT_LIVE_MESSAGE=`See it live`;async function offerDeployAndChat(e){try{return await e.select({message:SEE_IT_LIVE_MESSAGE,options:[{value:`deploy`,label:`Deploy and chat`},{value:`later`,label:`Later`}]})===`deploy`}catch(e){if(e instanceof WizardCancelledError)return!1;throw e}}function channelAlreadyAdded(e,t){return t===`web`?e.webAppPresent:e.slackOwners.length>0}function appendChannel(e,t){return e.includes(t)?[...e]:[...e,t]}async function pickChannel(e,t){let n=channelListRows(t),r=!n.some(e=>e.value!==`done`&&e.completed!==!0&&e.disabled!==!0),a={message:CHANNELS_PROMPT_MESSAGE,options:n,hintLayout:`inline`};r&&(a.initialValue=`done`);try{return{kind:`picked`,value:await e.select(a)}}catch(e){if(e instanceof WizardCancelledError)return{kind:`cancelled`};throw e}}function channelLandedDuringSubflow(e,t,n){return!channelAlreadyAdded(e,n)&&channelAlreadyAdded(t,n)}function deployAndChatDetails(e){let t={};return e.slackChatUrl!==void 0&&(t.chatUrl=e.slackChatUrl),e.slackWorkspaceName!==void 0&&(t.workspaceName=e.slackWorkspaceName),t}function channelListRows(e){let t=[{value:`repl`,label:`Terminal UI`,completed:!0,focusHint:`Already installed`}];for(let n of CHANNEL_SETUP_INTEGRATIONS){if(channelAlreadyAdded(e,n.kind)){t.push({value:n.kind,label:n.label,completed:!0,focusHint:`Already installed`});continue}let r=e.disabledChannelReasons[n.kind];if(r!==void 0){t.push({value:n.kind,label:n.label,disabled:!0,disabledReason:r});continue}let i={value:n.kind,label:n.label};n.hint!==void 0&&(i.hint=n.hint),t.push(i)}return t.push({value:`done`,label:`Done`,trailingAction:!0}),t}async function runChannelsFlow(s){let{appRoot:c,prompter:l,signal:u}=s,d={detectDeployment,inspectExistingChannelRegistrations,getVercelAuthStatus,installRegistryItem:async(e,t,n)=>{let{installOfficialRegistryItem:r}=await import(`#cli/commands/registry.js`);await r(e,t,n)},...s.deps},[f,p,m]=await withSpinner(l,`Checking the project…`,()=>Promise.all([d.detectDeployment(c,{signal:u}),d.inspectExistingChannelRegistrations(c),d.getVercelAuthStatus(c,{signal:u})]));u?.throwIfAborted();let h=p,g=channelSetupEnvironment(m,projectResolutionFromDeployment(f)),_={...createDefaultSetupState(),project:projectResolutionFromDeployment(f),projectPath:{kind:`resolved`,inPlace:!0,path:c}},v;for(;;){let t=await pickChannel(l,h);if(t.kind===`cancelled`){if(_.channels.length===0)return{kind:`cancelled`};break}let n=t.value;if(n===`done`)break;if(n===`repl`||channelAlreadyAdded(h,n))continue;assertCanAddSelectedChannels([n],h),await d.installRegistryItem(c,`channel/${n}`);let r;try{r=await channelSetupIntegration(n).setup({environment:g,state:{..._,channelSelection:[n]},ui:createChannelSetupUi({asker:interactiveAsker(l),prompter:l}),signal:u,skipDependencyMutation:!0,deps:d.addChannels})}catch(e){let t=u?.aborted===!0?await d.inspectExistingChannelRegistrations(c):await withSpinner(l,`Checking the project…`,()=>d.inspectExistingChannelRegistrations(c));if(channelLandedDuringSubflow(h,t,n)){if(_={..._,channels:appendChannel(_.channels,n)},h=t,e instanceof WizardCancelledError||(v=toErrorMessage(e)),u?.aborted===!0)break;continue}if(e instanceof WizardCancelledError){h=t;continue}throw e}r.kind===`done`&&(_=r.state);let o=u?.aborted===!0?await d.inspectExistingChannelRegistrations(c):await withSpinner(l,`Checking the project…`,()=>d.inspectExistingChannelRegistrations(c));if(channelLandedDuringSubflow(h,o,n)&&(_={..._,channels:appendChannel(_.channels,n)}),h=o,u?.aborted===!0)break;if(r.kind!==`cancelled`&&n===`slack`&&_.slackbotAttached&&await offerDeployAndChat(l))return{kind:`deploy-and-chat`,addedChannels:_.channels,chat:deployAndChatDetails(_)}}return v===void 0?{kind:`done`,addedChannels:_.channels}:{kind:`failed`,addedChannels:_.channels,message:v}}export{SEE_IT_LIVE_MESSAGE,runChannelsFlow};

package/dist/src/setup/flows/connections.d.ts

@@ -1,37 +0,0 @@
-import { ensureConnectionDependencies, listAuthoredConnections } from "#setup/scaffold/index.js";
-import { detectPackageManager } from "#setup/package-manager.js";
-import { runPackageManagerInstall } from "#setup/primitives/pm/run.js";
-import { type AddConnectionsDeps } from "../boxes/add-connections.js";
-import { detectDeployment } from "../project-resolution.js";
-import type { Prompter } from "../prompter.js";
-import { getVercelAuthStatus } from "../vercel-project.js";
-import { runLinkFlow } from "./link.js";
-export declare const CONNECTIONS_PROMPT_MESSAGE = "Select an MCP server to add to your agent through Vercel Connect";
-export interface ConnectionsFlowDeps {
-    detectDeployment: typeof detectDeployment;
-    detectPackageManager: typeof detectPackageManager;
-    getVercelAuthStatus: typeof getVercelAuthStatus;
-    runLinkFlow: typeof runLinkFlow;
-    ensureConnectionDependencies: typeof ensureConnectionDependencies;
-    listAuthoredConnections: typeof listAuthoredConnections;
-    runPackageManagerInstall: typeof runPackageManagerInstall;
-    addConnections?: AddConnectionsDeps;
-}
-export type ConnectionsFlowResult = {
-    kind: "done";
-    addedConnections: readonly string[];
-} | {
-    kind: "cancelled";
-} | {
-    kind: "failed";
-    addedConnections: readonly string[];
-    message: string;
-};
-/** Runs `/connect`, linking a project on first selection when needed. */
-export declare function runConnectionsFlow(input: {
-    appRoot: string;
-    prompter: Prompter;
-    signal?: AbortSignal;
-    disabledConnectionReasons?: Readonly<Record<string, string>>;
-    deps?: Partial<ConnectionsFlowDeps>;
-}): Promise<ConnectionsFlowResult>;

package/dist/src/setup/flows/connections.js

@@ -1,3 +0,0 @@
-import{interactiveAsker}from"../ask.js";import{detectDeployment,isProjectResolved,projectResolutionFromDeployment}from"../project-resolution.js";import{snapshotSetupState}from"../state.js";import{WizardCancelledError}from"../step.js";import{withSpinner}from"../with-spinner.js";import{getVercelAuthStatus,vercelAuthBlockerReason}from"../vercel-project.js";import{selectConnections}from"../boxes/select-connections.js";import{addConnections}from"../boxes/add-connections.js";import{runInteractive}from"../runner.js";import{inProjectSetupState,prompterSink}from"./in-project.js";import{runLinkFlow}from"./link.js";import{CONNECTION_CATALOG,ensureConnectionDependencies,listAuthoredConnections}from"#setup/scaffold/index.js";import{detectPackageManager}from"#setup/package-manager.js";import{toErrorMessage}from"#shared/errors.js";import{createPromptCommandOutput,withPhase}from"#setup/cli/index.js";import{runPackageManagerInstall}from"#setup/primitives/pm/run.js";const CONNECTIONS_PROMPT_MESSAGE=`Select an MCP server to add to your agent through Vercel Connect`,CONNECT_CONNECTIONS=CONNECTION_CATALOG.filter(e=>e.auth.kind===`connect`);function connectionRows(e,t,n){let r=vercelAuthBlockerReason(t),i=CONNECT_CONNECTIONS.map(t=>{let i={value:t.slug,label:t.label};if(e.has(t.slug))return{...i,completed:!0,focusHint:`Already added`};let a=n[t.slug];return a===void 0?r===void 0?{...i,hint:t.hint}:{...i,disabled:!0,disabledReason:r,disabledReasonTone:`warning`}:{...i,disabled:!0,disabledReason:a,disabledReasonTone:`warning`}});return i.push({value:`done`,label:`Done`,trailingAction:!0}),i}async function pickConnection(e,t,n,r){let i=connectionRows(t,n,r),o={message:CONNECTIONS_PROMPT_MESSAGE,options:i,hintLayout:`inline`,search:!0,placeholder:`type to search MCP servers`};i.some(e=>e.value!==`done`&&e.disabled!==!0&&e.completed!==!0)||(o.initialValue=`done`);try{return await e.select(o)}catch(e){if(e instanceof WizardCancelledError)return;throw e}}async function runConnectionsFlow(s){let{appRoot:c,prompter:l,signal:u}=s,d={detectDeployment,detectPackageManager,ensureConnectionDependencies,getVercelAuthStatus,listAuthoredConnections,runLinkFlow,runPackageManagerInstall,...s.deps},[f,p,m]=await withSpinner(l,`Checking the project…`,()=>Promise.all([d.detectDeployment(c,{signal:u}),d.listAuthoredConnections(c),d.getVercelAuthStatus(c,{signal:u})]));u?.throwIfAborted();let h=inProjectSetupState(c,projectResolutionFromDeployment(f)),g=new Set(p),_=await pickConnection(l,g,m,s.disabledConnectionReasons??{});if(_===void 0)return{kind:`cancelled`};if(_===`done`||g.has(_))return{kind:`done`,addedConnections:[]};try{if(!isProjectResolved(h.project)){if((await d.runLinkFlow({appRoot:c,prompter:l,signal:u,projectSelection:`create-or-link`,teamSelectMessage:()=>`You need to link to a project to use Vercel Connect.
-
-Select your team`})).kind===`cancelled`)return{kind:`cancelled`};let e=projectResolutionFromDeployment(await withSpinner(l,`Checking the project…`,()=>d.detectDeployment(c,{signal:u})));if(!isProjectResolved(e))throw Error(`Project link was not found after linking.`);h={...h,project:e}}let t=await d.detectPackageManager(c);if(await d.ensureConnectionDependencies({projectRoot:c}),!await withPhase(l.log,`Installing connection dependencies (${t.kind} install)...`,()=>d.runPackageManagerInstall(t.kind,c,{onOutput:createPromptCommandOutput(l.log),signal:u})))throw Error(`Dependency installation failed. Run \`${t.kind} install\`.`);if((await runInteractive([selectConnections({asker:interactiveAsker(l),presetConnections:[_]}),addConnections({prompter:l,signal:u,deps:d.addConnections})],h,prompterSink(l),{snapshot:snapshotSetupState,signal:u})).kind!==`done`)return{kind:`cancelled`};if(!new Set(await d.listAuthoredConnections(c)).has(_))throw Error(`Connection "${_}" was not added.`);return{kind:`done`,addedConnections:[_]}}catch(e){return e instanceof WizardCancelledError?{kind:`cancelled`}:{kind:`failed`,addedConnections:new Set(await d.listAuthoredConnections(c)).has(_)?[_]:[],message:toErrorMessage(e)}}}export{CONNECTIONS_PROMPT_MESSAGE,runConnectionsFlow};

package/dist/src/setup/onboarding.d.ts

@@ -1,60 +0,0 @@
-import type { Prompter } from "./prompter.js";
-import type { AnySetupBox } from "./runner.js";
-import type { EvePackageContract } from "./scaffold/index.js";
-import type { ArgsHeadlessAiGateway, ArgsHeadlessProject, ChannelKind, ChatPreference, SetupMode, SetupState } from "./state.js";
-/**
- * Options for {@link composeOnboardingBoxes}. These carry exactly what the
- * create flow's options carried: the preset answers that let each box resolve
- * without prompting, plus the directory and headless dispatch decisions.
- */
-export interface OnboardingBoxesOptions {
-    prompter: Prompter;
-    /** Skip the name prompt and use this value. */
-    presetName?: string;
-    /** Skip the setup-mode prompt and use this value. */
-    presetMode?: SetupMode;
-    /** Skip the model prompt and use this value. */
-    presetModel?: string;
-    /** Skip the channels prompt and use these kinds. */
-    presetChannels?: ChannelKind[];
-    /** Skip the connections picker and scaffold these catalog slugs. */
-    presetConnections?: string[];
-    /** Skip the "Create slackbot?" prompt inside the add-to-agent step. */
-    presetCreateSlackbot?: boolean;
-    /** Headless-only Vercel provisioning flags. Ignored on the interactive path. */
-    provisioning?: {
-        project: ArgsHeadlessProject;
-        aiGateway: ArgsHeadlessAiGateway;
-    };
-    /** Skip the chat-preference prompt and use this value. */
-    presetChatPreference?: ChatPreference;
-    /** Parent directory the project folder is created inside. Defaults to cwd. */
-    targetDirectory?: string;
-    /** Scaffold into cwd or targetDirectory instead of creating a child directory. */
-    inPlace?: boolean;
-    /** Allow the in-place scaffold to replace eve scaffold files that already exist. */
-    overwriteExisting?: boolean;
-    /** Skip the post-channel Vercel deployment entirely. */
-    presetNoDeploy?: boolean;
-    /**
-     * Headless mode: never prompt or spawn an interactive Vercel command. Boxes
-     * needing a human/browser action throw `HumanActionRequiredError`. Slack
-     * setup remains an interactive/onboarding handoff, not a headless flow.
-     */
-    headless?: boolean;
-    /** eve package metadata baked into the scaffolded `package.json`. */
-    evePackage?: EvePackageContract;
-}
-/**
- * Composes the full programmatic onboarding flow.
- *
- * 1. The interview phase: name, then the agent itself (model, channels,
- *    connections), then where it runs (the provisioning plans).
- * 2. Input preflight before filesystem writes.
- * 3. The scaffold box writes or reuses the agent template.
- * 4. Project and gateway facts are detected and executed from the plans.
- * 5. Channel setup writes Web/Slack surfaces and returns setup facts.
- * 6. Deploy runs once when Slack was added (the connector needs a public URL).
- * 7. Chat preference is picked from the final channel state.
- */
-export declare function composeOnboardingBoxes(options: OnboardingBoxesOptions): AnySetupBox<SetupState>[];

package/dist/src/setup/onboarding.js

@@ -1 +0,0 @@
-import{headlessAsker,interactiveAsker}from"./ask.js";import{addChannels}from"./boxes/add-channels.js";import{selectConnections}from"./boxes/select-connections.js";import{addConnections}from"./boxes/add-connections.js";import{detectAiGateway}from"./boxes/detect-ai-gateway.js";import{applyAiGatewayCredential}from"./boxes/apply-ai-gateway-credential.js";import{deployProject}from"./boxes/deploy-project.js";import{installChannelRegistryItems}from"./boxes/install-channel-registry-items.js";import{linkVercelProject}from"./boxes/link-project.js";import{oneShotNextSteps}from"./boxes/one-shot-next-steps.js";import{preflight}from"./boxes/preflight.js";import{resolveProvisioning}from"./boxes/resolve-provisioning.js";import{resolveTarget}from"./boxes/resolve-target.js";import{scaffold}from"./boxes/scaffold.js";import{selectChannels}from"./boxes/select-channels.js";import{selectChat}from"./boxes/select-chat.js";import{selectModel}from"./boxes/select-model.js";import{selectSetupMode}from"./boxes/select-setup-mode.js";import{resolve}from"node:path";function onlyWhen(e,t){return{...t,shouldRun:n=>e(n)&&(t.shouldRun?.(n)??!0)}}function completeSetupOnly(e){return onlyWhen(e=>e.setupMode===`complete`,e)}function composeOnboardingBoxes(r){let i=r.headless?{headless:!0,project:r.provisioning?.project??{},aiGateway:r.provisioning?.aiGateway??{}}:{headless:!1},a=r.headless?headlessAsker():interactiveAsker(r.prompter);return[resolveTarget({asker:a,notify:e=>r.prompter.note(e),presetName:r.presetName,targetDirectory:r.targetDirectory,inPlace:r.inPlace,resumeExisting:r.headless}),selectSetupMode({asker:a,presetMode:r.presetMode,presetModel:r.presetModel}),...[selectModel({asker:a,presetModel:r.presetModel}),selectChannels({asker:a,presetChannels:r.presetChannels,variant:`onboarding`}),selectConnections({asker:a,presetConnections:r.presetConnections,headless:r.headless}),resolveProvisioning({asker:a,prompter:r.prompter,targetDirectory:r.targetDirectory,mode:i})].map(completeSetupOnly),preflight({cwd:resolve(r.targetDirectory??process.cwd()),headless:r.headless}),scaffold({prompter:r.prompter,evePackage:r.evePackage,targetDirectory:r.targetDirectory,overwriteExisting:r.overwriteExisting,headless:r.headless}),...[detectAiGateway(),linkVercelProject({prompter:r.prompter,headless:r.headless}),applyAiGatewayCredential({prompter:r.prompter}),installChannelRegistryItems(),addChannels({asker:a,prompter:r.prompter,evePackage:r.evePackage,presetCreateSlackbot:r.presetCreateSlackbot,headless:r.headless,slackbotFailure:`warn-and-continue`,skipDependencyMutation:!0}),addConnections({prompter:r.prompter})].map(completeSetupOnly),completeSetupOnly(onlyWhen(e=>e.slackScaffolded,deployProject({prompter:r.prompter,skip:r.presetNoDeploy,headless:r.headless}))),completeSetupOnly(selectChat({asker:a,presetPreference:r.presetChatPreference})),oneShotNextSteps({prompter:r.prompter})]}export{composeOnboardingBoxes};