eve 0.6.0-beta.9 → 0.7.2

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.2`),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>;

package/dist/src/setup/scaffold/create/project.js

@@ -0,0 +1,80 @@
+import{getPackageManagerStrategy}from"../../primitives/pm/index.js";import{pathExists,writeTextFile}from"../files.js";import{resolveVersionToken}from"../version-tokens.js";import{SUPPORTED_AUTHORED_MODULE_FILE_EXTENSIONS}from"../update/module-files.js";import{WEB_APP_TEMPLATE_FILES}from"./web-template.js";import{basename,join,resolve}from"node:path";import{mkdir,readdir,stat}from"node:fs/promises";const CURRENT_DIRECTORY_PROJECT_NAME=`.`,ALLOWED_CREATE_IN_PLACE_ENTRIES=new Set([`.DS_Store`,`.git`,`.gitkeep`,`.hg`]),DEFAULT_EVE_PACKAGE_VERSION=`0.7.2`,DEFAULT_AI_PACKAGE_VERSION=`7.0.0-canary.171`,DEFAULT_ZOD_PACKAGE_VERSION=`4.4.3`;function modelProviderSlug(e){let t=(e.split(`/`)[0]??``).replaceAll(/[^A-Za-z0-9._-]/gu,``);return t.length>0?t:`anthropic`}function byokProviderEnvVar(e){let t=modelProviderSlug(e).toUpperCase().replaceAll(/[^A-Z0-9]/gu,`_`);return`${/^[0-9]/.test(t)?`_`:``}${t}_API_KEY`}function agentTemplateFiles(e){return{"agent/agent.ts":BASE_AGENT_TEMPLATE.replaceAll(`__EVE_INIT_MODEL__`,e),"agent/channels/eve.ts":WEB_APP_TEMPLATE_FILES[`agent/channels/eve.ts`],"agent/instructions.md":AGENT_INSTRUCTIONS_TEMPLATE}}function renderTemplate(e,t){return e.replaceAll(`__EVE_INIT_APP_NAME__`,t.appName).replaceAll(`__EVE_INIT_MODEL__`,t.model).replaceAll(`__EVE_INIT_BYOK_PROVIDER__`,modelProviderSlug(t.model)).replaceAll(`__EVE_INIT_BYOK_ENV_VAR__`,byokProviderEnvVar(t.model)).replaceAll(`__EVE_INIT_PACKAGE_VERSION__`,formatEveDependencySpecifier(t.evePackageVersion)).replaceAll(`__EVE_INIT_AI_SDK_VERSION__`,t.aiPackageVersion).replaceAll(`__EVE_INIT_ZOD_VERSION__`,t.zodPackageVersion).replaceAll(`__EVE_INIT_TSGO_VERSION__`,t.tsgoPackageVersion).replaceAll(`__EVE_INIT_TYPES_NODE_VERSION__`,t.typesNodePackageVersion)}function formatEveDependencySpecifier(e){return/^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z-.]+)?$/.test(e)?`^${e}`:e}const BASE_AGENT_TEMPLATE=`import { defineAgent } from "eve";
+
+export default defineAgent({
+  model: "__EVE_INIT_MODEL__",
+});
+`;function packageJsonTemplate(e){return`{
+  "name": "__EVE_INIT_APP_NAME__",
+  "version": "0.0.0",
+  "type": "module",
+  "imports": {
+    "#*": "./agent/*",
+    "#evals/*": "./evals/*"
+  },
+  "scripts": {
+    "build": "eve build",
+    "dev": "eve dev",
+    "start": "eve start",
+    "typecheck": "tsgo"
+  },
+  "dependencies": {
+    "ai": "__EVE_INIT_AI_SDK_VERSION__",
+    "eve": "__EVE_INIT_PACKAGE_VERSION__",
+    "zod": "__EVE_INIT_ZOD_VERSION__"
+  },
+  "devDependencies": {
+${e?`    "@types/node": "__EVE_INIT_TYPES_NODE_VERSION__",
+    "@typescript/native-preview": "__EVE_INIT_TSGO_VERSION__"`:`    "@typescript/native-preview": "__EVE_INIT_TSGO_VERSION__"`}
+  }
+}
+`}const AGENT_INSTRUCTIONS_TEMPLATE=`# Identity
+
+You are a helpful assistant.
+`,SHARED_TEMPLATE_FILES={"agent/channels/eve.ts":WEB_APP_TEMPLATE_FILES[`agent/channels/eve.ts`],"agent/instructions.md":AGENT_INSTRUCTIONS_TEMPLATE,"tsconfig.json":`{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "include": ["agent/**/*.ts", "evals/**/*.ts", ".eve/**/*.d.ts"]
+}
+`,".gitignore":`node_modules
+.env*
+.eve
+.vercel
+.workflow-data
+.next
+.output
+.nitro
+dist
+.DS_Store
+*.tsbuildinfo
+`,".vercelignore":`node_modules
+.eve
+.next
+.output
+.nitro
+dist
+`,"AGENTS.md":`# Eve Agent App
+
+This project uses the Eve framework. Before writing code, always read the relevant guide in \`node_modules/eve/dist/docs/public/\`.
+`,"CLAUDE.md":`@AGENTS.md
+`};function templateFiles(t,n){return{"agent/agent.ts":t?`import { defineAgent } from "eve";
+
+export default defineAgent({
+  model: "__EVE_INIT_MODEL__",
+  modelOptions: {
+    providerOptions: {
+      gateway: {
+        byok: {
+          "__EVE_INIT_BYOK_PROVIDER__": [{ apiKey: process.env.__EVE_INIT_BYOK_ENV_VAR__! }],
+        },
+      },
+    },
+  },
+});
+`:BASE_AGENT_TEMPLATE,...SHARED_TEMPLATE_FILES,"package.json":packageJsonTemplate(t),...getPackageManagerStrategy(n).scaffoldFiles}}async function assertCanCreateInPlace(e,n){if(!await pathExists(e))return;let r=(await readdir(e)).filter(e=>!ALLOWED_CREATE_IN_PLACE_ENTRIES.has(e));if(r.length>0&&!n){let e=r.slice(0,5).join(`, `),t=r.length>5?`, and ${r.length-5} more`:``;throw Error(`Cannot create project in current directory because it is not empty. Found: ${e}${t}. Use an empty directory.`)}}async function scaffoldBaseProject(e){let i=resolve(e.targetDirectory??process.cwd(),e.projectName),a=e.projectName===`.`,s=e.overwriteExisting??!1,u=e.byokProvider??!1,d=e.packageManager??`pnpm`;if(a)await assertCanCreateInPlace(i,s);else if(await pathExists(i))throw Error(`Cannot create project because "${i}" already exists.`);let f=e.typesNodePackageVersion??`25.9.1`,p={appName:basename(i),model:e.model,evePackageVersion:resolveVersionToken(`evePackageVersion`,e.evePackageVersion??`0.7.2`),aiPackageVersion:resolveVersionToken(`aiPackageVersion`,e.aiPackageVersion??`7.0.0-canary.171`),zodPackageVersion:resolveVersionToken(`zodPackageVersion`,e.zodPackageVersion??`4.4.3`),tsgoPackageVersion:resolveVersionToken(`tsgoPackageVersion`,e.tsgoPackageVersion??`7.0.0-dev.20260523.1`),typesNodePackageVersion:u?resolveVersionToken(`typesNodePackageVersion`,f):f};await mkdir(i,{recursive:!0});for(let[r,o]of Object.entries(templateFiles(u,d))){let c=`${i}/${r}`,l=await pathExists(c);await writeTextFile(c,renderTemplate(o,p),{force:a&&s}),l&&await e.onOverwriteFile?.(c)}return i}async function isEveProject(e){for(let t of SUPPORTED_AUTHORED_MODULE_FILE_EXTENSIONS)try{return await stat(join(e,`agent`,`agent${t}`)),!0}catch{}return!1}export{CURRENT_DIRECTORY_PROJECT_NAME,DEFAULT_AI_PACKAGE_VERSION,DEFAULT_EVE_PACKAGE_VERSION,DEFAULT_ZOD_PACKAGE_VERSION,agentTemplateFiles,byokProviderEnvVar,formatEveDependencySpecifier,isEveProject,modelProviderSlug,scaffoldBaseProject};

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

@@ -1,7 +1,7 @@
-export { CURRENT_DIRECTORY_PROJECT_NAME, isEveProject, scaffoldBaseProject, type ScaffoldBaseProjectOptions, } from "./project.js";
-export { DEFAULT_SLACK_CONNECTOR_SLUG, SLACK_CHANNEL_DEFAULT_ROUTE, deriveSlackConnectorSlug, ensureChannel, listAuthoredChannels, normalizeSlackConnectorSlug, type ChannelKind, type ChannelMutationResult, type EnsureChannelOptions, type SlackConnectorSlug, type WebPackageVersions, } from "./channels.js";
+export { byokProviderEnvVar, CURRENT_DIRECTORY_PROJECT_NAME, isEveProject, scaffoldBaseProject, type ScaffoldBaseProjectOptions, } from "./create/project.js";
+export { DEFAULT_SLACK_CONNECTOR_SLUG, SLACK_CHANNEL_DEFAULT_ROUTE, deriveSlackConnectorSlug, ensureChannel, isNextJsProject, listAuthoredChannels, normalizeSlackConnectorSlug, type ChannelKind, type ChannelMutationResult, type EnsureChannelOptions, type SlackConnectorSlug, type WebPackageVersions, } from "./update/channels.js";
 export { SCAFFOLDABLE_CHANNELS, type ScaffoldableChannel } from "./channels-catalog.js";
-export { ensureConnection, listAuthoredConnections, type ConnectionInput, type ConnectionMutationAction, type ConnectionMutationResult, type EnsureConnectionOptions, } from "./connections.js";
+export { ensureConnection, listAuthoredConnections, type ConnectionInput, type ConnectionMutationAction, type ConnectionMutationResult, type EnsureConnectionOptions, } from "./update/connections.js";
 export { catalogSlugs, CONNECTION_CATALOG, CUSTOM_CONNECTION_SLUG, effectiveProtocols, endpointForProtocol, getCatalogEntry, isValidConnectionSlug, SUPPORTED_PROTOCOLS, type ConnectionAuthSpec, type ConnectionCatalogEntry, type ConnectionProtocol, type CustomConnectionInput, type EnvHeader, type McpEndpoint, type OpenApiEndpoint, } from "./connections/catalog.js";
 export { WriteFileExistsError } from "./files.js";
-export { HumanActionRequiredError, type HumanAction } from "./human-action.js";
+export { HumanActionRequiredError, type HumanAction } from "../human-action.js";

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

@@ -1 +1 @@
-import{SCAFFOLDABLE_CHANNELS}from"./channels-catalog.js";import{WriteFileExistsError}from"./files.js";import{CURRENT_DIRECTORY_PROJECT_NAME,isEveProject,scaffoldBaseProject}from"./project.js";import{DEFAULT_SLACK_CONNECTOR_SLUG,SLACK_CHANNEL_DEFAULT_ROUTE,deriveSlackConnectorSlug,ensureChannel,listAuthoredChannels,normalizeSlackConnectorSlug}from"./channels.js";import{CONNECTION_CATALOG,CUSTOM_CONNECTION_SLUG,SUPPORTED_PROTOCOLS,catalogSlugs,effectiveProtocols,endpointForProtocol,getCatalogEntry,isValidConnectionSlug}from"./connections/catalog.js";import{ensureConnection,listAuthoredConnections}from"./connections.js";import{HumanActionRequiredError}from"./human-action.js";export{CONNECTION_CATALOG,CURRENT_DIRECTORY_PROJECT_NAME,CUSTOM_CONNECTION_SLUG,DEFAULT_SLACK_CONNECTOR_SLUG,HumanActionRequiredError,SCAFFOLDABLE_CHANNELS,SLACK_CHANNEL_DEFAULT_ROUTE,SUPPORTED_PROTOCOLS,WriteFileExistsError,catalogSlugs,deriveSlackConnectorSlug,effectiveProtocols,endpointForProtocol,ensureChannel,ensureConnection,getCatalogEntry,isEveProject,isValidConnectionSlug,listAuthoredChannels,listAuthoredConnections,normalizeSlackConnectorSlug,scaffoldBaseProject};
+import{HumanActionRequiredError}from"../human-action.js";import{SCAFFOLDABLE_CHANNELS}from"./channels-catalog.js";import{CONNECTION_CATALOG,CUSTOM_CONNECTION_SLUG,SUPPORTED_PROTOCOLS,catalogSlugs,effectiveProtocols,endpointForProtocol,getCatalogEntry,isValidConnectionSlug}from"./connections/catalog.js";import{WriteFileExistsError}from"./files.js";import{CURRENT_DIRECTORY_PROJECT_NAME,byokProviderEnvVar,isEveProject,scaffoldBaseProject}from"./create/project.js";import{DEFAULT_SLACK_CONNECTOR_SLUG,SLACK_CHANNEL_DEFAULT_ROUTE,deriveSlackConnectorSlug,ensureChannel,isNextJsProject,listAuthoredChannels,normalizeSlackConnectorSlug}from"./update/channels.js";import{ensureConnection,listAuthoredConnections}from"./update/connections.js";export{CONNECTION_CATALOG,CURRENT_DIRECTORY_PROJECT_NAME,CUSTOM_CONNECTION_SLUG,DEFAULT_SLACK_CONNECTOR_SLUG,HumanActionRequiredError,SCAFFOLDABLE_CHANNELS,SLACK_CHANNEL_DEFAULT_ROUTE,SUPPORTED_PROTOCOLS,WriteFileExistsError,byokProviderEnvVar,catalogSlugs,deriveSlackConnectorSlug,effectiveProtocols,endpointForProtocol,ensureChannel,ensureConnection,getCatalogEntry,isEveProject,isNextJsProject,isValidConnectionSlug,listAuthoredChannels,listAuthoredConnections,normalizeSlackConnectorSlug,scaffoldBaseProject};

package/dist/src/setup/scaffold/{channels.d.ts → update/channels.d.ts}

@@ -1,3 +1,4 @@
+import type { PackageManagerKind } from "../../package-manager.js";
 export declare const SLACK_CHANNEL_DEFAULT_ROUTE = "/eve/v1/slack";
 export declare const DEFAULT_SLACK_CONNECTOR_SLUG = "my-agent";
 declare const slackConnectorSlugBrand: unique symbol;
@@ -50,11 +51,21 @@ interface WebChannelSkippedResult {
     packageJsonUpdated: [];
 }
 type WebChannelMutationResult = WebChannelWrittenResult | WebChannelSkippedResult;
+/**
+ * Whether the project already carries a Next.js app: `package.json` declares a
+ * `next` dependency in any dependency field. This is the exact predicate the
+ * web scaffold skips on (`skipReason: "nextjs-project"`), so pickers can mark
+ * Web Chat as already present precisely when scaffolding would be a no-op.
+ * A missing `package.json` reads as "no app".
+ */
+export declare function isNextJsProject(projectRoot: string): Promise<boolean>;
 export declare function normalizeSlackConnectorSlug(input: string): SlackConnectorSlug;
 export declare function deriveSlackConnectorSlug(projectRoot: string, projectNameHint?: string): Promise<SlackConnectorSlug>;
 export interface EnsureChannelOptions {
     projectRoot: string;
     kind: ChannelKind;
+    /** Manager that owns generated project configuration. Defaults to pnpm. */
+    packageManager?: PackageManagerKind;
     force?: boolean;
     slackConnectorSlug?: SlackConnectorSlug;
     connectPackageVersion?: string;

package/dist/src/setup/scaffold/update/channels.js

@@ -0,0 +1,7 @@
+import{getPackageManagerStrategy}from"../../primitives/pm/index.js";import{pathExists,writeTextFile}from"../files.js";import{patchPackageJson}from"./package-json.js";import{resolveVersionToken}from"../version-tokens.js";import{getSupportedModuleBaseName,matchesSupportedModuleBaseName}from"./module-files.js";import{WEB_APP_TEMPLATE_FILES,WEB_APP_TEMPLATE_PACKAGE_JSON}from"../create/web-template.js";import"../create/project.js";import{basename,join,resolve}from"node:path";import{readFile,readdir,writeFile}from"node:fs/promises";const SLACK_CHANNEL_DEFAULT_ROUTE=`/eve/v1/slack`,DEFAULT_SLACK_CONNECTOR_SLUG=`my-agent`,PACKAGE_DEPENDENCY_FIELDS=[`dependencies`,`devDependencies`,`peerDependencies`,`optionalDependencies`],WEB_NEXT_CONFIG_PATH=`next.config.ts`,WEB_VERCEL_JSON_PATH=`vercel.json`,WEB_VERCEL_JSON_SCHEMA=`https://openapi.vercel.sh/vercel.json`,WEB_COMPETING_NEXT_CONFIG_PATHS=[`next.config.js`,`next.config.mjs`,WEB_NEXT_CONFIG_PATH,`next.config.mts`].filter(e=>e!==WEB_NEXT_CONFIG_PATH),WEB_DEFAULT_VERCEL_SERVICES={web:{entrypoint:`.`,framework:`nextjs`,routePrefix:`/`},eve:{buildCommand:`eve build`,entrypoint:`.`,framework:`eve`,routePrefix:`/_eve_internal/eve`}};function toSlackConnectorSlug(e){return e}function isJsonObject(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}async function readDependencyVersion(e,t){let n=JSON.parse(await readFile(e,`utf8`));if(!isJsonObject(n)||!isJsonObject(n.dependencies))return;let r=n.dependencies[t];return typeof r==`string`?r:void 0}function packageJsonHasDependency(e,t){for(let n of PACKAGE_DEPENDENCY_FIELDS){let r=e[n];if(isJsonObject(r)&&typeof r[t]==`string`)return!0}return!1}async function hasPackageDependency(e,n){if(!await pathExists(e))return!1;let r=JSON.parse(await readFile(e,`utf8`));return isJsonObject(r)&&packageJsonHasDependency(r,n)}async function isNextJsProject(e){return hasPackageDependency(join(e,`package.json`),`next`)}async function ensurePackageDependency(e,n,i){return!await pathExists(e)||await readDependencyVersion(e,n)===i?[]:(await patchPackageJson(e,{dependencies:{[n]:i}}),[{path:e,dependencies:[n],devDependencies:[],scripts:[]}])}function resolveWebPackageVersions(e){return{evePackageVersion:e?.evePackageVersion??`0.7.2`,aiPackageVersion:e?.aiPackageVersion??`7.0.0-canary.171`,nextPackageVersion:e?.nextPackageVersion??`16.2.6`,reactPackageVersion:e?.reactPackageVersion??`19.2.6`,reactDomPackageVersion:e?.reactDomPackageVersion??`19.2.6`,streamdownPackageVersion:e?.streamdownPackageVersion??`2.5.0`,zodPackageVersion:e?.zodPackageVersion??`4.4.3`,tsgoPackageVersion:e?.tsgoPackageVersion??`7.0.0-dev.20260523.1`,typesNodePackageVersion:e?.typesNodePackageVersion??`25.9.1`,typesReactPackageVersion:e?.typesReactPackageVersion??`19.2.15`,typesReactDomPackageVersion:e?.typesReactDomPackageVersion??`19.2.3`}}function formatEveDependencySpecifier(e){return/^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z-.]+)?$/.test(e)?`^${e}`:e}async function patchWebPackageJson(e,n){if(!await pathExists(e))return[];let a={...WEB_APP_TEMPLATE_PACKAGE_JSON.dependencies,ai:resolveVersionToken(`aiPackageVersion`,n.aiPackageVersion),eve:formatEveDependencySpecifier(resolveVersionToken(`evePackageVersion`,n.evePackageVersion)),next:resolveVersionToken(`nextPackageVersion`,n.nextPackageVersion),react:resolveVersionToken(`reactPackageVersion`,n.reactPackageVersion),"react-dom":resolveVersionToken(`reactDomPackageVersion`,n.reactDomPackageVersion),streamdown:resolveVersionToken(`streamdownPackageVersion`,n.streamdownPackageVersion),zod:resolveVersionToken(`zodPackageVersion`,n.zodPackageVersion)},o={...WEB_APP_TEMPLATE_PACKAGE_JSON.devDependencies,"@types/node":resolveVersionToken(`typesNodePackageVersion`,n.typesNodePackageVersion),"@types/react":resolveVersionToken(`typesReactPackageVersion`,n.typesReactPackageVersion),"@types/react-dom":resolveVersionToken(`typesReactDomPackageVersion`,n.typesReactDomPackageVersion),"@typescript/native-preview":resolveVersionToken(`tsgoPackageVersion`,n.tsgoPackageVersion)},s=WEB_APP_TEMPLATE_PACKAGE_JSON.scripts;return await patchPackageJson(e,{dependencies:a,devDependencies:o,scripts:s}),[{path:e,dependencies:Object.keys(a),devDependencies:Object.keys(o),scripts:Object.keys(s)}]}function normalizeSlackConnectorSlug(e){return toSlackConnectorSlug((e.trim().replace(/^@/,``).split(`/`).at(-1)??``).toLowerCase().replace(/[^a-z0-9_-]+/g,`-`).replace(/^[^a-z0-9]+/,``).replace(/[^a-z0-9]+$/,``).slice(0,100).replace(/[^a-z0-9]+$/,``)||`my-agent`)}async function deriveSlackConnectorSlug(e,t){if(t!==void 0&&t.length>0&&t!==`.`)return normalizeSlackConnectorSlug(t);try{let t=await readFile(join(e,`package.json`),`utf8`),n=JSON.parse(t);if(typeof n.name==`string`&&n.name.length>0)return normalizeSlackConnectorSlug(n.name)}catch{}return normalizeSlackConnectorSlug(basename(resolve(e))||`my-agent`)}function buildSlackTemplate(e){return`import { connectSlackCredentials } from "@vercel/connect/eve";
+import { slackChannel } from "eve/channels/slack";
+
+export default slackChannel({
+  credentials: connectSlackCredentials("slack/${e}"),
+});
+`}function renderWebAppTemplate(e,t,n){let r=n?``:`, { configureVercelOutput: false }`;return e.replaceAll(`__EVE_INIT_APP_NAME__`,t).replaceAll(`__EVE_INIT_WITH_EVE_OPTIONS__`,r)}function withWebVercelServices(e){let t=JSON.parse(e);if(!isJsonObject(t))throw Error(`${WEB_VERCEL_JSON_PATH} must contain a JSON object.`);let n=t.experimentalServices;if(n!==void 0&&!isJsonObject(n))throw Error(`${WEB_VERCEL_JSON_PATH} experimentalServices must contain a JSON object.`);let r={...t,$schema:typeof t.$schema==`string`?t.$schema:WEB_VERCEL_JSON_SCHEMA,experimentalServices:{...n,web:n?.web??WEB_DEFAULT_VERCEL_SERVICES.web,eve:n?.eve??WEB_DEFAULT_VERCEL_SERVICES.eve}};return JSON.stringify(t)===JSON.stringify(r)?e:`${JSON.stringify(r,null,2)}\n`}async function ensureWebVercelServices(e){if(!await pathExists(e))return await writeTextFile(e,`${JSON.stringify({$schema:WEB_VERCEL_JSON_SCHEMA,experimentalServices:WEB_DEFAULT_VERCEL_SERVICES},null,2)}\n`,{force:!0}),`written`;let r=await readFile(e,`utf8`),i=withWebVercelServices(r);return i===r?`skipped`:(await writeFile(e,i,`utf8`),`written`)}async function findCompetingNextConfigFiles(e){let n=[];for(let r of WEB_COMPETING_NEXT_CONFIG_PATHS){let i=join(e,r);await pathExists(i)&&n.push(i)}return n}async function ensureChannel(e){switch(e.kind){case`slack`:return ensureSlackChannel({...e,kind:`slack`});case`web`:return ensureWebChannel({...e,kind:`web`})}}async function ensureWebChannel(r){let i=join(r.projectRoot,`package.json`),a=await pathExists(join(r.projectRoot,`app/page.tsx`));if(!r.force&&await isNextJsProject(r.projectRoot))return{kind:`web`,action:`skipped`,skipReason:`nextjs-project`,filesWritten:[],filesSkipped:[i],packageJsonUpdated:[]};let o=await patchWebPackageJson(i,resolveWebPackageVersions(r.webPackageVersions)),c=[],u=[],d=[],f=[],p=basename(resolve(r.projectRoot)),m=r.configureVercelServices??!0;if(m){let e=join(r.projectRoot,WEB_VERCEL_JSON_PATH);await ensureWebVercelServices(e)===`written`?c.push(e):f.push(e)}let h=await getPackageManagerStrategy(r.packageManager??`pnpm`).applyProjectConfiguration(r.projectRoot);c.push(...h.filesWritten),f.push(...h.filesSkipped);for(let[e,i]of Object.entries(WEB_APP_TEMPLATE_FILES)){let a=join(r.projectRoot,e);if(e===`agent/channels/eve.ts`&&!r.force&&await pathExists(a)){f.push(a);continue}let o=await pathExists(a);await writeTextFile(a,renderWebAppTemplate(i,p,m),{force:!0}),c.push(a),o&&u.push(a)}d.push(...await findCompetingNextConfigFiles(r.projectRoot));let g={kind:`web`,action:a?`overwritten`:`created`,filesWritten:c,filesSkipped:f,packageJsonUpdated:o};return u.length>0&&(g.filesOverwritten=u),d.length>0&&(g.competingNextConfigFiles=d),g}async function ensureSlackChannel(e){let r=join(e.projectRoot,`agent/channels/slack.ts`),a=await pathExists(r);if(!e.force&&a)return{kind:`slack`,action:`skipped`,filesWritten:[],filesSkipped:[r],packageJsonUpdated:[]};let o=resolveVersionToken(`connectPackageVersion`,e.connectPackageVersion??`0.2.2`),s=await ensurePackageDependency(join(e.projectRoot,`package.json`),`@vercel/connect`,o),c=e.slackConnectorSlug??await deriveSlackConnectorSlug(e.projectRoot);await writeTextFile(r,buildSlackTemplate(c),{force:e.force});let l={kind:`slack`,action:a?`overwritten`:`created`,filesWritten:[r],filesSkipped:[],packageJsonUpdated:s,slackConnectorSlug:c};return a&&(l.filesOverwritten=[r]),l}async function listAuthoredChannels(e){let t=join(e,`agent/channels`),n;try{n=await readdir(t,{withFileTypes:!0})}catch(e){if(e.code===`ENOENT`)return[];throw e}let r=[];for(let e of n){if(e.isFile()){let t=getSupportedModuleBaseName(e.name);t!==null&&r.push(t);continue}if(e.isDirectory())try{(await readdir(join(t,e.name))).some(e=>matchesSupportedModuleBaseName(e,`connection`))&&r.push(e.name)}catch{}}return r.sort()}export{DEFAULT_SLACK_CONNECTOR_SLUG,SLACK_CHANNEL_DEFAULT_ROUTE,deriveSlackConnectorSlug,ensureChannel,isNextJsProject,listAuthoredChannels,normalizeSlackConnectorSlug};

package/dist/src/setup/scaffold/{connections.d.ts → update/connections.d.ts}

@@ -1,4 +1,4 @@
-import { type ConnectionCatalogEntry, type ConnectionProtocol, type CustomConnectionInput } from "./connections/catalog.js";
+import { type ConnectionCatalogEntry, type ConnectionProtocol, type CustomConnectionInput } from "../connections/catalog.js";
 import type { PackageJsonMutation } from "./channels.js";
 export type ConnectionMutationAction = "created" | "overwritten" | "skipped";
 export interface ConnectionMutationResult {

package/dist/src/setup/scaffold/update/connections.js

@@ -0,0 +1,21 @@
+import{endpointForProtocol}from"../connections/catalog.js";import{pathExists,writeTextFile}from"../files.js";import{patchPackageJson}from"./package-json.js";import{resolveVersionToken}from"../version-tokens.js";import{getSupportedModuleBaseName,matchesSupportedModuleBaseName}from"./module-files.js";import{join}from"node:path";import{readFile,readdir,writeFile}from"node:fs/promises";const CONNECT_PACKAGE_NAME=`@vercel/connect`,USER_AUTHORED_CONNECTION_DIR=`agent/connections`;function resolveAuth(e){return e.auth??{kind:`none`}}function envKeysForAuth(e){switch(e.kind){case`bearer-env`:return[e.envVar];case`header`:return e.headers.map(e=>e.envVar);case`connect`:case`none`:return[]}}function authBlock(e){switch(e.kind){case`connect`:return`  auth: connect("${e.connector}"),\n`;case`bearer-env`:return`  auth: { getToken: async () => ({ token: process.env.${e.envVar}! }) },\n`;case`header`:return`  headers: () => ({\n${e.headers.map(e=>`    "${e.header}": process.env.${e.envVar}!,`).join(`
+`)}\n  }),\n`;case`none`:return``}}function renderMcpTemplate(e,t,n){return`${n.kind===`connect`?`import { connect } from "@vercel/connect/eve";
+import { defineMcpClientConnection } from "eve/connections";
+`:`import { defineMcpClientConnection } from "eve/connections";
+`}
+export default defineMcpClientConnection({
+  url: "${e.url}",
+  description: "${t}",
+${authBlock(n)}});
+`}function renderOpenApiTemplate(e,t,n){let r=n.kind===`connect`?`import { connect } from "@vercel/connect/eve";
+import { defineOpenAPIConnection } from "eve/connections";
+`:`import { defineOpenAPIConnection } from "eve/connections";
+`,i=e.baseUrl?`  baseUrl: "${e.baseUrl}",\n`:``;return`${r}
+export default defineOpenAPIConnection({
+  spec: "${e.spec}",
+${i}  description: "${t}",
+${authBlock(n)}});
+`}function renderTemplate(e,t,n,r){return e===`mcp`?renderMcpTemplate(t,n,r):renderOpenApiTemplate(t,n,r)}function isJsonObject(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}async function ensureConnectDependency(e,n){if(!await pathExists(e))return[];let i=JSON.parse(await readFile(e,`utf8`));return(isJsonObject(i)&&isJsonObject(i.dependencies)?i.dependencies[CONNECT_PACKAGE_NAME]:void 0)===n?[]:(await patchPackageJson(e,{dependencies:{[CONNECT_PACKAGE_NAME]:n}}),[{path:e,dependencies:[CONNECT_PACKAGE_NAME],devDependencies:[],scripts:[]}])}function envKeyPresent(e,t){return RegExp(`^\\s*(?:export\\s+)?${t}\\s*=`,`m`).test(e)}async function seedEnvPlaceholders(e,n){if(n.length===0)return[];let r=``;await pathExists(e)&&(r=await readFile(e,`utf8`));let i=n.filter(e=>!envKeyPresent(r,e));if(i.length===0)return[];let a=`${r.length>0&&!r.endsWith(`
+`)?`
+`:``}${i.map(e=>`${e}=`).join(`
+`)}\n`;return await writeFile(e,r+a,`utf8`),i}async function ensureConnection(r){let a=r.slug??r.entry.slug,o=resolveAuth(r.entry),s=endpointForProtocol(r.entry,r.protocol);if(s===null)throw Error(`Connection "${a}" is missing a ${r.protocol===`mcp`?`mcp.url`:`openapi.spec`} endpoint for protocol "${r.protocol}".`);let c=join(r.projectRoot,USER_AUTHORED_CONNECTION_DIR,`${a}.ts`),l=envKeysForAuth(o),u=await pathExists(c);if(!r.force&&u)return{slug:a,protocol:r.protocol,action:`skipped`,filePath:c,filesWritten:[],filesSkipped:[c],packageJsonUpdated:[],envKeysAdded:[],envKeysRequired:l};let d=[];if(o.kind===`connect`){let e=resolveVersionToken(`connectPackageVersion`,r.connectPackageVersion??`0.2.2`);d.push(...await ensureConnectDependency(join(r.projectRoot,`package.json`),e))}await writeTextFile(c,renderTemplate(r.protocol,s,r.entry.description,o),{force:!0});let f=await seedEnvPlaceholders(join(r.projectRoot,`.env.local`),l),p={slug:a,protocol:r.protocol,action:u?`overwritten`:`created`,filePath:c,filesWritten:[c],filesSkipped:[],packageJsonUpdated:d,envKeysAdded:f,envKeysRequired:l};return u&&(p.filesOverwritten=[c]),p}async function listAuthoredConnections(e){let t=join(e,USER_AUTHORED_CONNECTION_DIR),n;try{n=await readdir(t,{withFileTypes:!0})}catch(e){if(e.code===`ENOENT`)return[];throw e}let r=[];for(let e of n){if(e.isFile()){let t=getSupportedModuleBaseName(e.name);t!==null&&r.push(t);continue}if(e.isDirectory())try{(await readdir(join(t,e.name))).some(e=>matchesSupportedModuleBaseName(e,`connection`))&&r.push(e.name)}catch{}}return r.sort()}export{ensureConnection,listAuthoredConnections};

package/dist/src/setup/scaffold/version-tokens.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Returns a scaffold version value, resolving a build-stamp token at the point
+ * of need when the running code is unstamped. The published package is stamped
+ * by the build (`scripts/stamp-version-tokens.mjs`), so the fallback only ever
+ * fires in a dev tree — tsgo watch emits and tests running from `src` — where
+ * the live workspace catalog *is* the truth the stamp would have captured.
+ * Outside a dev tree an unstamped token still throws, because writing the
+ * literal token into a scaffolded package.json would break the generated
+ * project.
+ */
+export declare function resolveVersionToken(field: string, value: string): string;

package/dist/src/setup/scaffold/version-tokens.js

@@ -0,0 +1 @@
+import{dirname,join}from"node:path";import{existsSync,readFileSync,realpathSync}from"node:fs";import{fileURLToPath}from"node:url";function versionToken(e){return`__${e}_VERSION__`}const TOKEN_SOURCES={[versionToken(`EVE_PACKAGE`)]:{kind:`eve-version`},[versionToken(`AI_SDK`)]:{kind:`catalog`,packageName:`ai`},[versionToken(`VERCEL_CONNECT`)]:{kind:`catalog`,packageName:`@vercel/connect`},[versionToken(`NEXT`)]:{kind:`catalog`,packageName:`next`},[versionToken(`REACT`)]:{kind:`catalog`,packageName:`react`},[versionToken(`REACT_DOM`)]:{kind:`catalog`,packageName:`react-dom`},[versionToken(`STREAMDOWN`)]:{kind:`catalog`,packageName:`streamdown`},[versionToken(`ZOD`)]:{kind:`catalog`,packageName:`zod`},[versionToken(`TSGO`)]:{kind:`catalog`,packageName:`@typescript/native-preview`},[versionToken(`TYPES_NODE`)]:{kind:`catalog`,packageName:`@types/node`},[versionToken(`TYPES_REACT`)]:{kind:`catalog`,packageName:`@types/react`},[versionToken(`TYPES_REACT_DOM`)]:{kind:`catalog`,packageName:`@types/react-dom`}},resolvedTokens=new Map;function findEvePackageRoot(){let o=dirname(realpathSync(fileURLToPath(import.meta.url)));for(;;){let i=join(o,`package.json`);if(existsSync(i)&&JSON.parse(readFileSync(i,`utf8`)).name===`eve`)return o;let a=dirname(o);if(a===o)return;o=a}}function findWorkspaceManifest(r){let i=r;for(;;){let r=join(i,`pnpm-workspace.yaml`);if(existsSync(r))return r;let a=dirname(i);if(a===i)return;i=a}}function readCatalogVersion(e,t){let n=readFileSync(e,`utf8`).split(/\r?\n/),i=!1;for(let e of n){if(/^catalog:\s*$/.test(e)){i=!0;continue}if(!i)continue;if(/^\S/.test(e))break;let n=e.match(/^\s+(?:"([^"]+)"|([\w@/.-]+)):\s*"([^"]+)"/);if(n&&(n[1]??n[2])===t)return n[3]}}function resolveTokenFromDevTree(e){let i=TOKEN_SOURCES[e];if(i!==void 0)try{let e=findEvePackageRoot();if(e===void 0||!existsSync(join(e,`scripts/stamp-version-tokens.mjs`)))return;if(i.kind===`eve-version`){let n=JSON.parse(readFileSync(join(e,`package.json`),`utf8`));return typeof n.version==`string`?n.version:void 0}let a=findWorkspaceManifest(e);return a===void 0?void 0:readCatalogVersion(a,i.packageName)}catch{return}}function resolveVersionToken(e,t){if(!t.startsWith(`__`))return t;let n=resolvedTokens.get(t);if(n!==void 0)return n;let r=resolveTokenFromDevTree(t);if(r===void 0)throw Error(`Scaffold received unstamped version token (${e}=${t}). Build eve before using its dist entrypoint.`);return resolvedTokens.set(t,r),r}export{resolveVersionToken};

package/dist/src/setup/{scaffold/steps/setup-slackbot.d.ts → slackbot.d.ts}

@@ -1,17 +1,13 @@
-import type { ChannelSetupPrompter } from "../cli/channel-setup-prompter.js";
-/** Controls prompting and connector naming while creating a Slackbot. */
-export interface SetupSlackbotOptions {
-    /** Skip the prompt and run the create flow when true. */
-    presetCreate?: boolean;
-    /** Connector short-name passed to `vercel connect create slack --name`. */
-    slackbotName?: string;
+import { type ChannelSetupLog } from "#setup/cli/index.js";
+import { captureVercel, runVercel, runVercelCaptureStdout } from "#setup/primitives/run-vercel.js";
+/** Injected for tests; defaults to the real Vercel CLI subprocess primitives. */
+export interface SlackbotProvisionDeps {
+    captureVercel: typeof captureVercel;
+    runVercel: typeof runVercel;
+    runVercelCaptureStdout: typeof runVercelCaptureStdout;
 }
 /** Outcome of the Connect create-and-attach sequence for a Slackbot. */
-export type SetupSlackbotResult = {
-    kind: "skipped";
-    created: false;
-    attached: false;
-} | {
+export type ProvisionSlackbotResult = {
     kind: "create-failed";
     created: false;
     attached: false;
@@ -32,17 +28,17 @@ export type SetupSlackbotResult = {
     workspaceUrl?: string;
     workspaceName?: string;
 };
+/** Identifiers returned by Vercel Connect for a Slack connector. */
+export interface SlackConnectorRef {
+    uid: string;
+    id: string;
+}
 /**
  * Reads the connector identifiers from `vercel connect create … -F json`
  * stdout, the authoritative source for the just-created connector's UID.
  * Returns `undefined` when stdout is empty or not the expected JSON.
  */
 export declare function parseCreatedSlackConnector(stdout: string): SlackConnectorRef | undefined;
-/** Identifiers returned by Vercel Connect for a Slack connector. */
-export interface SlackConnectorRef {
-    uid: string;
-    id: string;
-}
 /**
  * Finds the expected connector, or the newest Slack connector already attached to this project.
  */
@@ -54,10 +50,18 @@ export declare function parseInstallation(body: unknown): {
 } | undefined;
 /**
  * Creates a Slack Connect client, replaces its default trigger destination with the Eve route,
- * and resolves workspace details when Connect reports them.
+ * and resolves workspace details when Connect reports them. Promptless: progress streams
+ * through the rail-styled `log`, and the result union carries every failure mode for the
+ * caller to act on.
+ *
+ * Known quirk, preserved deliberately: a `connector-unresolved` result reports
+ * `created: true`, but callers discard that fact (nothing is recorded), so a rerun
+ * creates a second connector instead of adopting the unresolved one.
  */
-export declare function setupSlackbot(prompter: ChannelSetupPrompter, projectRoot: string, options?: SetupSlackbotOptions): Promise<SetupSlackbotResult>;
+export declare function provisionSlackbot(log: ChannelSetupLog, projectRoot: string, 
+/** Connector short-name passed to `vercel connect create slack --name`. */
+slug: string, deps?: SlackbotProvisionDeps): Promise<ProvisionSlackbotResult>;
 /**
  * Patches a connector UID chosen by Connect before the caller deploys the channel definition.
  */
-export declare function reconcileSlackUid(prompter: ChannelSetupPrompter, projectRoot: string, slackbot: SetupSlackbotResult, expectedUid: string): Promise<boolean>;
+export declare function reconcileSlackUid(log: ChannelSetupLog, projectRoot: string, slackbot: ProvisionSlackbotResult, expectedUid: string): Promise<boolean>;

package/dist/src/setup/slackbot.js

@@ -0,0 +1 @@
+import{join}from"node:path";import{SLACK_CHANNEL_DEFAULT_ROUTE}from"#setup/scaffold/index.js";import{readFile}from"node:fs/promises";import{createPromptCommandOutput}from"#setup/cli/index.js";import{captureVercel,runVercel,runVercelCaptureStdout}from"#setup/primitives/run-vercel.js";import{updateSlackChannelConnectorUid}from"#setup/scaffold/update/update-slack-channel.js";const defaultDeps={captureVercel,runVercel,runVercelCaptureStdout},LOOKUP_TIMEOUT_MS=6e4,ATTACH_TIMEOUT_MS=2*6e4;function parseCreatedSlackConnector(e){let t=e.trim();if(!t)return;let n;try{n=JSON.parse(t)}catch{return}if(typeof n!=`object`||!n)return;let{uid:r,id:i}=n;if(!(typeof r!=`string`||typeof i!=`string`))return{uid:r,id:i}}async function readProjectId(t){try{let r=await readFile(join(t,`.vercel`,`project.json`),`utf8`),i=JSON.parse(r);return typeof i.projectId==`string`?i.projectId:void 0}catch{return}}function pickSlackConnector(e,t,n){if(typeof e!=`object`||!e)return;let r=e,i=r.connectors??r.clients;if(!Array.isArray(i))return;let a;for(let e of i){if(e.type!==`slack`||typeof e.uid!=`string`||typeof e.id!=`string`)continue;let r={uid:e.uid,id:e.id};if(n!==void 0&&r.uid===n)return r;let i=typeof e.createdAt==`number`?e.createdAt:0;t!==void 0&&Array.isArray(e.projects)&&e.projects.some(e=>typeof e==`object`&&!!e&&e.id===t)&&(!a||i>a.createdAt)&&(a={ref:r,createdAt:i})}return a?.ref}function parseInstallation(e){if(typeof e!=`object`||!e)return;let t=e.installations;if(!Array.isArray(t)||t.length===0)return;let n=t[0];if(typeof n.tenantUrl==`string`)return{workspaceUrl:n.tenantUrl,workspaceName:typeof n.tenantName==`string`?n.tenantName:void 0}}async function findSlackConnector(e,t,n,r,i){let a=await e.captureVercel([`connect`,`list`,`-F`,`json`,`--all-projects`],{cwd:t,onOutput:i,timeoutMs:LOOKUP_TIMEOUT_MS});if(a.ok)try{return pickSlackConnector(JSON.parse(a.stdout),n,r)}catch{return}}async function fetchInstallationInfo(e,t,n,r){let i=await e.captureVercel([`api`,`/v1/connex/clients/${n}/installations`],{cwd:t,onOutput:r,timeoutMs:LOOKUP_TIMEOUT_MS});if(i.ok)try{return parseInstallation(JSON.parse(i.stdout))}catch{return}}async function withPhase(e,t,n){let r=e.spinner?.(t);r||e.message(t);try{return await n()}finally{r?.stop()}}async function provisionSlackbot(e,n,i,a=defaultDeps){let o=createPromptCommandOutput(e),s=await readProjectId(n),c=`slack/${i}`,l=await withPhase(e,`Creating a Slackbot through Vercel Connect...`,()=>a.runVercelCaptureStdout([`connect`,`create`,`slack`,`--triggers`,`--name`,i,`-F`,`json`],{cwd:n,onOutput:o,timeoutMs:6e5}));if(!l.ok)return{kind:`create-failed`,created:!1,attached:!1};e.success(`Slackbot created via Vercel Connect.`);let u=parseCreatedSlackConnector(l.stdout);if(u||=await withPhase(e,`Locating the Slack connector...`,()=>findSlackConnector(a,n,s,c,o)),!u)return e.warning("Could not locate the Slack connector. Run `vercel connect list --all-projects` to find its UID."),{kind:`connector-unresolved`,created:!0,attached:!1};let d=u;if(e.info(`Slack connector: ${d.uid}`),!await withPhase(e,`Configuring Slack event delivery for this agent...`,async()=>(await a.runVercel([`connect`,`detach`,d.uid,`--yes`],{cwd:n,onOutput:o,timeoutMs:ATTACH_TIMEOUT_MS}),a.runVercel([`connect`,`attach`,d.uid,`--triggers`,`--trigger-path`,SLACK_CHANNEL_DEFAULT_ROUTE,`--yes`],{cwd:n,onOutput:o,timeoutMs:ATTACH_TIMEOUT_MS}))))return e.warning(`Could not register this project as a trigger destination. Run \`vercel connect attach ${d.uid} --triggers --trigger-path ${SLACK_CHANNEL_DEFAULT_ROUTE} --yes\` to enable event delivery.`),{kind:`attach-failed`,created:!0,attached:!1,connectorUid:d.uid};let f=await withPhase(e,`Reading Slack workspace details...`,()=>fetchInstallationInfo(a,n,d.id,o));return f?{kind:`attached`,created:!0,attached:!0,connectorUid:d.uid,workspaceUrl:f.workspaceUrl,workspaceName:f.workspaceName}:{kind:`attached`,created:!0,attached:!0,connectorUid:d.uid}}async function reconcileSlackUid(t,n,r,i){if(r.kind!==`attached`||r.connectorUid===i)return!0;t.info(`Connect assigned UID ${r.connectorUid} (expected ${i}). Updating agent/channels/slack.ts before deployment...`);let{patched:a}=await updateSlackChannelConnectorUid(join(n,`agent/channels/slack.ts`),r.connectorUid);return a?!0:(t.warning(`Could not patch agent/channels/slack.ts automatically. Update \`connectSlackCredentials("...")\` to \`"${r.connectorUid}"\` and run \`vercel deploy --prod\`.`),!1)}export{parseCreatedSlackConnector,parseInstallation,pickSlackConnector,provisionSlackbot,reconcileSlackUid};

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

@@ -1,5 +1,5 @@
-import type { ChannelKind } from "#setup/scaffold/index.js";
-import { type AddToAgentState } from "#setup/scaffold/steps/index.js";
+import type { ChannelKind, ConnectionInput, ConnectionProtocol } from "#setup/scaffold/index.js";
+import { type ProjectResolution } from "./project-resolution.js";
 export { CURRENT_DIRECTORY_PROJECT_NAME } from "#setup/scaffold/index.js";
 export type { ChannelKind };
 /** Where the user wants to chat with the agent after scaffolding finishes. */
@@ -97,22 +97,55 @@ export type ResolvedAiGateway = {
 /**
  * How the scaffolded agent reaches a model. `"gateway"` routes through the
  * Vercel AI Gateway (OIDC, or a pasted gateway key). `"self"` scaffolds an
- * inline provider `byok` block reading `process.env`, and skips the model
- * prompt. Decided by the resolve-provisioning box.
+ * inline provider `byok` block reading `process.env`, derived from the model
+ * picked earlier in the interview. Decided by the resolve-provisioning box.
  */
 export type WiringMode = "gateway" | "self";
 /**
- * The in-memory state threaded through every setup box. One state serves both
- * the create wizard and `eve setup`: greenfield onboarding populates every
- * field, while in-project setup starts from the detected on-disk facts and
- * leaves the onboarding-only plans at their defaults.
+ * How much of the onboarding flow runs. `"complete"` is the full interview and
+ * provisioning sequence; `"one-shot"` scaffolds the base template with the
+ * default model and skips everything after the scaffold (provisioning, model,
+ * channels, linking, credentials, connections, deploy, chat). Decided by the
+ * select-setup-mode box right after the target is resolved.
  */
-export interface SetupState extends AddToAgentState {
+export type SetupMode = "complete" | "one-shot";
+/**
+ * One fully-specified connection to scaffold. The select-connections box
+ * resolves everything a prompt could decide (slug, protocol, the entry
+ * definition, and how the connector gets provisioned) during the interview,
+ * so the add-connections box runs effects without prompting.
+ */
+export interface ConnectionPlan {
+    slug: string;
+    protocol: ConnectionProtocol;
+    entry: ConnectionInput;
+    provision: {
+        kind: "connect";
+        service: string;
+    } | {
+        kind: "connect-manual";
+    } | {
+        kind: "command-hint";
+        service: string;
+    } | {
+        kind: "none";
+    };
+}
+/**
+ * The in-memory state threaded through every setup box. Greenfield onboarding
+ * populates every field, while in-project setup starts from the detected
+ * on-disk facts and leaves the onboarding-only plans at their defaults.
+ */
+export interface SetupState {
     agentName: string;
+    /** Decided by the select-setup-mode box; gates every post-scaffold box. */
+    setupMode: SetupMode;
     modelId: string;
     modelWiring: WiringMode;
     /** Channels chosen in the interview phase; scaffolded later by the channels box. */
     channelSelection: ChannelKind[];
+    /** Connections planned in the interview phase; scaffolded later by the connections box. */
+    connectionSelection: ConnectionPlan[];
     /** Decided once by the resolve-provisioning box; executed later by the link box. */
     vercelProject: ResolvedVercelProject;
     /** Decided once by the resolve-provisioning box; executed by the AI Gateway credential box. */
@@ -120,16 +153,30 @@ export interface SetupState extends AddToAgentState {
     projectPath: ResolvedProjectPath;
     aiGatewayCredentials: ResolvedAiGatewayCredentials;
     chat: ChatPreference | null;
+    /** Channels scaffolded so far in this run. */
+    channels: ChannelKind[];
+    webScaffolded: boolean;
+    slackScaffolded: boolean;
+    deploymentDependenciesInstalled: boolean;
+    /** The linked Vercel project facts, from the link box or the on-disk `.vercel` link. */
+    project: ProjectResolution;
+    deploymentPending: boolean;
+    slackbotCreated: boolean;
+    slackbotAttached: boolean;
+    slackConnectorUid: string | undefined;
+    slackWorkspaceUrl: string | undefined;
+    slackWorkspaceName: string | undefined;
 }
 export declare function createDefaultSetupState(): SetupState;
 /**
  * Whether this run has a Vercel project available, planned or already linked.
- * During onboarding the resolve-provisioning box records the plan before any
- * link exists, so the first disjunct drives the channel/connection/deploy
- * gating. During in-project setup there is no plan, but the detected on-disk
- * link resolves `state.project`, so the second disjunct fires instead. In the
- * create flow `state.project` stays unresolved until the link box runs, so the
- * second disjunct only fires when a real link exists.
+ * During onboarding the resolve-provisioning box records the plan at the end
+ * of the interview (after channels and connections), so the first disjunct
+ * drives the post-scaffold deploy gating. During in-project setup there is no
+ * plan, but the detected on-disk link resolves `state.project`, so the second
+ * disjunct fires instead. In the create flow `state.project` stays unresolved
+ * until the link box runs, so the second disjunct only fires when a real link
+ * exists.
  */
 export declare function hasVercelProject(state: Pick<SetupState, "vercelProject" | "project">): boolean;
 export declare function requireProjectPath(state: Pick<SetupState, "projectPath">): string;

package/dist/src/setup/state.js

@@ -1 +1 @@
-import{CURRENT_DIRECTORY_PROJECT_NAME}from"#setup/scaffold/index.js";import{createAddToAgentState,isProjectResolved}from"#setup/scaffold/steps/index.js";function createDefaultSetupState(){return{...createAddToAgentState(),agentName:``,modelId:``,modelWiring:`gateway`,channelSelection:[],vercelProject:{kind:`none`},aiGateway:{kind:`inherit`},projectPath:{kind:`unresolved`,inPlace:!1},aiGatewayCredentials:{kind:`unresolved`},chat:null}}function hasVercelProject(e){return e.vercelProject.kind!==`none`||isProjectResolved(e.project)}function requireProjectPath(e){if(e.projectPath.kind===`resolved`)return e.projectPath.path;throw Error(`Project path has not been resolved.`)}function snapshotSetupState(e){return Object.freeze({...e,aiGatewayCredentials:Object.freeze({...e.aiGatewayCredentials}),aiGateway:Object.freeze({...e.aiGateway}),channelSelection:Object.freeze([...e.channelSelection]),channels:Object.freeze([...e.channels]),project:Object.freeze({...e.project}),projectPath:Object.freeze({...e.projectPath}),vercelProject:Object.freeze({...e.vercelProject})})}export{CURRENT_DIRECTORY_PROJECT_NAME,createDefaultSetupState,hasVercelProject,requireProjectPath,snapshotSetupState};
+import{isProjectResolved}from"./project-resolution.js";import{CURRENT_DIRECTORY_PROJECT_NAME}from"#setup/scaffold/index.js";function createDefaultSetupState(){return{channels:[],webScaffolded:!1,slackScaffolded:!1,deploymentDependenciesInstalled:!1,project:{kind:`unresolved`},deploymentPending:!1,slackbotCreated:!1,slackbotAttached:!1,slackConnectorUid:void 0,slackWorkspaceUrl:void 0,slackWorkspaceName:void 0,agentName:``,setupMode:`complete`,modelId:``,modelWiring:`gateway`,channelSelection:[],connectionSelection:[],vercelProject:{kind:`none`},aiGateway:{kind:`inherit`},projectPath:{kind:`unresolved`,inPlace:!1},aiGatewayCredentials:{kind:`unresolved`},chat:null}}function hasVercelProject(t){return t.vercelProject.kind!==`none`||isProjectResolved(t.project)}function requireProjectPath(e){if(e.projectPath.kind===`resolved`)return e.projectPath.path;throw Error(`Project path has not been resolved.`)}function snapshotSetupState(e){return Object.freeze({...e,aiGatewayCredentials:Object.freeze({...e.aiGatewayCredentials}),aiGateway:Object.freeze({...e.aiGateway}),channelSelection:Object.freeze([...e.channelSelection]),connectionSelection:Object.freeze([...e.connectionSelection]),channels:Object.freeze([...e.channels]),project:Object.freeze({...e.project}),projectPath:Object.freeze({...e.projectPath}),vercelProject:Object.freeze({...e.vercelProject})})}export{CURRENT_DIRECTORY_PROJECT_NAME,createDefaultSetupState,hasVercelProject,requireProjectPath,snapshotSetupState};

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

@@ -2,13 +2,6 @@
 export interface OutputSink {
     write(line: string): void;
 }
-/** Result of the interactive gather face: an input to perform, or a user cancel. */
-export type InteractiveOutcome<Input> = {
-    kind: "done";
-    input: Input;
-} | {
-    kind: "cancelled";
-};
 /**
  * Thrown by the interactive prompter when the user cancels (Ctrl-C, or the
  * two-stage Escape quit). The runner converts it into a cancelled run, so a
@@ -18,11 +11,13 @@ export declare class WizardCancelledError extends Error {
     constructor();
 }
 /**
- * A unit of setup work reusable by both the create wizard and a future
- * `eve setup`. Only the two gather faces are mode-specific; `perform` owns the
- * side effects once and `apply` records the result once, so interactive and
- * headless execution cannot drift. See
- * `research/active/onboarding-step-unification.md`.
+ * A unit of work reusable by programmatic setup and channel-management flows.
+ * Every box has ONE gather for every mode: it asks its questions through an
+ * injected `Asker`, whose composed stack (interactive base, headless base,
+ * answer/policy decorators) decides how each question resolves; a user cancel
+ * propagates as {@link WizardCancelledError} for the runner to fold. `perform`
+ * owns the side effects once and `apply` records the result once, so
+ * interactive and headless execution cannot drift.
  *
  * `Input` is what a user/preset chooses; `Payload` is what `perform` actually
  * did (which may differ from what was requested, e.g. a skipped channel).
@@ -33,14 +28,10 @@ export interface SetupBox<State, Input, Payload> {
     shouldRun?(state: Readonly<State>): boolean;
     /** One-line status for a menu-driven runner (unused by the linear wizard). */
     summary?(state: Readonly<State>): string;
-    /** Interactive face: prompt for the input, or report a cancel. */
-    gatherInteractive(ctx: {
+    /** Mode-agnostic face: resolve the input, asking through the box's asker. */
+    gather(ctx: {
         state: Readonly<State>;
         initial?: Input;
-    }): Promise<InteractiveOutcome<Input>>;
-    /** Non-interactive face: derive the input from the box's options and state. */
-    gatherHeadless(ctx: {
-        state: Readonly<State>;
     }): Promise<Input>;
     /** The only side-effecting step. Must be idempotent: detect current files,
      *  link state, and connectors before mutating, so a rerun converges. */

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

@@ -1,7 +1,7 @@
-import { createPromptCommandOutput } from "#setup/scaffold/cli/index.js";
-import { type VercelCaptureFailure } from "#setup/scaffold/primitives/index.js";
-import { type ProjectResolution } from "#setup/scaffold/steps/index.js";
+import { createPromptCommandOutput } from "#setup/cli/index.js";
+import { type VercelCaptureFailure } from "#setup/primitives/index.js";
 import { z } from "zod";
+import type { ProjectResolution } from "./project-resolution.js";
 import type { Prompter } from "./prompter.js";
 import type { ResolvedVercelProjectSpec } from "./state.js";
 declare const VercelTeamListEntrySchema: z.ZodObject<{
@@ -21,6 +21,12 @@ declare const VercelProjectReferenceSchema: z.ZodObject<{
 }, z.core.$strip>;
 type VercelProjectReference = z.infer<typeof VercelProjectReferenceSchema>;
 export declare function unresolvedProject(): ProjectResolution;
+/**
+ * Runs a network reach behind a section-like spinner so the user sees the CLI
+ * is working, not hung. The spinner clears whether the work resolves or throws,
+ * and degrades to nothing when the prompter has no spinner (headless/test).
+ */
+export declare function withNetworkSpinner<T>(prompter: Prompter, message: string, task: () => Promise<T>): Promise<T>;
 /** Resolves the linked project id from a resolution, if any. */
 export declare function projectIdFromResolution(project: ProjectResolution): string | undefined;
 /** Lists the Vercel scopes available to the current CLI user. */
@@ -43,6 +49,12 @@ export declare function requireVercelLogin(failure?: VercelCaptureFailure): neve
  * API error) is surfaced verbatim rather than mislabeled as a login problem.
  */
 export declare function requireAuth(projectRoot: string, prompter?: Prompter): Promise<void>;
+/**
+ * Non-throwing auth probe: whether the Vercel CLI has a logged-in user. Used
+ * where authentication changes a decision (e.g. adopting an existing link)
+ * rather than being a precondition to enforce.
+ */
+export declare function isVercelAuthenticated(projectRoot: string): Promise<boolean>;
 /**
  * Resolves a passed team slug, or the current scope when unset, to a concrete
  * slug so every provisioning command can pass an explicit `--scope`.
@@ -81,11 +93,6 @@ export interface ArgsPickedProject {
 export declare function pickProject(prompter: Prompter, projectRoot: string, team: string): Promise<ArgsPickedProject>;
 /** Returns a project name for a new Vercel project, prompting when the default exists. */
 export declare function pickNewProjectName(prompter: Prompter, projectRoot: string, team: string, defaultProjectName: string): Promise<string>;
-/**
- * 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>;
 /**
  * Ensures the concrete project exists (creating it for a `new` plan) and links
  * this directory to it. Pure executor: it acts on a fully-resolved spec and