eve 0.71.3 → 0.72.0

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

@@ -5,6 +5,7 @@ import type { Prompter } from "../prompter.js";
 import type { ProvisioningMode, ResolvedAiGateway, ResolvedVercelProject, SetupState, WiringMode } from "../state.js";
 import type { SetupBox } from "../step.js";
 import { assertNewProjectNameAvailable, isVercelAuthenticated, pickNewProjectName, pickProject, pickTeam, requireAuth, resolveProjectByNameOrId, resolveTeam, validateTeam } from "../vercel-project.js";
+import type { VercelTeamRequirement } from "../vercel-project-api.js";
 /** Injected for tests; defaults to the real Vercel project and fs helpers. */
 export interface ResolveProvisioningDeps {
     requireAuth: typeof requireAuth;
@@ -47,6 +48,7 @@ export interface ResolveProvisioningOptions {
      */
     projectSelection?: "create-or-link" | "existing-only";
     teamSelectMessage?: (currentTeam: string) => string;
+    teamRequirement?: VercelTeamRequirement;
     deps?: ResolveProvisioningDeps;
 }
 /** Both provisioning plans plus the model wiring they imply. Input and payload. */

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

@@ -1 +1 @@
-import{select,text}from"../ask.js";import{detectProjectResolution,isProjectResolved,mergeProjectResolution}from"../project-resolution.js";import{withSpinner}from"../with-spinner.js";import{pathExists}from"../path-exists.js";import{assertNewProjectNameAvailable,isVercelAuthenticated,pickNewProjectName,pickProject,pickTeam,requireAuth,resolveProjectByNameOrId,resolveTeam,validateTeam}from"../vercel-project.js";import{join,resolve}from"node:path";import{byokProviderEnvVar}from"#setup/scaffold/index.js";import{whimsyFor}from"#setup/cli/index.js";function vercelDemands(e){return{connectSlugs:e.connectionSelection.filter(e=>e.entry.auth?.kind===`connect`).map(e=>e.slug)}}function connectClause(e){let t=e.length===1?`authenticates`:`authenticate`;return`${e.join(`, `)} ${t} through Vercel Connect`}function vercelRequirements(e){let t=[];return e.connectSlugs.length>0&&t.push(connectClause(e.connectSlugs)),t}function resolveProvisioning(e){let t=e.deps??{requireAuth,isVercelAuthenticated,detectProjectResolution,pathExists,validateTeam,resolveTeam,pickTeam,pickProject,pickNewProjectName,assertNewProjectNameAvailable,resolveProjectByNameOrId},parent=()=>resolve(e.targetDirectory??process.cwd());async function detectAdoptableLink(n,r){if(n.projectPath.kind!==`resolved`)return;let i=n.projectPath.path;if(await t.pathExists(join(i,`.vercel`,`project.json`)))return withSpinner(e.prompter,whimsyFor(`project-detect`),async()=>{let e=await t.detectProjectResolution(i,{signal:r});if(isProjectResolved(e)&&await t.isVercelAuthenticated(i,{signal:r}))return e})}async function plansFromFlags(n,r,i,a){if(r.skipVercel)return i.apiKey===void 0?{vercelProject:{kind:`none`},aiGateway:{kind:`byop`},modelWiring:`self`}:{vercelProject:{kind:`none`},aiGateway:{kind:`byok`,apiGatewayKey:i.apiKey},modelWiring:`gateway`};if(r.team===void 0||r.team.length===0)throw Error(`Headless Vercel provisioning requires --team <slug> or --scope <slug> so the current CLI scope is not applied silently.`);await t.requireAuth(parent(),void 0,{signal:a}),await t.validateTeam(e.prompter,parent(),r.team,{signal:a});let o=await t.resolveTeam(parent(),r.team,{signal:a}),s=i.apiKey===void 0?{kind:`inherit`}:{kind:`byok`,apiGatewayKey:i.apiKey},c;if(r.project===void 0)c={kind:`new`,project:n,team:o};else{let e=await t.resolveProjectByNameOrId(parent(),o,r.project,{signal:a});if(e===null)throw Error(`Vercel project "${r.project}" was not found in ${o}.`);c={kind:`existing`,project:e,team:o}}return c.kind===`new`&&await t.assertNewProjectNameAvailable(parent(),o,c.project,{signal:a}),{vercelProject:c,aiGateway:s,modelWiring:`gateway`}}async function promptPlans(n,r){let i=e.prompter,a=n.agentName,o=e.adoptExistingLink===!1?void 0:await detectAdoptableLink(n,r);if(o!==void 0)return i.log.info(`This directory is already linked to a Vercel project, so your agent will run there — the AI Gateway authenticates through your Vercel login.`),{vercelProject:{kind:`none`},aiGateway:{kind:`inherit`},modelWiring:`gateway`,project:o};let s=vercelRequirements(vercelDemands(n)),c=!0;if(s.length>0?i.log.info(`${s.join(` and `)}, so your agent will run on Vercel.`):c=await e.asker.ask(select({key:`deploy`,message:`Where should your agent run?`,options:[{id:`vercel`,value:!0,label:`On Vercel`,hint:`AI Gateway, Durable Workflow, Sandbox, and more`},{id:`local`,value:!1,label:`Locally for now`,hint:`run with eve dev, deploy any time later`}],recommended:!0,required:!0})),c){await t.requireAuth(parent(),i,{signal:r});let n={signal:r,selectMessage:e.teamSelectMessage},o=await t.pickTeam(i,parent(),void 0,n),s=[{value:`new`,label:`Create a new project`,hint:`Name: ${a}`},{value:`link`,label:`Link an existing project`}],c=e.projectSelection!==`existing-only`&&e.prompter.selectEditable?await e.prompter.selectEditable({message:`Vercel project`,options:s,initialValue:`new`,editable:{value:`new`,defaultValue:a,formatHint:e=>`Name: ${e}`,validate:e=>e.trim().length===0?`Project name cannot be empty.`:void 0}}):void 0;if((e.projectSelection===`existing-only`?`link`:c?.value??await e.asker.ask(select({key:`vercel-project`,message:`Vercel project`,options:[{id:`new`,value:`new`,label:`Create a new project`,hint:`Name: ${a}`},{id:`link`,value:`link`,label:`Link an existing project`}],recommended:`new`,required:!0})))===`new`){let e=c?.kind===`edited`?c.text:a;return{vercelProject:{kind:`new`,project:await t.pickNewProjectName(i,parent(),o,e,{signal:r}),team:o},aiGateway:{kind:`inherit`},modelWiring:`gateway`}}return{vercelProject:await t.pickProject(i,parent(),o,{allowCreateWhenEmpty:e.projectSelection!==`existing-only`,suggestedName:a,signal:r}),aiGateway:{kind:`inherit`},modelWiring:`gateway`}}return await e.asker.ask(select({key:`credential`,message:`How should your agent reach the model?`,options:[{id:`api-key`,value:`api-key`,label:`Use my own AI Gateway API key`,hint:`AI_GATEWAY_API_KEY`},{id:`local`,value:`local`,label:`Use my own provider API key`,hint:byokProviderEnvVar(n.modelId)}],recommended:`api-key`,required:!0}))===`api-key`?{vercelProject:{kind:`none`},aiGateway:{kind:`byok`,apiGatewayKey:await e.asker.ask(text({key:`gateway-api-key`,message:`Enter your AI_GATEWAY_API_KEY`,sensitive:!0,environment:`AI_GATEWAY_API_KEY`,validate:e=>e.trim().length===0?`API key cannot be empty.`:null,required:!0}))},modelWiring:`gateway`}:{vercelProject:{kind:`none`},aiGateway:{kind:`byop`},modelWiring:`self`}}return{id:`resolve-provisioning`,async gather({state:t,signal:n}){if(e.mode.headless){let r=await plansFromFlags(t.agentName,e.mode.project,e.mode.aiGateway,n);if(r.vercelProject.kind===`none`){let e=vercelDemands(t);if(e.connectSlugs.length>0)throw Error(`${connectClause(e.connectSlugs)}, which needs a Vercel project. Remove --skip-vercel to add ${e.connectSlugs.length===1?`it`:`them`}.`)}return r}return promptPlans(t,n)},async perform({input:e}){return e},apply(e,t){return{...e,vercelProject:t.vercelProject,aiGateway:t.aiGateway,modelWiring:t.modelWiring,project:t.project===void 0?e.project:mergeProjectResolution(e.project,t.project)}}}}export{resolveProvisioning};
+import{select,text}from"../ask.js";import{detectProjectResolution,isProjectResolved,mergeProjectResolution}from"../project-resolution.js";import{withSpinner}from"../with-spinner.js";import{pathExists}from"../path-exists.js";import{assertNewProjectNameAvailable,isVercelAuthenticated,pickNewProjectName,pickProject,pickTeam,requireAuth,resolveProjectByNameOrId,resolveTeam,validateTeam}from"../vercel-project.js";import{join,resolve}from"node:path";import{byokProviderEnvVar}from"#setup/scaffold/index.js";import{whimsyFor}from"#setup/cli/index.js";function vercelDemands(e){return{connectSlugs:e.connectionSelection.filter(e=>e.entry.auth?.kind===`connect`).map(e=>e.slug)}}function connectClause(e){let t=e.length===1?`authenticates`:`authenticate`;return`${e.join(`, `)} ${t} through Vercel Connect`}function vercelRequirements(e){let t=[];return e.connectSlugs.length>0&&t.push(connectClause(e.connectSlugs)),t}function resolveProvisioning(e){let t=e.deps??{requireAuth,isVercelAuthenticated,detectProjectResolution,pathExists,validateTeam,resolveTeam,pickTeam,pickProject,pickNewProjectName,assertNewProjectNameAvailable,resolveProjectByNameOrId},parent=()=>resolve(e.targetDirectory??process.cwd());async function detectAdoptableLink(n,r){if(n.projectPath.kind!==`resolved`)return;let i=n.projectPath.path;if(await t.pathExists(join(i,`.vercel`,`project.json`)))return withSpinner(e.prompter,whimsyFor(`project-detect`),async()=>{let e=await t.detectProjectResolution(i,{signal:r});if(isProjectResolved(e)&&await t.isVercelAuthenticated(i,{signal:r}))return e})}async function plansFromFlags(n,r,i,a){if(r.skipVercel)return i.apiKey===void 0?{vercelProject:{kind:`none`},aiGateway:{kind:`byop`},modelWiring:`self`}:{vercelProject:{kind:`none`},aiGateway:{kind:`byok`,apiGatewayKey:i.apiKey},modelWiring:`gateway`};if(r.team===void 0||r.team.length===0)throw Error(`Headless Vercel provisioning requires --team <slug> or --scope <slug> so the current CLI scope is not applied silently.`);await t.requireAuth(parent(),void 0,{signal:a}),await t.validateTeam(e.prompter,parent(),r.team,{signal:a});let o=await t.resolveTeam(parent(),r.team,{signal:a}),s=i.apiKey===void 0?{kind:`inherit`}:{kind:`byok`,apiGatewayKey:i.apiKey},c;if(r.project===void 0)c={kind:`new`,project:n,team:o};else{let e=await t.resolveProjectByNameOrId(parent(),o,r.project,{signal:a});if(e===null)throw Error(`Vercel project "${r.project}" was not found in ${o}.`);c={kind:`existing`,project:e,team:o}}return c.kind===`new`&&await t.assertNewProjectNameAvailable(parent(),o,c.project,{signal:a}),{vercelProject:c,aiGateway:s,modelWiring:`gateway`}}async function promptPlans(n,r){let i=e.prompter,a=n.agentName,o=e.adoptExistingLink===!1?void 0:await detectAdoptableLink(n,r);if(o!==void 0)return i.log.info(`This directory is already linked to a Vercel project, so your agent will run there — the AI Gateway authenticates through your Vercel login.`),{vercelProject:{kind:`none`},aiGateway:{kind:`inherit`},modelWiring:`gateway`,project:o};let s=vercelRequirements(vercelDemands(n)),c=!0;if(s.length>0?i.log.info(`${s.join(` and `)}, so your agent will run on Vercel.`):c=await e.asker.ask(select({key:`deploy`,message:`Where should your agent run?`,options:[{id:`vercel`,value:!0,label:`On Vercel`,hint:`AI Gateway, Durable Workflow, Sandbox, and more`},{id:`local`,value:!1,label:`Locally for now`,hint:`run with eve dev, deploy any time later`}],recommended:!0,required:!0})),c){await t.requireAuth(parent(),i,{signal:r});let n={signal:r,selectMessage:e.teamSelectMessage,teamRequirement:e.teamRequirement},o=await t.pickTeam(i,parent(),void 0,n),s=[{value:`new`,label:`Create a new project`,hint:`Name: ${a}`},{value:`link`,label:`Link an existing project`}],c=e.projectSelection!==`existing-only`&&e.prompter.selectEditable?await e.prompter.selectEditable({message:`Vercel project`,options:s,initialValue:`new`,editable:{value:`new`,defaultValue:a,formatHint:e=>`Name: ${e}`,validate:e=>e.trim().length===0?`Project name cannot be empty.`:void 0}}):void 0;if((e.projectSelection===`existing-only`?`link`:c?.value??await e.asker.ask(select({key:`vercel-project`,message:`Vercel project`,options:[{id:`new`,value:`new`,label:`Create a new project`,hint:`Name: ${a}`},{id:`link`,value:`link`,label:`Link an existing project`}],recommended:`new`,required:!0})))===`new`){let e=c?.kind===`edited`?c.text:a;return{vercelProject:{kind:`new`,project:await t.pickNewProjectName(i,parent(),o,e,{signal:r}),team:o},aiGateway:{kind:`inherit`},modelWiring:`gateway`}}return{vercelProject:await t.pickProject(i,parent(),o,{allowCreateWhenEmpty:e.projectSelection!==`existing-only`,suggestedName:a,signal:r}),aiGateway:{kind:`inherit`},modelWiring:`gateway`}}return await e.asker.ask(select({key:`credential`,message:`How should your agent reach the model?`,options:[{id:`api-key`,value:`api-key`,label:`Use my own AI Gateway API key`,hint:`AI_GATEWAY_API_KEY`},{id:`local`,value:`local`,label:`Use my own provider API key`,hint:byokProviderEnvVar(n.modelId)}],recommended:`api-key`,required:!0}))===`api-key`?{vercelProject:{kind:`none`},aiGateway:{kind:`byok`,apiGatewayKey:await e.asker.ask(text({key:`gateway-api-key`,message:`Enter your AI_GATEWAY_API_KEY`,sensitive:!0,environment:`AI_GATEWAY_API_KEY`,validate:e=>e.trim().length===0?`API key cannot be empty.`:null,required:!0}))},modelWiring:`gateway`}:{vercelProject:{kind:`none`},aiGateway:{kind:`byop`},modelWiring:`self`}}return{id:`resolve-provisioning`,async gather({state:t,signal:n}){if(e.mode.headless){let r=await plansFromFlags(t.agentName,e.mode.project,e.mode.aiGateway,n);if(r.vercelProject.kind===`none`){let e=vercelDemands(t);if(e.connectSlugs.length>0)throw Error(`${connectClause(e.connectSlugs)}, which needs a Vercel project. Remove --skip-vercel to add ${e.connectSlugs.length===1?`it`:`them`}.`)}return r}return promptPlans(t,n)},async perform({input:e}){return e},apply(e,t){return{...e,vercelProject:t.vercelProject,aiGateway:t.aiGateway,modelWiring:t.modelWiring,project:t.project===void 0?e.project:mergeProjectResolution(e.project,t.project)}}}}export{resolveProvisioning};

package/dist/src/setup/cli/prompt-ui.d.ts

@@ -111,6 +111,7 @@ export declare function renderMultiselectPrompt<T extends PromptValue>(input: {
     footerNote?: string;
     leadingRail?: "white" | "green";
     message: string;
+    helpText?: string;
     options: readonly PromptOption<T>[];
     selectedValues: readonly T[];
     state: PromptState;
@@ -125,6 +126,7 @@ export declare function renderSelectPrompt<T extends PromptValue>(input: {
     footerNote?: string;
     leadingRail?: "white" | "green";
     message: string;
+    helpText?: string;
     options: readonly PromptOption<T>[];
     state: PromptState;
 }): string;
@@ -143,6 +145,7 @@ export declare function renderSearchableSelect<T extends PromptValue>(input: {
     leadingRail?: "white" | "green";
     message: string;
     multiple: boolean;
+    helpText?: string;
     filter: string;
     placeholder?: string;
     options: readonly PromptOption<T>[];

package/dist/src/setup/cli/prompt-ui.js

@@ -2,4 +2,6 @@ import{UNICODE_ROW_GLYPHS,renderCursorRow,renderOptionRow,renderOptionRowContinu
    `);return`${t.green(`│`)}\n${t.green(`●`)}  ${n}\n`}function formatPromptCancellation(e,t){let n=e.replace(/\n/g,`
    `);return`${t.red(`│`)}\n${t.red(`●`)}  ${t.red(n)}\n`}function formatRailLine(e,t,n){if(e===``)return`${t.green(`│`)}\n`;let r=`${t.green(`│`)}  `;return`${e.split(`
 `).map(e=>e===``?t.green(`│`):wrapTextWithPrefix(n,e,r)).join(`
-`)}\n`}function renderMultiselectPrompt(e){let t=railFor(e.state,e.colors),n=formatPromptHeader(e.state,e.message,{colors:e.colors,leadingRail:e.leadingRail}),r=new Set(e.selectedValues),i=e.options.some(e=>!e.disabled)?``:`\n${t}\n${t}  ${e.colors.dim(`(no channels available to add)`)}`;switch(e.state){case`submit`:{let t=r.size===0?e.colors.dim(`(none selected)`):e.options.filter(e=>r.has(e.value)).map(e=>e.label).join(`, `);return formatPromptSubmission(e.state,e.message,t,{colors:e.colors,leadingRail:e.leadingRail})}case`cancel`:return`${n}${t}  ${e.colors.strikethrough(e.colors.dim(`cancelled`))}\n${t}`;case`error`:{let r=renderMultiselectRows({...e,rail:t});return`${n.trim()}\n${t}  ${r}${i}\n${cornerFor(e.state,e.colors)}  ${e.colors.red(e.error??``)}\n`}case`initial`:case`active`:return`${n}${t}  ${renderMultiselectRows({...e,rail:t})}${i}\n${cornerWithNote(cornerFor(e.state,e.colors),e.footerNote)}\n`}}function cornerWithNote(e,t){return t?`${e}  ${t}`:e}function renderSelectPrompt(e){let t=railFor(e.state,e.colors),n=formatPromptHeader(e.state,e.message,{colors:e.colors,leadingRail:e.leadingRail}),r=e.options[e.cursor];switch(e.state){case`submit`:{let t=r?r.label:``;return formatPromptSubmission(e.state,e.message,t,{colors:e.colors,leadingRail:e.leadingRail})}case`cancel`:return`${n}${t}  ${r?e.colors.strikethrough(e.colors.dim(r.label)):``}\n${t}`;case`initial`:case`active`:case`error`:{let r=labelColumnWidth(e.options);return`${n}${t}  ${e.options.map((n,i)=>{let a=i===e.cursor;return`${optionRow(n,{colors:e.colors,isCursor:a,isChecked:!1,placeholder:!1,hintPadding:r-n.label.length})}${descriptionLine(n,a,t,e.colors)}`}).join(`\n${t}  `)}\n${cornerWithNote(cornerFor(e.state,e.colors),e.footerNote)}\n`}}}function labelColumnWidth(e){return e.reduce((e,t)=>Math.max(e,t.label.length),0)}function optionRow(e,t){return renderOptionRow({colors:t.colors,glyphs:UNICODE_ROW_GLYPHS,label:e.label,hint:e.hint,focusHint:e.focusHint,accent:e.accent,isCursor:t.isCursor,state:resolveOptionRowState(e,t.isChecked),placeholder:t.placeholder,hintPadding:t.hintPadding})}function descriptionLine(e,t,n,r){return t&&e.description&&!e.disabled?`\n${n}  ${renderOptionRowContinuation(r.dim(e.description))}`:``}function renderSubmitRow(e,t,n=`Submit`){let r=t.bold(n),i=e?`${UNICODE_ROW_GLYPHS.selectedPointer} ${r}`:`  ${t.dim(r)}`;return`${renderCursorRow(i,e,t)} ${t.green(UNICODE_ROW_GLYPHS.success)}`}function renderMultiselectRows(e){let t=new Set(e.selectedValues),n=labelColumnWidth(e.options),r=e.options.map((r,i)=>{let a=i===e.cursor;return`${optionRow(r,{colors:e.colors,isCursor:a,isChecked:t.has(r.value),placeholder:!0,hintPadding:n-r.label.length})}${descriptionLine(r,a,e.rail,e.colors)}`}).join(`\n${e.rail}  `),i=renderSubmitRow(e.cursor===e.options.length,e.colors,e.submitLabel);return`${r}\n${e.rail}\n${e.rail}  ${i}`}function searchableHelpLine(e,t,n){let r=(n?[[t.cyan(`type`),`to filter`]]:[[t.cyan(`type`),`to filter`],[t.cyan(`enter`),`to select`]]).map(([e,n])=>`${e}${t.dim(` ${n}`)}`).join(t.dim(` · `));return`\n${e}  ${t.dim(`(`)}${r}${t.dim(`)`)}`}function renderSearchableSelect(e){let{colors:t}=e,n=railFor(e.state,t),r=formatPromptHeader(e.state,e.message,{colors:t,leadingRail:e.leadingRail});if(e.state===`submit`)return formatPromptSubmission(e.state,e.message,e.submitDisplay,{colors:t,leadingRail:e.leadingRail});if(e.state===`cancel`)return`${r}${n}  ${t.strikethrough(t.dim(e.filter))}${e.filter.trim()?`\n${n}`:``}`;let i=new Set(e.selectedValues),a=0;for(;e.options[a]?.featured;)a+=1;let o=e.viewSize??8,s=e.filter===``&&a>0?Math.min(a,o):o,c=e.multiple&&e.cursor>=e.options.length,l=!c&&e.cursor>=e.options.length?0:e.cursor,u=t.inverse(` `);e.filter.length>0?u=e.filter+t.inverse(` `):e.placeholder&&(u=t.dim(e.placeholder));let d=Math.max(0,Math.min(l-Math.floor(s/2),Math.max(0,e.options.length-s))),f=Math.min(d+s,e.options.length),p=e.options.slice(d,f),m=labelColumnWidth(p),h=p.length===0?t.dim(`(no matches)`):p.map((r,a)=>{let o=!c&&a+d===l;return`${optionRow(r,{colors:t,isCursor:o,isChecked:e.multiple&&i.has(r.value),placeholder:!1,hintPadding:m-r.label.length})}${descriptionLine(r,o,n,t)}`}).join(`\n${n}  `),g=e.multiple?`\n${n}\n${n}  ${renderSubmitRow(c,t,e.submitLabel)}`:``,_=e.options.length>p.length?`\n${n}  ${t.dim(`↑↓ ${e.options.length} options, showing ${d+1}–${f}`)}`:``,v=searchableHelpLine(n,t,e.multiple),y=`${n}  ${t.dim(` `)} ${u}\n${n}  ${h}${g}${_}${v}`;return e.state===`error`?`${r.trim()}\n${y}\n${cornerFor(e.state,t)}  ${t.red(e.error??``)}\n`:`${r}${y}\n${cornerWithNote(cornerFor(e.state,t),e.footerNote)}\n`}export{CORNER,RAIL,bulletFor,cornerFor,formatPromptCancellation,formatPromptHeader,formatPromptOpener,formatPromptOutro,formatPromptSubmission,formatRailLine,railFor,renderMultiselectPrompt,renderSearchableSelect,renderSelectPrompt};
+`)}\n`}function renderMultiselectPrompt(e){let t=railFor(e.state,e.colors),n=formatPromptHeader(e.state,e.message,{colors:e.colors,leadingRail:e.leadingRail}),r=new Set(e.selectedValues),i=e.options.some(e=>!e.disabled)?``:`\n${t}\n${t}  ${e.colors.dim(`(no channels available to add)`)}`;switch(e.state){case`submit`:{let t=r.size===0?e.colors.dim(`(none selected)`):e.options.filter(e=>r.has(e.value)).map(e=>e.label).join(`, `);return formatPromptSubmission(e.state,e.message,t,{colors:e.colors,leadingRail:e.leadingRail})}case`cancel`:return`${n}${t}  ${e.colors.strikethrough(e.colors.dim(`cancelled`))}\n${t}`;case`error`:{let r=renderMultiselectRows({...e,rail:t});return`${n.trim()}\n${t}  ${r}${i}${selectHelpText(e.helpText,t,e.colors)}\n${cornerFor(e.state,e.colors)}  ${e.colors.red(e.error??``)}\n`}case`initial`:case`active`:{let r=renderMultiselectRows({...e,rail:t}),a=cornerWithNote(cornerFor(e.state,e.colors),e.footerNote);return`${n}${t}  ${r}${i}${selectHelpText(e.helpText,t,e.colors)}\n${a}\n`}}}function selectHelpText(e,t,n){return e?`\n${t}\n${e.split(`
+`).map(e=>wrapTextWithPrefix(process.stdout,n.dim(e),`${t}  `)).join(`
+`)}\n${t}`:``}function cornerWithNote(e,t){return t?`${e}  ${t}`:e}function renderSelectPrompt(e){let t=railFor(e.state,e.colors),n=formatPromptHeader(e.state,e.message,{colors:e.colors,leadingRail:e.leadingRail}),r=e.options[e.cursor];switch(e.state){case`submit`:{let t=r?r.label:``;return formatPromptSubmission(e.state,e.message,t,{colors:e.colors,leadingRail:e.leadingRail})}case`cancel`:return`${n}${t}  ${r?e.colors.strikethrough(e.colors.dim(r.label)):``}\n${t}`;case`initial`:case`active`:case`error`:{let r=labelColumnWidth(e.options),i=e.options.map((n,i)=>{let a=i===e.cursor;return`${optionRow(n,{colors:e.colors,isCursor:a,isChecked:!1,placeholder:!1,hintPadding:r-n.label.length})}${descriptionLine(n,a,t,e.colors)}`}).join(`\n${t}  `),a=cornerWithNote(cornerFor(e.state,e.colors),e.footerNote);return`${n}${t}  ${i}${selectHelpText(e.helpText,t,e.colors)}\n${a}\n`}}}function labelColumnWidth(e){return e.reduce((e,t)=>Math.max(e,t.label.length),0)}function optionRow(e,t){return renderOptionRow({colors:t.colors,glyphs:UNICODE_ROW_GLYPHS,label:e.label,hint:e.hint,focusHint:e.focusHint,accent:e.accent,isCursor:t.isCursor,state:resolveOptionRowState(e,t.isChecked),placeholder:t.placeholder,hintPadding:t.hintPadding})}function descriptionLine(e,t,n,r){return t&&e.description&&!e.disabled?`\n${n}  ${renderOptionRowContinuation(r.dim(e.description))}`:``}function renderSubmitRow(e,t,n=`Submit`){let r=t.bold(n),i=e?`${UNICODE_ROW_GLYPHS.selectedPointer} ${r}`:`  ${t.dim(r)}`;return`${renderCursorRow(i,e,t)} ${t.green(UNICODE_ROW_GLYPHS.success)}`}function renderMultiselectRows(e){let t=new Set(e.selectedValues),n=labelColumnWidth(e.options),r=e.options.map((r,i)=>{let a=i===e.cursor;return`${optionRow(r,{colors:e.colors,isCursor:a,isChecked:t.has(r.value),placeholder:!0,hintPadding:n-r.label.length})}${descriptionLine(r,a,e.rail,e.colors)}`}).join(`\n${e.rail}  `),i=renderSubmitRow(e.cursor===e.options.length,e.colors,e.submitLabel);return`${r}\n${e.rail}\n${e.rail}  ${i}`}function searchableHelpLine(e,t,n){let r=(n?[[t.cyan(`type`),`to filter`]]:[[t.cyan(`type`),`to filter`],[t.cyan(`enter`),`to select`]]).map(([e,n])=>`${e}${t.dim(` ${n}`)}`).join(t.dim(` · `));return`\n${e}  ${t.dim(`(`)}${r}${t.dim(`)`)}`}function renderSearchableSelect(e){let{colors:t}=e,n=railFor(e.state,t),r=formatPromptHeader(e.state,e.message,{colors:t,leadingRail:e.leadingRail});if(e.state===`submit`)return formatPromptSubmission(e.state,e.message,e.submitDisplay,{colors:t,leadingRail:e.leadingRail});if(e.state===`cancel`)return`${r}${n}  ${t.strikethrough(t.dim(e.filter))}${e.filter.trim()?`\n${n}`:``}`;let i=new Set(e.selectedValues),a=0;for(;e.options[a]?.featured;)a+=1;let o=e.viewSize??8,s=e.filter===``&&a>0?Math.min(a,o):o,c=e.multiple&&e.cursor>=e.options.length,l=!c&&e.cursor>=e.options.length?0:e.cursor,u=t.inverse(` `);e.filter.length>0?u=e.filter+t.inverse(` `):e.placeholder&&(u=t.dim(e.placeholder));let d=Math.max(0,Math.min(l-Math.floor(s/2),Math.max(0,e.options.length-s))),f=Math.min(d+s,e.options.length),p=e.options.slice(d,f),m=labelColumnWidth(p),h=p.length===0?t.dim(`(no matches)`):p.map((r,a)=>{let o=!c&&a+d===l;return`${optionRow(r,{colors:t,isCursor:o,isChecked:e.multiple&&i.has(r.value),placeholder:!1,hintPadding:m-r.label.length})}${descriptionLine(r,o,n,t)}`}).join(`\n${n}  `),g=e.multiple?`\n${n}\n${n}  ${renderSubmitRow(c,t,e.submitLabel)}`:``,_=e.options.length>p.length?`\n${n}  ${t.dim(`↑↓ ${e.options.length} options, showing ${d+1}–${f}`)}`:``,v=searchableHelpLine(n,t,e.multiple),y=`${n}  ${t.dim(` `)} ${u}\n${n}  ${h}${g}${_}${selectHelpText(e.helpText,n,t)}${v}`;return e.state===`error`?`${r.trim()}\n${y}\n${cornerFor(e.state,t)}  ${t.red(e.error??``)}\n`:`${r}${y}\n${cornerWithNote(cornerFor(e.state,t),e.footerNote)}\n`}export{CORNER,RAIL,bulletFor,cornerFor,formatPromptCancellation,formatPromptHeader,formatPromptOpener,formatPromptOutro,formatPromptSubmission,formatRailLine,railFor,renderMultiselectPrompt,renderSearchableSelect,renderSelectPrompt};

package/dist/src/setup/cli/select-component.d.ts

@@ -73,6 +73,7 @@ export declare class SelectComponent extends Prompt<string | string[]> {
  */
 export declare function runSelectComponent<T extends PromptValue>(input: {
     message: string;
+    helpText?: string;
     options: readonly PromptOption<T>[];
     multiple: boolean;
     search: boolean;

package/dist/src/setup/cli/select-component.js

@@ -1 +1 @@
-import{renderMultiselectPrompt,renderSearchableSelect,renderSelectPrompt}from"./prompt-ui.js";import{createSelectOptionCodec}from"./select-option-codec.js";import{filterOptions,initialSelectState,orderedSelection,reduceSelect,searchActionQuery,selectValueAtCursor,submitRowIndex}from"./select-state.js";import pc from"#compiled/picocolors/index.js";import{Prompt,isCancel}from"#compiled/@clack/core/index.js";function toPromptState(e){return e}var SelectComponent=class extends Prompt{options;multiple;search;searchAction;required;filter=``;optionCursor=0;selectedSet=new Set;constructor(e){super({render:e.render,validate:()=>this.submitError()},!1),this.options=e.options,this.multiple=e.multiple,this.search=e.search,this.searchAction=e.searchAction,this.required=e.required,this.filter=e.initial.filter,this.optionCursor=e.initial.cursor,this.selectedSet=e.initial.selected,this.refreshValue(),this.on(`key`,(e,t)=>{if(this.multiple&&t?.name===`space`){this.apply({type:`toggle`});return}if(this.search){if(t?.name===`backspace`||e===``||e===`\b`){this.apply({type:`backspace`});return}e!==void 0&&e.length===1&&e>=` `&&e!==``&&this.apply({type:`char`,char:e})}}),this.on(`cursor`,e=>{e===`up`||e===`left`?this.apply({type:`up`}):(e===`down`||e===`right`)&&this.apply({type:`down`})})}visibleOptions(){return filterOptions(this.options,this.filter,this.searchAction)}onSubmitRow(){return this.multiple&&this.optionCursor===submitRowIndex(this.visibleOptions())}submitLabel(){if(this.required)return`Submit`;let e=new Set(this.options.filter(e=>e.locked).map(e=>e.value));return[...this.selectedSet].some(t=>!e.has(t))?`Submit`:`Skip`}_shouldSubmit(){return this.multiple?this.onSubmitRow()?!0:(this.apply({type:`toggle`}),!1):this.visibleOptions()[this.optionCursor]?.completed!==!0}selectedValues(){if(this.multiple)return orderedSelection(this.options,this.selectedSet);let e=selectValueAtCursor(this.visibleOptions(),this.optionCursor);return e===void 0?[]:[e]}submitDisplay(){if(this.multiple){let e=this.options.filter(e=>this.selectedSet.has(e.value)).map(e=>e.label);return e.length>0?e.join(`, `):pc.dim(`(none selected)`)}let e=selectValueAtCursor(this.visibleOptions(),this.optionCursor);return e===void 0?``:this.labelForValue(e)}labelForValue(e){let t=searchActionQuery(e);return t!==void 0&&this.searchAction!==void 0?this.searchAction.label(t):this.options.find(t=>t.value===e)?.label??e}submitError(){return this.multiple?this.required&&this.selectedSet.size===0?`Select at least one option, then press enter.`:void 0:selectValueAtCursor(this.visibleOptions(),this.optionCursor)===void 0?`Type to match an option, then press enter.`:void 0}apply(e){let t=reduceSelect({filter:this.filter,cursor:this.optionCursor,selected:this.selectedSet},e,{options:this.options,searchAction:this.searchAction,submitRow:this.multiple});this.filter=t.filter,this.optionCursor=t.cursor,this.selectedSet=t.selected,this.refreshValue()}refreshValue(){this.value=this.multiple?orderedSelection(this.options,this.selectedSet):selectValueAtCursor(this.visibleOptions(),this.optionCursor)}};function renderSelectComponent(e,t,n,r){let i=toPromptState(e.state);return e.search?renderSearchableSelect({colors:pc,state:i,leadingRail:n,message:t.message,multiple:e.multiple,filter:e.filter,placeholder:t.placeholder,options:e.visibleOptions(),cursor:e.optionCursor,selectedValues:e.selectedValues(),submitDisplay:e.submitDisplay(),footerNote:r,error:e.error,submitLabel:e.submitLabel()}):e.multiple?renderMultiselectPrompt({colors:pc,cursor:e.optionCursor,error:e.error,footerNote:r,leadingRail:n,message:t.message,options:e.options,selectedValues:e.selectedValues(),state:i,submitLabel:e.submitLabel()}):renderSelectPrompt({colors:pc,cursor:e.optionCursor,footerNote:r,leadingRail:n,message:t.message,options:e.options,state:i})}async function runSelectComponent(e){let t=createSelectOptionCodec(e.options),n=initialSelectState({options:t.options,defaultValue:e.defaultValue===void 0?void 0:t.encode(e.defaultValue),initialValues:e.initialValues?.map(e=>t.encode(e)),submitRow:e.multiple}),r,i,a=new SelectComponent({options:t.options,multiple:e.multiple,search:e.search,searchAction:e.searchAction===void 0?void 0:{label:e.searchAction.label},required:e.required,initial:n,render(){return r?renderSelectComponent(r,{message:e.message,placeholder:e.placeholder},e.leadingRail,i?.note()):``}});r=a,i=e.attachGuard?.(a);let o=await a.prompt();if(isCancel(o))return o;if(o===void 0)throw Error(`Select prompt returned no value.`);if(Array.isArray(o))return o.map(e=>t.decode(e));let s=searchActionQuery(o);return s!==void 0&&e.searchAction!==void 0?e.searchAction.value(s):t.decode(o)}export{SelectComponent,runSelectComponent};
+import{renderMultiselectPrompt,renderSearchableSelect,renderSelectPrompt}from"./prompt-ui.js";import{createSelectOptionCodec}from"./select-option-codec.js";import{filterOptions,initialSelectState,orderedSelection,reduceSelect,searchActionQuery,selectValueAtCursor,submitRowIndex}from"./select-state.js";import pc from"#compiled/picocolors/index.js";import{Prompt,isCancel}from"#compiled/@clack/core/index.js";function toPromptState(e){return e}var SelectComponent=class extends Prompt{options;multiple;search;searchAction;required;filter=``;optionCursor=0;selectedSet=new Set;constructor(e){super({render:e.render,validate:()=>this.submitError()},!1),this.options=e.options,this.multiple=e.multiple,this.search=e.search,this.searchAction=e.searchAction,this.required=e.required,this.filter=e.initial.filter,this.optionCursor=e.initial.cursor,this.selectedSet=e.initial.selected,this.refreshValue(),this.on(`key`,(e,t)=>{if(this.multiple&&t?.name===`space`){this.apply({type:`toggle`});return}if(this.search){if(t?.name===`backspace`||e===``||e===`\b`){this.apply({type:`backspace`});return}e!==void 0&&e.length===1&&e>=` `&&e!==``&&this.apply({type:`char`,char:e})}}),this.on(`cursor`,e=>{e===`up`||e===`left`?this.apply({type:`up`}):(e===`down`||e===`right`)&&this.apply({type:`down`})})}visibleOptions(){return filterOptions(this.options,this.filter,this.searchAction)}onSubmitRow(){return this.multiple&&this.optionCursor===submitRowIndex(this.visibleOptions())}submitLabel(){if(this.required)return`Submit`;let e=new Set(this.options.filter(e=>e.locked).map(e=>e.value));return[...this.selectedSet].some(t=>!e.has(t))?`Submit`:`Skip`}_shouldSubmit(){return this.multiple?this.onSubmitRow()?!0:(this.apply({type:`toggle`}),!1):this.visibleOptions()[this.optionCursor]?.completed!==!0}selectedValues(){if(this.multiple)return orderedSelection(this.options,this.selectedSet);let e=selectValueAtCursor(this.visibleOptions(),this.optionCursor);return e===void 0?[]:[e]}submitDisplay(){if(this.multiple){let e=this.options.filter(e=>this.selectedSet.has(e.value)).map(e=>e.label);return e.length>0?e.join(`, `):pc.dim(`(none selected)`)}let e=selectValueAtCursor(this.visibleOptions(),this.optionCursor);return e===void 0?``:this.labelForValue(e)}labelForValue(e){let t=searchActionQuery(e);return t!==void 0&&this.searchAction!==void 0?this.searchAction.label(t):this.options.find(t=>t.value===e)?.label??e}submitError(){return this.multiple?this.required&&this.selectedSet.size===0?`Select at least one option, then press enter.`:void 0:selectValueAtCursor(this.visibleOptions(),this.optionCursor)===void 0?`Type to match an option, then press enter.`:void 0}apply(e){let t=reduceSelect({filter:this.filter,cursor:this.optionCursor,selected:this.selectedSet},e,{options:this.options,searchAction:this.searchAction,submitRow:this.multiple});this.filter=t.filter,this.optionCursor=t.cursor,this.selectedSet=t.selected,this.refreshValue()}refreshValue(){this.value=this.multiple?orderedSelection(this.options,this.selectedSet):selectValueAtCursor(this.visibleOptions(),this.optionCursor)}};function renderSelectComponent(e,t,n,r){let i=toPromptState(e.state);return e.search?renderSearchableSelect({colors:pc,state:i,leadingRail:n,message:t.message,helpText:t.helpText,multiple:e.multiple,filter:e.filter,placeholder:t.placeholder,options:e.visibleOptions(),cursor:e.optionCursor,selectedValues:e.selectedValues(),submitDisplay:e.submitDisplay(),footerNote:r,error:e.error,submitLabel:e.submitLabel()}):e.multiple?renderMultiselectPrompt({colors:pc,cursor:e.optionCursor,error:e.error,footerNote:r,leadingRail:n,message:t.message,helpText:t.helpText,options:e.options,selectedValues:e.selectedValues(),state:i,submitLabel:e.submitLabel()}):renderSelectPrompt({colors:pc,cursor:e.optionCursor,footerNote:r,leadingRail:n,message:t.message,helpText:t.helpText,options:e.options,state:i})}async function runSelectComponent(e){let t=createSelectOptionCodec(e.options),n=initialSelectState({options:t.options,defaultValue:e.defaultValue===void 0?void 0:t.encode(e.defaultValue),initialValues:e.initialValues?.map(e=>t.encode(e)),submitRow:e.multiple}),r,i,a=new SelectComponent({options:t.options,multiple:e.multiple,search:e.search,searchAction:e.searchAction===void 0?void 0:{label:e.searchAction.label},required:e.required,initial:n,render(){return r?renderSelectComponent(r,{message:e.message,placeholder:e.placeholder,helpText:e.helpText},e.leadingRail,i?.note()):``}});r=a,i=e.attachGuard?.(a);let o=await a.prompt();if(isCancel(o))return o;if(o===void 0)throw Error(`Select prompt returned no value.`);if(Array.isArray(o))return o.map(e=>t.decode(e));let s=searchActionQuery(o);return s!==void 0&&e.searchAction!==void 0?e.searchAction.value(s):t.decode(o)}export{SelectComponent,runSelectComponent};

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

@@ -3,6 +3,7 @@ import { type ResolveProvisioningDeps } from "../boxes/resolve-provisioning.js";
 import type { Prompter } from "../prompter.js";
 import { readProjectLink, type VercelProjectReference } from "../project-resolution.js";
 import { requireAuth } from "../vercel-project.js";
+import { type VercelTeamRequirement } from "../vercel-project-api.js";
 import { runLoginFlow } from "./login.js";
 export interface EnsureVercelProjectDeps {
     resolveProvisioning?: ResolveProvisioningDeps;
@@ -17,5 +18,6 @@ export declare function ensureVercelProject(input: {
     prompter: Prompter;
     signal?: AbortSignal;
     teamSelectMessage?: (currentTeam: string) => string;
+    teamRequirement?: VercelTeamRequirement;
     deps?: Partial<EnsureVercelProjectDeps>;
 }): Promise<VercelProjectReference>;

package/dist/src/setup/flows/ensure-vercel-project.js

@@ -1 +1 @@
-import{interactiveAsker,withAnswers}from"../ask.js";import{readProjectLink}from"../project-resolution.js";import{snapshotSetupState}from"../state.js";import{requireAuth}from"../vercel-project.js";import{linkVercelProject}from"../boxes/link-project.js";import{resolveProvisioning}from"../boxes/resolve-provisioning.js";import{WizardCancelledError}from"../step.js";import{runInteractive}from"../runner.js";import{inProjectSetupState,prompterSink}from"./in-project.js";import{runLoginFlow}from"./login.js";async function ensureVercelProject(e){let t=e.deps?.readProjectLink??readProjectLink,n=await(e.deps?.runLoginFlow??runLoginFlow)({appRoot:e.appRoot,prompter:e.prompter,signal:e.signal,allowLogin:!1});if(n.kind===`cancelled`)throw new WizardCancelledError;n.kind!==`already`&&n.kind!==`logged-in`&&await(e.deps?.requireAuth??requireAuth)(e.appRoot,e.prompter,{signal:e.signal});let r=await t(e.appRoot);if(r!==void 0)return r;let i=inProjectSetupState(e.appRoot,{kind:`unresolved`}),a=[resolveProvisioning({asker:withAnswers({deploy:`vercel`})(interactiveAsker(e.prompter)),prompter:e.prompter,targetDirectory:e.appRoot,mode:{headless:!1},adoptExistingLink:!1,projectSelection:`create-or-link`,teamSelectMessage:e.teamSelectMessage,deps:e.deps?.resolveProvisioning}),linkVercelProject({prompter:e.prompter,deps:e.deps?.linkProject})];if((await runInteractive(a,i,prompterSink(e.prompter),{snapshot:snapshotSetupState,signal:e.signal})).kind===`cancelled`)throw e.signal?.throwIfAborted(),new WizardCancelledError;let o=await t(e.appRoot);if(o===void 0)throw Error(`Vercel project linking failed.`);return o}export{ensureVercelProject};
+import{interactiveAsker,withAnswers}from"../ask.js";import{readProjectLink}from"../project-resolution.js";import{snapshotSetupState}from"../state.js";import{checkTeamRequirement}from"../vercel-project-api.js";import{requireAuth}from"../vercel-project.js";import{linkVercelProject}from"../boxes/link-project.js";import{resolveProvisioning}from"../boxes/resolve-provisioning.js";import{WizardCancelledError}from"../step.js";import{runInteractive}from"../runner.js";import{inProjectSetupState,prompterSink}from"./in-project.js";import{runLoginFlow}from"./login.js";async function ensureVercelProject(e){let t=e.deps?.readProjectLink??readProjectLink,n=await(e.deps?.runLoginFlow??runLoginFlow)({appRoot:e.appRoot,prompter:e.prompter,signal:e.signal,allowLogin:!1});if(n.kind===`cancelled`)throw new WizardCancelledError;n.kind!==`already`&&n.kind!==`logged-in`&&await(e.deps?.requireAuth??requireAuth)(e.appRoot,e.prompter,{signal:e.signal});let r=await t(e.appRoot);if(r!==void 0){if(e.teamRequirement){let t=await checkTeamRequirement(e.appRoot,r.orgId,e.teamRequirement,{signal:e.signal});if(t)throw Error(`Cannot configure the linked Vercel team. ${t} Run \`eve link\` to choose another team, or ask its owner to finish setup.`)}return r}let i=inProjectSetupState(e.appRoot,{kind:`unresolved`}),a=[resolveProvisioning({asker:withAnswers({deploy:`vercel`})(interactiveAsker(e.prompter)),prompter:e.prompter,targetDirectory:e.appRoot,mode:{headless:!1},adoptExistingLink:!1,projectSelection:`create-or-link`,teamSelectMessage:e.teamSelectMessage,teamRequirement:e.teamRequirement,deps:e.deps?.resolveProvisioning}),linkVercelProject({prompter:e.prompter,deps:e.deps?.linkProject})];if((await runInteractive(a,i,prompterSink(e.prompter),{snapshot:snapshotSetupState,signal:e.signal})).kind===`cancelled`)throw e.signal?.throwIfAborted(),new WizardCancelledError;let o=await t(e.appRoot);if(o===void 0)throw Error(`Vercel project linking failed.`);return o}export{ensureVercelProject};

package/dist/src/setup/integrations/discord/api.js

@@ -1 +1 @@
-import{z}from"#compiled/zod/index.js";const DiscordApplicationSchema=z.object({id:z.string(),name:z.string(),verify_key:z.string()});async function discordRequest(e,t,n,r){return r(`https://discord.com/api/v10${t}`,{...n,headers:{authorization:`Bot ${e}`,"content-type":`application/json`,...n.headers}})}async function resolveDiscordApplication(e,t=fetch){let n=await discordRequest(e,`/oauth2/applications/@me`,{method:`GET`},t);if(!n.ok)throw Error(`Discord rejected the bot token (HTTP ${n.status}).`);let r=DiscordApplicationSchema.safeParse(await n.json());if(!r.success)throw Error(`Discord returned incomplete application details.`);return{id:r.data.id,name:r.data.name,publicKey:r.data.verify_key}}async function registerDiscordCommand(e,t,n,r=fetch){let i=await discordRequest(t,`/applications/${encodeURIComponent(e)}/commands`,{method:`POST`,body:JSON.stringify({name:n.name,description:n.description,type:1,options:[{name:`message`,description:`What should the agent do?`,type:3,required:!0}]})},r);if(!i.ok)throw Error(`Discord command registration failed (HTTP ${i.status}).`)}async function configureDiscordInteractionsEndpoint(e,t,n=fetch){let r=await discordRequest(e,`/applications/@me`,{method:`PATCH`,body:JSON.stringify({interactions_endpoint_url:`https://connect.vercel.com/trigger/${encodeURIComponent(t)}`})},n);if(!r.ok)throw Error(`Discord rejected the interactions endpoint (HTTP ${r.status}).`)}export{configureDiscordInteractionsEndpoint,registerDiscordCommand,resolveDiscordApplication};
+import{z}from"#compiled/zod/index.js";const DiscordApplicationSchema=z.object({id:z.string(),name:z.string(),verify_key:z.string()});async function discordRequest(e,t,n,r){return r(`https://discord.com/api/v10${t}`,{...n,headers:{authorization:`Bot ${e}`,"content-type":`application/json`,...n.headers}})}async function resolveDiscordApplication(e,t=fetch){let n=await discordRequest(e,`/oauth2/applications/@me`,{method:`GET`},t);if(!n.ok)throw Error(`Discord rejected the bot token (HTTP ${n.status}).`);let r=DiscordApplicationSchema.safeParse(await n.json());if(!r.success)throw Error(`Discord returned incomplete application details.`);return{id:r.data.id,name:r.data.name,publicKey:r.data.verify_key}}async function registerDiscordCommand(e,t,n,r=fetch){let i=await discordRequest(t,`/applications/${encodeURIComponent(e)}/commands`,{method:`POST`,body:JSON.stringify({name:n.name,description:n.description,type:1,options:[{name:`message`,description:`What should the agent do?`,type:3,required:!0},{name:`file`,description:`A file for the agent to read`,type:11,required:!1}]})},r);if(!i.ok)throw Error(`Discord command registration failed (HTTP ${i.status}).`)}async function configureDiscordInteractionsEndpoint(e,t,n=fetch){let r=await discordRequest(e,`/applications/@me`,{method:`PATCH`,body:JSON.stringify({interactions_endpoint_url:`https://connect.vercel.com/trigger/${encodeURIComponent(t)}`})},n);if(!r.ok)throw Error(`Discord rejected the interactions endpoint (HTTP ${r.status}).`)}export{configureDiscordInteractionsEndpoint,registerDiscordCommand,resolveDiscordApplication};

package/dist/src/setup/integrations/web/auth-options.d.ts

@@ -0,0 +1,4 @@
+import type { VercelTeamRequirement } from "#setup/vercel-project-api.js";
+export declare const WEB_CHAT_TEAM_REQUIREMENT: VercelTeamRequirement;
+export type WebAuthenticationChoice = "vercel" | "custom";
+export declare const WEB_AUTHENTICATION_QUESTION: import("#setup/ask.js").Question<WebAuthenticationChoice>;

package/dist/src/setup/integrations/web/auth-options.js

@@ -0,0 +1 @@
+import{select}from"#setup/ask.js";const WEB_CHAT_TEAM_REQUIREMENT={permissions:{oauth2Application:[`create`,`update`],projectEnvVars:[`create`],projectEnvVarsProduction:[`create`]},disabledReason:`Web Chat sign-in requires app and environment permissions; ask a team owner.`},WEB_AUTHENTICATION_QUESTION=select({key:`web-authentication`,message:`How should people sign in to Web Chat?`,options:[{id:`vercel`,label:`Sign in with Vercel`,hint:`Create a Vercel App for members of the linked project's team.`,value:`vercel`},{id:`custom`,label:`Configure authentication myself`,hint:`Keep the current channel auth; the default rejects production browser requests.`,value:`custom`}],recommended:`vercel`,required:!0});export{WEB_AUTHENTICATION_QUESTION,WEB_CHAT_TEAM_REQUIREMENT};

package/dist/src/setup/integrations/web/auth-scaffold.d.ts

@@ -0,0 +1,7 @@
+/** Checks authored files before provisioning, then returns the local scaffold operation. */
+export declare function prepareWebAuthScaffold(input: {
+    environmentRoot: string;
+    agentAppRoot: string;
+    webRoot?: string;
+    force?: boolean;
+}): Promise<() => Promise<void>>;

package/dist/src/setup/integrations/web/auth-scaffold.js

@@ -0,0 +1 @@
+import{readFile}from"node:fs/promises";import{basename,dirname,join,relative,sep}from"node:path";import{writeTextFile}from"#setup/scaffold/files.js";import{WEB_APP_SIGN_IN_WITH_VERCEL_TEMPLATE_FILES,WEB_APP_TEMPLATE_FILES,WEB_CHANNEL_TEMPLATES}from"#setup/scaffold/create/web-template.js";import{appendEnv}from"#setup/append-env.js";import{resolveWebPackageVersions}from"#setup/scaffold/update/web-options.js";async function readOptional(e){try{return await readFile(e,`utf8`)}catch(e){if(e.code===`ENOENT`)return;throw e}}async function prepareWebAuthScaffold(e){let t=e.webRoot??join(e.environmentRoot,`apps`,`web`),n=join(e.agentAppRoot,`agent`,`channels`,`eve.ts`),r=relative(dirname(n),join(t,`lib`,`auth.js`)).split(sep).join(`/`),i=WEB_CHANNEL_TEMPLATES[`sign-in-with-vercel`].replace(`"@/lib/auth"`,JSON.stringify(r.startsWith(`.`)?r:`./${r}`)),a=[...Object.entries(WEB_APP_SIGN_IN_WITH_VERCEL_TEMPLATE_FILES).filter(([e])=>e!==`app/layout.tsx`).map(([n,r])=>({path:join(t,n),source:r.replaceAll(`__EVE_INIT_APP_NAME__`,()=>JSON.stringify(basename(e.agentAppRoot)).slice(1,-1)),previous:WEB_APP_TEMPLATE_FILES[n]})),{path:n,source:i,previous:WEB_CHANNEL_TEMPLATES.default}];for(let t of a){let n=await readOptional(t.path);if(!e.force&&n!==void 0&&n!==t.source&&n!==t.previous)throw Error(`Could not add Sign in with Vercel because ${t.path} contains authored code. Preserve your changes and integrate auth manually, or retry setup with --overwrite.`)}let o=join(e.environmentRoot,`package.json`);return async()=>{let t=JSON.parse(await readFile(o,`utf8`));t.dependencies={...t.dependencies,"better-auth":t.dependencies?.[`better-auth`]??resolveWebPackageVersions(void 0,`sign-in-with-vercel`).betterAuthPackageVersion};for(let e of a)await writeTextFile(e.path,e.source,{force:!0});await writeTextFile(o,`${JSON.stringify(t,null,2)}\n`,{force:!0}),await appendEnv(join(e.environmentRoot,`.env.example`),{VERCEL_APP_CLIENT_ID:``,VERCEL_APP_CLIENT_SECRET:``,BETTER_AUTH_SECRET:``})}}export{prepareWebAuthScaffold};

package/dist/src/setup/integrations/web/provision-auth.d.ts

@@ -0,0 +1,3 @@
+import type { VercelProjectReference } from "#setup/project-resolution.js";
+/** Provisions team-only browser sign-in without rotating existing project credentials. */
+export declare function provisionWebChatAuth(project: VercelProjectReference, signal?: AbortSignal): Promise<void>;

package/dist/src/setup/integrations/web/provision-auth.js

@@ -0,0 +1 @@
+import{randomBytes}from"node:crypto";import{z}from"#compiled/zod/index.js";import{readVercelCliToken}from"#internal/model-auth/vercel-cli.js";const APP_CONFLICT_RECOVERY="Rename the Vercel project in its settings, then retry `eve add channel/web --skip-install`.",CALLBACK_PATH=`/api/auth/callback/vercel`,TARGETS=[`production`,`preview`],KEYS=[`VERCEL_APP_CLIENT_ID`,`VERCEL_APP_CLIENT_SECRET`,`BETTER_AUTH_SECRET`],AppSchema=z.object({clientId:z.string().min(1),teamId:z.string(),signInFrom:z.string().optional(),scopes:z.array(z.string()),grantTypes:z.record(z.string(),z.boolean()).optional(),clientAuthenticationMethods:z.record(z.string(),z.boolean()).optional(),projectRedirectUris:z.array(z.object({projectId:z.string(),path:z.string()})).optional(),clientSecrets:z.array(z.object({lastFourChars:z.string()})).optional()}),EnvSchema=z.object({id:z.string(),key:z.string(),value:z.string().optional(),target:z.union([z.string(),z.array(z.string())]).optional(),gitBranch:z.string().nullable().optional(),customEnvironmentIds:z.array(z.string()).optional()});var AppApiError=class extends Error{status;code;constructor(e,t){super(e===401||e===403?"Vercel denied Web Chat auth setup. Run `vercel login` and check that you can manage apps and environment variables in this team, or ask a team owner to run setup.":t===`app_limit_reached`?`This team has reached its Vercel App limit. Remove an unused app in team settings and retry.`:t===`app_name_taken`||t===`app_slug_taken`?`A Vercel App with this name or slug already exists. ${APP_CONFLICT_RECOVERY}`:"Vercel could not configure Web Chat authentication. Retry `eve add channel/web --skip-install`."),this.status=e,this.code=t}};function assertMatchingApp(e,t,n){if(e.teamId!==t.orgId||e.signInFrom!==`owning-team`||!e.grantTypes?.authorization_code||!e.clientAuthenticationMethods?.client_secret_post||![`openid`,`email`,`profile`].every(t=>e.scopes.includes(t))||!e.projectRedirectUris?.some(e=>e.projectId===t.projectId&&e.path===CALLBACK_PATH))throw Error(`The existing Vercel App does not match this project's team-only Web Chat settings. ${n?`Check VERCEL_APP_CLIENT_ID and the app in team settings before retrying.`:APP_CONFLICT_RECOVERY}`)}async function provisionWebChatAuth(e,t){let n=await readVercelCliToken();if(!n)throw Error("Run `vercel login` before setting up Sign in with Vercel.");let r=new URLSearchParams({teamId:e.orgId}),request=async(e,i=`GET`,a)=>{let o={method:i,headers:{authorization:`Bearer ${n}`,"content-type":`application/json`},redirect:`error`,signal:t?AbortSignal.any([t,AbortSignal.timeout(15e3)]):AbortSignal.timeout(15e3)};a!==void 0&&(o.body=JSON.stringify(a));let s=await fetch(`https://api.vercel.com${e}?${r}`,o).catch(()=>{throw t?.throwIfAborted(),new AppApiError(0)});if(!s.ok){let e=z.object({error:z.object({code:z.string().optional()})}).safeParse(await s.json().catch(()=>void 0));throw new AppApiError(s.status,e.success?e.data.error.code:void 0)}if(s.status!==204)return s.json().catch(()=>{throw new AppApiError(s.status)})},getApp=async e=>{try{return z.object({app:AppSchema}).parse(await request(`/oauth-apps/${encodeURIComponent(e)}`)).app}catch(e){if(e instanceof AppApiError&&e.code===`invalid_client`)return;throw e}},i=`/v9/projects/${encodeURIComponent(e.projectId)}`,a=z.object({id:z.string(),accountId:z.string(),name:z.string()}).parse(await request(i));if(a.id!==e.projectId||a.accountId!==e.orgId)throw Error(`The linked Vercel project is not available in the selected team.`);let o=z.object({envs:z.array(EnvSchema)}).parse(await request(`${i}/env`)).envs.filter(e=>!e.gitBranch&&!e.customEnvironmentIds?.length),forTarget=(e,t)=>o.find(n=>n.key===e&&(typeof n.target==`string`?[n.target]:n.target??[]).includes(t)),s=new Set(TARGETS.map(e=>forTarget(KEYS[0],e)?.value).filter(Boolean));if(s.size>1||TARGETS.some(e=>(forTarget(KEYS[1],e)||forTarget(KEYS[0],e))&&!forTarget(KEYS[0],e)?.value))throw Error(`Web Chat has conflicting or incomplete Vercel App credentials. Check production and preview environment variables before retrying.`);let c=e.projectId.replace(/^prj_/,``).toLowerCase(),l=`${a.name.slice(0,100)}-web-chat-${c}`.toLowerCase().replace(/[^a-z0-9-]/g,`-`),u=[...s][0],d=await getApp(u??l);if(!d&&u)throw Error(`The configured Vercel App is unavailable. Check VERCEL_APP_CLIENT_ID before retrying.`);if(!d)try{d=AppSchema.parse(await request(`/oauth-apps`,`POST`,{name:`${a.name.slice(0,100)} Web Chat ${c}`,slug:l,projectRedirectUris:[{projectId:e.projectId,path:CALLBACK_PATH}],scopes:[`openid`,`email`,`profile`],grantTypes:{authorization_code:!0},clientAuthenticationMethods:{client_secret_post:!0},signInFrom:`owning-team`}))}catch(e){if(!(e instanceof AppApiError)||(t?.throwIfAborted(),d=await getApp(l).catch(()=>{throw t?.throwIfAborted(),e}),!d))throw e}assertMatchingApp(d,e,u!==void 0);let missingTargets=e=>TARGETS.filter(t=>!forTarget(e,t));if(KEYS.every(e=>missingTargets(e).length===0))return;let f=missingTargets(KEYS[1]);if(f.length&&(d.clientSecrets?.length??0)>=2)throw Error(`This Vercel App has reached its client secret limit. Remove an unused secret in team settings and retry.`);let p=f.length?z.object({clientSecret:z.string().min(4)}).parse(await request(`/v1/apps/${encodeURIComponent(d.clientId)}/secrets`,`POST`,{})).clientSecret:void 0,m={VERCEL_APP_CLIENT_ID:d.clientId,VERCEL_APP_CLIENT_SECRET:p,BETTER_AUTH_SECRET:randomBytes(32).toString(`base64url`)},rollback=async e=>{let t=await Promise.allSettled(e.map(e=>request(`${i}/env/${encodeURIComponent(e.id)}`,`DELETE`))),n=t.some((t,n)=>t.status===`rejected`&&e[n]?.key===KEYS[1]);if(p&&!n&&t.push(...await Promise.allSettled([request(`/oauth-apps/${encodeURIComponent(d.clientId)}/secret/${encodeURIComponent(p.slice(-4))}`,`DELETE`)])),t.some(e=>e.status===`rejected`))throw Error(`Could not save Web Chat auth environment variables. Cleanup was incomplete. Check the project's environment variables and Vercel App client secrets in team settings before retrying.`)},h=z.object({created:z.array(EnvSchema),failed:z.array(z.unknown())}).parse(await request(`/v10/projects/${encodeURIComponent(e.projectId)}/env`,`POST`,KEYS.filter(e=>missingTargets(e).length).map(e=>({key:e,value:m[e],target:missingTargets(e),type:e===KEYS[0]?`plain`:`sensitive`,visibility:e===KEYS[0]?`config`:`secret`}))).catch(async e=>{throw e instanceof AppApiError&&e.status>=400&&e.status<500&&e.status!==408&&e.status!==499&&await rollback([]),e}));if(h.failed.length!==0)throw await rollback(h.created),Error("Could not save Web Chat auth environment variables. Retry `eve add channel/web --skip-install`.")}export{provisionWebChatAuth};

package/dist/src/setup/integrations/web/setup.d.ts

@@ -1,4 +1,9 @@
 import { resolveEveProjectContext } from "#internal/project-context.js";
+import type { RegistrySetupCompletion } from "#setup/registry-setup-protocol.js";
+import type { VercelProjectReference } from "#setup/project-resolution.js";
+import { installScaffoldDependencies } from "../shared/scaffold.js";
+import { prepareWebAuthScaffold } from "./auth-scaffold.js";
+import { provisionWebChatAuth } from "./provision-auth.js";
 import { detectPackageManager, type PackageManagerKind } from "#setup/package-manager.js";
 import { pathExists, writeTextFile } from "#setup/scaffold/files.js";
 import { type SetupApplyContext, type SetupPrepareContext } from "../types.js";
@@ -8,17 +13,17 @@ export interface WebSetupDeps {
     readTextFile(path: string): Promise<string>;
     resolveEveProjectContext: typeof resolveEveProjectContext;
     writeTextFile: typeof writeTextFile;
+    prepareWebAuthScaffold: typeof prepareWebAuthScaffold;
+    provisionWebChatAuth: typeof provisionWebChatAuth;
+    installScaffoldDependencies: typeof installScaffoldDependencies;
 }
 interface WebSetupPlan {
     hosting: "next" | "vercel";
     packageManager: PackageManagerKind;
+    authProject?: VercelProjectReference;
+    rootWebChat?: boolean;
 }
 export declare function prepareWebSetup(context: SetupPrepareContext, deps?: WebSetupDeps): Promise<WebSetupPlan>;
-export declare function applyWebSetup(plan: WebSetupPlan, context: SetupApplyContext, deps?: WebSetupDeps): Promise<{
-    facts: {
-        label: string;
-        value: string;
-    }[];
-}>;
+export declare function applyWebSetup(plan: WebSetupPlan, context: SetupApplyContext, deps?: WebSetupDeps): Promise<RegistrySetupCompletion>;
 export declare const WEB_SETUP: import("../types.js").SetupIntegration;
 export {};

package/dist/src/setup/integrations/web/setup.js

@@ -1,4 +1,4 @@
-import{defineSetupIntegration}from"../types.js";import{readFile}from"node:fs/promises";import{join}from"node:path";import{resolveEveProjectContext}from"#internal/project-context.js";import{detectPackageManager}from"#setup/package-manager.js";import{pathExists,writeTextFile}from"#setup/scaffold/files.js";import{select}from"#setup/ask.js";import{WEB_CHANNEL_TEMPLATES}from"#setup/scaffold/create/web-template.js";const NEXT_HOSTED_CONFIG=`import type { NextConfig } from "next";
+import{defineSetupIntegration}from"../types.js";import{installScaffoldDependencies}from"../shared/scaffold.js";import{prepareWebAuthScaffold}from"./auth-scaffold.js";import{WEB_AUTHENTICATION_QUESTION}from"./auth-options.js";import{provisionWebChatAuth}from"./provision-auth.js";import{readFile}from"node:fs/promises";import{join}from"node:path";import{resolveEveProjectContext}from"#internal/project-context.js";import{detectPackageManager}from"#setup/package-manager.js";import{pathExists,writeTextFile}from"#setup/scaffold/files.js";import{select}from"#setup/ask.js";import{WEB_CHANNEL_TEMPLATES}from"#setup/scaffold/create/web-template.js";const NEXT_HOSTED_CONFIG=`import type { NextConfig } from "next";
 import { withEve } from "eve/next";
 import { fileURLToPath } from "node:url";
 
@@ -25,10 +25,10 @@ export default await withEve({
     { src: "^(.*)$", destination: { type: "service", service: "web" } },
   ],
 });
-`,defaultDeps={detectPackageManager,pathExists,readTextFile:e=>readFile(e,`utf8`),resolveEveProjectContext,writeTextFile};async function prepareWebSetup(e,t=defaultDeps){let n=await t.resolveEveProjectContext(e.appRoot);if(n.kind===`workspace`)throw Error(`Web Chat setup requires a selected workspace agent.`);return{hosting:await e.asker.ask(select({key:`web-hosting`,message:`How should Web Chat and your agents be deployed?`,options:[{id:`vercel`,label:`Vercel services`,hint:`(Recommended) Web Chat and agents deploy as separate services.`,value:`vercel`},{id:`next`,label:`Next.js`,hint:`One Next.js app serves Web Chat and routes agent requests.`,value:`next`}],recommended:`vercel`,required:!0})),packageManager:(await t.detectPackageManager(n.environmentRoot)).kind}}function runScriptCommand(e,t){switch(e){case`npm`:return`npm run ${t}`;case`pnpm`:return`pnpm ${t}`;case`yarn`:return`yarn ${t}`;case`bun`:return`bun run ${t}`}}async function configurePeerServiceScripts(e,t){let n=join(e,`package.json`),r=JSON.parse(await t.readTextFile(n)),i={...r.scripts};i.dev??=`eve dev`,i[`dev:eve`]??=`eve dev`,i[`dev:all`]??=`vercel dev --local`,await t.writeTextFile(n,`${JSON.stringify({...r,scripts:i},null,2)}\n`,{force:!0})}async function assertInstallerOwned(e,t){try{let n=await readFile(e,`utf8`);if(t.includes(n))return}catch(e){if(e.code===`ENOENT`)return;throw e}throw Error(`Could not configure Web Chat because ${e} contains authored configuration. Preserve it and compose the eve integration manually.`)}async function applyWebSetup(e,t,n=defaultDeps){let r=await n.resolveEveProjectContext(t.appRoot);if(r.kind===`workspace`)throw Error(`Web Chat setup requires a selected workspace agent.`);let i=r.kind===`workspace-member`?r.member.appRoot:r.appRoot,a=join(i,`agent`,`channels`,`eve.ts`);(t.force||!await n.pathExists(a))&&await n.writeTextFile(a,WEB_CHANNEL_TEMPLATES.default,{force:t.force});let o=r.kind===`workspace-member`?r.member.name:void 0,s=join(r.environmentRoot,`apps`,`web`);await n.writeTextFile(join(s,`app`,`eve-agent.ts`),`/** Named workspace agent selected by the Web Chat installer. */\nexport const WEB_CHAT_AGENT: string | undefined = ${o===void 0?`undefined`:JSON.stringify(o)};\n`,{force:!0});let c=join(s,`next.config.ts`);await assertInstallerOwned(c,[`import type { NextConfig } from "next";
+`,defaultDeps={detectPackageManager,pathExists,readTextFile:e=>readFile(e,`utf8`),resolveEveProjectContext,writeTextFile,prepareWebAuthScaffold,provisionWebChatAuth,installScaffoldDependencies};async function prepareWebSetup(e,t=defaultDeps){let n=await t.resolveEveProjectContext(e.appRoot);if(n.kind===`workspace`)throw Error(`Web Chat setup requires a selected workspace agent.`);let r=await t.pathExists(join(n.environmentRoot,`app`,`eve-agent.ts`))&&!await t.pathExists(join(n.environmentRoot,`apps`,`web`,`app`,`eve-agent.ts`)),i=r?`next`:await e.asker.ask(select({key:`web-hosting`,message:`How should Web Chat and your agents be deployed?`,options:[{id:`vercel`,label:`Vercel services`,hint:`(Recommended) Web Chat and agents deploy as separate services.`,value:`vercel`},{id:`next`,label:`Next.js`,hint:`One Next.js app serves Web Chat and routes agent requests.`,value:`next`}],recommended:`vercel`,required:!0})),a=await e.asker.ask(WEB_AUTHENTICATION_QUESTION)===`vercel`?await e.resolveVercelProject(`Web Chat sign-in`):void 0,o={hosting:i,packageManager:(await t.detectPackageManager(n.environmentRoot)).kind};return a!==void 0&&(o.authProject=a),r&&(o.rootWebChat=!0),o}function runScriptCommand(e,t){switch(e){case`npm`:return`npm run ${t}`;case`pnpm`:return`pnpm ${t}`;case`yarn`:return`yarn ${t}`;case`bun`:return`bun run ${t}`}}async function configurePeerServiceScripts(e,t){let n=join(e,`package.json`),r=JSON.parse(await t.readTextFile(n)),i={...r.scripts};i.dev??=`eve dev`,i[`dev:eve`]??=`eve dev`,i[`dev:all`]??=`vercel dev --local`,await t.writeTextFile(n,`${JSON.stringify({...r,scripts:i},null,2)}\n`,{force:!0})}async function assertInstallerOwned(e,t){try{let n=await readFile(e,`utf8`);if(t.includes(n))return}catch(e){if(e.code===`ENOENT`)return;throw e}throw Error(`Could not configure Web Chat because ${e} contains authored configuration. Preserve it and compose the eve integration manually.`)}async function applyWebSetup(e,t,n=defaultDeps){let r=await n.resolveEveProjectContext(t.appRoot);if(r.kind===`workspace`)throw Error(`Web Chat setup requires a selected workspace agent.`);let i=r.kind===`workspace-member`?r.member.appRoot:r.appRoot,a=join(i,`agent`,`channels`,`eve.ts`),o=e.rootWebChat?r.environmentRoot:join(r.environmentRoot,`apps`,`web`),s=e.authProject===void 0?void 0:await n.prepareWebAuthScaffold({environmentRoot:r.environmentRoot,agentAppRoot:i,webRoot:o,force:t.force});s===void 0&&(t.force||!await n.pathExists(a))&&await n.writeTextFile(a,WEB_CHANNEL_TEMPLATES.default,{force:t.force});let c=r.kind===`workspace-member`?r.member.name:void 0;await n.writeTextFile(join(o,`app`,`eve-agent.ts`),`/** Named workspace agent selected by the Web Chat installer. */\nexport const WEB_CHAT_AGENT: string | undefined = ${c===void 0?`undefined`:JSON.stringify(c)};\n`,{force:!0});let l=join(o,`next.config.ts`),u=`import type { NextConfig } from "next";
 import { withEve } from "eve/next";
 
 const nextConfig: NextConfig = {};
 
 export default withEve(nextConfig);
-`,NEXT_HOSTED_CONFIG,PEER_SERVICE_NEXT_CONFIG]);let l;if(e.hosting===`vercel`){let e=join(r.environmentRoot,`vercel.ts`),t=join(r.environmentRoot,`vercel.json`);if(await assertInstallerOwned(e,[PEER_SERVICE_VERCEL_CONFIG,PEER_SERVICE_VERCEL_CONFIG.replace(/    web: \{[^}]+\},/,`    web: { framework: "nextjs", root: "apps/web" },`)]),await n.pathExists(t))throw Error(`Could not configure Vercel services because ${t} already exists. Preserve it and compose eve/vercel manually.`);await n.writeTextFile(c,PEER_SERVICE_NEXT_CONFIG,{force:!0}),await n.writeTextFile(e,PEER_SERVICE_VERCEL_CONFIG,{force:!0}),await configurePeerServiceScripts(r.environmentRoot,n),l=`dev:all`}else await n.writeTextFile(c,NEXT_HOSTED_CONFIG,{force:!0}),l=`dev:web`;return t.presenter.log.success(`Configured channel: web`),{facts:[{label:``,value:`Start locally with \`${runScriptCommand(e.packageManager,l)}\`.`}]}}const WEB_SETUP=defineSetupIntegration({kind:`web`,label:`Web Chat`,hint:`Browser-based chat interface`,prepare:prepareWebSetup,apply:applyWebSetup});export{WEB_SETUP,applyWebSetup,prepareWebSetup};
+`;await assertInstallerOwned(l,[u,NEXT_HOSTED_CONFIG,PEER_SERVICE_NEXT_CONFIG]);let d;if(e.hosting===`vercel`){let e=join(r.environmentRoot,`vercel.ts`),t=join(r.environmentRoot,`vercel.json`);if(await assertInstallerOwned(e,[PEER_SERVICE_VERCEL_CONFIG,PEER_SERVICE_VERCEL_CONFIG.replace(/    web: \{[^}]+\},/,`    web: { framework: "nextjs", root: "apps/web" },`)]),await n.pathExists(t))throw Error(`Could not configure Vercel services because ${t} already exists. Preserve it and compose eve/vercel manually.`);await n.writeTextFile(l,PEER_SERVICE_NEXT_CONFIG,{force:!0}),await n.writeTextFile(e,PEER_SERVICE_VERCEL_CONFIG,{force:!0}),await configurePeerServiceScripts(r.environmentRoot,n),d=`dev:all`}else await n.writeTextFile(l,e.rootWebChat?u:NEXT_HOSTED_CONFIG,{force:!0}),d=e.rootWebChat?`dev`:`dev:web`;e.authProject!==void 0&&s!==void 0&&(await n.provisionWebChatAuth(e.authProject,t.signal),t.signal?.throwIfAborted(),await s(),await n.installScaffoldDependencies({changed:!0,log:t.presenter.log,projectPath:r.environmentRoot,signal:t.signal}),t.presenter.log.success(`Configured Sign in with Vercel for this project's team`),t.presenter.nextSteps(["Local setup is complete. Run `eve deploy` to publish these changes. Production and preview credentials are configured.",`Local development continues to use localDev() without signing in.`])),t.presenter.log.success(`Configured channel: web`);let f={facts:[{label:``,value:`Start locally with \`${runScriptCommand(e.packageManager,d)}\`.`}]};return e.authProject!==void 0&&(f.deploymentRequired=!0),f}const WEB_SETUP=defineSetupIntegration({kind:`web`,label:`Web Chat`,hint:`Browser-based chat interface`,prepare:prepareWebSetup,apply:applyWebSetup});export{WEB_SETUP,applyWebSetup,prepareWebSetup};

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

@@ -93,6 +93,8 @@ export interface SelectCommonOptions<T extends PrompterValue> {
     message: string;
     /** Inert context rendered beneath the question heading and above its options. */
     description?: string;
+    /** Shared guidance rendered below the options and above keyboard hints. */
+    helpText?: string;
     /** Labeled facts rendered beneath the description and above the options. */
     metadata?: readonly SelectMetadata[];
     options: SelectOption<T>[];

package/dist/src/setup/prompter.js

@@ -1 +1 @@
-import{WizardCancelledError}from"./step.js";import{initialQuitGuardState,quitHintNote,reduceQuitGuard}from"./quit-guard.js";import pc from"#compiled/picocolors/index.js";import{cornerFor,createRailLog,formatPromptCancellation,formatPromptHeader,formatPromptOpener,formatPromptOutro,formatPromptSubmission,formatRailLine,railFor,runSelectComponent}from"#setup/cli/index.js";import{TextPrompt,isCancel,settings}from"#compiled/@clack/core/index.js";var PlannerNavigationError=class extends Error{direction;values;constructor(e,t){super(`Planner requested ${e} navigation.`),this.name=`PlannerNavigationError`,this.direction=e,this.values=t}};function guardCancel(e){if(isCancel(e))throw process.stdout.write(formatPromptCancellation(`Setup cancelled.`,pc)),new WizardCancelledError;return e}let escapeCancelDisabled=!1;function disableEscapeCancel(){escapeCancelDisabled||=(settings.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,pc)}}function toPromptState(e){return e}function railForState(e){return railFor(toPromptState(e),pc)}function cornerForState(e){return cornerFor(toPromptState(e),pc)}function header(e,t,n){return formatPromptHeader(toPromptState(e),t,{colors:pc,leadingRail:n===0?`white`:`green`})}const REDACTED_DISPLAY=`••••••••`;function textPrompt(e,t){let n,r=new TextPrompt({validate:t.validate?e=>t.validate?.(e??``):void 0,placeholder:t.placeholder,defaultValue:t.defaultValue,initialValue:t.defaultValue,render(){let r=header(this.state,t.message,e),i=t.placeholder?pc.inverse(t.placeholder[0])+pc.dim(t.placeholder.slice(1)):pc.inverse(pc.hidden(`_`)),a=this.value?`•`.repeat(this.value.length):i,o=i;switch(t.mask?o=a:this.value&&(o=this.userInputWithCursor),this.state){case`error`:return`${r.trim()}\n${railForState(this.state)}  ${o}\n${cornerForState(this.state)}  ${pc.red(this.error)}\n`;case`submit`:{let n=this.value||t.placeholder||``;return t.mask&&(n=this.value?REDACTED_DISPLAY:t.placeholder??``),formatPromptSubmission(this.state,t.message,n,{colors:pc,leadingRail:e===0?`white`:`green`})}case`cancel`:return`${r}${railForState(this.state)}  ${pc.strikethrough(pc.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(r),r.prompt()}function cornerNote(e){return e?`  ${e}`:``}function createPrompter(){disableEscapeCancel();let e=0,t=createRailLog({colors:pc,output:process.stdout});function printNotices(e){for(let n of e??[])n.tone===`success`?t.success(n.text):n.tone===`warning`?t.warning(n.text):n.tone===`error`?t.error(n.text):t.message(n.text)}return{async text(n){t.settle(),printNotices(n.notices);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(),printNotices(n.notices),n.description!==void 0&&process.stdout.write(formatRailLine(pc.dim(n.description),pc,process.stdout));for(let{label:e,value:t}of n.metadata??[])process.stdout.write(formatRailLine(`${pc.dim(`${e}:`)} ${t}`,pc,process.stdout));let r=guardCancel(await runSelectComponent({message:n.message,options:n.options,multiple:n.multiple===!0,search:n.search??!1,searchAction:n.multiple===!0?void 0:n.searchAction,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(pc.bold(e.message),pc,process.stdout));for(let t of e.lines??[])process.stdout.write(formatRailLine(pc.dim(t),pc,process.stdout))},note(e,n,r){t.settle();let i=r?.tone===`success`?pc.green:pc.red;n&&process.stdout.write(formatRailLine(i(pc.bold(n)),pc,process.stdout)),process.stdout.write(formatRailLine(i(e),pc,process.stdout))},intro(e,n=`Production-grade agent framework.`){t.settle(),process.stdout.write(formatPromptOpener(e,n,pc))},outro(e){t.settle(),process.stdout.write(formatPromptOutro(e,pc))},log:t}}export{PlannerNavigationError,createPrompter};
+import{WizardCancelledError}from"./step.js";import{initialQuitGuardState,quitHintNote,reduceQuitGuard}from"./quit-guard.js";import pc from"#compiled/picocolors/index.js";import{cornerFor,createRailLog,formatPromptCancellation,formatPromptHeader,formatPromptOpener,formatPromptOutro,formatPromptSubmission,formatRailLine,railFor,runSelectComponent}from"#setup/cli/index.js";import{TextPrompt,isCancel,settings}from"#compiled/@clack/core/index.js";var PlannerNavigationError=class extends Error{direction;values;constructor(e,t){super(`Planner requested ${e} navigation.`),this.name=`PlannerNavigationError`,this.direction=e,this.values=t}};function guardCancel(e){if(isCancel(e))throw process.stdout.write(formatPromptCancellation(`Setup cancelled.`,pc)),new WizardCancelledError;return e}let escapeCancelDisabled=!1;function disableEscapeCancel(){escapeCancelDisabled||=(settings.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,pc)}}function toPromptState(e){return e}function railForState(e){return railFor(toPromptState(e),pc)}function cornerForState(e){return cornerFor(toPromptState(e),pc)}function header(e,t,n){return formatPromptHeader(toPromptState(e),t,{colors:pc,leadingRail:n===0?`white`:`green`})}const REDACTED_DISPLAY=`••••••••`;function textPrompt(e,t){let n,r=new TextPrompt({validate:t.validate?e=>t.validate?.(e??``):void 0,placeholder:t.placeholder,defaultValue:t.defaultValue,initialValue:t.defaultValue,render(){let r=header(this.state,t.message,e),i=t.placeholder?pc.inverse(t.placeholder[0])+pc.dim(t.placeholder.slice(1)):pc.inverse(pc.hidden(`_`)),a=this.value?`•`.repeat(this.value.length):i,o=i;switch(t.mask?o=a:this.value&&(o=this.userInputWithCursor),this.state){case`error`:return`${r.trim()}\n${railForState(this.state)}  ${o}\n${cornerForState(this.state)}  ${pc.red(this.error)}\n`;case`submit`:{let n=this.value||t.placeholder||``;return t.mask&&(n=this.value?REDACTED_DISPLAY:t.placeholder??``),formatPromptSubmission(this.state,t.message,n,{colors:pc,leadingRail:e===0?`white`:`green`})}case`cancel`:return`${r}${railForState(this.state)}  ${pc.strikethrough(pc.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(r),r.prompt()}function cornerNote(e){return e?`  ${e}`:``}function createPrompter(){disableEscapeCancel();let e=0,t=createRailLog({colors:pc,output:process.stdout});function printNotices(e){for(let n of e??[])n.tone===`success`?t.success(n.text):n.tone===`warning`?t.warning(n.text):n.tone===`error`?t.error(n.text):t.message(n.text)}return{async text(n){t.settle(),printNotices(n.notices);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(),printNotices(n.notices),n.description!==void 0&&process.stdout.write(formatRailLine(pc.dim(n.description),pc,process.stdout));for(let{label:e,value:t}of n.metadata??[])process.stdout.write(formatRailLine(`${pc.dim(`${e}:`)} ${t}`,pc,process.stdout));let r=guardCancel(await runSelectComponent({message:n.message,helpText:n.helpText,options:n.options,multiple:n.multiple===!0,search:n.search??!1,searchAction:n.multiple===!0?void 0:n.searchAction,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(pc.bold(e.message),pc,process.stdout));for(let t of e.lines??[])process.stdout.write(formatRailLine(pc.dim(t),pc,process.stdout))},note(e,n,r){t.settle();let i=r?.tone===`success`?pc.green:pc.red;n&&process.stdout.write(formatRailLine(i(pc.bold(n)),pc,process.stdout)),process.stdout.write(formatRailLine(i(e),pc,process.stdout))},intro(e,n=`Production-grade agent framework.`){t.settle(),process.stdout.write(formatPromptOpener(e,n,pc))},outro(e){t.settle(),process.stdout.write(formatPromptOutro(e,pc))},log:t}}export{PlannerNavigationError,createPrompter};

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

@@ -1 +1 @@
-import{pathExists,writeTextFile}from"../files.js";import{resolveVersionToken}from"../version-tokens.js";import{patchPackageJson}from"../update/package-json.js";import{applyPackageManagerWorkspaceConfiguration,isPackageManagerWorkspaceMember,patchWorkspaceRootPackageJson}from"../workspace-root.js";import{agentTemplateFiles,formatEveDependencySpecifier,resolveEvePackageContract}from"./project.js";import{readFile}from"node:fs/promises";import{join}from"node:path";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(e){let t=e.packageManager??`pnpm`,n=join(e.projectRoot,`package.json`);if(!await pathExists(n))throw Error(`Cannot add an eve agent to "${e.projectRoot}" because it has no package.json. Run \`eve init <name>\` to create a new project instead.`);let r;try{r=JSON.parse(await readFile(n,`utf8`))}catch(e){let t=e instanceof Error?e.message:String(e);throw Error(`Cannot add an eve agent because "${n}" is not valid JSON. No files were changed. Fix the file, then retry eve init. ${t}`)}let i=agentTemplateFiles(e.model,e.reasoning),a=[];for(let t of Object.keys(i))await pathExists(join(e.projectRoot,t))&&a.push(t);if(a.length===0&&await pathExists(join(e.projectRoot,`agent`))&&a.push(`agent/`),a.length>0)throw Error(`Cannot add an eve agent to "${e.projectRoot}" because it already has: ${a.join(`, `)}.`);let o=resolveEvePackageContract(e.evePackage),s=resolveVersionToken(`aiPackageVersion`,e.aiPackageVersion??`^7.0.105`),c=resolveVersionToken(`connectPackageVersion`,e.connectPackageVersion??`2.2.0`),l=resolveVersionToken(`zodPackageVersion`,e.zodPackageVersion??`4.5.4`),u=[];for(let[t,n]of Object.entries(i)){let r=join(e.projectRoot,t);await writeTextFile(r,n),u.push(r)}let d={"@vercel/connect":c,ai:s,eve:formatEveDependencySpecifier(o.version),zod:l},f={};for(let[e,t]of Object.entries(d))hasDeclaredDependency(r,e)||(f[e]=t);let p={};Object.keys(f).length>0&&(p.dependencies=f),isPackageManagerWorkspaceMember(t,e.projectRoot)||(p.nodeEngineRequirement=o.nodeEngine);let m=await patchPackageJson(n,p),h=await patchWorkspaceRootPackageJson(t,e.projectRoot,{nodeEngineRequirement:o.nodeEngine}),g=h.nodeEngineOverride??m.nodeEngineOverride,_=await applyPackageManagerWorkspaceConfiguration({packageManager:t,projectRoot:e.projectRoot});return{filesWritten:u,dependenciesAdded:Object.keys(f).sort(),nodeEngineOverride:g,configurationFilesChanged:[...m.changed?[n]:[],...h.changed&&h.path!==void 0?[h.path]:[],..._.filesWritten]}}export{addAgentToProject};
+import{pathExists,writeTextFile}from"../files.js";import{resolveVersionToken}from"../version-tokens.js";import{patchPackageJson}from"../update/package-json.js";import{applyPackageManagerWorkspaceConfiguration,isPackageManagerWorkspaceMember,patchWorkspaceRootPackageJson}from"../workspace-root.js";import{agentTemplateFiles,formatEveDependencySpecifier,resolveEvePackageContract}from"./project.js";import{readFile}from"node:fs/promises";import{join}from"node:path";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(e){let t=e.packageManager??`pnpm`,n=join(e.projectRoot,`package.json`);if(!await pathExists(n))throw Error(`Cannot add an eve agent to "${e.projectRoot}" because it has no package.json. Run \`eve init <name>\` to create a new project instead.`);let r;try{r=JSON.parse(await readFile(n,`utf8`))}catch(e){let t=e instanceof Error?e.message:String(e);throw Error(`Cannot add an eve agent because "${n}" is not valid JSON. No files were changed. Fix the file, then retry eve init. ${t}`)}let i=agentTemplateFiles(e.model,e.reasoning),a=[];for(let t of Object.keys(i))await pathExists(join(e.projectRoot,t))&&a.push(t);if(a.length===0&&await pathExists(join(e.projectRoot,`agent`))&&a.push(`agent/`),a.length>0)throw Error(`Cannot add an eve agent to "${e.projectRoot}" because it already has: ${a.join(`, `)}.`);let o=resolveEvePackageContract(e.evePackage),s=resolveVersionToken(`aiPackageVersion`,e.aiPackageVersion??`^7.0.128`),c=resolveVersionToken(`connectPackageVersion`,e.connectPackageVersion??`2.2.0`),l=resolveVersionToken(`zodPackageVersion`,e.zodPackageVersion??`4.5.4`),u=[];for(let[t,n]of Object.entries(i)){let r=join(e.projectRoot,t);await writeTextFile(r,n),u.push(r)}let d={"@vercel/connect":c,ai:s,eve:formatEveDependencySpecifier(o.version),zod:l},f={};for(let[e,t]of Object.entries(d))hasDeclaredDependency(r,e)||(f[e]=t);let p={};Object.keys(f).length>0&&(p.dependencies=f),isPackageManagerWorkspaceMember(t,e.projectRoot)||(p.nodeEngineRequirement=o.nodeEngine);let m=await patchPackageJson(n,p),h=await patchWorkspaceRootPackageJson(t,e.projectRoot,{nodeEngineRequirement:o.nodeEngine}),g=h.nodeEngineOverride??m.nodeEngineOverride,_=await applyPackageManagerWorkspaceConfiguration({packageManager:t,projectRoot:e.projectRoot});return{filesWritten:u,dependenciesAdded:Object.keys(f).sort(),nodeEngineOverride:g,configurationFilesChanged:[...m.changed?[n]:[],...h.changed&&h.path!==void 0?[h.path]:[],..._.filesWritten]}}export{addAgentToProject};

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

@@ -1,4 +1,4 @@
-import{pinnedNodeEngineMajor}from"../../node-engine.js";import{parseChatGptModelSelection}from"../../../shared/chatgpt-model.js";import{SUPPORTED_AUTHORED_MODULE_FILE_EXTENSIONS}from"../update/module-files.js";import{pathExists,writeTextFile}from"../files.js";import{blockingCreateInPlaceEntries}from"../create-in-place.js";import{DEFAULT_CONNECT_PACKAGE_VERSION,resolveVersionToken}from"../version-tokens.js";import{applyPackageManagerWorkspaceConfiguration,isPackageManagerWorkspaceMember,patchWorkspaceRootPackageJson}from"../workspace-root.js";import{WEB_CHANNEL_TEMPLATES}from"./web-template.js";import{AGENT_INSTRUCTIONS_TEMPLATE}from"./instructions-template.js";import{SCAFFOLDED_AGENT_PATHS}from"./agent-paths.js";import{mkdir,readdir,stat}from"node:fs/promises";import{basename,join,resolve}from"node:path";const CURRENT_DIRECTORY_PROJECT_NAME=`.`,DEFAULT_AI_PACKAGE_VERSION=`^7.0.105`,DEFAULT_ZOD_PACKAGE_VERSION=`4.5.4`,DEFAULT_EVE_PACKAGE_CONTRACT={version:`0.71.3`,nodeEngine:`>=24`};function resolveEvePackageContract(e=DEFAULT_EVE_PACKAGE_CONTRACT){return{version:resolveVersionToken(`evePackage.version`,e.version),nodeEngine:resolveVersionToken(`evePackage.nodeEngine`,e.nodeEngine)}}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,t){return{[SCAFFOLDED_AGENT_PATHS.config]:renderAgentTemplate(e,t),[SCAFFOLDED_AGENT_PATHS.channel]:WEB_CHANNEL_TEMPLATES.default,[SCAFFOLDED_AGENT_PATHS.instructions]:AGENT_INSTRUCTIONS_TEMPLATE}}function renderAgentTemplate(e,t){let n=parseChatGptModelSelection(e);return n===void 0?BASE_AGENT_TEMPLATE.replaceAll(`__EVE_INIT_MODEL__`,e).replaceAll(`__EVE_INIT_REASONING__`,reasoningTemplateLine(t)):`import { defineAgent } from "eve";\nimport { chatgpt } from "eve/models/openai";\n\nexport default defineAgent({\n  model: chatgpt(${JSON.stringify(n)}),\n${reasoningTemplateLine(t)}});\n`}function reasoningTemplateLine(e){return e===void 0||e===`provider-default`?``:`  reasoning: "${e}",\n`}function renderTemplate(e,t){return e===BASE_AGENT_TEMPLATE&&parseChatGptModelSelection(t.model)!==void 0?renderAgentTemplate(t.model,t.reasoning):e.replaceAll(`__EVE_INIT_APP_NAME__`,t.appName).replaceAll(`__EVE_INIT_MODEL__`,t.model).replaceAll(`__EVE_INIT_REASONING__`,reasoningTemplateLine(t.reasoning)).replaceAll(`__EVE_INIT_BYOK_PROVIDER__`,modelProviderSlug(t.model)).replaceAll(`__EVE_INIT_BYOK_ENV_VAR__`,byokProviderEnvVar(t.model)).replaceAll(`__EVE_INIT_PACKAGE_VERSION__`,formatEveDependencySpecifier(t.eveVersion)).replaceAll(`__EVE_INIT_AI_SDK_VERSION__`,t.aiPackageVersion).replaceAll(`__EVE_INIT_CONNECT_VERSION__`,t.connectPackageVersion).replaceAll(`__EVE_INIT_ZOD_VERSION__`,t.zodPackageVersion).replaceAll(`__EVE_INIT_TYPESCRIPT_VERSION__`,t.typescriptPackageVersion).replaceAll(`__EVE_INIT_TYPES_NODE_VERSION__`,t.nodeTypesVersion).replaceAll(`__EVE_INIT_NODE_ENGINE__`,t.nodeEngine)}function formatEveDependencySpecifier(e){return/^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z-.]+)?$/.test(e)?`^${e}`:e}const BASE_AGENT_TEMPLATE=`import { defineAgent } from "eve";
+import{pinnedNodeEngineMajor}from"../../node-engine.js";import{parseChatGptModelSelection}from"../../../shared/chatgpt-model.js";import{SUPPORTED_AUTHORED_MODULE_FILE_EXTENSIONS}from"../update/module-files.js";import{pathExists,writeTextFile}from"../files.js";import{blockingCreateInPlaceEntries}from"../create-in-place.js";import{DEFAULT_CONNECT_PACKAGE_VERSION,resolveVersionToken}from"../version-tokens.js";import{applyPackageManagerWorkspaceConfiguration,isPackageManagerWorkspaceMember,patchWorkspaceRootPackageJson}from"../workspace-root.js";import{WEB_CHANNEL_TEMPLATES}from"./web-template.js";import{AGENT_INSTRUCTIONS_TEMPLATE}from"./instructions-template.js";import{SCAFFOLDED_AGENT_PATHS}from"./agent-paths.js";import{mkdir,readdir,stat}from"node:fs/promises";import{basename,join,resolve}from"node:path";const CURRENT_DIRECTORY_PROJECT_NAME=`.`,DEFAULT_AI_PACKAGE_VERSION=`^7.0.128`,DEFAULT_ZOD_PACKAGE_VERSION=`4.5.4`,DEFAULT_EVE_PACKAGE_CONTRACT={version:`0.72.0`,nodeEngine:`>=24`};function resolveEvePackageContract(e=DEFAULT_EVE_PACKAGE_CONTRACT){return{version:resolveVersionToken(`evePackage.version`,e.version),nodeEngine:resolveVersionToken(`evePackage.nodeEngine`,e.nodeEngine)}}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,t){return{[SCAFFOLDED_AGENT_PATHS.config]:renderAgentTemplate(e,t),[SCAFFOLDED_AGENT_PATHS.channel]:WEB_CHANNEL_TEMPLATES.default,[SCAFFOLDED_AGENT_PATHS.instructions]:AGENT_INSTRUCTIONS_TEMPLATE}}function renderAgentTemplate(e,t){let n=parseChatGptModelSelection(e);return n===void 0?BASE_AGENT_TEMPLATE.replaceAll(`__EVE_INIT_MODEL__`,e).replaceAll(`__EVE_INIT_REASONING__`,reasoningTemplateLine(t)):`import { defineAgent } from "eve";\nimport { chatgpt } from "eve/models/openai";\n\nexport default defineAgent({\n  model: chatgpt(${JSON.stringify(n)}),\n${reasoningTemplateLine(t)}});\n`}function reasoningTemplateLine(e){return e===void 0||e===`provider-default`?``:`  reasoning: "${e}",\n`}function renderTemplate(e,t){return e===BASE_AGENT_TEMPLATE&&parseChatGptModelSelection(t.model)!==void 0?renderAgentTemplate(t.model,t.reasoning):e.replaceAll(`__EVE_INIT_APP_NAME__`,t.appName).replaceAll(`__EVE_INIT_MODEL__`,t.model).replaceAll(`__EVE_INIT_REASONING__`,reasoningTemplateLine(t.reasoning)).replaceAll(`__EVE_INIT_BYOK_PROVIDER__`,modelProviderSlug(t.model)).replaceAll(`__EVE_INIT_BYOK_ENV_VAR__`,byokProviderEnvVar(t.model)).replaceAll(`__EVE_INIT_PACKAGE_VERSION__`,formatEveDependencySpecifier(t.eveVersion)).replaceAll(`__EVE_INIT_AI_SDK_VERSION__`,t.aiPackageVersion).replaceAll(`__EVE_INIT_CONNECT_VERSION__`,t.connectPackageVersion).replaceAll(`__EVE_INIT_ZOD_VERSION__`,t.zodPackageVersion).replaceAll(`__EVE_INIT_TYPESCRIPT_VERSION__`,t.typescriptPackageVersion).replaceAll(`__EVE_INIT_TYPES_NODE_VERSION__`,t.nodeTypesVersion).replaceAll(`__EVE_INIT_NODE_ENGINE__`,t.nodeEngine)}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__",
@@ -114,4 +114,4 @@ __EVE_INIT_REASONING__  modelOptions: {
     },
   },
 });
-`:BASE_AGENT_TEMPLATE,...SHARED_TEMPLATE_FILES,"package.json":packageJsonTemplate(e.includeRootOnlyPackageJsonFields)}}async function assertCanCreateInPlace(e,t){if(!await pathExists(e))return;let n=await readdir(e),r=blockingCreateInPlaceEntries(n);if(r.length>0&&!t){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 t=resolve(e.targetDirectory??process.cwd(),e.projectName),n=e.projectName===`.`,r=e.overwriteExisting??!1,i=e.byokProvider??!1,a=e.packageManager??`pnpm`,o=resolveEvePackageContract(e.evePackage),s=pinnedNodeEngineMajor(o.nodeEngine),c=resolve(e.workspaceProbeDirectory??t),l=isPackageManagerWorkspaceMember(a,c);if(n)await assertCanCreateInPlace(t,r);else if(await pathExists(t))throw Error(`Cannot create project because "${t}" already exists.`);let u={appName:basename(t),model:e.model,reasoning:e.reasoning,eveVersion:o.version,aiPackageVersion:resolveVersionToken(`aiPackageVersion`,e.aiPackageVersion??`^7.0.105`),connectPackageVersion:resolveVersionToken(`connectPackageVersion`,e.connectPackageVersion??`2.2.0`),zodPackageVersion:resolveVersionToken(`zodPackageVersion`,e.zodPackageVersion??`4.5.4`),typescriptPackageVersion:resolveVersionToken(`typescriptPackageVersion`,e.typescriptPackageVersion??`7.0.2`),nodeTypesVersion:s,nodeEngine:s};await mkdir(t,{recursive:!0});for(let[a,o]of Object.entries(templateFiles({byokProvider:i,includeRootOnlyPackageJsonFields:!l}))){let i=`${t}/${a}`,s=await pathExists(i);await writeTextFile(i,renderTemplate(o,u),{force:n&&r}),s&&await e.onOverwriteFile?.(i)}return await applyPackageManagerWorkspaceConfiguration({packageManager:a,projectRoot:t,workspaceProbeRoot:c,onWorkspaceRootMutation:e.onWorkspaceRootMutation}),await patchWorkspaceRootPackageJson(a,c,{nodeEngineRequirement:o.nodeEngine,onWorkspaceRootMutation:e.onWorkspaceRootMutation}),t}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_CONNECT_PACKAGE_VERSION,DEFAULT_EVE_PACKAGE_CONTRACT,DEFAULT_ZOD_PACKAGE_VERSION,ROOT_ONLY_PACKAGE_JSON_TEMPLATE_SUFFIX,agentTemplateFiles,byokProviderEnvVar,formatEveDependencySpecifier,isEveProject,modelProviderSlug,resolveEvePackageContract,scaffoldBaseProject};
+`:BASE_AGENT_TEMPLATE,...SHARED_TEMPLATE_FILES,"package.json":packageJsonTemplate(e.includeRootOnlyPackageJsonFields)}}async function assertCanCreateInPlace(e,t){if(!await pathExists(e))return;let n=await readdir(e),r=blockingCreateInPlaceEntries(n);if(r.length>0&&!t){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 t=resolve(e.targetDirectory??process.cwd(),e.projectName),n=e.projectName===`.`,r=e.overwriteExisting??!1,i=e.byokProvider??!1,a=e.packageManager??`pnpm`,o=resolveEvePackageContract(e.evePackage),s=pinnedNodeEngineMajor(o.nodeEngine),c=resolve(e.workspaceProbeDirectory??t),l=isPackageManagerWorkspaceMember(a,c);if(n)await assertCanCreateInPlace(t,r);else if(await pathExists(t))throw Error(`Cannot create project because "${t}" already exists.`);let u={appName:basename(t),model:e.model,reasoning:e.reasoning,eveVersion:o.version,aiPackageVersion:resolveVersionToken(`aiPackageVersion`,e.aiPackageVersion??`^7.0.128`),connectPackageVersion:resolveVersionToken(`connectPackageVersion`,e.connectPackageVersion??`2.2.0`),zodPackageVersion:resolveVersionToken(`zodPackageVersion`,e.zodPackageVersion??`4.5.4`),typescriptPackageVersion:resolveVersionToken(`typescriptPackageVersion`,e.typescriptPackageVersion??`7.0.2`),nodeTypesVersion:s,nodeEngine:s};await mkdir(t,{recursive:!0});for(let[a,o]of Object.entries(templateFiles({byokProvider:i,includeRootOnlyPackageJsonFields:!l}))){let i=`${t}/${a}`,s=await pathExists(i);await writeTextFile(i,renderTemplate(o,u),{force:n&&r}),s&&await e.onOverwriteFile?.(i)}return await applyPackageManagerWorkspaceConfiguration({packageManager:a,projectRoot:t,workspaceProbeRoot:c,onWorkspaceRootMutation:e.onWorkspaceRootMutation}),await patchWorkspaceRootPackageJson(a,c,{nodeEngineRequirement:o.nodeEngine,onWorkspaceRootMutation:e.onWorkspaceRootMutation}),t}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_CONNECT_PACKAGE_VERSION,DEFAULT_EVE_PACKAGE_CONTRACT,DEFAULT_ZOD_PACKAGE_VERSION,ROOT_ONLY_PACKAGE_JSON_TEMPLATE_SUFFIX,agentTemplateFiles,byokProviderEnvVar,formatEveDependencySpecifier,isEveProject,modelProviderSlug,resolveEvePackageContract,scaffoldBaseProject};

package/dist/src/setup/scaffold/create/web-template.d.ts

@@ -55,7 +55,7 @@ export declare const WEB_APP_SIGN_IN_WITH_VERCEL_TEMPLATE_FILES: {
     readonly "app/s/[sessionId]/page.tsx": 'import { AuthenticatedAgentChat } from "@/app/_components/authenticated-agent-chat";\n\nexport default async function SessionPage({\n  params,\n}: {\n  readonly params: Promise<{ readonly sessionId: string }>;\n}) {\n  const { sessionId } = await params;\n  return <AuthenticatedAgentChat sessionId={sessionId} />;\n}\n';
     readonly "app/s/page.tsx": 'import { AuthenticatedAgentChat } from "@/app/_components/authenticated-agent-chat";\n\nexport default function NewSessionPage() {\n  return <AuthenticatedAgentChat sessionless />;\n}\n';
     readonly "lib/auth-client.ts": '"use client";\n\nimport { createAuthClient } from "better-auth/react";\n\nexport const authClient = createAuthClient();\n';
-    readonly "lib/auth.ts": 'import { betterAuth } from "better-auth";\n\nconst SESSION_MAX_AGE_SECONDS = 8 * 60 * 60;\nconst DEVELOPMENT_ALLOWED_HOSTS = ["localhost:*", "127.0.0.1:*"];\n\nfunction getAllowedHosts(): string[] {\n  if (process.env.NODE_ENV === "development") {\n    return DEVELOPMENT_ALLOWED_HOSTS;\n  }\n  const deploymentHosts = [\n    process.env.VERCEL_URL,\n    process.env.VERCEL_BRANCH_URL,\n    process.env.VERCEL_PROJECT_PRODUCTION_URL,\n  ].filter((host): host is string => Boolean(host));\n  if (deploymentHosts.length === 0) {\n    throw new Error("No trusted deployment hosts are configured");\n  }\n  return Array.from(new Set(deploymentHosts));\n}\n\nfunction requireEnvironmentVariable(name: string): string {\n  const value = process.env[name];\n  if (value) return value;\n  if (process.env.NODE_ENV === "development") return `development-${name}`;\n  throw new Error(`Missing required environment variable: ${name}`);\n}\n\nexport const auth = betterAuth({\n  baseURL: {\n    allowedHosts: getAllowedHosts(),\n    protocol: process.env.NODE_ENV === "development" ? "auto" : "https",\n  },\n  secret: requireEnvironmentVariable("BETTER_AUTH_SECRET"),\n  session: {\n    expiresIn: SESSION_MAX_AGE_SECONDS,\n    disableSessionRefresh: true,\n    cookieCache: {\n      enabled: true,\n      maxAge: SESSION_MAX_AGE_SECONDS,\n      refreshCache: false,\n      strategy: "jwe",\n    },\n  },\n  socialProviders: {\n    vercel: {\n      clientId: requireEnvironmentVariable("VERCEL_APP_CLIENT_ID"),\n      clientSecret: requireEnvironmentVariable("VERCEL_APP_CLIENT_SECRET"),\n    },\n  },\n});\n';
+    readonly "lib/auth.ts": 'import { betterAuth } from "better-auth";\n\nconst SESSION_MAX_AGE_SECONDS = 8 * 60 * 60;\nconst DEVELOPMENT_ALLOWED_HOSTS = ["localhost:*", "127.0.0.1:*"];\n\nfunction getAllowedHosts(): string[] {\n  if (process.env.NODE_ENV === "development") {\n    return DEVELOPMENT_ALLOWED_HOSTS;\n  }\n  const deploymentHosts = [\n    process.env.VERCEL_URL,\n    process.env.VERCEL_BRANCH_URL,\n    process.env.VERCEL_PROJECT_PRODUCTION_URL,\n  ].filter((host): host is string => Boolean(host));\n  if (deploymentHosts.length === 0) {\n    throw new Error("No trusted deployment hosts are configured");\n  }\n  return Array.from(new Set(deploymentHosts));\n}\n\nfunction requireEnvironmentVariable(name: string): string {\n  const value = process.env[name];\n  if (value) return value;\n  if (process.env.NODE_ENV === "development") return `development-${name}`;\n  throw new Error(`Missing required environment variable: ${name}`);\n}\n\nexport const auth = betterAuth({\n  baseURL: {\n    allowedHosts: getAllowedHosts(),\n    protocol: process.env.NODE_ENV === "development" ? "auto" : "https",\n  },\n  secret: requireEnvironmentVariable("BETTER_AUTH_SECRET"),\n  session: {\n    expiresIn: SESSION_MAX_AGE_SECONDS,\n    disableSessionRefresh: true,\n    cookieCache: {\n      enabled: true,\n      maxAge: SESSION_MAX_AGE_SECONDS,\n      refreshCache: false,\n      strategy: "jwe",\n    },\n  },\n  socialProviders: {\n    vercel: {\n      clientId: requireEnvironmentVariable("VERCEL_APP_CLIENT_ID"),\n      clientSecret: requireEnvironmentVariable("VERCEL_APP_CLIENT_SECRET"),\n      scope: ["openid", "email", "profile"],\n    },\n  },\n});\n';
 };
 export declare const WEB_APP_TEMPLATE_PACKAGE_JSON: {
     readonly scripts: {

package/dist/src/setup/scaffold/create/web-template.js

@@ -6139,6 +6139,7 @@ export const auth = betterAuth({
     vercel: {
       clientId: requireEnvironmentVariable("VERCEL_APP_CLIENT_ID"),
       clientSecret: requireEnvironmentVariable("VERCEL_APP_CLIENT_SECRET"),
+      scope: ["openid", "email", "profile"],
     },
   },
 });

package/dist/src/setup/scaffold/update/web-options.js

@@ -1 +1 @@
-import{DEFAULT_EVE_PACKAGE_CONTRACT}from"../create/project.js";function resolveWebPackageVersions(e,t){return{evePackage:e?.evePackage??DEFAULT_EVE_PACKAGE_CONTRACT,aiPackageVersion:e?.aiPackageVersion??`^7.0.105`,betterAuthPackageVersion:e?.betterAuthPackageVersion??`1.6.26`,nextPackageVersion:e?.nextPackageVersion??(t===`sign-in-with-vercel`?`16.3.0`:`16.3.4`),reactPackageVersion:e?.reactPackageVersion??`19.2.6`,reactDomPackageVersion:e?.reactDomPackageVersion??`19.2.6`,streamdownPackageVersion:e?.streamdownPackageVersion??`2.5.0`,zodPackageVersion:e?.zodPackageVersion??`4.5.4`,typesReactPackageVersion:e?.typesReactPackageVersion??`19.2.15`,typesReactDomPackageVersion:e?.typesReactDomPackageVersion??`19.2.3`}}export{resolveWebPackageVersions};
+import{DEFAULT_EVE_PACKAGE_CONTRACT}from"../create/project.js";function resolveWebPackageVersions(e,t){return{evePackage:e?.evePackage??DEFAULT_EVE_PACKAGE_CONTRACT,aiPackageVersion:e?.aiPackageVersion??`^7.0.128`,betterAuthPackageVersion:e?.betterAuthPackageVersion??`1.6.26`,nextPackageVersion:e?.nextPackageVersion??(t===`sign-in-with-vercel`?`16.3.0`:`16.3.4`),reactPackageVersion:e?.reactPackageVersion??`19.2.6`,reactDomPackageVersion:e?.reactDomPackageVersion??`19.2.6`,streamdownPackageVersion:e?.streamdownPackageVersion??`2.5.0`,zodPackageVersion:e?.zodPackageVersion??`4.5.4`,typesReactPackageVersion:e?.typesReactPackageVersion??`19.2.15`,typesReactDomPackageVersion:e?.typesReactDomPackageVersion??`19.2.3`}}export{resolveWebPackageVersions};

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

@@ -26,6 +26,15 @@ export declare function parseVercelJson(stdout: string, description: string): un
 export declare function requireVercelTeamAccess(failure: VercelCaptureFailure): never;
 /** Lists up to the maximum 100 Vercel scopes supported by the CLI. */
 export declare function listTeams(projectRoot: string, options?: VercelProjectOperationOptions): Promise<VercelTeamListEntry[]>;
+/** Capabilities required by a setup flow, using Vercel's permission resource names. */
+export interface VercelTeamRequirement {
+    permissions: Readonly<Record<string, readonly string[]>>;
+    disabledReason: string;
+}
+/** Checks the listed teams in one request, retaining unknown scopes as unavailable. */
+export declare function checkTeamRequirements(projectRoot: string, teams: readonly VercelTeamListEntry[], requirement: VercelTeamRequirement, options?: VercelProjectOperationOptions): Promise<Map<string, string | undefined>>;
+/** Returns an actionable reason when a specific team cannot satisfy a setup flow. */
+export declare function checkTeamRequirement(projectRoot: string, team: string, requirement: VercelTeamRequirement, options?: VercelProjectOperationOptions): Promise<string | undefined>;
 /** Lists the 20 most recent Vercel projects in one account scope. */
 export declare function listRecentProjects(projectRoot: string, team: string, options?: VercelProjectOperationOptions): Promise<VercelProjectListEntry[]>;
 /** Ranks exact and prefix project-name matches ahead of substring matches. */

package/dist/src/setup/vercel-project-api.js

@@ -1 +1 @@
-import{isForbiddenApiFailure}from"./vercel-api-failure.js";import{z}from"#compiled/zod/index.js";import{captureVercel}from"#setup/primitives/index.js";import{HumanActionRequiredError}from"#setup/human-action.js";const VERCEL_PROJECT_REQUEST_TIMEOUT_MS=15e3,VercelTeamListEntrySchema=z.object({name:z.string(),slug:z.string(),current:z.boolean()}),VercelProjectListEntrySchema=z.object({name:z.string(),id:z.string()}),VercelPaginationSchema=z.object({next:z.number().int().nonnegative().nullable().optional()}),VercelTeamPageSchema=z.object({teams:z.array(VercelTeamListEntrySchema),pagination:VercelPaginationSchema.optional()}).transform(e=>e.teams),VercelProjectPageSchema=z.object({projects:z.array(VercelProjectListEntrySchema),pagination:VercelPaginationSchema.optional()}).transform(e=>({items:e.projects,next:e.pagination?.next??void 0}));function parseVercelJson(e,t){try{return JSON.parse(e)}catch{throw Error(`Could not parse ${t} JSON from Vercel CLI output.`)}}function requireVercelTeamAccess(e){let t=e.stderr.trim(),n=t?` ${t}`:``;throw new HumanActionRequiredError({kind:`vercel-forbidden`,command:`vercel login`,reason:`Vercel denied access to this scope.${n} Re-authenticate (for example to complete a team's SSO) or switch to a team you can access.`})}function isUnsupportedTeamListFailure(e){let t=`${e.stderr}\n${e.stdout}`;return/(?:unknown|unexpected|invalid).*(?:--format|--limit)/iu.test(t)}function requireVercelCliUpgrade(e){throw new HumanActionRequiredError({kind:`vercel-cli-upgrade`,command:`vercel upgrade`,reason:`The installed Vercel CLI does not support the team-list options eve needs. ${e.message} Upgrade it and retry.`})}async function captureTeamPage(e,t,n){let r=await captureVercel(n,{cwd:e,signal:t.signal});if(t.signal?.throwIfAborted(),!r.ok)throw isForbiddenApiFailure(r.failure)&&requireVercelTeamAccess(r.failure),isUnsupportedTeamListFailure(r.failure)&&requireVercelCliUpgrade(r.failure),Error(`Could not list Vercel teams. ${r.failure.message}`);return r.stdout}async function listTeams(e,t={}){let n=await captureTeamPage(e,t,[`teams`,`ls`,`--format`,`json`,`--limit`,`100`]),r=VercelTeamPageSchema.safeParse(parseVercelJson(n,`teams`));if(!r.success)throw Error(`Could not read teams from Vercel CLI JSON output.`);return r.data}async function fetchProjectPage(e,t,n){let r=[`project`,`ls`,`--format`,`json`,`--scope`,t];n.search!==void 0&&r.push(`--filter`,n.search),n.next!==void 0&&r.push(`--next`,String(n.next));let i=await captureVercel(r,{cwd:e,signal:n.signal,timeoutMs:VERCEL_PROJECT_REQUEST_TIMEOUT_MS});if(n.signal?.throwIfAborted(),!i.ok)throw isForbiddenApiFailure(i.failure)&&requireVercelTeamAccess(i.failure),Error(`Could not list Vercel projects in ${t}. ${i.failure.message}`);let a=VercelProjectPageSchema.safeParse(parseVercelJson(i.stdout,`projects`));if(!a.success)throw Error(`Could not read projects from Vercel CLI JSON output.`);return a.data}async function listRecentProjects(e,t,n={}){return(await fetchProjectPage(e,t,n)).items}function projectSearchRank(e,t){let n=e.name.toLowerCase(),r=t.toLowerCase();return n===r?0:n.startsWith(r)?1:2}function rankProjectSearchResults(e,t){let n=t.trim();return[...e].sort((e,t)=>projectSearchRank(e,n)-projectSearchRank(t,n))}async function searchProjects(e,t,n,r={}){let i=n.trim();if(i.length===0)throw Error(`Project search query cannot be empty.`);let a=await fetchProjectPage(e,t,{...r,search:i}),o=rankProjectSearchResults(a.items,i);return a.next===void 0?{projects:o}:{projects:o,next:a.next}}export{VERCEL_PROJECT_REQUEST_TIMEOUT_MS,listRecentProjects,listTeams,parseVercelJson,rankProjectSearchResults,requireVercelTeamAccess,searchProjects};
+import{isForbiddenApiFailure}from"./vercel-api-failure.js";import{z}from"#compiled/zod/index.js";import{captureVercel}from"#setup/primitives/index.js";import{HumanActionRequiredError}from"#setup/human-action.js";const VERCEL_PROJECT_REQUEST_TIMEOUT_MS=15e3,VercelTeamListEntrySchema=z.object({name:z.string(),slug:z.string(),current:z.boolean()}),VercelProjectListEntrySchema=z.object({name:z.string(),id:z.string()}),VercelPaginationSchema=z.object({next:z.number().int().nonnegative().nullable().optional()}),VercelTeamPageSchema=z.object({teams:z.array(VercelTeamListEntrySchema),pagination:VercelPaginationSchema.optional()}).transform(e=>e.teams),VercelProjectPageSchema=z.object({projects:z.array(VercelProjectListEntrySchema),pagination:VercelPaginationSchema.optional()}).transform(e=>({items:e.projects,next:e.pagination?.next??void 0}));function parseVercelJson(e,t){try{return JSON.parse(e)}catch{throw Error(`Could not parse ${t} JSON from Vercel CLI output.`)}}function requireVercelTeamAccess(e){let t=e.stderr.trim(),n=t?` ${t}`:``;throw new HumanActionRequiredError({kind:`vercel-forbidden`,command:`vercel login`,reason:`Vercel denied access to this scope.${n} Re-authenticate (for example to complete a team's SSO) or switch to a team you can access.`})}function isUnsupportedTeamListFailure(e){let t=`${e.stderr}\n${e.stdout}`;return/(?:unknown|unexpected|invalid).*(?:--format|--limit)/iu.test(t)}function requireVercelCliUpgrade(e){throw new HumanActionRequiredError({kind:`vercel-cli-upgrade`,command:`vercel upgrade`,reason:`The installed Vercel CLI does not support the team-list options eve needs. ${e.message} Upgrade it and retry.`})}async function captureTeamPage(e,t,n){let r=await captureVercel(n,{cwd:e,signal:t.signal});if(t.signal?.throwIfAborted(),!r.ok)throw isForbiddenApiFailure(r.failure)&&requireVercelTeamAccess(r.failure),isUnsupportedTeamListFailure(r.failure)&&requireVercelCliUpgrade(r.failure),Error(`Could not list Vercel teams. ${r.failure.message}`);return r.stdout}async function listTeams(e,t={}){let n=await captureTeamPage(e,t,[`teams`,`ls`,`--format`,`json`,`--limit`,`100`]),r=VercelTeamPageSchema.safeParse(parseVercelJson(n,`teams`));if(!r.success)throw Error(`Could not read teams from Vercel CLI JSON output.`);return r.data}const TeamPermissionsSchema=z.record(z.string(),z.array(z.string())),UNVERIFIED_TEAM_PERMISSIONS="Could not verify permissions; run `vercel login` or retry.";function teamPermissionIssue(e,t){let n=TeamPermissionsSchema.safeParse(e);return n.success?Object.entries(t.permissions).every(([e,t])=>t.every(t=>n.data[e]?.includes(t)))?void 0:t.disabledReason:UNVERIFIED_TEAM_PERMISSIONS}async function checkTeamRequirements(e,t,n,r={}){let i=new Map(t.map(e=>[e.slug,UNVERIFIED_TEAM_PERMISSIONS])),a=await captureVercel([`api`,`/v2/teams?permissions=true&limit=100`,`--method`,`GET`],{cwd:e,signal:r.signal,timeoutMs:VERCEL_PROJECT_REQUEST_TIMEOUT_MS});if(r.signal?.throwIfAborted(),!a.ok)return i;let o;try{o=JSON.parse(a.stdout)}catch{return i}let s=z.object({teams:z.array(z.object({slug:z.string(),permissions:z.unknown().optional(),limited:z.boolean().optional()})).max(100)}).safeParse(o);if(!s.success)return i;for(let e of s.data.teams)i.has(e.slug)&&i.set(e.slug,e.limited?UNVERIFIED_TEAM_PERMISSIONS:teamPermissionIssue(e.permissions,n));return i}async function checkTeamRequirement(e,t,n,r={}){let i=await captureVercel([`api`,`/v1/user/permissions`,`--method`,`GET`,`--scope`,t],{cwd:e,signal:r.signal,timeoutMs:VERCEL_PROJECT_REQUEST_TIMEOUT_MS});if(r.signal?.throwIfAborted(),!i.ok)return UNVERIFIED_TEAM_PERMISSIONS;let a;try{a=JSON.parse(i.stdout)}catch{return UNVERIFIED_TEAM_PERMISSIONS}let o=z.object({permissions:z.unknown()}).safeParse(a);return o.success?teamPermissionIssue(o.data.permissions,n):UNVERIFIED_TEAM_PERMISSIONS}async function fetchProjectPage(e,t,n){let r=[`project`,`ls`,`--format`,`json`,`--scope`,t];n.search!==void 0&&r.push(`--filter`,n.search),n.next!==void 0&&r.push(`--next`,String(n.next));let i=await captureVercel(r,{cwd:e,signal:n.signal,timeoutMs:VERCEL_PROJECT_REQUEST_TIMEOUT_MS});if(n.signal?.throwIfAborted(),!i.ok)throw isForbiddenApiFailure(i.failure)&&requireVercelTeamAccess(i.failure),Error(`Could not list Vercel projects in ${t}. ${i.failure.message}`);let a=VercelProjectPageSchema.safeParse(parseVercelJson(i.stdout,`projects`));if(!a.success)throw Error(`Could not read projects from Vercel CLI JSON output.`);return a.data}async function listRecentProjects(e,t,n={}){return(await fetchProjectPage(e,t,n)).items}function projectSearchRank(e,t){let n=e.name.toLowerCase(),r=t.toLowerCase();return n===r?0:n.startsWith(r)?1:2}function rankProjectSearchResults(e,t){let n=t.trim();return[...e].sort((e,t)=>projectSearchRank(e,n)-projectSearchRank(t,n))}async function searchProjects(e,t,n,r={}){let i=n.trim();if(i.length===0)throw Error(`Project search query cannot be empty.`);let a=await fetchProjectPage(e,t,{...r,search:i}),o=rankProjectSearchResults(a.items,i);return a.next===void 0?{projects:o}:{projects:o,next:a.next}}export{VERCEL_PROJECT_REQUEST_TIMEOUT_MS,checkTeamRequirement,checkTeamRequirements,listRecentProjects,listTeams,parseVercelJson,rankProjectSearchResults,requireVercelTeamAccess,searchProjects};

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

@@ -2,7 +2,7 @@ import { createPromptCommandOutput } from "#setup/cli/index.js";
 import { type ProjectResolution } from "./project-resolution.js";
 import type { Prompter } from "./prompter.js";
 import type { ResolvedVercelProjectSpec, VercelProjectIdentity } from "./state.js";
-import { type VercelProjectOperationOptions } from "./vercel-project-api.js";
+import { type VercelTeamRequirement, type VercelProjectOperationOptions } from "./vercel-project-api.js";
 import { type CreatedProjectFrameworkOptions } from "./vercel-project-framework.js";
 interface PickProjectOptions extends VercelProjectOperationOptions {
     /** Whether an empty project list may fall back to entering a name to create. */
@@ -15,6 +15,7 @@ interface PickProjectOptions extends VercelProjectOperationOptions {
     suggestedName?: string;
 }
 interface PickTeamOptions extends VercelProjectOperationOptions {
+    teamRequirement?: VercelTeamRequirement;
     /** Builds the team selector heading from the current team's display name. */
     selectMessage?: (currentTeam: string) => string;
 }
@@ -67,7 +68,8 @@ export declare function validateTeam(prompter: Prompter, projectRoot: string, te
 /**
  * Picks the Vercel team (scope). A passed slug is validated and resolved; with
  * zero or one team the current scope is used without prompting; otherwise the
- * user filters and chooses from the list with a single-selection picker.
+ * user filters and chooses from the list with a single-selection picker. Flows
+ * with a team requirement always show the picker and disable ineligible teams.
  */
 export declare function pickTeam(prompter: Prompter, projectRoot: string, presetTeam: string | undefined, options?: PickTeamOptions): Promise<string>;
 /** Picks an existing project under a team, or a name to create when none exist. */

package/dist/src/shared/web-search.d.ts

@@ -1,2 +1,2 @@
 /** Web search providers available through Vercel AI Gateway. */
-export type WebSearchProvider = "exa" | "parallel";
+export type WebSearchProvider = "exa" | "parallel" | "browserbase";

package/dist/src/subagents/adapter.js

@@ -1 +1 @@
-import{createErrorId,createLogger}from"#internal/logging.js";import{ContinuationTokenKey,SessionIdKey,SessionInboxKey}from"#context/keys.js";import{resumeHook}from"#internal/workflow/runtime.js";import{SUBAGENT_ADAPTER_KIND,isSubagentAdapterState}from"#subagents/adapter-state.js";const log=createLogger(`execution.subagent-adapter`),SUBAGENT_ADAPTER={kind:SUBAGENT_ADAPTER_KIND,async"approval.candidate"(e,t){await forwardSubagentAuthorizationEvent({data:e,type:`approval.candidate`},t)},async"approval.settled"(e,t){await forwardSubagentAuthorizationEvent({data:e,type:`approval.settled`},t)},async"authorization.required"(e,t){await forwardSubagentAuthorizationEvent({data:e,type:`authorization.required`},t)},async"authorization.completed"(e,t){await forwardSubagentAuthorizationEvent({data:e,type:`authorization.completed`},t)},async"input.requested"(e,t){let n=t.state;isSubagentAdapterState(n)&&await forwardSubagentInputRequestStep({hookPayload:{callId:n.callId,childContinuationToken:t.ctx.require(ContinuationTokenKey),childSessionId:t.ctx.require(SessionIdKey),childSessionInbox:t.ctx.get(SessionInboxKey),inputSource:t.inputSource,event:{requests:e.requests,sequence:e.sequence,stepIndex:e.stepIndex,turnId:e.turnId},kind:`subagent-input-request`,subagentName:n.subagentName},parentContinuationToken:n.parentContinuationToken})}};async function forwardSubagentAuthorizationEvent(e,t){let n=t.state;isSubagentAdapterState(n)&&await forwardSubagentAuthorizationEventStep({hookPayload:{callId:n.callId,childSessionId:t.ctx.require(SessionIdKey),event:e,kind:`subagent-authorization-event`,subagentName:n.subagentName},parentContinuationToken:n.parentContinuationToken})}async function forwardSubagentAuthorizationEventStep(e){"use step";try{await resumeHook(e.parentContinuationToken,e.hookPayload)}catch(t){let n=createErrorId();throw log.warn(`failed to forward subagent authorization event to parent`,{callId:e.hookPayload.callId,childSessionId:e.hookPayload.childSessionId,errorId:n,eventType:e.hookPayload.event.type,parentContinuationToken:e.parentContinuationToken,subagentName:e.hookPayload.subagentName,error:t}),t}}async function forwardSubagentInputRequestStep(e){"use step";try{await resumeHook(e.parentContinuationToken,e.hookPayload)}catch(t){let n=createErrorId();throw log.warn(`failed to forward proxied HITL batch to parent`,{callId:e.hookPayload.callId,childContinuationToken:e.hookPayload.childContinuationToken,childSessionId:e.hookPayload.childSessionId,errorId:n,parentContinuationToken:e.parentContinuationToken,subagentName:e.hookPayload.subagentName,error:t}),t}}export{SUBAGENT_ADAPTER};
+import{createErrorId,createLogger}from"#internal/logging.js";import{ContinuationTokenKey,SessionIdKey,SessionInboxKey}from"#context/keys.js";import{SUBAGENT_ADAPTER_KIND,isSubagentAdapterState}from"#subagents/adapter-state.js";const log=createLogger(`execution.subagent-adapter`),SUBAGENT_ADAPTER={kind:SUBAGENT_ADAPTER_KIND,async"approval.candidate"(e,t){await forwardSubagentAuthorizationEvent({data:e,type:`approval.candidate`},t)},async"approval.settled"(e,t){await forwardSubagentAuthorizationEvent({data:e,type:`approval.settled`},t)},async"authorization.required"(e,t){await forwardSubagentAuthorizationEvent({data:e,type:`authorization.required`},t)},async"authorization.completed"(e,t){await forwardSubagentAuthorizationEvent({data:e,type:`authorization.completed`},t)},async"input.requested"(e,t){let n=t.state;isSubagentAdapterState(n)&&await forwardSubagentInputRequestStep({hookPayload:{callId:n.callId,childContinuationToken:t.ctx.require(ContinuationTokenKey),childSessionId:t.ctx.require(SessionIdKey),childSessionInbox:t.ctx.get(SessionInboxKey),inputSource:t.inputSource,event:{requests:e.requests,sequence:e.sequence,stepIndex:e.stepIndex,turnId:e.turnId},kind:`subagent-input-request`,subagentName:n.subagentName},parentContinuationToken:n.parentContinuationToken})}};async function forwardSubagentAuthorizationEvent(e,t){let n=t.state;isSubagentAdapterState(n)&&await forwardSubagentAuthorizationEventStep({hookPayload:{callId:n.callId,childSessionId:t.ctx.require(SessionIdKey),event:e,kind:`subagent-authorization-event`,subagentName:n.subagentName},parentContinuationToken:n.parentContinuationToken})}async function forwardSubagentAuthorizationEventStep(e){"use step";try{await resumeParentHook(e.parentContinuationToken,e.hookPayload)}catch(t){let n=createErrorId();throw log.warn(`failed to forward subagent authorization event to parent`,{callId:e.hookPayload.callId,childSessionId:e.hookPayload.childSessionId,errorId:n,eventType:e.hookPayload.event.type,parentContinuationToken:e.parentContinuationToken,subagentName:e.hookPayload.subagentName,error:t}),t}}async function forwardSubagentInputRequestStep(e){"use step";try{await resumeParentHook(e.parentContinuationToken,e.hookPayload)}catch(t){let n=createErrorId();throw log.warn(`failed to forward proxied HITL batch to parent`,{callId:e.hookPayload.callId,childContinuationToken:e.hookPayload.childContinuationToken,childSessionId:e.hookPayload.childSessionId,errorId:n,parentContinuationToken:e.parentContinuationToken,subagentName:e.hookPayload.subagentName,error:t}),t}}async function resumeParentHook(e,t){let{resumeHook:n}=await import(`#internal/workflow/runtime.js`);await n(e,t)}export{SUBAGENT_ADAPTER};

package/dist/src/subagents/event-proxy-step.js

@@ -1 +1 @@
-import{publishFromSessionStep,restoreSessionStep}from"#execution/publish-session-events.js";import{withSessionStateDelta}from"#execution/session/state-delta.js";import{upsertProxyInputRequests}from"#harness/proxy-input-requests.js";import{emitProxiedAuthorizationEvent,emitProxiedInputRequest}from"#subagents/hitl-proxy.js";async function runProxySubagentEventStep(e){"use step";return await withSessionStateDelta(e,async e=>emitProxiedSubagentEvent({...await restoreSessionStep(e),workflowAsk:e.workflowAsk,runId:e.runId,hookPayload:e.hookPayload}))}async function emitProxiedSubagentEvent(e){let{hookPayload:t,runId:n,workflowAsk:r}=e,{published:i}=await publishFromSessionStep(e,{origin:`relayed`,inputSource:t.kind===`subagent-input-request`?JSON.stringify([t.childContinuationToken,t.inputSource??null]):void 0,async publish(e,n){if(t.kind===`subagent-authorization-event`){await emitProxiedAuthorizationEvent({emit:e,hookPayload:t,session:n});return}return await emitProxiedInputRequest({emit:e,hookPayload:t,session:n})},updateSession(e,i){return i===void 0||t.kind!==`subagent-input-request`?{session:e}:{session:upsertProxyInputRequests({entries:i.map(([e,t])=>[e,{...t,...r!==void 0&&{workflowAsk:r},...n!==void 0&&{runId:n}}]),forChildContinuationToken:t.childContinuationToken,inputSource:t.inputSource,session:e})}}});return i}export{emitProxiedSubagentEvent,runProxySubagentEventStep};
+import{currentProjection}from"#harness/session-machine/current.js";import{publishFromSessionStep,restoreSessionStep}from"#execution/publish-session-events.js";import{withSessionStateDelta}from"#execution/session/state-delta.js";import{applyTransition,sessionView}from"#harness/session-machine/commit.js";import{relay}from"#harness/session-machine/transitions.js";import{getProxyInputRequests,toProxyInputRequestEntries,upsertProxyInputRequests}from"#harness/proxy-input-requests.js";async function runProxySubagentEventStep(e){"use step";return await withSessionStateDelta(e,async e=>emitProxiedSubagentEvent({...await restoreSessionStep(e),workflowAsk:e.workflowAsk,runId:e.runId,hookPayload:e.hookPayload}))}async function emitProxiedSubagentEvent(e){let{ctx:t,hookPayload:n,runId:r,workflowAsk:i}=e,{published:a}=await publishFromSessionStep(e,{origin:`relayed`,inputSource:n.kind===`subagent-input-request`?JSON.stringify([n.childContinuationToken,n.inputSource??null]):void 0,async publish(e,r){let i=sessionView(currentProjection(t),r.state),a=n.kind===`subagent-input-request`?toProxyInputRequestEntries(n):void 0,o=new Set(a?.map(([e])=>e)),s=n.kind===`subagent-input-request`?[...getProxyInputRequests(r.state)].filter(([e,t])=>t.childContinuationToken===n.childContinuationToken&&t.inputSource===n.inputSource&&!o.has(e)).map(([e])=>e):[];return await applyTransition(r,relay(i,{payload:n,replacedRequestIds:s}),e),a},updateSession(e,t){return t===void 0||n.kind!==`subagent-input-request`?{session:e}:{session:upsertProxyInputRequests({entries:t.map(([e,t])=>[e,{...t,...i!==void 0&&{workflowAsk:i},...r!==void 0&&{runId:r}}]),forChildContinuationToken:n.childContinuationToken,inputSource:n.inputSource,session:e})}}});return a}export{emitProxiedSubagentEvent,runProxySubagentEventStep};

package/dist/src/subagents/hitl-proxy.d.ts

@@ -1,34 +1,10 @@
 import type { SessionInboxAddress } from "#execution/session-inbox/address.js";
-import type { DeliverPayload, SubagentAuthorizationEventHookPayload, SubagentInputRequestHookPayload } from "#channel/types.js";
-import type { PendingInputBatchEvent } from "#harness/pending-input-batches.js";
+import type { DeliverPayload } from "#channel/types.js";
+import type { StepCoordinates as PendingInputBatchEvent } from "#harness/session-machine/view.js";
 import type { WorkflowAskRoute, ProxyInputRequest } from "#harness/proxy-input-requests.js";
-import type { HarnessEmitFn, HarnessSessionBase, SessionStateMap } from "#harness/types.js";
-import { type InputResolution } from "#protocol/message.js";
+import type { SessionStateMap } from "#harness/types.js";
+import type { InputResolution } from "#protocol/message.js";
 import type { InputResponse } from "#shared/input.js";
-/**
- * Runs the parent-side work for a `subagent-input-request`: emits the request,
- * then `turn.waiting` for the parent's open turn. The call that asked is still
- * running, so the turn stays open until the answer lets that call settle. The
- * returned proxy entries route the eventual response back down to the asker.
- */
-export declare function emitProxiedInputRequest(input: {
-    readonly emit: HarnessEmitFn;
-    readonly hookPayload: SubagentInputRequestHookPayload;
-    readonly session: HarnessSessionBase;
-}): Promise<readonly (readonly [requestId: string, route: ProxyInputRequest])[]>;
-/**
- * Runs the parent-side work for a `subagent-authorization-event`: re-emits the
- * event, and after `authorization.required` parks the parent's open turn with
- * `turn.waiting`. The sign-in completes on the asker's own callback while the
- * call keeps running, so the parent's turn neither ends nor resets.
- */
-export declare function emitProxiedAuthorizationEvent(input: {
-    readonly emit: HarnessEmitFn;
-    readonly hookPayload: SubagentAuthorizationEventHookPayload;
-    readonly session: HarnessSessionBase;
-}): Promise<void>;
-/** The `turn.waiting` that parks the session's open turn while a person must act. */
-export declare function createTurnWaitingOnInputEvent(session: Pick<HarnessSessionBase, "state">): import("#protocol/message.js").TurnWaitingStreamEvent;
 /** One proxied-child bucket of a routed deliver payload. */
 export interface RoutedChildDelivery {
     readonly workflowAsk?: WorkflowAskRoute;