eve 0.29.2 → 0.29.4

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

@@ -1,130 +0,0 @@
-import { deriveSlackConnectorSlug, ensureChannel, type ChannelKind, type EvePackageContract } from "#setup/scaffold/index.js";
-import { detectPackageManager } from "#setup/package-manager.js";
-import { runPackageManagerInstall } from "#setup/primitives/pm/run.js";
-import { ensureVercelProject } from "#setup/flows/ensure-vercel-project.js";
-import { type ProjectResolution } from "../../project-resolution.js";
-import type { Asker } from "../../ask.js";
-import type { Prompter } from "../../prompter.js";
-import { provisionSlackbot, reconcileSlackUid } from "../../slackbot.js";
-import { type SetupBox } from "../../step.js";
-/** State required by channel setup, kept narrow so the integration can move packages. */
-export interface AddChannelsState {
-    projectPath: string | {
-        kind: "unresolved";
-        inPlace: boolean;
-    } | {
-        kind: "resolved";
-        inPlace: boolean;
-        path: string;
-    };
-    project: ProjectResolution;
-    channelSelection: ChannelKind[];
-    channels: ChannelKind[];
-    webScaffolded: boolean;
-    slackScaffolded: boolean;
-}
-/** Injected for tests; defaults to the real scaffold, Connect, and Vercel effects. */
-export interface AddChannelsDeps {
-    ensureChannel: typeof ensureChannel;
-    deriveSlackConnectorSlug: typeof deriveSlackConnectorSlug;
-    provisionSlackbot: typeof provisionSlackbot;
-    reconcileSlackUid: typeof reconcileSlackUid;
-    detectPackageManager: typeof detectPackageManager;
-    runPackageManagerInstall: typeof runPackageManagerInstall;
-    ensureVercelProject: typeof ensureVercelProject;
-}
-export interface AddChannelsOptions {
-    /** Resolves the slackbot question; the composed stack decides how. */
-    asker: Asker;
-    /**
-     * Logs through `prompter.log` in `perform`, and owns the interactive
-     * `vercel link` fallback. The slackbot question itself now travels the asker,
-     * not this prompter.
-     */
-    prompter: Prompter;
-    /**
-     * Headless mode: gates the interactive `vercel link` fallback inside `perform`
-     * and refuses Slack up front. Fixed at composition time (the same place the
-     * asker base is chosen), since `gather` cannot read the mode off the asker.
-     */
-    headless?: boolean;
-    /**
-     * eve package metadata for the scaffolded web `package.json`. When omitted,
-     * every package value comes from the build-stamped defaults.
-     */
-    evePackage?: EvePackageContract;
-    /** Reuse the preferred existing Slack connector without prompting. */
-    presetCreateSlackbot?: boolean;
-    /** Overwrite existing channel files (`eve add --overwrite channel/slack`). */
-    force?: boolean;
-    /** Credential source for Slack. Defaults to Vercel Connect. */
-    slackCredentials?: "vercel-connect" | "environment";
-    /**
-     * Override for the web scaffold's Vercel services config. The explicit
-     * environment plan takes precedence; otherwise this defaults to
-     * `hasVercelProject(state)`.
-     */
-    configureVercelServices?: boolean;
-    /**
-     * Opt-in fallback when Slack is chosen interactively but `state.project` is
-     * unresolved: link the project before provisioning the slackbot. The Slack
-     * integration sets this so Vercel Connect setup can link an unlinked project.
-     */
-    ensureLinkedProject?: "interactive-vercel-link";
-    /**
-     * What a failed slackbot provision (create or attach) does to the run. The
-     * default, "abort", fails the whole box — right for `eve add channel/slack`,
-     * where Slack is the point. "warn-and-continue" records nothing so a later
-     * `eve add channel/slack` starts clean.
-     */
-    slackbotFailure?: "abort" | "warn-and-continue";
-    deps?: AddChannelsDeps;
-    /** Registry installation already owns package dependency mutations. */
-    skipDependencyMutation?: boolean;
-}
-/**
- * Inputs resolved before `perform` runs channel effects.
- */
-export interface AddChannelsInput {
-    headless: boolean;
-    createSlackbot: boolean | undefined;
-}
-/** Slackbot facts resolved by a successful Connect provision. */
-export interface AddChannelsSlackbotFacts {
-    connectorUid: string;
-    /** Deep link that opens a DM compose with the bot ("chat with your agent"). */
-    chatUrl?: string;
-    workspaceName?: string;
-}
-/**
- * What `perform` actually did. `channelsAdded` lists the channels recorded this
- * run (web before slack); a skipped Web scaffold (Next.js detected) records
- * nothing, deliberately. `slackbot` is present only after a fresh, fully
- * attached provision; every failure mode either throws or (under
- * `slackbotFailure: "warn-and-continue"`) skips Slack entirely, so a failed
- * Slack setup records nothing (atomicity).
- */
-export interface AddChannelsPayload {
-    channelsAdded: ChannelKind[];
-    webScaffolded: boolean;
-    slackScaffolded: boolean;
-    /**
-     * Whether the post-scaffold dependency install succeeded. False both when no
-     * channels were recorded and when the install failed.
-     */
-    dependenciesChanged: boolean;
-    dependenciesInstalled: boolean;
-    project: ProjectResolution;
-    slackbot?: AddChannelsSlackbotFacts;
-}
-/**
- * Channel integration setup. Scaffolds the requested channel: writes the Web Chat files,
- * provisions the Slackbot through Vercel Connect, writes the Slack channel
- * definition, reconciles a Connect-assigned connector UID, and installs the
- * dependencies the scaffold added to `package.json` so a running `eve dev`
- * can load the new channel modules right away. The only prompt
- * (the slackbot question) travels the asker in `gather`; `perform` is promptless
- * and reads `state.project` directly, resolved earlier by the link box or the
- * in-project seed.
- */
-export declare function addChannels<State extends AddChannelsState = AddChannelsState>(options: AddChannelsOptions): SetupBox<State, AddChannelsInput, AddChannelsPayload>;

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

@@ -1,2 +0,0 @@
-import{isProjectResolved,mergeProjectResolution}from"../../project-resolution.js";import{WizardCancelledError}from"../../step.js";import{provisionSlackbot,reconcileSlackUid}from"../../slackbot.js";import{deriveSlackConnectorSlug,ensureChannel}from"#setup/scaffold/index.js";import{formatNodeEngineOverrideWarning}from"#setup/node-engine.js";import{detectPackageManager}from"#setup/package-manager.js";import{HumanActionRequiredError}from"#setup/human-action.js";import{createPromptCommandOutput,withPhase}from"#setup/cli/index.js";import{runPackageManagerInstall}from"#setup/primitives/pm/run.js";import{ensureVercelProject}from"#setup/flows/ensure-vercel-project.js";function slackbotFailureCopy(e){switch(e.state){case`not-installed`:return{reason:`Slackbot is not connected to a Slack workspace. Slack channel was not added.`,followUp:"Continuing without Slack — the install timed out and was cleaned up; re-run `eve add channel/slack` to try again."};case`cleanup-failed`:return{reason:`The abandoned Slack connector could not be removed. Slack channel was not added.`,followUp:`Continuing without Slack — resolve the cleanup warning above before trying again.`};case`connector-lookup-failed`:return{reason:`Existing Slack connectors could not be inspected. Slack channel was not added.`,followUp:"Continuing without Slack — restore Vercel CLI access, then re-run `eve add channel/slack`."};case`installation-check-failed`:return{reason:`Slack workspace installation could not be verified. Slack channel was not added.`,followUp:"Continuing without Slack — verify Vercel Connect is reachable, then re-run `eve add channel/slack`."};case`existing-not-installed`:return{reason:`The existing Slack connector is not connected to a Slack workspace. Slack channel was not added.`,followUp:`Continuing without Slack — resolve the existing connector warning above before trying again.`};case`detach-failed`:return{reason:`Slackbot provisioning could not replace the existing trigger destination. Slack channel was not added.`,followUp:"Continuing without Slack — run the `vercel connect detach` and `vercel connect attach` commands above."};case`attach-failed`:return{reason:`Slackbot provisioning did not attach this project. Slack channel was not added.`,followUp:"Continuing without Slack — finish event delivery with the `vercel connect attach` command above."};case`create-failed`:return{reason:`Slackbot creation failed.`,followUp:"Continuing without Slack — add it later with `eve add channel/slack`."}}}function warnOverwrittenFiles(e,t){for(let n of t??[])e.warning(`Overwrote ${n}`)}function warnCompetingNextConfigFiles(e,t){for(let n of t??[])e.warning(`Found competing Next.js config at ${n}; merge any needed settings into next.config.ts and remove it before starting the preview, or Next.js may ignore the generated eve rewrite.`)}function addChannels(f){let p=f.deps??{ensureChannel,deriveSlackConnectorSlug,provisionSlackbot,reconcileSlackUid,detectPackageManager,runPackageManagerInstall,ensureVercelProject};async function scaffoldSlackChannel(e,t,n,r,i,a){let o=!1;if(!t.slackScaffolded){let t=await p.ensureChannel({projectRoot:n,kind:`slack`,slackConnectorUid:a,slackConnectorSlug:r,force:f.force,skipDependencyMutation:f.skipDependencyMutation});i.dependenciesChanged||=t.packageJsonUpdated.length>0,warnOverwrittenFiles(e,t.filesOverwritten),t.action===`created`||t.action===`overwritten`?e.success(`Scaffolded channel: slack`):e.info(`Channel "slack" already exists. Skipping file creation.`),o=t.action!==`skipped`,i.slackScaffolded=!0}return i.channelsAdded.push(`slack`),o}async function addWebChannelToPayload(t,n,r,i,a,o){if(!n.channelSelection.includes(`web`))return;if(n.webScaffolded){a.channelsAdded.push(`web`);return}t.message(`Scaffolding Web Chat channel files...`);let c={projectRoot:r,kind:`web`,packageManager:i,force:f.force,configureVercelServices:f.configureVercelServices??isProjectResolved(n.project),skipDependencyMutation:f.skipDependencyMutation};f.evePackage!==void 0&&(c.webPackageVersions={evePackage:f.evePackage});let l=await p.ensureChannel(c);if(a.dependenciesChanged||=l.packageJsonUpdated.length>0,o?.throwIfAborted(),warnOverwrittenFiles(t,l.filesOverwritten),l.kind===`web`&&l.action!==`skipped`&&l.nodeEngineOverride!==void 0&&t.warning(formatNodeEngineOverrideWarning(l.nodeEngineOverride)),warnCompetingNextConfigFiles(t,`competingNextConfigFiles`in l?l.competingNextConfigFiles:void 0),l.action===`created`||l.action===`overwritten`){t.success(`Scaffolded channel: web`),a.webScaffolded=!0,a.channelsAdded.push(`web`);return}t.info(`Next.js project detected. Skipping Web Chat scaffolding.`)}function assertSlackProjectReady(t){if(f.ensureLinkedProject===void 0){if(!isProjectResolved(t.project))throw Error(`Slack setup with Vercel Connect requires a linked Vercel project.`);if(!isProjectResolved(t.project))throw Error(`Expected a linked Vercel project for Slack, but none was resolved.`)}}async function provisionSlackbotWithControls(e,t,n,r){let i={selectConnector:async(e,t)=>{if(f.presetCreateSlackbot===!0)return t??e[0];let n={message:`Which Slack app would you like to use?`,options:[...e.map(e=>{let n={value:e.uid,label:`Use ${e.uid}`};return e.uid===t?.uid&&(n.hint=`Matches this agent`),n}),{value:`create`,label:`Create a new Slack app`}],initialValue:t?.uid},r=await f.prompter.select(n);return r===`create`?`create`:e.find(e=>e.uid===r)}};return r!==void 0&&(i.signal=r),f.prompter.awaitChoice!==void 0&&(i.awaitChoice=f.prompter.awaitChoice),p.provisionSlackbot(e,t,n,void 0,i)}async function scaffoldAttachedSlackChannel(e,t,n,r,i,a){if(!await scaffoldSlackChannel(e,t,n,r,i,a.connectorUid)&&!await p.reconcileSlackUid(e,n,a,`slack/${r}`))throw Error(`Slack connector UID update is required before deployment.`)}async function addSlackChannelToPayload(r,i,a,o,s,c){if(!i.channelSelection.includes(`slack`))return;let u=await p.deriveSlackConnectorSlug(o);if(f.slackCredentials===`environment`){if(!i.slackScaffolded){let e=await p.ensureChannel({projectRoot:o,kind:`slack`,slackConnectorSlug:u,slackCredentials:`environment`,force:f.force,skipDependencyMutation:f.skipDependencyMutation});s.dependenciesChanged||=e.packageJsonUpdated.length>0,warnOverwrittenFiles(r,e.filesOverwritten),e.action===`created`||e.action===`overwritten`?r.success(`Scaffolded channel: slack`):r.info(`Channel "slack" already exists. Skipping file creation.`),s.slackScaffolded=!0}s.channelsAdded.push(`slack`);return}if(assertSlackProjectReady(i),!isProjectResolved(s.project)){if(a.headless)throw new HumanActionRequiredError({kind:`vercel-link`,command:`vercel link`,reason:`Slackbot creation needs this directory linked to a Vercel project.`});let e=await p.ensureVercelProject({appRoot:o,prompter:f.prompter,signal:c});s.project=mergeProjectResolution(s.project,{kind:`linked`,projectId:e.projectId})}let d=await provisionSlackbotWithControls(r,o,u,c);if(c?.throwIfAborted(),d.state===`cancelled`)throw new WizardCancelledError;if(d.state!==`attached`){let e=slackbotFailureCopy(d);if(f.slackbotFailure!==`warn-and-continue`)throw Error(e.reason);r.warning(`${e.reason} ${e.followUp}`);return}s.slackbot={connectorUid:d.connectorUid,chatUrl:d.chatUrl,workspaceName:d.workspaceName},await scaffoldAttachedSlackChannel(r,i,o,u,s,d)}async function installChannelDependencies(e,t,n,r,i){if(!(f.skipDependencyMutation||!r.dependenciesChanged)){if(await withPhase(e,`Installing channel dependencies (${n} install)...`,()=>p.runPackageManagerInstall(n,t,{onOutput:createPromptCommandOutput(e),signal:i}))){r.dependenciesInstalled=!0;return}e.warning(`Dependency installation failed. The new channels stay unloadable until \`${n} install\` or a deploy succeeds.`)}}async function performAddChannels(e,t,n){n?.throwIfAborted();let r=f.prompter.log,i=typeof e.projectPath==`string`?e.projectPath:e.projectPath.kind===`resolved`?e.projectPath.path:void 0;if(i===void 0)throw Error(`Project path has not been resolved.`);let a={channelsAdded:[],webScaffolded:e.webScaffolded,slackScaffolded:e.slackScaffolded,dependenciesChanged:!1,dependenciesInstalled:!1,project:e.project},o=await p.detectPackageManager(i);return await addWebChannelToPayload(r,e,i,o.kind,a,n),await addSlackChannelToPayload(r,e,t,i,a,n),await installChannelDependencies(r,i,o.kind,a,n),a}return{id:`add-channels`,async gather({state:e}){let t=f.headless??!1;if(t&&e.channelSelection.includes(`slack`)&&f.slackCredentials!==`environment`)throw Error("Slack setup is interactive. Run `eve add channel/slack` from an interactive terminal.");return{headless:t,createSlackbot:f.presetCreateSlackbot}},async perform({state:e,input:t,signal:r}){try{return await performAddChannels(e,t,r)}catch(e){if(!(e instanceof WizardCancelledError)){let t=e instanceof Error?e.message:String(e),n=t.split(`
-`)[0]?.trim()??t;f.prompter.log.error(n)}throw e}},apply(e,n){let r=[...e.channels];for(let e of n.channelsAdded)r.includes(e)||r.push(e);let i={...e,channels:r,webScaffolded:n.webScaffolded,slackScaffolded:n.slackScaffolded,project:mergeProjectResolution(e.project,n.project)};return n.slackbot,i}}}export{addChannels};

package/dist/src/setup/integrations/channels/slack.d.ts

@@ -1,3 +0,0 @@
-import type { ChannelSetupIntegration } from "./types.js";
-/** Slack's channel-owned credential choice, provisioning, and scaffold behavior. */
-export declare const SLACK_CHANNEL_SETUP: ChannelSetupIntegration;

package/dist/src/setup/integrations/channels/slack.js

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

package/dist/src/setup/integrations/channels/types.d.ts

@@ -1,49 +0,0 @@
-import type { AddChannelsDeps } from "./setup.js";
-import type { ChannelSetupEnvironment } from "./environment.js";
-import type { ChannelSetupUi } from "./ui.js";
-import type { ChannelKind } from "../../scaffold/index.js";
-import type { ProjectResolution } from "../../project-resolution.js";
-/** Narrow state owned by one channel setup invocation. */
-export interface ChannelSetupState {
-    readonly projectPath: string | {
-        kind: "unresolved";
-        inPlace: boolean;
-    } | {
-        kind: "resolved";
-        inPlace: boolean;
-        path: string;
-    };
-    readonly project: ProjectResolution;
-    readonly channelSelection: ChannelKind[];
-    readonly channels: ChannelKind[];
-    readonly webScaffolded: boolean;
-    readonly slackScaffolded: boolean;
-}
-/** Shared inputs available to a channel-owned setup implementation. */
-export interface ChannelSetupContext {
-    readonly environment: ChannelSetupEnvironment;
-    readonly state: Readonly<ChannelSetupState>;
-    readonly ui: ChannelSetupUi;
-    readonly signal?: AbortSignal;
-    readonly force?: boolean;
-    readonly headless?: boolean;
-    readonly presetCreateSlackbot?: boolean;
-    readonly presetPortableCredentials?: boolean;
-    readonly deps?: AddChannelsDeps;
-    /** Registry installation already owns package dependency mutations. */
-    readonly skipDependencyMutation?: boolean;
-}
-/** Structured outcome from a channel-owned setup implementation. */
-export type ChannelSetupResult = {
-    readonly kind: "done";
-    readonly state: ChannelSetupState;
-} | {
-    readonly kind: "cancelled";
-};
-/** Setup behavior paired with canonical channel catalog metadata. */
-export interface ChannelSetupIntegration {
-    readonly kind: ChannelKind;
-    readonly label: string;
-    readonly hint?: string;
-    setup(context: ChannelSetupContext): Promise<ChannelSetupResult>;
-}

package/dist/src/setup/integrations/channels/ui.js

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

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

@@ -1,3 +0,0 @@
-import type { ChannelSetupIntegration } from "./types.js";
-/** Web Chat's channel-owned setup behavior. */
-export declare const WEB_CHANNEL_SETUP: ChannelSetupIntegration;

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

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