eve 0.6.0-beta.9 → 0.7.0

package/dist/src/setup/primitives/pm/npm.d.ts

@@ -0,0 +1,10 @@
+import { applyNoProjectConfiguration } from "./shared.js";
+export declare const npmPackageManager: {
+    kind: "npm";
+    scaffoldFiles: {};
+    applyProjectConfiguration: typeof applyNoProjectConfiguration;
+    devArguments: () => string[];
+    installArguments: (options: import("./types.js").PackageManagerInstallOptions) => string[];
+    prepareArguments: (_projectRoot: string, args: readonly string[]) => readonly string[];
+    resolveInvocation: (args: readonly string[]) => import("./types.js").PackageManagerInvocation;
+};

package/dist/src/setup/primitives/pm/npm.js

@@ -0,0 +1 @@
+import{applyNoProjectConfiguration,resolveStandardInvocation}from"./shared.js";const npmPackageManager={kind:`npm`,scaffoldFiles:{},applyProjectConfiguration:applyNoProjectConfiguration,devArguments:()=>[`exec`,`--`,`eve`,`dev`],installArguments:e=>[`install`,...e.bypassMinimumReleaseAge===!0?[`--min-release-age=0`]:[]],prepareArguments:(e,t)=>t,resolveInvocation:e=>resolveStandardInvocation(`npm`,e)};export{npmPackageManager};

package/dist/src/setup/primitives/pm/pnpm.d.ts

@@ -0,0 +1,27 @@
+export declare const PNPM_WORKSPACE_PATH = "pnpm-workspace.yaml";
+export declare const PNPM_WORKSPACE_CONTENT: string;
+export declare const pnpmPackageManager: {
+    kind: "pnpm";
+    scaffoldFiles: {
+        "pnpm-workspace.yaml": string;
+    };
+    applyProjectConfiguration(projectRoot: string): Promise<{
+        filesSkipped: never[];
+        filesWritten: string[];
+    } | {
+        filesSkipped: string[];
+        filesWritten: never[];
+    }>;
+    devArguments: () => string[];
+    installArguments: (options: import("./types.js").PackageManagerInstallOptions) => string[];
+    prepareArguments: (projectRoot: string, args: readonly string[]) => string[];
+    resolveInvocation(args: readonly string[]): {
+        args: readonly string[];
+        command: string;
+        shell: boolean;
+    } | {
+        shell?: undefined;
+        args: readonly string[];
+        command: string;
+    };
+};

package/dist/src/setup/primitives/pm/pnpm.js

@@ -0,0 +1,8 @@
+import{pathExists}from"../../path-exists.js";import{extname,join}from"node:path";import{existsSync}from"node:fs";import{readFile,writeFile}from"node:fs/promises";const PNPM_WORKSPACE_PATH=`pnpm-workspace.yaml`,PNPM_WORKSPACE_CONTENT=[`minimumReleaseAgeExclude:`,`  - eve`,`allowBuilds:`,`  sharp: false`,`# Some Eve releases import oxc-parser without declaring it; remove once`,`# every supported Eve range declares it itself.`,`packageExtensions:`,`  eve:`,`    dependencies:`,`      oxc-parser: ^0.134.0`,``].join(`
+`),EVE_RELEASE_AGE_EXCLUSION=`  - eve`,SHARP_BUILD_POLICY=`  sharp: false`;function findYamlBlockEnd(e,t){let n=t+1;for(;n<e.length;){let t=e[n]??``;if(t.length>0&&!t.startsWith(` `)&&!t.startsWith(`	`))break;n+=1}return n}function withSharpBuildPolicy(e){let t=e.endsWith(`
+`)?e:`${e}\n`,n=t.split(`
+`),r=n.findIndex(e=>e===`allowBuilds:`);if(r<0)return`${t.trim().length===0?``:`${t}\n`}allowBuilds:\n${SHARP_BUILD_POLICY}\n`;let i=findYamlBlockEnd(n,r);if(n.slice(r+1,i).some(e=>/^\s+sharp:/.test(e)))return e;let a=i;for(;a>r+1&&n[a-1]===``;)--a;return n.splice(a,0,SHARP_BUILD_POLICY),n.join(`
+`)}function withExperimentalEveReleaseAgeExclusion(e){let t=e.endsWith(`
+`)?e:`${e}\n`,n=t.split(`
+`),r=n.findIndex(e=>e===`minimumReleaseAgeExclude:`);if(r<0)return`${t.trim().length===0?``:`${t}\n`}minimumReleaseAgeExclude:\n${EVE_RELEASE_AGE_EXCLUSION}\n`;let i=findYamlBlockEnd(n,r);if(n.slice(r+1,i).some(e=>e.trim()===`- eve`))return e;let a=i;for(;a>r+1&&n[a-1]===``;)--a;return n.splice(a,0,EVE_RELEASE_AGE_EXCLUSION),n.join(`
+`)}async function ensurePnpmWorkspacePolicy(t){if(!await pathExists(t))return await writeFile(t,PNPM_WORKSPACE_CONTENT,`utf8`),`written`;let n=await readFile(t,`utf8`),r=withExperimentalEveReleaseAgeExclusion(withSharpBuildPolicy(n));return r===n?`skipped`:(await writeFile(t,r,`utf8`),`written`)}const pnpmPackageManager={kind:`pnpm`,scaffoldFiles:{[PNPM_WORKSPACE_PATH]:PNPM_WORKSPACE_CONTENT},async applyProjectConfiguration(e){let t=join(e,PNPM_WORKSPACE_PATH);return await ensurePnpmWorkspacePolicy(t)===`written`?{filesSkipped:[],filesWritten:[t]}:{filesSkipped:[t],filesWritten:[]}},devArguments:()=>[`exec`,`eve`,`dev`],installArguments:e=>[`install`,`--no-frozen-lockfile`,...e.bypassMinimumReleaseAge===!0?[`--config.minimum-release-age=0`]:[]],prepareArguments:(e,t)=>[`--dir`,e,...existsSync(join(e,`pnpm-workspace.yaml`))?[]:[`--ignore-workspace`],...t],resolveInvocation(e){let i=process.env.PNPM_HOME;if(i!==void 0){let t=join(i,process.platform===`win32`?`pnpm.CMD`:`pnpm`);if(existsSync(t))return{args:e,command:t,shell:process.platform===`win32`}}let a=process.env.npm_execpath;if(a!==void 0&&a.toLowerCase().includes(`pnpm`)){let n=extname(a).toLowerCase();return n===`.cjs`||n===`.js`?{args:[a,...e],command:process.execPath}:{args:e,command:a,shell:process.platform===`win32`}}return{args:e,command:`pnpm`}}};export{PNPM_WORKSPACE_CONTENT,PNPM_WORKSPACE_PATH,pnpmPackageManager};

package/dist/src/setup/primitives/pm/run.d.ts

@@ -0,0 +1,23 @@
+import type { PackageManagerKind } from "../../package-manager.js";
+import { type ProcessOutputHandler } from "../process-output.js";
+/** Output routing options for setup-owned package manager commands. */
+export interface RunPackageManagerOptions {
+    /** Streams command output to a parent-owned renderer instead of writing outside it. */
+    onOutput?: ProcessOutputHandler;
+}
+/** @deprecated Use {@link RunPackageManagerOptions}. */
+export type RunPnpmOptions = RunPackageManagerOptions;
+/** Runs the selected package manager in `projectRoot`. */
+export declare function spawnPackageManager(kind: PackageManagerKind, projectRoot: string, args: readonly string[], options?: RunPackageManagerOptions): Promise<boolean>;
+export interface RunInstallOptions extends RunPackageManagerOptions {
+    /** Disables the manager's minimum-release-age cooldown for this run when supported. */
+    bypassMinimumReleaseAge?: boolean;
+}
+/** Installs project dependencies using the selected package-manager strategy. */
+export declare function runPackageManagerInstall(kind: PackageManagerKind, projectRoot: string, options?: RunInstallOptions): Promise<boolean>;
+/** The argv that runs the locally installed Eve binary's `dev` command. */
+export declare function eveDevArguments(kind: PackageManagerKind): readonly string[];
+/** Compatibility wrapper for callers that still explicitly require pnpm. */
+export declare function spawnPnpm(projectRoot: string, args: readonly string[], options?: RunPackageManagerOptions): Promise<boolean>;
+/** Compatibility wrapper for callers that still explicitly require pnpm. */
+export declare function runPnpmInstall(projectRoot: string, options?: RunPackageManagerOptions): Promise<boolean>;

package/dist/src/setup/primitives/pm/run.js

@@ -0,0 +1 @@
+import{createProcessOutputBuffer}from"../process-output.js";import{getPackageManagerStrategy}from"./index.js";import{spawn}from"node:child_process";function spawnPackageManager(r,i,a,o={}){return new Promise(s=>{let c=getPackageManagerStrategy(r),l=c.prepareArguments(i,a),u=c.resolveInvocation(l),d=o.onOutput&&createProcessOutputBuffer(o.onOutput),f=spawn(u.command,[...u.args],{cwd:i,stdio:o.onOutput?[`inherit`,`pipe`,`pipe`]:`inherit`,shell:u.shell});f.stdout?.on(`data`,e=>d?.write(`stdout`,e)),f.stderr?.on(`data`,e=>d?.write(`stderr`,e));let p=!1;function settle(e){p||(p=!0,d?.flush(),s(e))}function reportFailure(e){o.onOutput?o.onOutput({stream:`stderr`,text:e}):process.stderr.write(`\n${e}\n`)}f.on(`error`,e=>{e.code===`ENOENT`?reportFailure(`${r} not found. Install it before running this step.`):reportFailure(`${r} ${a.join(` `)} failed: ${e.message}`),settle(!1)}),f.on(`close`,e=>settle(e===0))})}function runPackageManagerInstall(e,n,r={}){return spawnPackageManager(e,n,getPackageManagerStrategy(e).installArguments(r),{onOutput:r.onOutput})}function eveDevArguments(e){return getPackageManagerStrategy(e).devArguments()}function spawnPnpm(e,t,n={}){return spawnPackageManager(`pnpm`,e,t,n)}function runPnpmInstall(e,t={}){return runPackageManagerInstall(`pnpm`,e,t)}export{eveDevArguments,runPackageManagerInstall,runPnpmInstall,spawnPackageManager,spawnPnpm};

package/dist/src/setup/primitives/pm/shared.d.ts

@@ -0,0 +1,8 @@
+import type { PackageManagerInvocation } from "./types.js";
+export type StandardExecutablePackageManager = "bun" | "npm" | "yarn";
+/** Resolves a manager executable, preserving test and package-runner interposition. */
+export declare function resolveStandardInvocation(kind: StandardExecutablePackageManager, args: readonly string[]): PackageManagerInvocation;
+export declare function applyNoProjectConfiguration(): Promise<{
+    filesSkipped: [];
+    filesWritten: [];
+}>;

package/dist/src/setup/primitives/pm/shared.js

@@ -0,0 +1 @@
+import{extname}from"node:path";function resolveStandardInvocation(e,t){let n=process.env.npm_execpath,r=n?.toLowerCase(),i=r!==void 0&&(e===`npm`?r.includes(`npm`)&&!r.includes(`pnpm`):r.includes(e));if(n!==void 0&&i){let e=extname(n).toLowerCase();return e===`.cjs`||e===`.js`?{args:[n,...t],command:process.execPath}:{args:t,command:n,shell:process.platform===`win32`}}return{args:t,command:e,shell:process.platform===`win32`}}async function applyNoProjectConfiguration(){return{filesSkipped:[],filesWritten:[]}}export{applyNoProjectConfiguration,resolveStandardInvocation};

package/dist/src/setup/primitives/pm/types.d.ts

@@ -0,0 +1,37 @@
+import type { PackageManagerKind } from "../../package-manager.js";
+/** Executable and arguments used to invoke a package manager. */
+export interface PackageManagerInvocation {
+    readonly args: readonly string[];
+    readonly command: string;
+    readonly shell?: boolean;
+}
+/** Files changed while applying package-manager-owned project configuration. */
+export interface PackageManagerConfigurationResult {
+    readonly filesSkipped: readonly string[];
+    readonly filesWritten: readonly string[];
+}
+export interface PackageManagerInstallOptions {
+    readonly bypassMinimumReleaseAge?: boolean;
+}
+/**
+ * Package-manager-specific command and generated-project behavior.
+ *
+ * Process lifecycle and output handling remain shared; each strategy owns the
+ * arguments, executable resolution, and project files understood by its manager.
+ */
+export interface PackageManagerStrategy {
+    /** Package manager represented by this strategy. */
+    readonly kind: PackageManagerKind;
+    /** Manager-owned files included when creating a fresh project. */
+    readonly scaffoldFiles: Readonly<Record<string, string>>;
+    /** Adds or reconciles manager-owned configuration in an existing project. */
+    applyProjectConfiguration(projectRoot: string): Promise<PackageManagerConfigurationResult>;
+    /** Arguments that run the project-local Eve development command. */
+    devArguments(): readonly string[];
+    /** Arguments that install project dependencies. */
+    installArguments(options: PackageManagerInstallOptions): readonly string[];
+    /** Adds any project-scoping arguments required before command execution. */
+    prepareArguments(projectRoot: string, args: readonly string[]): readonly string[];
+    /** Resolves the executable exposed by the current host environment. */
+    resolveInvocation(args: readonly string[]): PackageManagerInvocation;
+}

package/dist/src/setup/primitives/pm/types.js

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

package/dist/src/setup/primitives/pm/yarn.d.ts

@@ -0,0 +1,10 @@
+import { applyNoProjectConfiguration } from "./shared.js";
+export declare const yarnPackageManager: {
+    kind: "yarn";
+    scaffoldFiles: {};
+    applyProjectConfiguration: typeof applyNoProjectConfiguration;
+    devArguments: () => string[];
+    installArguments: () => string[];
+    prepareArguments: (_projectRoot: string, args: readonly string[]) => readonly string[];
+    resolveInvocation: (args: readonly string[]) => import("./types.js").PackageManagerInvocation;
+};

package/dist/src/setup/primitives/pm/yarn.js

@@ -0,0 +1 @@
+import{applyNoProjectConfiguration,resolveStandardInvocation}from"./shared.js";const yarnPackageManager={kind:`yarn`,scaffoldFiles:{},applyProjectConfiguration:applyNoProjectConfiguration,devArguments:()=>[`eve`,`dev`],installArguments:()=>[`install`],prepareArguments:(e,t)=>t,resolveInvocation:e=>resolveStandardInvocation(`yarn`,e)};export{yarnPackageManager};

package/dist/src/setup/primitives/run-pnpm.d.ts

@@ -0,0 +1 @@
+export { eveDevArguments, runPackageManagerInstall, runPnpmInstall, spawnPackageManager, spawnPnpm, type RunInstallOptions, type RunPackageManagerOptions as RunPnpmOptions, } from "./pm/run.js";

package/dist/src/setup/primitives/run-pnpm.js

@@ -0,0 +1 @@
+import{eveDevArguments,runPackageManagerInstall,runPnpmInstall,spawnPackageManager,spawnPnpm}from"./pm/run.js";export{eveDevArguments,runPackageManagerInstall,runPnpmInstall,spawnPackageManager,spawnPnpm};

package/dist/src/setup/{scaffold/primitives → primitives}/run-vercel.d.ts

@@ -7,6 +7,13 @@ export interface RunVercelOptions {
     nonInteractive?: boolean;
     /** Streams command output to a parent-owned renderer instead of writing outside it. */
     onOutput?: ProcessOutputHandler;
+    /**
+     * Hard deadline for the whole command. When it elapses the run settles as a
+     * failure and the child is killed (SIGTERM, then SIGKILL after a short
+     * grace). Unbounded when omitted — only safe for commands that cannot wait
+     * on external action, e.g. a Connect create parked on a browser OAuth.
+     */
+    timeoutMs?: number;
 }
 /**
  * Runs a Vercel CLI command with the Connect feature flag enabled.

package/dist/src/setup/primitives/run-vercel.js

@@ -0,0 +1 @@
+import{createProcessOutputBuffer}from"./process-output.js";import{dirname,join,resolve}from"node:path";import{spawn}from"node:child_process";import{accessSync,constants,existsSync,statSync}from"node:fs";const CONNECT_FEATURE_FLAG_ENV={FF_CONNECT_ENABLED:`1`},VERCEL_NOT_FOUND_MESSAGE=`Vercel CLI not found. Install with: npm i -g vercel@latest`;function buildSpawnEnv(e){return{...process.env,...CONNECT_FEATURE_FLAG_ENV,...e}}function existingDir(e){let n=resolve(e);for(;!existsSync(n);){let e=dirname(n);if(e===n)break;n=e}return n}function armDeadline(e,t,n){if(t===void 0)return()=>{};let r=setTimeout(()=>{n(),e.kill(`SIGTERM`);let t=setTimeout(()=>e.kill(`SIGKILL`),5e3);t.unref(),e.once(`close`,()=>clearTimeout(t))},t);return r.unref(),()=>clearTimeout(r)}function timeoutMessage(e,t){return`vercel ${e.join(` `)} timed out after ${Math.round(t/1e3)}s and was aborted.`}function ancestorDirectories(e){let n=[],i=resolve(e);for(;;){n.push(i);let e=dirname(i);if(e===i)return n;i=e}}function findExecutable(e){try{if(accessSync(e,constants.F_OK|constants.X_OK),statSync(e).isFile())return e}catch{return}}function findLocalVercel(e){for(let t of ancestorDirectories(e)){let e=findExecutable(join(t,`node_modules`,`.bin`,`vercel`));if(e!==void 0)return e}}function resolveVercelInvocation(e){let t=findLocalVercel(e);return t===void 0?{command:`vercel`,commandArgs:[]}:{command:t,commandArgs:[]}}function stdioForRun(e){return e.onOutput?[e.nonInteractive?`ignore`:`inherit`,`pipe`,`pipe`]:e.nonInteractive?[`ignore`,`pipe`,`pipe`]:`inherit`}async function runVercel(t,n){return new Promise(r=>{let a=existingDir(n.cwd),o=resolveVercelInvocation(a),s=n.onOutput&&createProcessOutputBuffer(n.onOutput),c=spawn(o.command,[...o.commandArgs,...t],{cwd:a,stdio:stdioForRun(n),env:buildSpawnEnv(n.extraEnv??{})});c.stdout?.on(`data`,e=>s?.write(`stdout`,e)),c.stderr?.on(`data`,e=>s?.write(`stderr`,e));let l=!1;function settle(e){l||(l=!0,s?.flush(),r(e))}function reportFailure(e){n.onOutput?n.onOutput({stream:`stderr`,text:e}):process.stderr.write(`\n${e}\n`)}let u=armDeadline(c,n.timeoutMs,()=>{reportFailure(timeoutMessage(t,n.timeoutMs??0)),settle(!1)});c.on(`error`,e=>{u(),e.code===`ENOENT`?reportFailure(VERCEL_NOT_FOUND_MESSAGE):reportFailure(`vercel ${t.join(` `)} failed: ${e.message}`),settle(!1)}),c.on(`close`,e=>{u(),!l&&e!==0&&e!==null&&(s?.flush(),reportFailure(`vercel ${t.join(` `)} exited with code ${e}.`)),settle(e===0)})})}async function runVercelCaptureStdout(t,n){return new Promise(r=>{let a=existingDir(n.cwd),o=resolveVercelInvocation(a),s=n.onOutput&&createProcessOutputBuffer(n.onOutput),c=spawn(o.command,[...o.commandArgs,...t],{cwd:a,stdio:[n.nonInteractive?`ignore`:`inherit`,`pipe`,n.onOutput?`pipe`:`inherit`],env:buildSpawnEnv(n.extraEnv??{})}),l=[];c.stdout?.on(`data`,e=>l.push(e.toString(`utf8`))),c.stderr?.on(`data`,e=>s?.write(`stderr`,e));let u=!1;function settle(e){u||(u=!0,s?.flush(),r({ok:e,stdout:l.join(``)}))}function reportFailure(e){n.onOutput?n.onOutput({stream:`stderr`,text:e}):process.stderr.write(`\n${e}\n`)}let d=armDeadline(c,n.timeoutMs,()=>{reportFailure(timeoutMessage(t,n.timeoutMs??0)),settle(!1)});c.on(`error`,e=>{d(),reportFailure(e.code===`ENOENT`?VERCEL_NOT_FOUND_MESSAGE:`vercel ${t.join(` `)} failed: ${e.message}`),settle(!1)}),c.on(`close`,e=>{d(),!u&&e!==0&&e!==null&&reportFailure(`vercel ${t.join(` `)} exited with code ${e}.`),settle(e===0)})})}async function captureVercel(t,n){return new Promise(r=>{let a=existingDir(n.cwd),o=resolveVercelInvocation(a),s=n.onOutput&&createProcessOutputBuffer(n.onOutput),c=spawn(o.command,[...o.commandArgs,...t],{cwd:a,stdio:[`ignore`,`pipe`,`pipe`],env:buildSpawnEnv(n.extraEnv??{})}),l=[],u=[];c.stdout?.on(`data`,e=>l.push(e.toString(`utf8`))),c.stderr?.on(`data`,e=>{u.push(e.toString(`utf8`)),s?.write(`stderr`,e)});let d=!1;function fail(e){d||(d=!0,s?.flush(),n.onOutput?.({stream:`stderr`,text:e.message}),r({ok:!1,failure:e}))}function succeed(){d||(d=!0,s?.flush(),r({ok:!0,stdout:l.join(``)}))}let f=armDeadline(c,n.timeoutMs,()=>{fail({code:null,stdout:l.join(``),stderr:u.join(``),message:timeoutMessage(t,n.timeoutMs??0)})});c.on(`error`,e=>{f(),fail({errno:e.code,stdout:l.join(``),stderr:u.join(``),message:e.code===`ENOENT`?VERCEL_NOT_FOUND_MESSAGE:`vercel ${t.join(` `)} failed: ${e.message}`})}),c.on(`close`,e=>{if(f(),e!==0&&e!==null){fail({code:e,stdout:l.join(``),stderr:u.join(``),message:`vercel ${t.join(` `)} exited with code ${e}.`});return}succeed()})})}export{captureVercel,runVercel,runVercelCaptureStdout};

package/dist/src/setup/project-name.d.ts

@@ -0,0 +1,4 @@
+/** Returns an error message when a project name is not a safe single path segment. */
+export declare function validateProjectName(value: string): string | undefined;
+/** Parses and normalizes a project name at an external input boundary. */
+export declare function parseProjectName(value: string): string;

package/dist/src/setup/project-name.js

@@ -0,0 +1 @@
+const PROJECT_NAME_REGEX=/^(?!.*---)[a-z0-9-_.]+$/;function validateProjectName(t){let n=t.trim();if(n.length===0)return`Project name cannot be empty.`;if(n===`.`||n===`..`)return`Project name cannot be '${n}'.`;if(!PROJECT_NAME_REGEX.test(n)||n.length>100)return`Project name can only contain up to 100 lowercase letters, digits, and the characters '.', '_', '-'.`}function parseProjectName(e){let t=e.trim(),n=validateProjectName(t);if(n!==void 0)throw Error(n);return t}export{parseProjectName,validateProjectName};

package/dist/src/setup/project-resolution.d.ts

@@ -0,0 +1,54 @@
+/** Link and production-deployment status for a Vercel project directory. */
+export type DeploymentState = "unlinked" | "linked" | "deployed";
+/** Vercel project data resolved from local link metadata and the API. */
+export interface DeploymentInfo {
+    state: DeploymentState;
+    projectId?: string;
+    orgId?: string;
+    productionUrl?: string;
+}
+/**
+ * Reads local Vercel link metadata and checks whether the linked project has a production alias.
+ */
+export declare function detectDeployment(projectPath: string): Promise<DeploymentInfo>;
+/** Human-readable identity of a linked Vercel project, for the dashboard status bar. */
+export interface ProjectIdentity {
+    projectName: string;
+    /** The team's display name; absent for a personal-account project. */
+    teamName?: string;
+}
+/**
+ * Resolves a linked project's human-readable name and team for the dashboard
+ * status bar, from local `.vercel/project.json` plus the Vercel API. A
+ * personal-account project (a non-`team_` org) carries no team, so `teamName`
+ * is absent; the project name falls back to its id if the API call fails.
+ *
+ * Returns `undefined` when the directory is not linked. Network-bound: callers
+ * render a loading affordance and cache the result.
+ *
+ * @param projectPath Absolute path of the linked project directory.
+ */
+export declare function detectProjectIdentity(projectPath: string): Promise<ProjectIdentity | undefined>;
+export type ProjectResolution = {
+    kind: "unresolved";
+} | {
+    kind: "linked";
+    projectId: string;
+} | {
+    kind: "deployed";
+    projectId: string;
+    productionUrl: string;
+};
+export declare function projectResolutionFromDeployment(deployment: DeploymentInfo): ProjectResolution;
+/**
+ * Side-effect-free fact gathering after a link: reads `.vercel/project.json`
+ * to resolve the project. The on-disk link is the single source of truth.
+ */
+export declare function detectProjectResolution(projectRoot: string): Promise<ProjectResolution>;
+export declare function mergeProjectResolution(current: ProjectResolution, next: ProjectResolution): ProjectResolution;
+export declare function projectResolutionFromDeployResult(project: ProjectResolution, deploy: {
+    deployed: boolean;
+    productionUrl?: string;
+}): ProjectResolution;
+export declare function isProjectResolved(project: ProjectResolution): boolean;
+export declare function projectProductionUrlFromResolution(project: ProjectResolution): string | undefined;

package/dist/src/setup/project-resolution.js

@@ -0,0 +1 @@
+import{captureVercel}from"./primitives/run-vercel.js";import{join}from"node:path";import{readFile}from"node:fs/promises";function pickShortestAlias(e){if(!Array.isArray(e))return;let t;for(let n of e)typeof n!=`string`||n.length===0||(t===void 0||n.length<t.length)&&(t=n);return t}async function fetchProductionAlias(t,n,r){let i=await captureVercel([`api`,`/v9/projects/${t}?teamId=${n}`,`--scope`,n],{cwd:r});if(i.ok)try{let e=pickShortestAlias(JSON.parse(i.stdout).targets?.production?.alias);return e?`https://${e}`:void 0}catch{return}}async function detectDeployment(e){let r;try{r=await readFile(join(e,`.vercel`,`project.json`),`utf8`)}catch{return{state:`unlinked`}}let i;try{i=JSON.parse(r)}catch{return{state:`unlinked`}}let a=typeof i.projectId==`string`?i.projectId:void 0,o=typeof i.orgId==`string`?i.orgId:void 0;if(!a||!o)return{state:`unlinked`};let s=await fetchProductionAlias(a,o,e);return{state:s?`deployed`:`linked`,projectId:a,orgId:o,productionUrl:s}}async function fetchVercelName(t,n,r){let i=await captureVercel([`api`,t,`--scope`,n],{cwd:r});if(i.ok)try{let e=JSON.parse(i.stdout);return typeof e.name==`string`&&e.name.length>0?e.name:typeof e.slug==`string`&&e.slug.length>0?e.slug:void 0}catch{return}}async function detectProjectIdentity(e){let r;try{r=await readFile(join(e,`.vercel`,`project.json`),`utf8`)}catch{return}let i;try{i=JSON.parse(r)}catch{return}let a=typeof i.projectId==`string`?i.projectId:void 0,o=typeof i.orgId==`string`?i.orgId:void 0;if(!a||!o)return;let[s,c]=await Promise.all([fetchVercelName(`/v9/projects/${a}?teamId=${o}`,o,e).then(e=>e??a),o.startsWith(`team_`)?fetchVercelName(`/v2/teams/${o}`,o,e):Promise.resolve(void 0)]);return{projectName:s,teamName:c}}function projectResolutionFromDeployment(e){return e.state===`unlinked`||e.projectId===void 0?{kind:`unresolved`}:e.state===`deployed`&&e.productionUrl!==void 0?{kind:`deployed`,projectId:e.projectId,productionUrl:e.productionUrl}:{kind:`linked`,projectId:e.projectId}}async function detectProjectResolution(e){return projectResolutionFromDeployment(await detectDeployment(e))}function mergeProjectResolution(e,t){return t.kind===`unresolved`||e.kind===`deployed`&&e.projectId===t.projectId?e:t}function projectResolutionFromDeployResult(e,t){return e.kind===`unresolved`||!t.deployed||t.productionUrl===void 0?e:{kind:`deployed`,projectId:e.projectId,productionUrl:t.productionUrl}}function isProjectResolved(e){return e.kind!==`unresolved`}function projectProductionUrlFromResolution(e){return e.kind===`deployed`?e.productionUrl:void 0}export{detectDeployment,detectProjectIdentity,detectProjectResolution,isProjectResolved,mergeProjectResolution,projectProductionUrlFromResolution,projectResolutionFromDeployResult,projectResolutionFromDeployment};

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

@@ -1,4 +1,4 @@
-import { type RailSpinner } from "#setup/scaffold/cli/index.js";
+import { type RailSpinner } from "#setup/cli/index.js";
 /**
  * Clack constrains option values to readonly primitives. Our scaffold flow
  * only ever uses string-valued options (`ChannelKind`, `SetupMode`,
@@ -25,6 +25,22 @@ export interface SelectOption<T extends PrompterValue> {
     locked?: boolean;
     /** Parenthetical shown after a locked option'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;
+}
+/**
+ * An outcome line from an earlier lap of a looping menu, shown with the
+ * repainted question: the TUI panel renders it beneath the options, the CLI
+ * prints it to scrollback before the prompt.
+ */
+export interface SelectNotice {
+    tone: "success" | "info" | "warning";
+    text: string;
 }
 /** Options common to every {@link Prompter.select} call. */
 export interface SelectCommonOptions<T extends PrompterValue> {
@@ -43,6 +59,15 @@ export interface SelectCommonOptions<T extends PrompterValue> {
      * so it is inherently satisfied.
      */
     required?: boolean;
+    /**
+     * "stacked" renders each option's hint on its own line below the label with
+     * a blank line between options — for small action menus whose hints carry
+     * current values. A TUI-panel affordance: the CLI prompter keeps its inline
+     * hint rendering.
+     */
+    layout?: "stacked";
+    /** Outcome lines from earlier laps of a looping menu. */
+    notices?: readonly SelectNotice[];
 }
 /** Single-select form: navigate, then enter picks the highlighted option. */
 export interface SingleSelectOptions<T extends PrompterValue> extends SelectCommonOptions<T> {
@@ -50,12 +75,19 @@ export interface SingleSelectOptions<T extends PrompterValue> extends SelectComm
     /** Pre-position the cursor on the option whose value matches. */
     initialValue?: T;
 }
-/** Multi-select form: space toggles rows, enter confirms the marked set. */
+/** Multi-select form: space or enter toggles rows; enter on the trailing Submit row confirms the marked set. */
 export interface MultiSelectOptions<T extends PrompterValue> extends SelectCommonOptions<T> {
     multiple: true;
     /** Pre-mark these values as selected. */
     initialValues?: T[];
 }
+/** Color intent for {@link Prompter.note}: red warning (default) or green success. */
+export type NoteTone = "warning" | "success";
+/** Input for {@link Prompter.acknowledge}: a heading plus optional body lines. */
+export interface AcknowledgeOptions {
+    message: string;
+    lines?: readonly string[];
+}
 export interface Prompter {
     text(opts: {
         message: string;
@@ -69,13 +101,29 @@ export interface Prompter {
     }): Promise<string>;
     /**
      * Unified picker. Defaults to single-select (enter picks the highlighted row);
-     * pass `multiple: true` for a checklist (space toggles, enter confirms). Add
+     * pass `multiple: true` for a checklist (space or enter toggles, enter on
+     * the trailing Submit row confirms). Add
      * `search: true` for a type-ahead filter. `required` gates an empty
      * multi-select submission.
      */
     select<T extends PrompterValue>(opts: SingleSelectOptions<T>): Promise<T>;
     select<T extends PrompterValue>(opts: MultiSelectOptions<T>): Promise<T[]>;
-    note(message: string, title?: string): void;
+    /**
+     * Static instructions the user dismisses before the flow moves on. The TUI
+     * renders them in the question slot of the flow panel (the text takes the
+     * place of option rows) until enter; the CLI prints them to scrollback and
+     * resolves immediately, since printed text persists there. Optional so
+     * lightweight test fakes can omit it — flows fall back to {@link note}.
+     */
+    acknowledge?(opts: AcknowledgeOptions): Promise<void>;
+    /**
+     * Rail-attached notice, no bullet — reads as a follow-up to the previous
+     * step. Red by default (warnings, collisions); pass `tone: "success"` for a
+     * green closing note like the one-shot next steps.
+     */
+    note(message: string, title?: string, options?: {
+        tone?: NoteTone;
+    }): void;
     /** Prints the Vercel ▲ logo + title + subtitle banner. */
     intro(title: string, subtitle?: string): void;
     /** Prints a final green ● end-cap with the message. */

package/dist/src/setup/prompter.js

@@ -1 +1 @@
-import{__toESM}from"../_virtual/_rolldown/runtime.js";import{WizardCancelledError}from"./step.js";import{h,ht,q}from"../node_modules/.pnpm/@clack_core@1.3.1/node_modules/@clack/core/dist/index.js";import{require_picocolors}from"../node_modules/.pnpm/picocolors@1.1.1/node_modules/picocolors/picocolors.js";import{initialQuitGuardState,quitHintNote,reduceQuitGuard}from"./quit-guard.js";import{cornerFor,createRailLog,formatPromptCancellation,formatPromptHeader,formatPromptOpener,formatPromptOutro,formatPromptSubmission,formatRailLine,railFor,runSelectComponent}from"#setup/scaffold/cli/index.js";var import_picocolors=__toESM(require_picocolors(),1);function guardCancel(e){if(q(e))throw process.stdout.write(formatPromptCancellation(`Setup cancelled.`,import_picocolors.default)),new WizardCancelledError;return e}let escapeCancelDisabled=!1;function disableEscapeCancel(){escapeCancelDisabled||=(h.aliases.delete(`escape`),!0)}function attachQuitGuard(e){let t=initialQuitGuardState;return e.on(`key`,(n,r)=>{let{state:i,action:a}=reduceQuitGuard(t,r?.name===`escape`?{type:`escape`}:{type:`other-key`});t=i,a===`quit`&&(e.state=`cancel`)}),{note:()=>quitHintNote(t,import_picocolors.default)}}function toPromptState(e){return e}function railForState(e){return railFor(toPromptState(e),import_picocolors.default)}function cornerForState(e){return cornerFor(toPromptState(e),import_picocolors.default)}function header(e,t,n){return formatPromptHeader(toPromptState(e),t,{colors:import_picocolors.default,leadingRail:n===0?`white`:`green`})}const REDACTED_DISPLAY=`••••••••`;function textPrompt(e,t){let n,i=new ht({validate:t.validate?e=>t.validate?.(e??``):void 0,placeholder:t.placeholder,defaultValue:t.defaultValue,render(){let r=header(this.state,t.message,e),i=t.placeholder?import_picocolors.default.inverse(t.placeholder[0])+import_picocolors.default.dim(t.placeholder.slice(1)):import_picocolors.default.inverse(import_picocolors.default.hidden(`_`)),a=this.value?`•`.repeat(this.value.length):i,o=t.mask?a:this.value?this.userInputWithCursor:i;switch(this.state){case`error`:return`${r.trim()}\n${railForState(this.state)}  ${o}\n${cornerForState(this.state)}  ${import_picocolors.default.red(this.error)}\n`;case`submit`:{let n=t.mask?this.value?REDACTED_DISPLAY:t.placeholder||``:this.value||t.placeholder||``;return formatPromptSubmission(this.state,t.message,n,{colors:import_picocolors.default,leadingRail:e===0?`white`:`green`})}case`cancel`:return`${r}${railForState(this.state)}  ${import_picocolors.default.strikethrough(import_picocolors.default.dim(t.mask&&this.value?REDACTED_DISPLAY:this.value??``))}${this.value?.trim()?`\n${railForState(this.state)}`:``}`;default:return`${r}${railForState(this.state)}  ${o}\n${cornerForState(this.state)}${cornerNote(n?.note())}\n`}}});return n=attachQuitGuard(i),i.prompt()}function cornerNote(e){return e?`  ${e}`:``}function createPrompter(){disableEscapeCancel();let e=0,t=createRailLog({colors:import_picocolors.default,output:process.stdout});return{async text(n){t.settle();let r=guardCancel(await textPrompt(e,n));return e+=1,r??``},async password(n){t.settle();let r=guardCancel(await textPrompt(e,{message:n.message,mask:!0,validate:n.validate}));return e+=1,r??``},async select(n){t.settle();let r=guardCancel(await runSelectComponent({message:n.message,options:n.options,multiple:n.multiple===!0,search:n.search??!1,required:n.required??!1,placeholder:n.placeholder,defaultValue:n.multiple===!0?void 0:n.initialValue,initialValues:n.multiple===!0?n.initialValues:void 0,leadingRail:e===0?`white`:`green`,attachGuard:e=>attachQuitGuard(e)}));return e+=1,r},note(e,n){t.settle(),n&&process.stdout.write(formatRailLine(import_picocolors.default.red(import_picocolors.default.bold(n)),import_picocolors.default,process.stdout)),process.stdout.write(formatRailLine(import_picocolors.default.red(e),import_picocolors.default,process.stdout))},intro(e,n=`Eve by Vercel: like Next.js, but for agents.`){t.settle(),process.stdout.write(formatPromptOpener(e,n,import_picocolors.default))},outro(e){t.settle(),process.stdout.write(formatPromptOutro(e,import_picocolors.default))},log:t}}export{createPrompter};
+import{__toESM}from"../_virtual/_rolldown/runtime.js";import{require_picocolors}from"../node_modules/.pnpm/picocolors@1.1.1/node_modules/picocolors/picocolors.js";import{h,ht,q}from"../node_modules/.pnpm/@clack_core@1.3.1/node_modules/@clack/core/dist/index.js";import{WizardCancelledError}from"./step.js";import{initialQuitGuardState,quitHintNote,reduceQuitGuard}from"./quit-guard.js";import{cornerFor,createRailLog,formatPromptCancellation,formatPromptHeader,formatPromptOpener,formatPromptOutro,formatPromptSubmission,formatRailLine,railFor,runSelectComponent}from"#setup/cli/index.js";var import_picocolors=__toESM(require_picocolors(),1);function guardCancel(e){if(q(e))throw process.stdout.write(formatPromptCancellation(`Setup cancelled.`,import_picocolors.default)),new WizardCancelledError;return e}let escapeCancelDisabled=!1;function disableEscapeCancel(){escapeCancelDisabled||=(h.aliases.delete(`escape`),!0)}function attachQuitGuard(e){let t=initialQuitGuardState;return e.on(`key`,(n,r)=>{let{state:i,action:a}=reduceQuitGuard(t,r?.name===`escape`?{type:`escape`}:{type:`other-key`});t=i,a===`quit`&&(e.state=`cancel`)}),{note:()=>quitHintNote(t,import_picocolors.default)}}function toPromptState(e){return e}function railForState(e){return railFor(toPromptState(e),import_picocolors.default)}function cornerForState(e){return cornerFor(toPromptState(e),import_picocolors.default)}function header(e,t,n){return formatPromptHeader(toPromptState(e),t,{colors:import_picocolors.default,leadingRail:n===0?`white`:`green`})}const REDACTED_DISPLAY=`••••••••`;function textPrompt(e,t){let n,i=new ht({validate:t.validate?e=>t.validate?.(e??``):void 0,placeholder:t.placeholder,defaultValue:t.defaultValue,render(){let r=header(this.state,t.message,e),i=t.placeholder?import_picocolors.default.inverse(t.placeholder[0])+import_picocolors.default.dim(t.placeholder.slice(1)):import_picocolors.default.inverse(import_picocolors.default.hidden(`_`)),a=this.value?`•`.repeat(this.value.length):i,o=t.mask?a:this.value?this.userInputWithCursor:i;switch(this.state){case`error`:return`${r.trim()}\n${railForState(this.state)}  ${o}\n${cornerForState(this.state)}  ${import_picocolors.default.red(this.error)}\n`;case`submit`:{let n=t.mask?this.value?REDACTED_DISPLAY:t.placeholder||``:this.value||t.placeholder||``;return formatPromptSubmission(this.state,t.message,n,{colors:import_picocolors.default,leadingRail:e===0?`white`:`green`})}case`cancel`:return`${r}${railForState(this.state)}  ${import_picocolors.default.strikethrough(import_picocolors.default.dim(t.mask&&this.value?REDACTED_DISPLAY:this.value??``))}${this.value?.trim()?`\n${railForState(this.state)}`:``}`;default:return`${r}${railForState(this.state)}  ${o}\n${cornerForState(this.state)}${cornerNote(n?.note())}\n`}}});return n=attachQuitGuard(i),i.prompt()}function cornerNote(e){return e?`  ${e}`:``}function createPrompter(){disableEscapeCancel();let e=0,t=createRailLog({colors:import_picocolors.default,output:process.stdout});return{async text(n){t.settle();let r=guardCancel(await textPrompt(e,n));return e+=1,r??``},async password(n){t.settle();let r=guardCancel(await textPrompt(e,{message:n.message,mask:!0,validate:n.validate}));return e+=1,r??``},async select(n){t.settle();for(let e of n.notices??[])e.tone===`success`?t.success(e.text):e.tone===`warning`?t.warning(e.text):t.message(e.text);let r=guardCancel(await runSelectComponent({message:n.message,options:n.options,multiple:n.multiple===!0,search:n.search??!1,required:n.required??!1,placeholder:n.placeholder,defaultValue:n.multiple===!0?void 0:n.initialValue,initialValues:n.multiple===!0?n.initialValues:void 0,leadingRail:e===0?`white`:`green`,attachGuard:e=>attachQuitGuard(e)}));return e+=1,r},async acknowledge(e){t.settle(),process.stdout.write(formatRailLine(import_picocolors.default.bold(e.message),import_picocolors.default,process.stdout));for(let t of e.lines??[])process.stdout.write(formatRailLine(import_picocolors.default.dim(t),import_picocolors.default,process.stdout))},note(e,n,r){t.settle();let i=r?.tone===`success`?import_picocolors.default.green:import_picocolors.default.red;n&&process.stdout.write(formatRailLine(i(import_picocolors.default.bold(n)),import_picocolors.default,process.stdout)),process.stdout.write(formatRailLine(i(e),import_picocolors.default,process.stdout))},intro(e,n=`Production-grade agent framework.`){t.settle(),process.stdout.write(formatPromptOpener(e,n,import_picocolors.default))},outro(e){t.settle(),process.stdout.write(formatPromptOutro(e,import_picocolors.default))},log:t}}export{createPrompter};

package/dist/src/setup/quit-guard.d.ts

@@ -1,4 +1,4 @@
-import type { PromptColors } from "#setup/scaffold/cli/index.js";
+import type { PromptColors } from "#setup/cli/index.js";
 /**
  * Two-stage Escape-to-quit state for an interactive prompt.
  *

package/dist/src/setup/run-vercel-link.d.ts

@@ -1,4 +1,4 @@
-import { type RunVercelOptions } from "#setup/scaffold/primitives/index.js";
+import { type RunVercelOptions } from "#setup/primitives/index.js";
 type VercelOutputHandler = NonNullable<RunVercelOptions["onOutput"]>;
 /**
  * Runs `vercel env pull --yes` inside a linked project so `.env.local`

package/dist/src/setup/run-vercel-link.js

@@ -1 +1 @@
-import{runVercel}from"#setup/scaffold/primitives/index.js";async function runVercelEnvPull(e,t){return runVercel([`env`,`pull`,`--yes`],{cwd:e,onOutput:t})}export{runVercelEnvPull};
+import{runVercel}from"#setup/primitives/index.js";async function runVercelEnvPull(e,t){return runVercel([`env`,`pull`,`--yes`],{cwd:e,onOutput:t})}export{runVercelEnvPull};

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

@@ -36,14 +36,15 @@ export interface RunnerOptions<State> {
 /**
  * Linear interactive runner: walk the boxes in order, prompting for each. A box
  * whose `perform` throws a {@link RetryableSetupError} is re-gathered with the
- * prior input as the default; a cancel (returned as an outcome, or thrown by a
- * prompter) ends the whole run. There is no back navigation: side effects are
- * not undone by restoring in-memory state.
+ * prior input as the default; a cancel (a {@link WizardCancelledError} thrown
+ * by a prompter) ends the whole run. There is no back navigation: side effects
+ * are not undone by restoring in-memory state.
  */
 export declare function runInteractive<State>(boxes: readonly AnySetupBox<State>[], initialState: State, sink: OutputSink, options?: RunnerOptions<State>): Promise<RunResult<State>>;
 /**
  * Non-interactive runner: derive each box's input from its options and apply
  * it. No retry loop and no prompts; a box that cannot proceed without a human
- * is expected to throw from `gatherHeadless`/`perform`.
+ * is expected to throw from its gather (a unified box's headless-based asker
+ * refuses required questions with `InteractionRequired`) or from `perform`.
  */
 export declare function runHeadless<State>(boxes: readonly AnySetupBox<State>[], initialState: State, sink: OutputSink, options?: RunnerOptions<State>): Promise<State>;

package/dist/src/setup/runner.js

@@ -1 +1 @@
-import{WizardCancelledError}from"./step.js";import{ChannelAddCancelledError}from"#setup/scaffold/cli/index.js";function isCancellation(n){return n instanceof WizardCancelledError||n instanceof ChannelAddCancelledError}var RetryableSetupError=class extends Error{constructor(e,t){super(e,t),this.name=`RetryableSetupError`}};function isRetryable(e){return e instanceof RetryableSetupError}async function runInteractive(e,t,n,r){let i=t,view=()=>r?.snapshot?r.snapshot(i):i,a={};try{for(let t of e)if(t.shouldRun?.(view())!==!1)for(;;){let e=await t.gatherInteractive({state:view(),initial:a[t.id]});if(e.kind===`cancelled`)return{kind:`cancelled`};a[t.id]=e.input;try{let r=await t.perform({state:view(),input:e.input,sink:n});i=t.apply(i,r);break}catch(e){if(!isRetryable(e))throw e;n.write(e instanceof Error?e.message:String(e))}}}catch(e){if(isCancellation(e))return{kind:`cancelled`};throw e}return{kind:`done`,state:i}}async function runHeadless(e,t,n,r){let i=t,view=()=>r?.snapshot?r.snapshot(i):i;for(let t of e){if(t.shouldRun?.(view())===!1)continue;let e=await t.gatherHeadless({state:view()}),r=await t.perform({state:view(),input:e,sink:n});i=t.apply(i,r)}return i}export{RetryableSetupError,runHeadless,runInteractive};
+import{WizardCancelledError}from"./step.js";function isCancellation(t){return t instanceof WizardCancelledError}var RetryableSetupError=class extends Error{constructor(e,t){super(e,t),this.name=`RetryableSetupError`}};function isRetryable(e){return e instanceof RetryableSetupError}async function runInteractive(e,t,n,r){let i=t,view=()=>r?.snapshot?r.snapshot(i):i,a={};try{for(let t of e)if(t.shouldRun?.(view())!==!1)for(;;){let e=await t.gather({state:view(),initial:a[t.id]});a[t.id]=e;try{let r=await t.perform({state:view(),input:e,sink:n});i=t.apply(i,r);break}catch(e){if(!isRetryable(e))throw e;n.write(e instanceof Error?e.message:String(e))}}}catch(e){if(isCancellation(e))return{kind:`cancelled`};throw e}return{kind:`done`,state:i}}async function runHeadless(e,t,n,r){let i=t,view=()=>r?.snapshot?r.snapshot(i):i;for(let t of e){if(t.shouldRun?.(view())===!1)continue;let e=await t.gather({state:view()}),r=await t.perform({state:view(),input:e,sink:n});i=t.apply(i,r)}return i}export{RetryableSetupError,runHeadless,runInteractive};

package/dist/src/setup/scaffold/channels-catalog.d.ts

@@ -1,6 +1,6 @@
 /**
- * Build-time catalog of the channels the onboarding CLI can scaffold. It drives
- * the `Select channels` picker shown during create and `eve channels add`.
+ * Build-time catalog of channels used by programmatic setup and
+ * `eve channels add`.
  *
  * Channel *identity* (slug, name, and whether it is scaffoldable) is owned by
  * `@vercel/eve-catalog`, the cross-surface source of truth shared with the docs
@@ -9,7 +9,7 @@
  * as `web`), the picker copy, and the picker order — and validates that the
  * overlay and the catalog cannot drift apart.
  */
-import type { ChannelKind } from "./channels.js";
+import type { ChannelKind } from "./update/channels.js";
 /** A catalog channel the CLI can scaffold, paired with its picker presentation. */
 export interface ScaffoldableChannel {
     /** Catalog slug. */

package/dist/src/setup/scaffold/channels-catalog.js

@@ -1 +1 @@
-import{channelEntries}from"../../packages/eve-catalog/src/index.js";const CHANNEL_SCAFFOLDS=[{slug:`eve`,kind:`web`,label:`Web Chat`},{slug:`slack`,kind:`slack`,label:`Slack`,hint:`creates slackbot and deploys to Vercel`}];function buildScaffoldableChannels(){let n=new Set(channelEntries().filter(e=>e.surfaces.scaffoldable).map(e=>e.slug)),r=[];for(let e of CHANNEL_SCAFFOLDS){if(!n.delete(e.slug))throw Error(`Channel overlay "${e.slug}" is not a scaffoldable channel in @vercel/eve-catalog.`);let t={slug:e.slug,kind:e.kind,label:e.label};e.hint!==void 0&&(t.hint=e.hint),r.push(t)}if(n.size>0){let e=[...n].sort().join(`, `);throw Error(`Scaffoldable catalog channels missing a scaffolder overlay: ${e}.`)}return r}const SCAFFOLDABLE_CHANNELS=buildScaffoldableChannels();export{SCAFFOLDABLE_CHANNELS};
+import{channelEntries}from"../../packages/eve-catalog/src/index.js";const CHANNEL_SCAFFOLDS=[{slug:`eve`,kind:`web`,label:`Web Chat`,hint:`Next.js app`},{slug:`slack`,kind:`slack`,label:`Slack`,hint:`creates slackbot and deploys to Vercel`}];function buildScaffoldableChannels(){let n=new Set(channelEntries().filter(e=>e.surfaces.scaffoldable).map(e=>e.slug)),r=[];for(let e of CHANNEL_SCAFFOLDS){if(!n.delete(e.slug))throw Error(`Channel overlay "${e.slug}" is not a scaffoldable channel in @vercel/eve-catalog.`);let t={slug:e.slug,kind:e.kind,label:e.label};e.hint!==void 0&&(t.hint=e.hint),r.push(t)}if(n.size>0){let e=[...n].sort().join(`, `);throw Error(`Scaffoldable catalog channels missing a scaffolder overlay: ${e}.`)}return r}const SCAFFOLDABLE_CHANNELS=buildScaffoldableChannels();export{SCAFFOLDABLE_CHANNELS};

package/dist/src/setup/scaffold/create/add-to-project.d.ts

@@ -0,0 +1,26 @@
+import type { PackageManagerKind } from "../../package-manager.js";
+export interface AddAgentToProjectOptions {
+    projectRoot: string;
+    model: string;
+    /**
+     * The host project's package manager, which owns any manager-specific
+     * generated project configuration. Defaults to pnpm.
+     */
+    packageManager?: PackageManagerKind;
+    evePackageVersion?: string;
+    aiPackageVersion?: string;
+    zodPackageVersion?: string;
+}
+export interface AddAgentToProjectResult {
+    filesWritten: string[];
+    /** Dependencies added to package.json; ones the project already declares anywhere are left untouched. */
+    dependenciesAdded: string[];
+}
+/**
+ * Adds an Eve agent to an existing package: writes the `agent/` files, adds
+ * the runtime dependencies the project does not already declare, and applies
+ * the selected package manager's project configuration. The host project owns
+ * everything else (tsconfig, scripts, ignore files), so this mode never
+ * touches it. All conflicts are gathered and reported before anything is written.
+ */
+export declare function addAgentToProject(options: AddAgentToProjectOptions): Promise<AddAgentToProjectResult>;

package/dist/src/setup/scaffold/create/add-to-project.js

@@ -0,0 +1 @@
+import{getPackageManagerStrategy}from"../../primitives/pm/index.js";import{pathExists,writeTextFile}from"../files.js";import{patchPackageJson}from"../update/package-json.js";import{resolveVersionToken}from"../version-tokens.js";import{agentTemplateFiles,formatEveDependencySpecifier}from"./project.js";import{join}from"node:path";import{readFile}from"node:fs/promises";const DEPENDENCY_FIELDS=[`dependencies`,`devDependencies`,`optionalDependencies`,`peerDependencies`];function isJsonObject(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function hasDeclaredDependency(e,t){if(!isJsonObject(e))return!1;for(let n of DEPENDENCY_FIELDS){let r=e[n];if(isJsonObject(r)&&typeof r[t]==`string`)return!0}return!1}async function addAgentToProject(i){let a=join(i.projectRoot,`package.json`);if(!await pathExists(a))throw Error(`Cannot add an Eve agent to "${i.projectRoot}" because it has no package.json. Run \`eve init <name>\` to create a new project instead.`);let o=agentTemplateFiles(i.model),s=[];for(let e of Object.keys(o))await pathExists(join(i.projectRoot,e))&&s.push(e);if(s.length===0&&await pathExists(join(i.projectRoot,`agent`))&&s.push(`agent/`),s.length>0)throw Error(`Cannot add an Eve agent to "${i.projectRoot}" because it already has: ${s.join(`, `)}. Move them aside first.`);let c=resolveVersionToken(`evePackageVersion`,i.evePackageVersion??`0.7.0`),l=resolveVersionToken(`aiPackageVersion`,i.aiPackageVersion??`7.0.0-canary.171`),u=resolveVersionToken(`zodPackageVersion`,i.zodPackageVersion??`4.4.3`),d=[];for(let[e,t]of Object.entries(o)){let r=join(i.projectRoot,e);await writeTextFile(r,t),d.push(r)}let f=JSON.parse(await readFile(a,`utf8`)),p={ai:l,eve:formatEveDependencySpecifier(c),zod:u},m={};for(let[e,t]of Object.entries(p))hasDeclaredDependency(f,e)||(m[e]=t);return Object.keys(m).length>0&&await patchPackageJson(a,{dependencies:m}),await getPackageManagerStrategy(i.packageManager??`pnpm`).applyProjectConfiguration(i.projectRoot),{filesWritten:d,dependenciesAdded:Object.keys(m).sort()}}export{addAgentToProject};

package/dist/src/setup/scaffold/create/project.d.ts

@@ -0,0 +1,54 @@
+import type { PackageManagerKind } from "../../package-manager.js";
+export declare const CURRENT_DIRECTORY_PROJECT_NAME = ".";
+export declare const DEFAULT_EVE_PACKAGE_VERSION = "__EVE_PACKAGE_VERSION__";
+export declare const DEFAULT_AI_PACKAGE_VERSION = "__AI_SDK_VERSION__";
+export declare const DEFAULT_ZOD_PACKAGE_VERSION = "__ZOD_VERSION__";
+/**
+ * Provider slug a gateway model id routes through: the segment before the
+ * first "/" (e.g. `anthropic/claude-sonnet-4.6` → `anthropic`). The slug is
+ * injected into generated source, so characters outside the catalog's slug
+ * alphabet are dropped; an id without a usable prefix falls back to
+ * `anthropic`.
+ */
+export declare function modelProviderSlug(modelId: string): string;
+/**
+ * Env var the byok scaffold reads the provider API key from, derived from the
+ * model's provider slug (e.g. `anthropic/...` → `ANTHROPIC_API_KEY`). The name
+ * is the scaffold's convention: the key is passed to the gateway `byok` block
+ * explicitly, so users can rename it freely. Non-alphanumerics fold to `_`
+ * and a leading digit is prefixed, keeping `process.env.<name>` valid source.
+ */
+export declare function byokProviderEnvVar(modelId: string): string;
+/**
+ * The files that define the agent itself, rendered for `model`. This is the
+ * subset `eve init` writes when adding an agent to an existing project, where
+ * everything outside `agent/` belongs to the host app.
+ */
+export declare function agentTemplateFiles(model: string): Record<string, string>;
+export declare function formatEveDependencySpecifier(versionOrSpecifier: string): string;
+export interface ScaffoldBaseProjectOptions {
+    projectName: string;
+    model: string;
+    /**
+     * The manager that owns command execution and manager-specific generated
+     * project files for this scaffold.
+     * Defaults to pnpm.
+     */
+    packageManager?: PackageManagerKind;
+    targetDirectory?: string;
+    overwriteExisting?: boolean;
+    onOverwriteFile?: (filePath: string) => void | Promise<void>;
+    evePackageVersion?: string;
+    aiPackageVersion?: string;
+    zodPackageVersion?: string;
+    tsgoPackageVersion?: string;
+    typesNodePackageVersion?: string;
+    /**
+     * Scaffold an inline provider `byok` block in `agent.ts` that reads the
+     * provider key from `process.env` instead of relying on the managed Vercel
+     * AI Gateway. Adds `@types/node` to the project so `process` is typed.
+     */
+    byokProvider?: boolean;
+}
+export declare function scaffoldBaseProject(options: ScaffoldBaseProjectOptions): Promise<string>;
+export declare function isEveProject(projectRoot: string): Promise<boolean>;