eve 0.5.4 → 0.6.0-beta.3

package/dist/src/cli/commands/channel-add-conflicts.d.ts

@@ -0,0 +1,21 @@
+import type { ChannelKind } from "@vercel/eve-scaffold";
+import type { DisabledChannelReasons } from "@vercel/eve-scaffold/cli";
+/**
+ * Existing authored registrations that affect the scaffolded channel picker
+ * or would conflict with a generated channel module.
+ */
+export interface ExistingChannelRegistrations {
+    readonly disabledChannelReasons: DisabledChannelReasons;
+    readonly webRouteOwners: readonly string[];
+    readonly slackOwners: readonly string[];
+}
+/**
+ * Inspects compiled authored channels so custom filenames still disable the
+ * scaffold option for the channel behavior they register.
+ */
+export declare function inspectExistingChannelRegistrations(projectRoot: string): Promise<ExistingChannelRegistrations>;
+/**
+ * Rejects scaffolding when another authored module already owns behavior
+ * emitted by the generated channel module.
+ */
+export declare function assertCanAddSelectedChannels(selectedChannels: readonly ChannelKind[], registrations: ExistingChannelRegistrations): void;

package/dist/src/cli/commands/channel-add-conflicts.js

@@ -0,0 +1 @@
+import{EVE_CREATE_SESSION_ROUTE_PATH}from"#protocol/routes.js";import{join}from"node:path";import{compileChannelDefinition}from"#compiler/normalize-channel.js";import{discoverAgent}from"#discover/discover-agent.js";const SCAFFOLDED_WEB_CHANNEL_LOGICAL_PATH=`channels/eve.ts`;async function inspectExistingChannelRegistrations(a){let o=join(a,`agent`),{manifest:s}=await discoverAgent({agentRoot:o,appRoot:a}),c=new Set,l=new Set;for(let t of s.channels){let r=await compileChannelDefinition(o,t),i=Array.isArray(r)?r:[r];for(let n of i)n.kind===`channel`&&(n.method===`POST`&&n.urlPath===EVE_CREATE_SESSION_ROUTE_PATH&&c.add(t.logicalPath),n.adapterKind===`slack`&&l.add(t.logicalPath))}let u={};return[...c].some(e=>e!==SCAFFOLDED_WEB_CHANNEL_LOGICAL_PATH)&&(u.web=`POST ${EVE_CREATE_SESSION_ROUTE_PATH} already registered`),l.size>0&&(u.slack=`Slack channel already registered`),{disabledChannelReasons:u,webRouteOwners:[...c],slackOwners:[...l]}}function assertCanAddSelectedChannels(t,n){if(t.includes(`web`)){let t=n.webRouteOwners.find(e=>e!==SCAFFOLDED_WEB_CHANNEL_LOGICAL_PATH);if(t!==void 0)throw Error(`Cannot scaffold Web Chat because agent/${t} already defines POST ${EVE_CREATE_SESSION_ROUTE_PATH}. Web Chat scaffolds the same Eve session routes.`)}if(t.includes(`slack`)){let e=n.slackOwners.find(e=>e!==`channels/slack.ts`);if(e!==void 0)throw Error(`Cannot scaffold Slack because agent/${e} already defines a Slack channel. Slack scaffolding would register the channel again.`)}}export{assertCanAddSelectedChannels,inspectExistingChannelRegistrations};

package/dist/src/cli/commands/channels.d.ts

@@ -0,0 +1,26 @@
+import { type AddToAgentState, type DeployProjectOptions, type RunAddToAgentOptions } from "@vercel/eve-scaffold/steps";
+import { type ChannelAddPrompter } from "@vercel/eve-scaffold/cli";
+import { type DeploymentInfo } from "@vercel/eve-scaffold/primitives";
+export interface CliLogger {
+    error(message: string): void;
+    log(message: string): void;
+}
+export interface AddChannelCommandOptions {
+    force?: boolean;
+    /** Assume yes for confirmations (slackbot creation). Requires an explicit kind. */
+    yes?: boolean;
+}
+export interface ChannelsAddDependencies {
+    createPrompter?: () => ChannelAddPrompter;
+    detectDeployment(projectPath: string): Promise<DeploymentInfo>;
+    deployProject(options: DeployProjectOptions): Promise<AddToAgentState>;
+    runAddToAgent(options: RunAddToAgentOptions): Promise<AddToAgentState>;
+}
+export declare function runChannelsAddCommand(logger: CliLogger, appRoot: string, args: {
+    kind?: string;
+    options: AddChannelCommandOptions;
+}, dependencies?: ChannelsAddDependencies): Promise<void>;
+export interface ListChannelsCommandOptions {
+    json?: boolean;
+}
+export declare function runChannelsListCommand(logger: CliLogger, appRoot: string, options: ListChannelsCommandOptions): Promise<void>;

package/dist/src/cli/commands/channels.js

@@ -0,0 +1 @@
+import{assertCanAddSelectedChannels,inspectExistingChannelRegistrations}from"./channel-add-conflicts.js";import{isEveProject}from"../../packages/eve-scaffold/src/project.js";import{listAuthoredChannels}from"../../packages/eve-scaffold/src/channels.js";import"../../packages/eve-scaffold/src/index.js";import{detectDeployment}from"../../packages/eve-scaffold/src/primitives/detect-deployment.js";import{createAddToAgentState,deployProject,runAddToAgent}from"../../packages/eve-scaffold/src/steps/run-add-to-agent.js";import"../../packages/eve-scaffold/src/steps/index.js";import{ChannelAddCancelledError,createChannelAddPrompter}from"../../packages/eve-scaffold/src/cli/channel-add-prompter.js";import"../../packages/eve-scaffold/src/cli/index.js";import"../../packages/eve-scaffold/src/primitives/index.js";const NOT_AN_AGENT_MESSAGE="No Eve agent in this directory. Run `pnpm create eve`, then run this command from inside the new project.",KNOWN_CHANNEL_KINDS=[`slack`,`web`];function isChannelKind(e){return KNOWN_CHANNEL_KINDS.includes(e)}function parseChannelKind(e){if(!isChannelKind(e))throw Error(`Unknown channel kind "${e}". Known: ${KNOWN_CHANNEL_KINDS.join(`, `)}.`);return e}const defaultChannelsAddDependencies={detectDeployment,deployProject,runAddToAgent};async function runAddChannelsFlow(n,r,i,o){if(r===void 0&&(i.yes||!process.stdin.isTTY||!process.stdout.isTTY))throw Error(`Pass a channel kind: \`eve channels add <${KNOWN_CHANNEL_KINDS.join(`|`)}>\`.`);let s=o.createPrompter?.()??createChannelAddPrompter();s.intro(`Add channels to your Eve agent`),s.log.message(`Checking the current Vercel project...`);let c=createAddToAgentState(await o.detectDeployment(n)),l;function inspectRegistrations(){return l===void 0&&(s.log.message(`Inspecting existing channel registrations...`),l=inspectExistingChannelRegistrations(n)),l}let u=r===void 0?(await inspectRegistrations()).disabledChannelReasons:void 0;c=await o.runAddToAgent({prompter:s,projectPath:n,state:c,presetChannels:r===void 0?void 0:[r],presetCreateSlackbot:i.yes?!0:void 0,disabledChannelReasons:u,force:i.force,validateSelectedChannels:async t=>{!t.includes(`web`)&&!t.includes(`slack`)||assertCanAddSelectedChannels(t,await inspectRegistrations())}}),c=await o.deployProject({prompter:s,projectPath:n,state:c}),s.outro(c.channels.length===0?`No channels added.`:`Channels added.`)}async function runChannelsAddCommand(e,t,r,i=defaultChannelsAddDependencies){if(!await isEveProject(t)){e.error(NOT_AN_AGENT_MESSAGE),process.exitCode=1;return}try{await runAddChannelsFlow(t,r.kind===void 0?void 0:parseChannelKind(r.kind),r.options,i)}catch(t){if(t instanceof ChannelAddCancelledError)return;e.error(t instanceof Error?t.message:String(t)),process.exitCode=1}}async function runChannelsListCommand(e,t,i){if(!await isEveProject(t)){e.error(NOT_AN_AGENT_MESSAGE),process.exitCode=1;return}let a=await listAuthoredChannels(t);if(i.json){e.log(JSON.stringify({channels:a},null,2));return}if(a.length===0){e.log("No channels defined. Run `eve channels add` to add one.");return}for(let t of a)e.log(t)}export{runChannelsAddCommand,runChannelsListCommand};

package/dist/src/cli/commands/info.d.ts

@@ -0,0 +1,53 @@
+import { type ApplicationInspection } from "#services/inspect-application.js";
+interface CliInfoLogger {
+    log(message: string): void;
+}
+/** Options accepted by {@link printApplicationInfo}. */
+export interface PrintApplicationInfoOptions {
+    /** Emit a machine-readable JSON document instead of the human table. */
+    json?: boolean;
+}
+/** Machine-readable view of an application inspection, emitted by `eve info --json`. */
+export interface ApplicationInfoJson {
+    appRoot: string;
+    agentRoot: string | null;
+    layout: string | null;
+    status: string;
+    diagnostics: {
+        errors: number;
+        warnings: number;
+    } | null;
+    model: string | null;
+    instructions: string | null;
+    skills: string[];
+    tools: string[];
+    channels: {
+        name: string;
+        kind: string | null;
+        method: string | null;
+        urlPath: string | null;
+    }[];
+    messaging: {
+        create: string;
+        continue: string;
+        stream: string;
+    };
+    artifacts: {
+        compiledManifest: string;
+        discoveryManifest: string;
+        diagnostics: string;
+        moduleMap: string;
+        metadata: string;
+    } | null;
+}
+/**
+ * Projects a structured inspection into the stable `eve info --json` contract.
+ * Tools and channels an agent relies on to verify setup come straight from the
+ * compiled manifest, so this stays in sync with what the runtime actually serves.
+ */
+export declare function buildApplicationInfoJson(inspection: ApplicationInspection): ApplicationInfoJson;
+/**
+ * Writes resolved application details and the active message-route contract.
+ */
+export declare function printApplicationInfo(logger: CliInfoLogger, appRoot: string, options?: PrintApplicationInfoOptions): Promise<void>;
+export {};

package/dist/src/cli/commands/info.js

@@ -0,0 +1,2 @@
+import{inspectApplication}from"#services/inspect-application.js";import{createCliTheme,renderCliBanner,renderCliSection}from"#cli/ui/output.js";function buildApplicationInfoJson(e){let{application:t,compiledState:n,messaging:r}=e;return{appRoot:t.appRoot,agentRoot:n?.project.agentRoot??null,layout:n?.project.layout??null,status:n?.metadata.status??`unavailable`,diagnostics:n?{errors:n.metadata.discovery.summary.errors,warnings:n.metadata.discovery.summary.warnings}:null,model:n?.manifest.config.model.id??null,instructions:n?.manifest.instructions?.logicalPath??null,skills:(n?.manifest.skills??[]).map(e=>e.name),tools:(n?.manifest.tools??[]).map(e=>e.name),channels:(n?.manifest.channels??[]).map(e=>e.kind===`channel`?{name:e.name,kind:e.adapterKind??null,method:e.method,urlPath:e.urlPath}:{name:e.name,kind:`disabled`,method:null,urlPath:null}),messaging:{create:r.createSessionRoutePath,continue:r.continueSessionRoutePattern,stream:r.streamRoutePattern},artifacts:n?{compiledManifest:n.paths.compiledManifestPath,discoveryManifest:n.paths.discoveryManifestPath,diagnostics:n.paths.diagnosticsPath,moduleMap:n.paths.moduleMapPath,metadata:n.paths.compileMetadataPath}:null}}function pluralize(e,t){return`${e} ${t}${e===1?``:`s`}`}function formatDiscoverySummary(e,t){return`${pluralize(e,`error`)}, ${pluralize(t,`warning`)}`}function resolveCompileTone(e){switch(e){case`ready`:return`success`;case`failed`:return`danger`;default:return`warning`}}async function printApplicationInfo(i,a,o={}){let s=await inspectApplication(a);if(o.json){i.log(JSON.stringify(buildApplicationInfoJson(s),null,2));return}let c=s.compiledState,l=s.application,u=createCliTheme(),d=[{label:`App Root`,value:l.appRoot}],f=[{label:`Workflow Build`,value:l.workflowBuildDir},{label:`Output`,value:l.outputDir}],p=[];c===null?d.push({label:`Compile`,tone:`warning`,value:`unavailable`}):(d.push({label:`Agent Root`,value:c.project.agentRoot},{label:`Layout`,value:c.project.layout},{label:`Compile`,tone:resolveCompileTone(c.metadata.status),value:c.metadata.status},{label:`Diagnostics`,tone:c.metadata.discovery.summary.errors>0?`danger`:c.metadata.discovery.summary.warnings>0?`warning`:`success`,value:formatDiscoverySummary(c.metadata.discovery.summary.errors,c.metadata.discovery.summary.warnings)},{label:`Instructions`,value:c.manifest.instructions?.logicalPath??`none`},{label:`Skills`,value:pluralize(c.manifest.skills.length,`skill`)}),f.unshift({label:`Compiled Manifest`,value:c.paths.compiledManifestPath},{label:`Discovery Manifest`,value:c.paths.discoveryManifestPath},{label:`Diagnostics`,value:c.paths.diagnosticsPath},{label:`Module Map`,value:c.paths.moduleMapPath},{label:`Metadata`,value:c.paths.compileMetadataPath}),p.push(c.manifest.instructions===void 0?{label:`Instructions`,value:`No instructions prompt discovered.`}:{label:`Instructions`,value:c.manifest.instructions.logicalPath})),i.log([renderCliBanner(u,{subtitle:`Resolved application paths and the active message contract.`,title:`Eve Info`}),``,renderCliSection(u,{rows:d,title:`Application`}),``,renderCliSection(u,{rows:f,title:`Artifacts`}),...c===null?[]:[``,renderCliSection(u,{rows:p,title:`Instructions`})],``,renderCliSection(u,{rows:[{label:`Workflow ID`,value:l.workflowId},{label:`Source Dir`,value:l.workflowSourceDir},{label:`Create`,tone:`info`,value:`POST ${s.messaging.createSessionRoutePath}`},{label:`Continue`,tone:`info`,value:`POST ${s.messaging.continueSessionRoutePattern}`},{label:`Stream`,tone:`info`,value:`GET ${s.messaging.streamRoutePattern}`}],title:`Messaging`})].join(`
+`))}export{buildApplicationInfoJson,printApplicationInfo};

package/dist/src/cli/dev/environment.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Development environment files loaded by local CLI commands such as
+ * `eve dev`, `eve build`, and `eve eval`, ordered from highest to lowest
+ * precedence.
+ */
+export declare const DEVELOPMENT_ENV_FILE_NAMES: readonly [".env.development.local", ".env.local", ".env.development", ".env"];
+/**
+ * Returns the local development environment files Eve loads from an
+ * application root, ordered from highest to lowest precedence.
+ */
+export declare function getDevelopmentEnvironmentFilePaths(appRoot: string): string[];
+/**
+ * Loads or reloads local development environment files from the application
+ * root.
+ *
+ * Variables that existed before the first load keep parent-process
+ * precedence. Variables supplied by env files are refreshed on subsequent
+ * reloads so dev-mode file watching can pick up changed values.
+ */
+export declare function loadDevelopmentEnvironmentFiles(appRoot: string): void;

package/dist/src/cli/dev/environment.js

@@ -0,0 +1 @@
+import{join,resolve}from"node:path";import{readFileSync}from"node:fs";import{parseEnv}from"node:util";import{isObject}from"#shared/guards.js";const DEVELOPMENT_ENV_FILE_NAMES=[`.env.development.local`,`.env.local`,`.env.development`,`.env`];function isMissingEnvironmentFileError(e){return isObject(e)&&e.code===`ENOENT`}const developmentEnvironmentLoaders=new Map;function getDevelopmentEnvironmentFilePaths(n){let r=resolve(n);return DEVELOPMENT_ENV_FILE_NAMES.map(t=>join(r,t))}function loadDevelopmentEnvironmentFiles(e){getDevelopmentEnvironmentLoader(e).reload()}function getDevelopmentEnvironmentLoader(e){let n=resolve(e),r=developmentEnvironmentLoaders.get(n);if(r!==void 0)return r;let i=createDevelopmentEnvironmentLoader(n);return developmentEnvironmentLoaders.set(n,i),i}function createDevelopmentEnvironmentLoader(e){let t=new Set(Object.keys(process.env)),n=new Map;return{reload(){let r=readDevelopmentEnvironmentValues(e);for(let[e,i]of n)r.has(e)||t.has(e)||(process.env[e]===i&&delete process.env[e],n.delete(e));for(let[e,i]of r)t.has(e)||(process.env[e]=i,n.set(e,i))}}}function readDevelopmentEnvironmentValues(t){let i=new Map;for(let o of[...DEVELOPMENT_ENV_FILE_NAMES].reverse())try{let a=parseEnv(readFileSync(join(t,o),`utf8`));for(let[e,t]of Object.entries(a))t!==void 0&&i.set(e,t)}catch(e){if(!isMissingEnvironmentFileError(e))throw e}return i}export{DEVELOPMENT_ENV_FILE_NAMES,getDevelopmentEnvironmentFilePaths,loadDevelopmentEnvironmentFiles};

package/dist/src/cli/dev/repl/input-requests.d.ts

@@ -0,0 +1,38 @@
+import type { HandleMessageStreamEvent } from "#protocol/message.js";
+import type { InputRequest, InputResponse } from "#runtime/input/types.js";
+import { type CliTheme } from "#cli/ui/output.js";
+/**
+ * Sentinel returned when the CLI user pressed Escape while responding to a
+ * pending runtime input request.
+ */
+export declare const ESCAPED_RUNTIME_INPUT_PROMPT: unique symbol;
+/**
+ * One raw answer collected from the CLI while prompting for pending runtime
+ * input requests.
+ */
+export type RuntimeInputPromptValue = string | typeof ESCAPED_RUNTIME_INPUT_PROMPT | undefined;
+/**
+ * Outcome of one interactive CLI prompt pass for pending runtime input.
+ */
+export type RuntimeInputPromptResult = {
+    readonly inputResponses: readonly InputResponse[];
+    readonly kind: "submitted";
+} | {
+    readonly kind: "deferred";
+} | {
+    readonly kind: "aborted";
+};
+/**
+ * Returns the last pending runtime-input batch emitted in one turn, if any.
+ */
+export declare function extractPendingRuntimeInputRequests(events: readonly HandleMessageStreamEvent[]): readonly InputRequest[];
+/**
+ * Interactively collects CLI-native responses for pending runtime input
+ * requests.
+ */
+export declare function promptForRuntimeInputRequests(input: {
+    ask(prompt: string): Promise<RuntimeInputPromptValue>;
+    print(message: string): void;
+    requests: readonly InputRequest[];
+    theme: CliTheme;
+}): Promise<RuntimeInputPromptResult>;

package/dist/src/cli/dev/repl/input-requests.js

@@ -0,0 +1 @@
+import{renderCliTaggedLine}from"#cli/ui/output.js";import{resolveTextToResponse}from"#channel/resolve-text.js";const ESCAPED_RUNTIME_INPUT_PROMPT=Symbol(`eve.cli.runtime-input.escaped`);function extractPendingRuntimeInputRequests(e){for(let t=e.length-1;t>=0;--t){let n=e[t];if(n?.type===`input.requested`)return n.data.requests}return[]}async function promptForRuntimeInputRequests(t){let n=[];t.print(renderCliTaggedLine(t.theme,{message:`pending input request${t.requests.length===1?``:`s`}: reply now, press Escape, or type "skip" to return to the normal prompt`,tag:`input`,tone:`info`}));for(let e of t.requests){let r=await promptForRuntimeInputRequest({ask:t.ask,print:t.print,request:e,theme:t.theme});if(r.kind!==`submitted`)return r;n.push(r.inputResponse)}return{inputResponses:n,kind:`submitted`}}function isApprovalRequest(e){return e.display===`confirmation`}async function promptForRuntimeInputRequest(e){return isApprovalRequest(e.request)?await promptForApprovalInputRequest({ask:e.ask,print:e.print,request:e.request,theme:e.theme}):await promptForQuestionInputRequest({ask:e.ask,print:e.print,request:e.request,theme:e.theme})}async function promptForApprovalInputRequest(t){for(t.print(renderCliTaggedLine(t.theme,{message:`approve tool "${t.request.action.toolName}"? (yes/no)`,tag:`approval`,tone:`warning`})),t.print(renderCliTaggedLine(t.theme,{message:JSON.stringify(t.request.action.input,null,2),tag:`tool`,tone:`muted`}));;){let r=await t.ask(`approval> `);if(r===void 0)return{kind:`aborted`};if(r===ESCAPED_RUNTIME_INPUT_PROMPT)return{kind:`deferred`};let i=r.trim().toLowerCase();if(i===`skip`||i===`/skip`)return{kind:`deferred`};if(i===`a`||i===`approve`||i===`y`||i===`yes`)return{inputResponse:{optionId:`approve`,requestId:t.request.requestId},kind:`submitted`};if(i===`d`||i===`deny`||i===`n`||i===`no`)return{inputResponse:{optionId:`deny`,requestId:t.request.requestId},kind:`submitted`};t.print(renderCliTaggedLine(t.theme,{message:`enter "yes" to approve, "no" to deny, press Escape, or type "skip" to return to the normal prompt`,tag:`input`,tone:`warning`}))}}async function promptForQuestionInputRequest(r){r.print(renderCliTaggedLine(r.theme,{message:r.request.prompt,tag:`question`,tone:`info`}));for(let[t,n]of(r.request.options??[]).entries())r.print(renderCliTaggedLine(r.theme,{message:`${t+1}. ${n.label}${n.description===void 0?``:` - ${n.description}`}`,tag:`option`,tone:`muted`}));let i=r.request.allowFreeform===!0||(r.request.options?.length??0)===0;for(;;){let a=await r.ask(`answer> `);if(a===void 0)return{kind:`aborted`};if(a===ESCAPED_RUNTIME_INPUT_PROMPT)return{kind:`deferred`};let o=a.trim();if(o===`skip`||o===`/skip`)return{kind:`deferred`};let s=resolveTextToResponse(o,r.request);if(s!==void 0)return{inputResponse:s,kind:`submitted`};r.print(renderCliTaggedLine(r.theme,{message:r.request.options===void 0||r.request.options.length===0?`enter a response, press Escape, or type "skip" to return to the normal prompt`:i?`enter an option number/id, freeform text, press Escape, or type "skip" to return to the normal prompt`:`enter an option number/id, press Escape, or type "skip" to return to the normal prompt`,tag:`input`,tone:`warning`}))}}export{ESCAPED_RUNTIME_INPUT_PROMPT,extractPendingRuntimeInputRequests,promptForRuntimeInputRequests};

package/dist/src/cli/dev/repl/input.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Parsed result for one line of interactive `eve dev` input.
+ */
+export type DevReplInput = {
+    kind: "empty";
+} | {
+    kind: "exit";
+} | {
+    kind: "help";
+} | {
+    kind: "new";
+} | {
+    kind: "message";
+    message: string;
+};
+/**
+ * Parse one line of input for the minimal development REPL.
+ */
+export declare function parseDevReplInput(value: string): DevReplInput;

package/dist/src/cli/dev/repl/input.js

@@ -0,0 +1 @@
+function parseDevReplInput(e){let t=e.trim();return t.length===0?{kind:`empty`}:t===`/exit`||t===`/quit`?{kind:`exit`}:t===`/help`?{kind:`help`}:t===`/new`?{kind:`new`}:{kind:`message`,message:t}}export{parseDevReplInput};

package/dist/src/cli/dev/repl/repl.d.ts

@@ -0,0 +1,62 @@
+import { type HandleMessageStreamEvent } from "#protocol/message.js";
+import type { InputRequest } from "#runtime/input/types.js";
+import { type CliTheme } from "#cli/ui/output.js";
+import { createDevelopmentTerminal } from "#cli/dev/repl/terminal.js";
+export type ReplDisplayBlockKind = "content" | "meta";
+export type LiveContentKind = "message" | "reasoning";
+export interface FormattedContentEvent {
+    readonly finalized: boolean;
+    readonly kind: LiveContentKind;
+    readonly line: string;
+}
+export interface TurnDisplayState {
+    readonly activeLiveContentKind: LiveContentKind | null;
+    readonly lastPrintedBlockKind: ReplDisplayBlockKind | null;
+}
+interface TurnEventRenderOptions {
+    readonly isSubagent?: boolean;
+    readonly sourceLabel?: string;
+}
+export type TurnDisplayTerminal = Pick<ReturnType<typeof createDevelopmentTerminal>, "commitLive" | "print" | "updateLive">;
+export declare function formatContentEvent(theme: CliTheme, event: HandleMessageStreamEvent, options?: TurnEventRenderOptions): FormattedContentEvent | undefined;
+export declare function formatEvent(theme: CliTheme, event: HandleMessageStreamEvent, options?: TurnEventRenderOptions): string | undefined;
+export declare function createTurnDisplayState(): TurnDisplayState;
+export declare function renderTurnEvent(input: {
+    readonly event: HandleMessageStreamEvent;
+    readonly options?: TurnEventRenderOptions;
+    readonly state: TurnDisplayState;
+    readonly terminal: TurnDisplayTerminal;
+    readonly theme: CliTheme;
+}): TurnDisplayState;
+/**
+ * Decides whether the REPL should drain in-flight subagent stream
+ * subscriptions before redrawing the next user prompt.
+ *
+ * Returns `true` for ordinary turn boundaries (no pending input
+ * requests on the parent stream). The drain ensures any final
+ * subagent events — `session.completed`, `session.failed`, or
+ * trailing messages — render in order with the parent boundary.
+ *
+ * Returns `false` when the parent's boundary carries one or more
+ * pending input requests (HITL). A subagent that triggered the HITL
+ * request runs in `task` mode (see `execution/subagent-tool.ts`)
+ * and never emits a turn-boundary event on its own stream while
+ * parked for HITL — `harness/tool-loop.ts` gates `emitTurnEpilogue`
+ * on `mode === "conversation"`. Blocking on
+ * `ReplSubagentStreamManager.waitForIdle()` here would stall the
+ * prompt until the subagent's serverless function times out, which
+ * is exactly the multi-minute delay this gate prevents.
+ *
+ * Subagent subscriptions stay alive across the prompt; they resume
+ * rendering when the user answers and the subagent unparks.
+ *
+ * Exported for unit-test coverage of the gating contract.
+ */
+export declare function shouldDrainSubagentStreamsOnBoundary(pendingInputRequests: readonly InputRequest[]): boolean;
+/**
+ * Run the minimal interactive `eve dev` REPL against an Eve server.
+ */
+export declare function runDevelopmentRepl(input: {
+    serverUrl: string;
+}): Promise<void>;
+export {};

package/dist/src/cli/dev/repl/repl.js

@@ -0,0 +1,2 @@
+import{EVE_CONTINUE_SESSION_ROUTE_PATTERN,EVE_CREATE_SESSION_ROUTE_PATH,EVE_MESSAGE_STREAM_ROUTE_PATTERN,createEveMessageStreamRoutePath}from"#protocol/routes.js";import{createInterface,emitKeypressEvents}from"node:readline";import{createCliTheme,renderCliBanner,renderCliSection,renderCliSpeakerLine,renderCliTaggedLine}from"#cli/ui/output.js";import{openStreamIterable}from"#client/open-stream.js";import{isCurrentTurnBoundaryEvent}from"#protocol/message.js";import{toErrorMessage}from"#shared/errors.js";import{createDevelopmentRequestHeadersAsync}from"#services/dev-client/request-headers.js";import{extractCurrentTurnBoundaryEvent}from"#services/dev-client/stream.js";import{resolveDevelopmentServerResourceUrl}from"#services/dev-client/url.js";import{formatVercelAuthChallengeMessage,isVercelAuthChallenge}from"#services/dev-client/vercel-auth-error.js";import{createDevClient}from"#services/dev-client.js";import{parseDevReplInput}from"#cli/dev/repl/input.js";import{ESCAPED_RUNTIME_INPUT_PROMPT,extractPendingRuntimeInputRequests,promptForRuntimeInputRequests}from"#cli/dev/repl/input-requests.js";import{createDevelopmentTerminal}from"#cli/dev/repl/terminal.js";function renderConnectionRows(r){let i=[{label:`Server`,tone:`info`,value:r.serverUrl},{label:`Create`,tone:`info`,value:`POST ${EVE_CREATE_SESSION_ROUTE_PATH}`},{label:`Continue`,tone:`info`,value:`POST ${EVE_CONTINUE_SESSION_ROUTE_PATTERN}`},{label:`Stream`,tone:`info`,value:`GET ${EVE_MESSAGE_STREAM_ROUTE_PATTERN}`}];return i.push({label:`Session`,value:`Follow-up messages reuse the active continuation token.`}),i}function renderCommandRows(){return[{label:`/help`,value:`Print the connection contract and available commands.`},{label:`/new`,value:`Clear the current durable session cursor.`},{label:`/exit`,value:`Exit the REPL.`}]}function renderIntro(e,t){return[renderCliBanner(e,{subtitle:`Interactive development REPL for the active Eve server.`,title:`Eve Dev`}),``,renderCliSection(e,{rows:renderConnectionRows(t),title:`Connection`}),``,renderCliSection(e,{rows:renderCommandRows(),title:`Commands`})].join(`
+`)}function normalizeStepMessage(e){let t=e.trim();return t.length>0?t:null}function getRenderTag(e){return e.options?.isSubagent===!0?`subagent`:e.fallback}function getRenderTone(e){return e.options?.isSubagent===!0?`subagent`:e.fallback}function prefixSourceLabel(e){return e.options?.sourceLabel===void 0?e.message:`${e.options.sourceLabel}${e.separator??` `}${e.message}`}function formatContentEvent(e,t,n){switch(t.type){case`message.appended`:return{finalized:!1,kind:`message`,line:renderCliSpeakerLine(e,{message:t.data.messageSoFar,speaker:n?.sourceLabel??`agent`,tone:getRenderTone({fallback:`accent`,options:n})})};case`message.completed`:if(t.data.message===null)return;if(t.data.finishReason===`tool-calls`){let r=normalizeStepMessage(t.data.message);return r===null?void 0:{finalized:!0,kind:`message`,line:renderCliTaggedLine(e,{message:prefixSourceLabel({message:r,options:n,separator:`: `}),tag:getRenderTag({fallback:`step`,options:n}),tone:getRenderTone({fallback:`accent`,options:n})})}}return{finalized:!0,kind:`message`,line:renderCliSpeakerLine(e,{message:t.data.message,speaker:n?.sourceLabel??`agent`,tone:getRenderTone({fallback:`accent`,options:n})})};case`reasoning.appended`:return{finalized:!1,kind:`reasoning`,line:renderCliTaggedLine(e,{message:prefixSourceLabel({message:t.data.reasoningSoFar,options:n,separator:`: `}),tag:getRenderTag({fallback:`reasoning`,options:n}),tone:getRenderTone({fallback:`info`,options:n})})};case`reasoning.completed`:return{finalized:!0,kind:`reasoning`,line:renderCliTaggedLine(e,{message:prefixSourceLabel({message:t.data.reasoning,options:n,separator:`: `}),tag:getRenderTag({fallback:`reasoning`,options:n}),tone:getRenderTone({fallback:`info`,options:n})})};default:return}}function formatEvent(e,t,n){let r=formatContentEvent(e,t,n);if(r!==void 0)return r.line;switch(t.type){case`message.received`:return;case`actions.requested`:return renderCliTaggedLine(e,{message:prefixSourceLabel({message:`${t.type} (${t.data.actions.length} action${t.data.actions.length===1?``:`s`})`,options:n}),tag:getRenderTag({fallback:`event`,options:n}),tone:getRenderTone({fallback:`muted`,options:n})});case`input.requested`:return renderCliTaggedLine(e,{message:prefixSourceLabel({message:`${t.type} (${t.data.requests.length} request${t.data.requests.length===1?``:`s`})`,options:n}),tag:getRenderTag({fallback:`event`,options:n}),tone:getRenderTone({fallback:`info`,options:n})});case`action.result`:return renderCliTaggedLine(e,{message:prefixSourceLabel({message:`${t.type} (${formatActionResultLabel(t.data.result)})`,options:n}),tag:getRenderTag({fallback:`event`,options:n}),tone:getRenderTone({fallback:`muted`,options:n})});case`session.waiting`:case`session.completed`:return;case`authorization.required`:return renderCliTaggedLine(e,{message:prefixSourceLabel({message:`${t.type} (${t.data.name}: ${t.data.description}${formatAuthorizationChallengeSuffix(t.data.authorization)})`,options:n}),tag:getRenderTag({fallback:`event`,options:n}),tone:getRenderTone({fallback:`warning`,options:n})});case`compaction.requested`:return renderCliTaggedLine(e,{message:prefixSourceLabel({message:`compacting conversation history`,options:n}),tag:getRenderTag({fallback:`event`,options:n}),tone:getRenderTone({fallback:`muted`,options:n})});case`compaction.completed`:return renderCliTaggedLine(e,{message:prefixSourceLabel({message:`conversation history compacted`,options:n}),tag:getRenderTag({fallback:`event`,options:n}),tone:getRenderTone({fallback:`muted`,options:n})});case`step.failed`:case`turn.failed`:case`session.failed`:return;case`subagent.called`:return renderCliTaggedLine(e,{message:prefixSourceLabel({message:`${t.type} (${t.data.name} -> ${t.data.childSessionId})`,options:n}),tag:getRenderTag({fallback:`event`,options:n}),tone:getRenderTone({fallback:`info`,options:n})});case`subagent.started`:return renderCliTaggedLine(e,{message:prefixSourceLabel({message:`${t.type} (${t.data.subagentName})`,options:n}),tag:getRenderTag({fallback:`event`,options:n}),tone:getRenderTone({fallback:`info`,options:n})});case`subagent.event`:return renderCliTaggedLine(e,{message:prefixSourceLabel({message:`${t.type} (${t.data.subagentName}: ${formatNestedSubagentEventLabel(t.data.event)})`,options:n}),tag:getRenderTag({fallback:`event`,options:n}),tone:getRenderTone({fallback:`muted`,options:n})});case`subagent.completed`:return renderCliTaggedLine(e,{message:prefixSourceLabel({message:`${t.type} (${t.data.subagentName})`,options:n}),tag:getRenderTag({fallback:`event`,options:n}),tone:getRenderTone({fallback:`info`,options:n})});default:return}}function getEventDisplayBlockKind(e){switch(e.type){case`message.appended`:case`message.completed`:case`reasoning.appended`:case`reasoning.completed`:return`content`;default:return`meta`}}function createTurnDisplayState(){return{activeLiveContentKind:null,lastPrintedBlockKind:null}}function printDisplayLine(e){let t=e.state;return t.activeLiveContentKind!==null&&(e.terminal.commitLive(),t={activeLiveContentKind:null,lastPrintedBlockKind:`content`}),t.lastPrintedBlockKind!==null&&t.lastPrintedBlockKind!==e.kind&&e.terminal.print(``),e.terminal.print(e.line),{activeLiveContentKind:null,lastPrintedBlockKind:e.kind}}function renderTurnEvent(e){let t=formatContentEvent(e.theme,e.event,e.options);if(t!==void 0){let n=e.state;return n.activeLiveContentKind!==null&&n.activeLiveContentKind!==t.kind&&(e.terminal.commitLive(),n={activeLiveContentKind:null,lastPrintedBlockKind:`content`}),n.lastPrintedBlockKind!==null&&n.lastPrintedBlockKind!==`content`&&e.terminal.print(``),e.terminal.updateLive(t.line),t.finalized?(e.terminal.commitLive(),{activeLiveContentKind:null,lastPrintedBlockKind:`content`}):{activeLiveContentKind:t.kind,lastPrintedBlockKind:`content`}}let n=formatEvent(e.theme,e.event,e.options);return n===void 0?e.state:printDisplayLine({kind:getEventDisplayBlockKind(e.event),line:n,state:e.state,terminal:e.terminal})}function isAbortLikeError(e){return(e instanceof DOMException||e instanceof Error)&&e.name===`AbortError`}function shouldDrainSubagentStreamsOnBoundary(e){return e.length===0}var ReplSubagentStreamManager=class{#e=new Map;#t;#n;#r;#i;constructor(e){this.#t=e.displayStateRef,this.#n=e.serverUrl,this.#r=e.terminal,this.#i=e.theme}subscribe(e){if(this.#e.has(e.sessionId))return;let t=new AbortController,n=this.#a({controller:t,sessionId:e.sessionId,subagentName:e.subagentName}).finally(()=>{this.#e.delete(e.sessionId)});this.#e.set(e.sessionId,{controller:t,done:n,label:e.subagentName})}async waitForIdle(){for(;this.#e.size>0;)await Promise.all([...this.#e.values()].map(e=>e.done))}async close(){let e=[...this.#e.values()];for(let t of e)t.controller.abort();await Promise.allSettled(e.map(e=>e.done))}async#a(e){let t=resolveDevelopmentServerResourceUrl({resource:createEveMessageStreamRoutePath(e.sessionId),serverUrl:this.#n});try{for await(let n of openStreamIterable({host:this.#n,maxReconnectAttempts:3,resolveHeaders:async()=>await createDevelopmentRequestHeadersAsync({resourceUrl:t}),sessionId:e.sessionId,signal:e.controller.signal,startIndex:0}))if(this.#t.current=renderTurnEvent({event:n,options:{isSubagent:!0,sourceLabel:e.subagentName},state:this.#t.current,terminal:this.#r,theme:this.#i}),n.type===`subagent.called`&&this.subscribe({sessionId:n.data.childSessionId,subagentName:n.data.name}),isCurrentTurnBoundaryEvent(n))return}catch(t){if(isAbortLikeError(t))return;let n=toErrorMessage(t);this.#t.current=printDisplayLine({kind:`meta`,line:renderCliTaggedLine(this.#i,{message:`${e.subagentName} stream failed: ${n}`,tag:`subagent`,tone:`danger`}),state:this.#t.current,terminal:this.#r})}finally{e.controller.abort()}}};function formatActionResultLabel(e){switch(e.kind){case`load-skill-result`:return e.kind;case`subagent-result`:return`${e.kind}:${e.subagentName}`;case`tool-result`:return`${e.kind}:${e.toolName}`}}function formatAuthorizationChallengeSuffix(e){if(e===void 0)return``;let t=[];return e.url!==void 0&&t.push(e.url),e.userCode!==void 0&&t.push(`code ${e.userCode}`),e.instructions!==void 0&&t.push(e.instructions),t.length===0?``:` — ${t.join(`, `)}`}function formatNestedSubagentEventLabel(e){switch(e.type){case`actions.requested`:{let t=e.data.actions,n=t.map(e=>e.kind===`tool-call`?e.toolName:e.kind).join(`,`);return`${e.type} (${t.length} action${t.length===1?``:`s`}${n.length>0?`: ${n}`:``})`}case`action.result`:return`${e.type} (${formatActionResultLabel(e.data.result)})`;case`input.requested`:return`${e.type} (${e.data.requests.length} request${e.data.requests.length===1?``:`s`})`;default:return e.type}}function formatDispatch(e,t){return t.continuationToken?renderCliTaggedLine(e,{message:`resuming session ${t.continuationToken}`,tag:`session`,tone:`info`}):renderCliTaggedLine(e,{message:`starting a new session`,tag:`session`,tone:`info`})}function formatTurnDispatch(e,t){return t.turn.inputResponses!==void 0&&t.turn.message===void 0?renderCliTaggedLine(e,{message:`responding to pending input request${t.turn.inputResponses.length===1?``:`s`}`,tag:`session`,tone:`info`}):formatDispatch(e,t.session)}function formatSessionBoundary(e,t){let n=extractCurrentTurnBoundaryEvent(t),r=extractPendingRuntimeInputRequests(t);switch(n?.type){case`session.waiting`:return[renderCliTaggedLine(e,{message:r.length>0?`waiting for input approval/answer or the next message`:`waiting for the next message`,tag:`session`,tone:`success`})];case`session.completed`:return[renderCliTaggedLine(e,{message:`session completed; the next input starts a new session`,tag:`session`,tone:`success`})];case`session.failed`:{let t=n.data.details&&typeof n.data.details.name==`string`?n.data.details.name:void 0;return[renderCliTaggedLine(e,{message:t?`session failed (${t}): ${n.data.message}`:`session failed: ${n.data.message}`,tag:`session`,tone:`danger`}),renderCliTaggedLine(e,{message:`cleared; the next input starts a new session`,tag:`session`,tone:`warning`})]}default:return[]}}async function waitForInputLine(e,t,n={}){return await new Promise(r=>{let i=e.input,cleanup=()=>{e.off(`close`,handleClose),e.off(`line`,handleLine),i.off(`keypress`,handleKeypress)},handleClose=()=>{cleanup(),r(void 0)},handleLine=e=>{cleanup(),r(e)},handleKeypress=(t,i)=>{n.allowEscape!==!0||i.name!==`escape`||(cleanup(),e.write(null,{ctrl:!0,name:`u`}),r(ESCAPED_RUNTIME_INPUT_PROMPT))};e.setPrompt(t),e.once(`close`,handleClose),e.once(`line`,handleLine),n.allowEscape&&(emitKeypressEvents(i,e),i.on(`keypress`,handleKeypress)),e.prompt()})}async function runTurn(e){let t=e.turn,n={current:createTurnDisplayState()},i=new ReplSubagentStreamManager({displayStateRef:n,serverUrl:e.serverUrl,terminal:e.terminal,theme:e.theme}),ask=async t=>{e.terminal.startPrompt(e.rl,t);let n=await waitForInputLine(e.rl,t,{allowEscape:!0});return e.terminal.stopPrompt(),n};try{for(;;){let a=e.client.getSession();n.current=printDisplayLine({kind:`meta`,line:formatTurnDispatch(e.theme,{session:a,turn:t}),state:n.current,terminal:e.terminal});let o=await e.client.send({inputResponses:t.inputResponses,message:t.message,onEvent(t){n.current=renderTurnEvent({event:t,state:n.current,terminal:e.terminal,theme:e.theme}),t.type===`subagent.called`&&i.subscribe({sessionId:t.data.childSessionId,subagentName:t.data.name})},onResponseStart(t){t.sessionId&&a.sessionId!==t.sessionId&&(n.current=printDisplayLine({kind:`meta`,line:renderCliTaggedLine(e.theme,{message:t.sessionId,tag:`session`,tone:`accent`}),state:n.current,terminal:e.terminal}),n.current=printDisplayLine({kind:`meta`,line:renderCliTaggedLine(e.theme,{message:resolveDevelopmentServerResourceUrl({resource:createEveMessageStreamRoutePath(t.sessionId),serverUrl:e.serverUrl}).toString(),tag:`stream`,tone:`info`}),state:n.current,terminal:e.terminal}))}}),s=extractPendingRuntimeInputRequests(o.events);if(shouldDrainSubagentStreamsOnBoundary(s)){await i.waitForIdle();for(let t of formatSessionBoundary(e.theme,o.events))n.current=printDisplayLine({kind:`meta`,line:t,state:n.current,terminal:e.terminal});return`continue`}let c=await promptForRuntimeInputRequests({ask,print(t){n.current=printDisplayLine({kind:`meta`,line:t,state:n.current,terminal:e.terminal})},requests:s,theme:e.theme});if(c.kind===`aborted`)return`exit`;if(c.kind===`deferred`)return n.current=printDisplayLine({kind:`meta`,line:renderCliTaggedLine(e.theme,{message:`left pending input requests unresolved; send a new message to ignore them`,tag:`session`,tone:`warning`}),state:n.current,terminal:e.terminal}),`continue`;t={inputResponses:c.inputResponses}}}finally{await i.close()}}async function runDevelopmentRepl(e){let t=createDevelopmentTerminal(),n=createCliTheme({color:!0}),r=createInterface({input:process.stdin,output:t.output,terminal:!0});r.on(`SIGINT`,()=>{r.close()});let a=createDevClient({serverUrl:e.serverUrl});try{for(t.print(renderIntro(n,e)),t.print(``);;){t.print(``),t.startPrompt(r,`you> `);let i=await waitForInputLine(r,`you> `);if(t.stopPrompt(),i===void 0)return;let o=parseDevReplInput(i);switch(o.kind!==`empty`&&o.kind!==`exit`&&t.print(``),o.kind){case`empty`:continue;case`help`:t.print(renderIntro(n,e)),t.print(``);continue;case`exit`:return;case`new`:await a.clear(),t.print(renderCliTaggedLine(n,{message:`cleared; the next input starts a new session`,tag:`session`,tone:`warning`})),t.print(``);continue;case`message`:try{if(await runTurn({client:a,rl:r,serverUrl:e.serverUrl,terminal:t,theme:n,turn:{message:o.message}})===`exit`)return}catch(r){isVercelAuthChallenge(r)?t.printError(renderCliTaggedLine(n,{message:formatVercelAuthChallengeMessage({serverUrl:e.serverUrl}),tag:`auth`,tone:`warning`})):t.printError(renderCliTaggedLine(n,{message:toErrorMessage(r),tag:`error`,tone:`danger`}))}t.print(``)}}}finally{await a.close(),r.close(),t.dispose()}}export{createTurnDisplayState,formatContentEvent,formatEvent,renderTurnEvent,runDevelopmentRepl,shouldDrainSubagentStreamsOnBoundary};

package/dist/src/cli/dev/repl/terminal.d.ts

@@ -0,0 +1,21 @@
+import type { Interface } from "node:readline";
+/**
+ * Output controller used by the interactive `eve dev` REPL.
+ *
+ * It keeps the prompt stable by temporarily clearing and restoring it when
+ * background server logs write to stdout or stderr.
+ */
+export interface DevelopmentTerminal {
+    commitLive(): void;
+    readonly output: NodeJS.WriteStream;
+    dispose(): void;
+    print(message: string): void;
+    printError(message: string): void;
+    startPrompt(rl: Interface, prompt: string): void;
+    stopPrompt(): void;
+    updateLive(message: string): void;
+}
+/**
+ * Creates the terminal surface used by the interactive development REPL.
+ */
+export declare function createDevelopmentTerminal(): DevelopmentTerminal;

package/dist/src/cli/dev/repl/terminal.js

@@ -0,0 +1,5 @@
+const ansiSgrPattern=RegExp(`${String.fromCodePoint(27)}\\[[0-9;]*m`,`gu`);function chunkToString(e,t){return typeof e==`string`?e:Buffer.from(e).toString(t)}function endsWithLineBreak(e){return e.endsWith(`
+`)||e.endsWith(`\r`)}function stripAnsi(t){return t.replace(ansiSgrPattern,``)}function countRenderedLines(e){let t=process.stdout.columns;return e.split(/\r\n|\r|\n/u).reduce((e,n)=>{let r=Array.from(stripAnsi(n)).length;return t===void 0||t<=0?e+1:e+Math.max(1,Math.ceil(r/t))},0)}function getPromptCursor(e){let t=e.cursor;return typeof t==`number`?t:e.line.length}function createDevelopmentTerminal(){let e=process.stdout.write.bind(process.stdout),t=process.stderr.write.bind(process.stderr),n=null,r=null,writeOriginal=(e,t,n,r,i)=>Reflect.apply(t,e,[n,r,i]),clearPrompt=()=>{n!==null&&writeOriginal(process.stdout,e,`\x1B[2K\r`)},redrawPrompt=()=>{if(n===null)return;let{prompt:t,rl:r}=n,i=getPromptCursor(r),a=r.line.length-i;writeOriginal(process.stdout,e,`${t}${r.line}`),a>0&&writeOriginal(process.stdout,e,`\u001B[${a}D`)},clearLiveBlock=()=>{if(r!==null)for(let t=0;t<r.lineCount;t+=1)writeOriginal(process.stdout,e,`\x1B[1A`),writeOriginal(process.stdout,e,`\x1B[2K\r`)},renderLiveBlock=t=>{let n=t.length===0||!endsWithLineBreak(t);writeOriginal(process.stdout,e,t),n&&writeOriginal(process.stdout,e,`
+`),r={lineCount:countRenderedLines(t),message:t}},printMessage=(e,t,r)=>{let i=n!==null,a=e.length===0||!endsWithLineBreak(e);i&&clearPrompt(),writeOriginal(r,t,e),a&&writeOriginal(r,t,`
+`),i&&redrawPrompt()},patchStream=(e,t)=>(e.write=((i,a,o)=>{if(n===null&&r===null)return writeOriginal(e,t,i,a,o);let s=chunkToString(i,typeof a==`string`?a:void 0),c=r;n!==null&&clearPrompt(),c!==null&&(clearLiveBlock(),r=null);let l=writeOriginal(e,t,i,a,o);return s.length>0&&!endsWithLineBreak(s)&&writeOriginal(e,t,`
+`),c!==null&&renderLiveBlock(c.message),n!==null&&redrawPrompt(),l}),()=>{e.write=t}),i=patchStream(process.stdout,e),a=patchStream(process.stderr,t);return{commitLive(){r=null},dispose(){n=null,r=null,i(),a()},output:new Proxy(process.stdout,{get(t,n,r){if(n===`write`)return(t,n,r)=>writeOriginal(process.stdout,e,t,n,r);let i=Reflect.get(t,n,r);return typeof i==`function`?i.bind(t):i}}),print(t){printMessage(t,e,process.stdout)},printError(e){printMessage(e,t,process.stderr)},startPrompt(e,t){n={prompt:t,rl:e}},stopPrompt(){n=null},updateLive(e){let t=n!==null;t&&clearPrompt(),r!==null&&(clearLiveBlock(),r=null),renderLiveBlock(e),t&&redrawPrompt()}}}export{createDevelopmentTerminal};

package/dist/src/cli/dev/tui/layout.d.ts

@@ -0,0 +1,24 @@
+export { sliceVisible, stripAnsi, visibleLength } from "./terminal-text.js";
+export type TUIScreenState = {
+    width: number;
+    height: number;
+    title: string;
+    rightTitle?: string;
+    body: string;
+    input: string;
+    inputActive: boolean;
+    inputCursorVisible?: boolean;
+    scrollOffset: number;
+    status?: string;
+};
+export type TUIScreenLinesState = Omit<TUIScreenState, "body"> & {
+    bodyLines: string[];
+};
+export type TUIScreenViewportState = Omit<TUIScreenLinesState, "bodyLines" | "scrollOffset"> & {
+    visibleBodyLines: string[];
+};
+export declare function renderScreen(state: TUIScreenState): string;
+export declare function renderScreenLines(state: TUIScreenLinesState): string;
+export declare function renderScreenViewport(state: TUIScreenViewportState): string;
+export declare function wrapText(input: string, width: number): string[];
+export declare function clampScrollOffset(scrollOffset: number, body: string, bodyHeight: number, width: number): number;

package/dist/src/cli/dev/tui/layout.js

@@ -0,0 +1,3 @@
+import{ansiPrefixPattern,codePointWidth,sliceVisible,stripAnsi,visibleLength}from"./terminal-text.js";import{renderMarkdown}from"./markdown.js";function renderScreen(e){let t=Math.max(20,e.width)-4,n=wrapText(renderMarkdown(e.body),t);return renderScreenLines({...e,bodyLines:n})}function renderScreenLines(e){let t=Math.max(8,e.height)-3-2,n=Math.max(0,e.bodyLines.length-t),r=Math.min(Math.max(0,e.scrollOffset),n),i=Math.max(0,e.bodyLines.length-t-r),a=e.bodyLines.slice(i,i+t);return renderScreenViewport({...e,visibleBodyLines:a})}function renderScreenViewport(e){let t=Math.max(20,e.width),n=Math.max(8,e.height)-3-2,r=e.visibleBodyLines.slice(0,n);for(;r.length<n;)r.push(``);return[topBorder(t,e.title,e.rightTitle),...r.map(e=>boxLine(e,t)),bottomBorder(t),topBorder(t,e.inputActive?`Input`:`Status`),boxLine(e.inputActive?`> ${e.input}${e.inputCursorVisible===!1?` `:`█`}`:e.status??`Streaming... ↑/↓ scroll · Ctrl+C quit`,t),bottomBorder(t)].join(`
+`)}function wrapText(e,t){if(t<=0)return[``];let n=[];for(let r of e.split(`
+`)){if(r.length===0){n.push(``);continue}let e=r;for(;visibleLength(e)>t;){let r=findBreakPoint(e,t);n.push(e.slice(0,r).trimEnd()),e=e.slice(r).trimStart()}n.push(e)}return n}function clampScrollOffset(e,t,n,r){let i=Math.max(1,n-2),o=wrapText(renderMarkdown(t),Math.max(1,r-4)),s=Math.max(0,o.length-i);return Math.min(Math.max(0,e),s)}function findBreakPoint(n,r){let i=0,a=0,o=-1;for(;i<n.length&&a<r;){let s=n.slice(i).match(ansiPrefixPattern);if(s){i+=s[0].length;continue}let c=n.codePointAt(i);if(c==null)break;let l=String.fromCodePoint(c),u=codePointWidth(c);if(u>0&&a+u>r)break;l===` `&&(o=i),i+=l.length,a+=u}let s=indexAfterAnsiSequences(n,i);return a===r&&n.codePointAt(s)===32?s:o>0?o:indexAtVisibleWidth(n,r)}function topBorder(e,t,r){let a=Math.max(0,e-2),o=sliceVisible(` ${t} `,a),s=r?sliceVisible(` ${r} `,Math.max(0,a-visibleLength(o))):``,c=Math.max(0,a-visibleLength(o)-visibleLength(s));return`┌${o}${`─`.repeat(c)}${s}┐`}function bottomBorder(e){return`└${`─`.repeat(e-2)}┘`}function boxLine(e,t){let r=t-4,a=sliceVisible(e,r);return`│ ${a}${` `.repeat(Math.max(0,r-visibleLength(a)))} │`}function indexAtVisibleWidth(n,r){let i=0,a=0;for(;i<n.length&&a<r;){let o=n.slice(i).match(ansiPrefixPattern);if(o){i+=o[0].length;continue}let s=n.codePointAt(i);if(s==null)break;let c=String.fromCodePoint(s),l=codePointWidth(s);if(l>0&&a+l>r)break;i+=c.length,a+=l}return i}function indexAfterAnsiSequences(t,n){let r=n;for(;r<t.length;){let n=t.slice(r).match(ansiPrefixPattern);if(!n)break;r+=n[0].length}return r}export{clampScrollOffset,renderScreen,renderScreenLines,renderScreenViewport,sliceVisible,stripAnsi,visibleLength,wrapText};

package/dist/src/cli/dev/tui/markdown.d.ts

@@ -0,0 +1,14 @@
+export type MarkdownToken = {
+    type: "text";
+    text: string;
+} | {
+    type: "bold";
+    text: string;
+} | {
+    type: "italic";
+    text: string;
+} | {
+    type: "code";
+    text: string;
+};
+export declare function renderMarkdown(input: string): string;

package/dist/src/cli/dev/tui/markdown.js

@@ -0,0 +1,3 @@
+import{visibleLength}from"./terminal-text.js";const ansi={bold:`\x1B[1m`,boldOff:`\x1B[22m`,italic:`\x1B[3m`,italicOff:`\x1B[23m`};function renderMarkdown(e){let t=e.split(`
+`),n=[];for(let e=0;e<t.length;e+=1){let r=parseTable(t,e);if(r!=null){n.push(...renderTable(r)),e=r.endIndex-1;continue}n.push(renderMarkdownLine(t[e]??``))}return n.join(`
+`)}function renderMarkdownLine(e){if(e.startsWith(`### `))return renderInlineMarkdown(`▶ ${e.slice(4)}`);if(e.startsWith(`## `))return renderInlineMarkdown(`■ ${e.slice(3)}`);if(e.startsWith(`# `))return renderInlineMarkdown(`█ ${e.slice(2)}`);let t=e.match(/^(\s*)[-+*]\s+(.*)$/);if(t){let[,e,n=``]=t;return renderInlineMarkdown(`${e}•${n.length>0?` ${n}`:``}`)}return/^\d+\. /.test(e)?renderInlineMarkdown(e.replace(/^(\d+)\. /,`$1. `)):e.startsWith(`> `)?renderInlineMarkdown(`│ ${e.slice(2)}`):renderInlineMarkdown(e)}function renderInlineMarkdown(e){let n=[];return e.replaceAll(/https?:\/\/\S+/g,e=>{let t=`\uE000${n.length}\uE001`;return n.push(e),t}).replaceAll(/`([^`]+)`/g,`$1`).replaceAll(/\*\*([^*\n]+)\*\*/g,`${ansi.bold}$1${ansi.boldOff}`).replaceAll(/__([^_\n]+)__/g,`${ansi.bold}$1${ansi.boldOff}`).replaceAll(/\*([^*\n]+)\*/g,`${ansi.italic}$1${ansi.italicOff}`).replaceAll(/_([^_\n]+)_/g,`${ansi.italic}$1${ansi.italicOff}`).replaceAll(/\uE000(\d+)\uE001/g,(e,t)=>n[Number(t)]??``)}function parseTable(e,t){let n=parseTableCells(e[t]??``);if(n==null||n.length<2)return;let r=parseTableCells(e[t+1]??``);if(r==null||r.length!==n.length)return;let i=parseTableAlignments(r);if(i==null)return;let a=[],o=t+2;for(;o<e.length;){let t=parseTableCells(e[o]??``);if(t==null)break;a.push(normalizeTableRow(t,n.length)),o+=1}return{alignments:i,endIndex:o,header:n,rows:a}}function parseTableCells(e){if(!e.includes(`|`))return;let t=e.trim();t.startsWith(`|`)&&(t=t.slice(1)),t.endsWith(`|`)&&!t.endsWith(`\\|`)&&(t=t.slice(0,-1));let n=[],r=``;for(let e=0;e<t.length;e+=1){let i=t[e],a=t[e+1];if(i===`\\`&&a===`|`){r+=`|`,e+=1;continue}if(i===`|`){n.push(r.trim()),r=``;continue}r+=i}return n.push(r.trim()),n}function parseTableAlignments(e){let t=[];for(let n of e){let e=n.match(/^(:)?-{3,}(:)?$/);if(e==null)return;let[,r,i]=e;t.push(r!=null&&i!=null?`center`:i==null?`left`:`right`)}return t}function normalizeTableRow(e,t){return Array.from({length:t},(t,n)=>e[n]??``)}function renderTable(n){let r=n.header.map(e=>`${ansi.bold}${renderInlineMarkdown(e)}${ansi.boldOff}`),i=n.rows.map(e=>e.map(renderInlineMarkdown)),a=[r,...i],o=n.alignments.map((t,n)=>Math.max(3,...a.map(t=>visibleLength(t[n]??``))));return[formatTableRow(r,o,n.alignments),o.map(e=>`─`.repeat(e)).join(`  `),...i.map(e=>formatTableRow(e,o,n.alignments))]}function formatTableRow(e,t,n){return e.map((e,r)=>alignTableCell(e,t[r]??0,n[r]??`left`)).join(`  `)}function alignTableCell(t,n,r){let i=Math.max(0,n-visibleLength(t));if(r===`right`)return`${` `.repeat(i)}${t}`;if(r===`center`){let e=Math.floor(i/2),n=i-e;return`${` `.repeat(e)}${t}${` `.repeat(n)}`}return`${t}${` `.repeat(i)}`}export{renderMarkdown};

package/dist/src/cli/dev/tui/runner.d.ts

@@ -0,0 +1,211 @@
+import { type ConnectionAuthorizationOutcome, Client, ClientSession } from "#client/index.js";
+import { type UIMessage, type UIMessageChunk } from "ai";
+import type { AssistantResponseStatsMode, TerminalPartDisplayMode, TuiDisplayOptions } from "./types.js";
+import { type TerminalInput, type TerminalOutput } from "./terminal-renderer.js";
+export type AgentTUIStreamResult = {
+    uiMessageStream: AsyncIterable<UIMessageChunk> | ReadableStream<UIMessageChunk>;
+    message?: UIMessage;
+    abort?: () => void;
+};
+export type AgentTUIStreamOptions = {
+    messages: UIMessage[];
+};
+export type AgentTUISessionOptions = {
+    title?: string;
+    initialPrompt?: string;
+    submittedPrompt?: string;
+    waitForExit?: boolean;
+    continueSession?: boolean;
+    tools?: TerminalPartDisplayMode;
+    reasoning?: TerminalPartDisplayMode;
+    subagents?: TerminalPartDisplayMode;
+    connectionAuth?: TerminalPartDisplayMode;
+    assistantResponseStats?: AssistantResponseStatsMode;
+    contextSize?: number;
+};
+export type AgentTUIToolApprovalRequest = {
+    approvalId: string;
+    toolCallId: string;
+    toolName: string;
+    title?: string;
+    input: unknown;
+    providerExecuted?: boolean;
+    messageId: string;
+    partIndex: number;
+};
+export type AgentTUIToolApprovalResponse = {
+    approved: boolean;
+    reason?: string;
+};
+export type AgentTUIInputOption = {
+    id: string;
+    label: string;
+    description?: string;
+    style?: "primary" | "danger" | "default";
+};
+export type AgentTUIInputQuestion = {
+    requestId: string;
+    prompt: string;
+    display: "select" | "text";
+    options?: ReadonlyArray<AgentTUIInputOption>;
+    allowFreeform?: boolean;
+};
+export type AgentTUIInputQuestionResponse = {
+    optionId?: string;
+    text?: string;
+};
+export type AgentTUIRenderer = {
+    readPrompt?(options?: AgentTUISessionOptions): Promise<string | undefined>;
+    readToolApproval?(request: AgentTUIToolApprovalRequest, options?: AgentTUISessionOptions): Promise<AgentTUIToolApprovalResponse>;
+    readInputQuestion?(question: AgentTUIInputQuestion, options?: AgentTUISessionOptions): Promise<AgentTUIInputQuestionResponse | undefined>;
+    renderStream(result: AgentTUIStreamResult, options?: AgentTUISessionOptions): Promise<UIMessage | undefined>;
+    /**
+     * Out-of-band update for one child step (reasoning + message text) of a
+     * subagent dispatch. Called by the runner as child-session stream events
+     * arrive. The renderer renders this as a body section colored by the
+     * subagent palette.
+     */
+    upsertSubagentStep?(update: SubagentStepUpdate): void;
+    /**
+     * Out-of-band update for one child tool call of a subagent dispatch.
+     */
+    upsertSubagentTool?(update: SubagentToolUpdate): void;
+    /**
+     * Registers a tool call id as originating from a subagent's child
+     * session. The renderer must skip rendering parent UIMessage tool parts
+     * for these ids — they are surfaced via {@link upsertSubagentTool}
+     * instead.
+     */
+    markChildToolCallId?(callId: string): void;
+    /**
+     * Out-of-band update for one MCP connection authorization lifecycle.
+     * Called by the runner as `authorization.*` events arrive.
+     * The renderer renders this as a persistent body section per
+     * connection that transitions through `required` → `pending` →
+     * one of the terminal `ConnectionAuthorizationOutcome` states.
+     */
+    upsertConnectionAuth?(update: ConnectionAuthUpdate): void;
+    /**
+     * Sets the number of connections currently awaiting an OAuth
+     * callback. The renderer overrides its bottom status bar with a
+     * "waiting for connection authorization" hint while this is > 0,
+     * so the user understands the agent is parked, not hung.
+     */
+    setConnectionAuthPendingCount?(count: number): void;
+    /**
+     * Clears the rendered transcript and resets per-conversation display
+     * state, leaving the UI interactive on a fresh screen. Used by the
+     * `/new` command to start a new session with a clean slate.
+     */
+    reset?(): void;
+    /**
+     * Tears down interactive mode and restores the terminal, as if the user
+     * pressed Ctrl+C. Used by the `/exit` command.
+     */
+    shutdown?(): void;
+};
+export type EveTUIRunnerOptions = TuiDisplayOptions & {
+    session: ClientSession;
+    /**
+     * Optional client used to attach to child sessions for live subagent
+     * stream observation. When omitted, the TUI still shows the subagent
+     * section but cannot surface the subagent's reasoning / response /
+     * intermediate events — only the parent-stream `called` and
+     * `completed` transitions.
+     */
+    client?: Client;
+    renderer?: AgentTUIRenderer;
+    screen?: TerminalOutput;
+    userInput?: TerminalInput;
+    /**
+     * Formats an error thrown while dispatching a turn (the initial
+     * `session.send()` POST — e.g. a transport failure or a Vercel
+     * Deployment Protection challenge) into the text rendered in the
+     * inline error region. Defaults to the error's message. Callers that
+     * know about transport-specific challenges (the `eve dev` glue) inject
+     * a richer formatter here.
+     */
+    formatTransportError?: (error: unknown) => string;
+    /**
+     * Local `eve dev` server URL. When present, normal prompts refresh the
+     * active session after HMR so the next prompt uses the latest authored
+     * artifacts; input-response resumes keep the current session.
+     */
+    serverUrl?: string;
+};
+export declare class EveTUIRunner {
+    #private;
+    constructor(options: EveTUIRunnerOptions);
+    run(): Promise<void>;
+}
+type ResponseMetadata = {
+    usage?: {
+        totalTokens?: number;
+        outputTokens?: number;
+    };
+};
+type SubagentChildStep = {
+    reasoning: string;
+    message: string;
+    finalized: boolean;
+};
+type SubagentToolState = {
+    toolName: string;
+    input: unknown;
+    status: "approval-requested" | "executing" | "done" | "failed";
+    output?: unknown;
+    errorText?: string;
+};
+export type SubagentRun = {
+    name: string;
+    /**
+     * One entry per logical "child message" — independent of the child's
+     * `stepIndex` field, which the harness can reuse across multiple
+     * assistant messages within a turn (e.g. a message before a tool call
+     * and another message after the tool result both arrive under
+     * `stepIndex: 0`). The key is a monotonic counter so each
+     * `message.completed` opens a new box on the next inbound delta.
+     */
+    steps: Map<number, SubagentChildStep>;
+    /**
+     * Section currently accepting reasoning/message deltas. `null` means
+     * the next delta opens a new section.
+     */
+    currentSectionKey: number | null;
+    /** Monotonic counter for new section keys. */
+    nextSectionKey: number;
+    tools: Map<string, SubagentToolState>;
+};
+export type SubagentStepUpdate = {
+    callId: string;
+    subagentName: string;
+    sectionKey: number;
+    reasoning: string;
+    message: string;
+    finalized: boolean;
+};
+export type SubagentToolUpdate = {
+    callId: string;
+    subagentName: string;
+    childCallId: string;
+    toolName: string;
+    input: unknown;
+    status: "approval-requested" | "executing" | "done" | "failed";
+    output?: unknown;
+    errorText?: string;
+};
+export type ConnectionAuthChallenge = {
+    url?: string;
+    userCode?: string;
+    expiresAt?: string;
+    instructions?: string;
+};
+export type ConnectionAuthState = "required" | "pending" | ConnectionAuthorizationOutcome;
+export type ConnectionAuthUpdate = {
+    name: string;
+    description: string;
+    state: ConnectionAuthState;
+    challenge?: ConnectionAuthChallenge;
+    reason?: string;
+};
+export type { ResponseMetadata as _ResponseMetadata };