eve 0.82.0 → 0.83.1

package/CHANGELOG.md

@@ -1,5 +1,86 @@
 # eve
 
+## 0.83.1
+
+### Patch Changes
+
+- 25c9fff: Dynamic tools now accept an `endsTurn` function, as static tools do. eve replays it from a durable descriptor like `execute`, so a tool returned by a `defineDynamic` resolver can decide from its output whether the call ends the turn.
+- eda6122: Eval artifacts now record client timing for each captured session: when each request was sent and accepted (including time spent retrying `session_not_ready`) and when each event arrived. `eve eval --keep-state` keeps the local eval server's state, including its Workflow data, after the run.
+- 77f4473: `eve eval --repeat <n>` and the `repeat` option in `evals.config.ts` run every eval `n` times to measure repeatability. Each attempt is reported as its own result with a 1-based `attempt`, with its own artifact files, Braintrust row, JUnit test case, and Datadog run iteration, and the console summary shows a per-eval pass rate such as `3/5 passed`.
+- 6f551a7: Model calls no longer resume the session sandbox just to render attachment labels. Images and PDFs that eve staged or already read for the session are served from a bounded in-memory cache, so the sandbox is resumed only when eve needs bytes it doesn't already hold.
+- d77462d: Non-module files under `agent/lib/`, such as a JSON file imported by a helper, no longer fail discovery. eve ignores them like it does in `tools/`, `channels/`, and `hooks/`, and the bundler resolves them when imported.
+- 3fbef89: Sandbox work no longer delays the model call. Prewarmed sessions start the sandbox in the background, turns resume a sandbox the session already uses as they begin, and dynamic skill files are written in the background; a tool that uses the sandbox waits only for what remains. A first message sent to a prewarmed session no longer waits for prewarming, and its `defineSandbox()` selector runs with the auth of the request that created the session.
+- 0a9f857: Add correlated OpenTelemetry events for session handover forwarding and inbox unblocking. Receiver observations include a replay-stable Workflow timestamp and are exported by the next existing turn step without adding tracing-only Workflow steps.
+
+## 0.83.0
+
+### Minor Changes
+
+- 12a1e90: `DefaultSandbox` now selects its provider once, when eve prepares the sandbox, and records the choice in the build: Vercel Sandbox on Vercel, then Docker when a daemon is reachable, then just-bash only in `eve dev` and `eve eval`. The runtime uses the recorded provider instead of probing the host again, so a build and its server can no longer select different providers. A production `eve build` with neither Vercel nor Docker no longer falls back to just-bash: the build succeeds, and opening the sandbox fails with an error that asks you to start Docker and rebuild, deploy to Vercel, or select a provider explicitly.
+  
+  `DefaultSandbox.environment().open()` now accepts `networkPolicy`, and its sessions expose `setNetworkPolicy()`. eve forwards the policy to the selected provider. Docker rejects any policy other than `"allow-all"` or `"deny-all"` when it opens the sandbox, instead of starting the container with open network access, and just-bash rejects any policy other than `"allow-all"`.
+  
+  Sessions now record their sandbox under the provider name `"default"` instead of `vercel`, `docker`, or `just-bash`. Sessions saved by an earlier eve under the provider that `DefaultSandbox` selected resume the same sandbox. When a session's recorded state belongs to another provider or state protocol, for example after you change providers, eve now starts a fresh sandbox instead of failing; the old sandbox is not deleted. This upgrade is one-way: if you roll back to an earlier eve release, sessions created on this release fail to open their sandbox, because earlier releases reject state recorded under `"default"`.
+  
+  `VercelSandbox.environment()` no longer captures a snapshot when the environment has no `prepare` callback, no managed workspace or skill files, and no `source`. Session sandboxes start from the image and install the base runtime themselves, as `DefaultSandbox` already did on Vercel. Such sessions now apply a `networkPolicy` set on the environment after base setup; before, only a policy passed to `open()` applied, so `VercelSandbox.environment({ networkPolicy })` and `DefaultSandbox.environment({ vercel: { networkPolicy } })` could leave a session with open network access.
+- 62112b5: The just-bash sandbox provider now runs on the public `defineSandboxProvider()` API, and `customCommands` and `filesystem` use eve-owned types from `eve/sandbox/just-bash`, such as `JustBashCommand` and `JustBashFilesystem`, that still accept just-bash's `defineCommand()` results and filesystems. Local just-bash templates rebuild once after upgrading, since their keys no longer include custom commands or the filesystem; reading a directory now rejects instead of returning `null`, and a command ending in a `# comment` runs in any working directory.
+- 8b68a92: Remove the microsandbox sandbox provider. The `eve/sandbox/microsandbox` export and the `microsandbox` option on `DefaultSandbox.environment()` are gone, and `DefaultSandbox` now selects Vercel Sandbox on Vercel, then Docker when a daemon is reachable, then just-bash. To migrate, switch `MicrosandboxSandbox.image()` and `MicrosandboxSandbox.dockerfile()` to `DockerSandbox.image()` and `DockerSandbox.dockerfile()` from `eve/sandbox/docker`, and remove the `microsandbox` dependency. A session that recorded a microsandbox sandbox starts a fresh sandbox from its current provider on its next `ctx.getSandbox()`.
+  
+  eve no longer cleans up what microsandbox left on your machine. Before you uninstall `microsandbox`, use its tooling to remove sandboxes and snapshots whose names start with `eve-sbx-`. Then delete `.eve/sandbox-cache/microsandbox` in each app. If you used `MicrosandboxSandbox.dockerfile()`, also run `docker rm -f eve-sandbox-registry` to remove the local image registry it started, and remove the local images tagged `127.0.0.1:51921/eve/…`.
+  
+  Deployed self-modification (`eve/self-modification/remote`) now requires deploying on Vercel. Builds still succeed on any host, but in a deployment outside Vercel the deployed subagent fails with an error that names this requirement when it opens its sandbox.
+- 5b27aa8: **Breaking for custom sandbox providers.** `defineSandboxProvider()` now takes a byte-level `SandboxConnection` (`spawn`, `readFile`, `writeFiles`, `removePath`, `stop`, optional `close` and `extensions`), and eve derives the full sandbox session from it. Built-in providers are unchanged. See the [custom sandbox providers guide](https://eve.dev/docs/sandbox/custom-providers). To migrate a provider:
+  
+  - Return `{ connection, state }` from `start()` and a connection from `resume()`. `onSandboxStop()` and `onRuntimeShutdown()` become `connection.stop()`, and `onSandboxDelete()` folds into `onSessionEnd()` with `reason: "deleted"`.
+  - Replace `ctx.resources` and `ctx.sourceRevision` with `ctx.templateKey()` and `ctx.populate()`, and remove your own `prepare` option, which eve now runs. `environment()` receives `{}` instead of `undefined` when no options are passed. Set `toolSessions: true` to support keyed `invokeTool` calls.
+  - Rename `SandboxPreparedArtifact` to `SandboxJson`, `SandboxProviderSessionContext` to `SandboxSessionContext`, and `SandboxProviderPrepareContext` to `SandboxPrepareContext`. `SandboxProviderHandle` and the `SandboxProviderResource*` and `SandboxProviderTargetFile` types are removed, as is `ctx.host`.
+  
+  `eve/sandbox/provider` also exports `SandboxSessionGoneError`, `SandboxTemplateNotProvisionedError`, and `SANDBOX_AGENT_ENV`. In `eve/sandbox`, `SandboxSession` gains a required `writeFiles()`, so hand-built sessions such as test doubles need one, and `SandboxNetworkPolicy` is now an eve-owned type rather than the Vercel Sandbox SDK's `NetworkPolicy`.
+- 3f698dd: Sandbox providers now key each sandbox by its session: `start()` must return the existing sandbox for `ctx.session.id` when one exists, and the required `onSessionEnd(ctx, state | null, { reason })` takes no artifact and must delete by key when `state` is `null`. Session end now removes a sandbox even when the session never recorded it, such as one a subagent sharing the sandbox opened first. Built-in providers keep a session's sandbox across rebuilds and open-option changes.
+- 950409f: `VercelSandbox` now runs on the public `defineSandboxProvider()` API, keeping existing sandbox names, session state, and snapshots. Breaking: a relative `workingDirectory` now resolves from `/workspace`, and `eve/sandbox/vercel` no longer re-exports `Drive`, so import it from `@vercel/sandbox` instead.
+
+### Patch Changes
+
+- bd050f8: Clearer sandbox error messages. Sandbox errors now say what went wrong and how to fix it, for example when the build and the runtime select different providers, a prepared template is missing, a session's sandbox came from another provider, or the sandbox file does not export its environment.
+- 95571f1: Fix discovery of extension mounts written as `export { default } from "<pkg>"` inside a packaged extension, which `eve extension build` compiles to `import x from "<pkg>"; export { x as default };`.
+- 7066b20: `eve dev` memory no longer grows with every save. Each rebuild now compiles and bundles your agent in a short-lived child process, and each new version of your code is served by a fresh worker, so old copies of authored modules no longer stay loaded. Modules imported by relative path now keep their package's `sideEffects` setting, so identical source bundles the same way on every save; in `"type": "module"` apps, default imports of older CommonJS packages that set `__esModule` now follow Node's rules. Thanks @callicles for reporting this in #5203.
+- dff87bc: `eve dev` now rebuilds once per edit to a source-backed workspace extension. Before, the temporary `.eve-extension-build-*` files from the extension build started a second, unnecessary rebuild.
+- 2b07d0a: The Discord channel can now answer DMs, mentions, and thread replies. `discordChannel({ gateway: {} })` accepts messages forwarded from the Discord Gateway, and `experimental_runDiscordGatewayRelay` from the new `eve/channels/discord/gateway` entry point holds that connection, for example in a Vercel Daemon. In text channels, a mention starts a thread that holds the conversation, and a reply to any bot message continues the session that posted it; set `gateway.startThread: false` to answer in the channel, or return `conversation` or `startThread` from `gateway.onMessage` to decide per message. `defaultDiscordMessageAuth` gives a message's author the same principal `defaultDiscordAuth` gives them for commands and button presses.
+- 87962a0: `eve add channel/discord` now first asks whether people reach the agent through DMs, mentions, and threads, or a slash command. The first scaffolds the Discord Gateway relay in `daemon/`, registers it as a Vercel Daemon in `vercel.json`, enables `gateway` on the channel, turns on the bot's Message Content intent when Discord allows it, and skips registering `/ask`; the second keeps today's slash command setup and is what `--yes` picks. Non-interactive runs answer `discord-messages` with `"gateway"` or `"commands"`.
+- acc76d5: The Discord channel now shows connection sign-ins. In a DM it posts the sign-in link and any confirmation code; in a server it posts a **Sign in** button that shows the link only to the person who has to sign in, in an ephemeral message. The message updates once the sign-in completes or is cancelled.
+- 4db529f: `DockerSandbox` now runs on the public `defineSandboxProvider()` contract. Container names, recorded session state, and template image references stay the same, so running sessions and prepared images from earlier builds keep working. A few behaviors change: `sandbox.delete()` removes the session's container by its session-derived name, honors the caller's `abortSignal`, and succeeds when the container is already gone; eve normalizes relative paths such as `logs/../out.txt` to `/workspace/out.txt` before they reach the container; and a Docker environment's `prepare` callback is typed with `DockerSandboxSession`.
+- 5cf30b6: A dynamic model resolver's `step.started` event now carries the index of the step it selects a model for. From the second step of a turn on, it used to carry the previous step's index, so per-step work keyed on `stepIndex` was attributed to the wrong step.
+- 3c25e62: A dynamic skill that stops returning `files` but is still returned now keeps the files already written to the sandbox, so files the sandbox provides another way, such as from its snapshot, stay in place. If you dropped `files` to take files away from some callers, stop returning the skill for them instead: a skill the resolver stops returning still has its files removed. On Vercel Sandbox, eve now writes a dynamic skill's files in one batch, with one path lookup and one upload instead of two round trips per file.
+- 1bbe939: `eve eval` artifacts now record each eval's `startedAt` and `completedAt` in `summary.json`, `results.jsonl`, and the per-eval detail file.
+- 448804d: An eval's `derived.usage` now takes each session's latest usage by time. An eval that captured a session again with an earlier snapshot reported that snapshot's lower total. Its `costUsd` is now absent when a counted session reported no cost, instead of summing only the sessions that did.
+- 94784e1: Validate idle session state inside the workflow before starting a deployment handoff, avoiding unnecessary successor starts when durable work is still pending. Preserve inbox ownership and the original session stream throughout the move.
+- 580417f: Fix repeated horizontal rules and question text accumulating in terminal scrollback during human-in-the-loop prompts. Question and approval drawers now fit small terminals, keeping the focused choice or text editor visible.
+- b848a51: Avoid an extra setup command when creating a Vercel sandbox from a prepared snapshot of the standard eve image without Drive mounts. eve now checks the base runtime again after authored preparation, so a `prepare` callback that breaks it fails the build; existing sandboxes, resumes, custom images or sources, Drive mounts, and sandboxes without a prepared snapshot keep their setup checks. Vercel templates rebuild once so every snapshot has passed the new check.
+- 39a8b4c: A session whose sandbox is gone (for example after a removed Docker container, a deleted Vercel Sandbox, or a deleted just-bash session directory) now starts a fresh sandbox on its next `ctx.getSandbox()`. Previously every sandbox call in that session failed with the same resume error until the session ended. Thanks @bradhallett for reporting this in #5113 and @moinulmoin for the just-bash case in #4440.
+- bb4afff: New sessions start their first model step sooner, and later turns no longer wait for their cancellation hooks to register before their first step. Thanks @Lukavyi for reporting the startup latency in #876.
+- 798a91e: The Linq channel now rejects inbound webhooks with a 401 whenever its webhook verifier returns any falsy value, including the `null` that `vercelOidc()` returns for a missing or invalid token. Previously only `false` rejected a request, so Vercel Connect setups without a `signingSecret` accepted unsigned webhooks.
+- aaae448: Self-hosted `eve start` servers now reject requests to `/.well-known/workflow/v1/flow` that did not come from the server's own workflow queue, so a client can no longer forge a workflow delivery with a chosen run context or principal. Startup always recovers pending and running local workflow runs through the authenticated queue, ignoring `WORKFLOW_LOCAL_RECOVER_ACTIVE_RUNS`; queue deliveries must stay on the process that enqueued them.
+- 9d1998f: Export `agentWithModel` for `agent/tools/agent.ts` to opt into a root-copy tool whose model-facing input selects the AI Gateway model for each task.
+- cbc87ae: OpenAPI connection tool calls now follow redirects only within the base URL's origin. A redirect to another origin is returned as the tool result, with its target in `location`, instead of followed, so credentials in custom headers, such as an `apiKey` security scheme's header, no longer reach the redirect target. A same-origin redirect loop now fails after 10 hops with an explicit error.
+- 7a908f5: Compaction summaries now run on the AI SDK model instance set as `compaction.model`. Before, a direct model instance there was ignored and summaries ran on the agent's top-level `model`.
+- 84daf59: Compiles now prune `node_modules/.cache/eve/authored-modules` in the background, deleting cached bundles that no running eve process can still import, so the directory no longer grows without bound locally or in persisted Vercel build caches. Thanks @ryantbrown for reporting this in #847 and @kevludwig for reporting the Vercel build-cache impact.
+- 9bd75df: `server-only` and `client-only` imports now load as empty modules in every eve bundle, so tools, channels, workflow steps, and shared workspace packages that import them build and boot without `--conditions=react-server` or a direct dependency. Thanks @jakeleventhal for the original implementation in #3752.
+- b9f984c: Update the bundled Workflow runtime to reduce redundant history reads during concurrent hook registration and avoid unnecessary input/output reads when resuming hooks. Include replay-ordering fixes and the local-world fix for deliveries that race a session handoff.
+- f5b36b3: Repair orphaned local tool calls in saved history before the next model request with an explicit unknown-outcome error. The repair never reruns tools or moves recorded results, and leaves provider-executed calls, approval requests and duplicate call IDs alone.
+- 1fe0d91: Dynamic skills with supporting files are written into a sandbox that eve recreates after the old one was gone, at the start of the next turn. Before, the recreated sandbox got the same identity as the old one, so its skills were missing their files until the skill changed.
+- b3ede07: The Linq and Photon channels' default webhook verification now only accepts Vercel OIDC tokens from the same project and environment.
+- 00aa593: eve now runs every sandbox provider, including `DefaultSandbox`, directly on the public `defineSandboxProvider()` contract, and calls `connection.close()` when the step that opened a connection ends, so the next step resumes through a new connection. Server shutdown stops only connections eve still holds, so a custom provider that defines `close()` and runs remote compute should bound idle compute itself, for example with an idle timeout.
+- c3bbae4: Relative symlinks in an agent's `sandbox/workspace/` files, in skill packages, and in sandbox templates now stay relative in build output and in each sandbox session. Before, eve rewrote them as absolute host paths: `just-bash` sessions rejected them with `EACCES ... resolves outside sandbox`, and they did not resolve inside Docker, microsandbox, or remote sandboxes.
+- 00aa593: Custom sandbox providers can declare `workspaceRoot` on a connection, and eve resolves relative paths, the default working directory, `resolvePath(".")`, and build-time workspace seeding from it; built-in providers keep `/workspace`. The `read_file`, `write_file`, `glob`, and `grep` tools now accept paths relative to the workspace root, and the workspace and skills prompt sections no longer name `/workspace`.
+- db18149: `eve start` and the `withEve` production server for Next.js now fail fast with a clear "port is already in use" error when another process holds the port, instead of reporting a server they did not start and leaving the built server running in the background. Thanks @KingAmo for reporting this in #4938.
+- 9d804f2: A sandbox that was stopped and then ended no longer stays registered for server shutdown, so long-running eve servers stop accumulating ended sessions and shutdown no longer stops their connections again.
+- f1656a5: Tools can now hand the model a file by URL. `toolOutputPart.fileUrl(url, { mediaType })` from `eve/tools` returns a `{ type: "file", data: { type: "url", url } }` content part from `toModelOutput`, so a large file such as a presigned PDF link reaches the model without being base64-encoded, staged into the sandbox, or stored in session history. Only `https:` URLs are accepted, and the URL must stay readable for the rest of the session because every later model call sends it again.
+- ea3a387: Calling `prewarm()` on an existing session can now prepare an idle owner on the Vercel deployment accepting the request before the next message. Apps can trigger it when typing starts; it preserves the session, history, stream, and expiry, and does not block Send or run the model.
+  
+  Preparation uses the existing `POST /eve/v1/session/:sessionId` endpoint with no body or `{}`. Requests with messages or input responses keep their existing behavior.
+- 07dbdef: Each start or resume of a `workflow` tool program may now run up to 30 seconds of JavaScript and take up to 5 minutes in total, and time spent waiting for child agents counts toward neither limit.
+- dd0aac6: A `"use step"` helper in a workflow tool can now call `ctx.getSandbox()` to open the sandbox of the session that called the tool, on any sandbox provider, so a task can prepare files the session's later tool calls read. When the session had not recorded its sandbox when it called the tool, the step opens it with the owning session's sandbox definition; the step never owns the sandbox, and the session removes it when the session ends.
+
 ## 0.82.0
 
 ### Minor Changes

package/NOTICE

@@ -4,7 +4,7 @@ Copyright 2026 Vercel, Inc. and contributors
 This product includes software developed at Vercel, Inc.
 (https://vercel.com/).
 
-The bundled code-mode runtime includes run, Copyright 2023 Vercel, Inc.,
+The bundled workflow program runtime is run, Copyright 2023 Vercel, Inc.,
 licensed under the Apache License, Version 2.0.
 
 run embeds devalue 5.8.2, quickjs-wasi 3.6.0, and QuickJS under the MIT

package/dist/src/channel/pending-authorization.d.ts

@@ -7,4 +7,9 @@ type AuthorizationRequired = AuthorizationRequiredStreamEvent["data"];
  * `attemptId`, so one attempt completing never hides another still pending.
  */
 export declare function findPendingAuthorization(session: Pick<Session, "getEventStream">, matches: (event: AuthorizationRequired) => boolean): Promise<AuthorizationRequired | undefined>;
+/** Identifies one sign-in attempt: a connection name and its `attemptId`. */
+export declare function attemptKey(event: {
+    readonly attemptId?: string;
+    readonly name: string;
+}): string;
 export {};

package/dist/src/channel/pending-authorization.js

@@ -1 +1 @@
-async function findPendingAuthorization(e,t){let n=new Map,r=(await e.getEventStream({follow:!1,startIndex:-500})).getReader();try{for(;;){let e=await r.read();if(e.done)break;let i=e.value;if(i.type===`authorization.required`&&t(i.data)){let e=attemptKey(i.data);n.delete(e),n.set(e,i.data)}else i.type===`authorization.completed`&&n.delete(attemptKey(i.data))}}finally{await r.cancel().catch(()=>{})}return[...n.values()].at(-1)}function attemptKey(e){return JSON.stringify([e.name,e.attemptId??null])}export{findPendingAuthorization};
+async function findPendingAuthorization(e,t){let n=new Map,r=(await e.getEventStream({follow:!1,startIndex:-500})).getReader();try{for(;;){let e=await r.read();if(e.done)break;let i=e.value;if(i.type===`authorization.required`&&t(i.data)){let e=attemptKey(i.data);n.delete(e),n.set(e,i.data)}else i.type===`authorization.completed`&&n.delete(attemptKey(i.data))}}finally{await r.cancel().catch(()=>{})}return[...n.values()].at(-1)}function attemptKey(e){return JSON.stringify([e.name,e.attemptId??null])}export{attemptKey,findPendingAuthorization};

package/dist/src/channel/session.d.ts

@@ -22,6 +22,8 @@ export interface Session {
     cancel(options?: {
         turnId?: string;
     }): Promise<CancelTurnResult>;
+    /** Prepares an idle session on the deployment accepting this request, without a model turn. */
+    prewarm(): Promise<import("#protocol/prewarm-session.js").PrewarmSessionResult>;
     /** Queues compaction on this exact session ID. */
     compact(): Promise<CompactSessionResult>;
     /** Queues a context clear on this exact session ID. */

package/dist/src/channel/session.js

@@ -1 +1 @@
-import{attachClientContext,readClientContext}from"#internal/client-context.js";import{validateDeliveryIdempotencyKey}from"#channel/delivery-idempotency.js";import{createChannelDeliveryMetadata}from"#channel/delivery-metadata.js";import{serializeFilePartsInMessage}from"#channel/send-input.js";import{DEFAULT_TURN_POLICY}from"#channel/types.js";import{validateSessionHistory}from"#shared/session-history.js";import{parseInputResponses}from"#shared/input.js";import{AuthKey,ContinuationHookTokensKey,ContinuationTokenKey,InitiatorAuthKey,SessionIdKey}from"#context/keys.js";import{toChannelLocalContinuationToken}from"#shared/continuation-token.js";function createSession(e,t,n={}){return{id:e,async send(r,i){validateDeliveryIdempotencyKey(i.idempotencyKey);let a=createDelivery(n),o=sessionCallbackToTurnCaller(i.callback),s=validateSessionHistory(i.history),c=attachClientContext({message:serializeFilePartsInMessage(r)},readClientContext(i));i.context!==void 0&&(c.context=i.context),s!==void 0&&(c.history=s),i.outputSchema!==void 0&&(c.outputSchema=i.outputSchema);let l={idempotencyKey:i.idempotencyKey,auth:i.auth,delivery:a,kind:`send`,payload:c,requestId:n.requestId,turnPolicy:i.turnPolicy??n.turnPolicy??DEFAULT_TURN_POLICY,title:i.title};return await t.dispatchSession({command:o===void 0?l:{...l,caller:o},sessionId:e})},async respond(r,i){if(validateDeliveryIdempotencyKey(i.idempotencyKey),r.length===0)throw Error(`respond() requires at least one input response.`);let a=parseInputResponses(r),o=sessionCallbackToTurnCaller(i.callback),s=createDelivery(n),c=attachClientContext({inputResponses:a},readClientContext(i));i.context!==void 0&&(c.context=i.context),i.outputSchema!==void 0&&(c.outputSchema=i.outputSchema);let l={idempotencyKey:i.idempotencyKey,auth:i.auth,delivery:s,kind:`send`,payload:c,requestId:n.requestId};return await t.dispatchSession({command:o===void 0?l:{...l,caller:o},sessionId:e})},async cancel(n){let r={kind:`cancel`};return n?.turnId!==void 0&&(r.turnId=n.turnId),await t.dispatchSession({command:r,sessionId:e})},async compact(){return await t.dispatchSession({command:{kind:`compact`},sessionId:e})},async clear(){return await t.dispatchSession({command:{kind:`clear`},sessionId:e})},async reset(n){return await t.dispatchSession({command:{kind:`reset`,reason:n?.reason},sessionId:e})},async getEventStream(n){return t.getEventStream(e,n)},async getStreamTailIndex(){return t.getStreamTailIndex(e)}}}function createAttachSessionFn(e,t={}){return n=>createSession(n,e,t)}function createDelivery(e){return e.channelKind!==void 0&&e.channelName!==void 0?createChannelDeliveryMetadata(e):void 0}function buildSessionHandle(e){return{get id(){return e.get(SessionIdKey)??``},get auth(){return{current:e.get(AuthKey)??null,initiator:e.get(InitiatorAuthKey)??null}},get continuation(){let t=e.get(ContinuationTokenKey);if(t!==void 0&&t.length!==0)return{token:toChannelLocalContinuationToken(t),alias(n){if(n.length===0)throw Error(`A session alias requires a nonempty token.`);let r=namespaceContinuationToken(t,n);t!==r&&(e.set(ContinuationHookTokensKey,e=>{let n=e??[t];return n.includes(r)?n:[...n,r]}),e.set(ContinuationTokenKey,r))}}}}}function namespaceContinuationToken(e,t){let n=e.indexOf(`:`);if(n<=0)throw Error(`Cannot set session continuation token without an existing namespaced continuation token. Start the session with a placeholder continuationToken.`);return`${e.slice(0,n+1)}${t}`}function sessionCallbackToTurnCaller(e){return e===void 0?void 0:{callId:e.callId,replyTo:{kind:`callback`,token:e.token,url:e.url},subagentName:e.subagentName}}export{buildSessionHandle,createAttachSessionFn,createSession,sessionCallbackToTurnCaller};
+import{attachClientContext,readClientContext}from"#internal/client-context.js";import{validateDeliveryIdempotencyKey}from"#channel/delivery-idempotency.js";import{createChannelDeliveryMetadata}from"#channel/delivery-metadata.js";import{serializeFilePartsInMessage}from"#channel/send-input.js";import{DEFAULT_TURN_POLICY}from"#channel/types.js";import{validateSessionHistory}from"#shared/session-history.js";import{parseInputResponses}from"#shared/input.js";import{AuthKey,ContinuationHookTokensKey,ContinuationTokenKey,InitiatorAuthKey,SessionIdKey}from"#context/keys.js";import{toChannelLocalContinuationToken}from"#shared/continuation-token.js";function createSession(e,t,n={}){return{id:e,async send(r,i){validateDeliveryIdempotencyKey(i.idempotencyKey);let a=createDelivery(n),o=sessionCallbackToTurnCaller(i.callback),s=validateSessionHistory(i.history),c=attachClientContext({message:serializeFilePartsInMessage(r)},readClientContext(i));i.context!==void 0&&(c.context=i.context),s!==void 0&&(c.history=s),i.outputSchema!==void 0&&(c.outputSchema=i.outputSchema);let l={idempotencyKey:i.idempotencyKey,auth:i.auth,delivery:a,kind:`send`,payload:c,requestId:n.requestId,turnPolicy:i.turnPolicy??n.turnPolicy??DEFAULT_TURN_POLICY,title:i.title};return await t.dispatchSession({command:o===void 0?l:{...l,caller:o},sessionId:e})},async respond(r,i){if(validateDeliveryIdempotencyKey(i.idempotencyKey),r.length===0)throw Error(`respond() requires at least one input response.`);let a=parseInputResponses(r),o=sessionCallbackToTurnCaller(i.callback),s=createDelivery(n),c=attachClientContext({inputResponses:a},readClientContext(i));i.context!==void 0&&(c.context=i.context),i.outputSchema!==void 0&&(c.outputSchema=i.outputSchema);let l={idempotencyKey:i.idempotencyKey,auth:i.auth,delivery:s,kind:`send`,payload:c,requestId:n.requestId};return await t.dispatchSession({command:o===void 0?l:{...l,caller:o},sessionId:e})},async cancel(n){let r={kind:`cancel`};return n?.turnId!==void 0&&(r.turnId=n.turnId),await t.dispatchSession({command:r,sessionId:e})},async prewarm(){return await t.dispatchSession({command:{kind:`prewarm`,targetDeploymentId:n.acceptedDeploymentId},sessionId:e})},async compact(){return await t.dispatchSession({command:{kind:`compact`},sessionId:e})},async clear(){return await t.dispatchSession({command:{kind:`clear`},sessionId:e})},async reset(n){return await t.dispatchSession({command:{kind:`reset`,reason:n?.reason},sessionId:e})},async getEventStream(n){return t.getEventStream(e,n)},async getStreamTailIndex(){return t.getStreamTailIndex(e)}}}function createAttachSessionFn(e,t={}){return n=>createSession(n,e,t)}function createDelivery(e){return e.channelKind!==void 0&&e.channelName!==void 0?createChannelDeliveryMetadata(e):void 0}function buildSessionHandle(e){return{get id(){return e.get(SessionIdKey)??``},get auth(){return{current:e.get(AuthKey)??null,initiator:e.get(InitiatorAuthKey)??null}},get continuation(){let t=e.get(ContinuationTokenKey);if(t!==void 0&&t.length!==0)return{token:toChannelLocalContinuationToken(t),alias(n){if(n.length===0)throw Error(`A session alias requires a nonempty token.`);let r=namespaceContinuationToken(t,n);t!==r&&(e.set(ContinuationHookTokensKey,e=>{let n=e??[t];return n.includes(r)?n:[...n,r]}),e.set(ContinuationTokenKey,r))}}}}}function namespaceContinuationToken(e,t){let n=e.indexOf(`:`);if(n<=0)throw Error(`Cannot set session continuation token without an existing namespaced continuation token. Start the session with a placeholder continuationToken.`);return`${e.slice(0,n+1)}${t}`}function sessionCallbackToTurnCaller(e){return e===void 0?void 0:{callId:e.callId,replyTo:{kind:`callback`,token:e.token,url:e.url},subagentName:e.subagentName}}export{buildSessionHandle,createAttachSessionFn,createSession,sessionCallbackToTurnCaller};

package/dist/src/channel/types.d.ts

@@ -179,6 +179,9 @@ export type SessionCommand = {
 } | {
     readonly kind: "cancel";
     readonly turnId?: string;
+} | {
+    readonly kind: "prewarm";
+    readonly targetDeploymentId?: string;
 } | {
     readonly kind: "compact";
 } | {
@@ -204,6 +207,8 @@ export type ResetSessionResult = {
     readonly status: "no_active_session";
 };
 export type SessionCommandResult<TCommand extends SessionCommand = SessionCommand> = TCommand extends {
+    readonly kind: "prewarm";
+} ? import("#protocol/prewarm-session.js").PrewarmSessionResult : TCommand extends {
     readonly kind: "send";
 } ? SessionSendCommandResult : TCommand extends {
     readonly kind: "cancel";

package/dist/src/chunks/{use-eve-agent-DTu78IAF.js → use-eve-agent-DnbG9c7c.js}

@@ -1751,9 +1751,11 @@ function isResultCompletedEvent(event) {
 //#region src/client/message-response.ts
 const consumeResponse = Symbol("consumeMessageResponse");
 const acceptedDeliveryId = Symbol("acceptedDeliveryId");
+const sendReceipt = Symbol("sendReceipt");
 var MessageResponse = class {
 	sessionId;
 	[acceptedDeliveryId];
+	[sendReceipt];
 	#cancelTurn;
 	#cancellation;
 	#consumed = false;
@@ -1765,6 +1767,7 @@ var MessageResponse = class {
 		this.#cancelTurn = input.cancelTurn;
 		this.sessionId = input.sessionId;
 		this[acceptedDeliveryId] = input.deliveryId;
+		this[sendReceipt] = input.receipt;
 		this.#createStream = input.createStream;
 		this.#resumesTurn = input.resumesTurn ?? false;
 	}
@@ -1821,6 +1824,18 @@ function consumeMessageResponse(response, source) {
 	return response[consumeResponse](source);
 }
 
+//#endregion
+//#region src/protocol/prewarm-session.ts
+const PrewarmResponseSchema = z.object({
+	ok: z.literal(true),
+	status: z.enum([
+		"ready",
+		"accepted",
+		"unsupported",
+		"no_active_session"
+	])
+});
+
 //#endregion
 //#region src/protocol/cancel-turn.ts
 const CancelTurnResponseSchema = z.discriminatedUnion("status", [z.strictObject({
@@ -1867,6 +1882,17 @@ const ResetResponseSchema = z.discriminatedUnion("status", [z.object({
 
 //#endregion
 //#region src/client/session-controls.ts
+async function prewarmClientSession(input) {
+	const { payload } = await postJson({
+		context: input.context,
+		operation: "Prewarm",
+		path: createEveSessionRoutePath(input.sessionId),
+		signal: input.signal
+	});
+	const result = PrewarmResponseSchema.safeParse(payload);
+	if (!result.success) throw new Error("Prewarm route returned an invalid response.");
+	return { status: result.data.status };
+}
 async function cancelClientSession(input) {
 	const { signal, ...body } = input.options ?? {};
 	const { payload, response } = await postJson({
@@ -2323,14 +2349,22 @@ var ClientSession = class ClientSession {
 		this.#state = state;
 	}
 	static async create(context, input) {
+		const startedAt = Date.now();
 		const response = await postTurn(context, EVE_SESSION_ROUTE_PATH, input, true, input.stubs);
-		const { sessionId } = await readAcceptedMessage(response);
+		const acceptedAt = Date.now();
+		const { sessionId, deliveryId } = await readAcceptedMessage(response);
 		const session = new ClientSession(context, {
 			sessionId,
 			streamIndex: 0
 		});
+		const receipt = {
+			deliveryId,
+			startedAt,
+			notReadyMs: 0,
+			acceptedAt
+		};
 		return {
-			response: session.#messageResponse(response, input, 0),
+			response: session.#messageResponse(response, input, 0, void 0, receipt),
 			session
 		};
 	}
@@ -2377,11 +2411,21 @@ var ClientSession = class ClientSession {
 	async #send(input, retrySessionNotReady) {
 		const initialStreamIndex = this.#state.streamIndex;
 		const path = createEveSessionRoutePath(this.#state.sessionId);
-		const response = retrySessionNotReady ? await postSessionSend(this.#context, path, input) : await postTurn(this.#context, path, input, false);
+		const { response, timing } = await postSessionSend(this.#context, path, input, retrySessionNotReady);
 		const { sessionId: responseSessionId, deliveryId } = await readAcceptedMessage(response, this.#state.sessionId);
 		if (responseSessionId !== this.#state.sessionId) throw new Error("Message route returned a different session id.");
 		if (input.message !== void 0 && deliveryId === void 0) throw new Error("Message route did not return a delivery id. Update the server before sending with this client.");
-		return this.#messageResponse(response, input, initialStreamIndex, input.message === void 0 ? void 0 : deliveryId);
+		return this.#messageResponse(response, input, initialStreamIndex, input.message === void 0 ? void 0 : deliveryId, {
+			...timing,
+			deliveryId
+		});
+	}
+	async prewarm(options) {
+		return await prewarmClientSession({
+			context: this.#context,
+			sessionId: this.#state.sessionId,
+			signal: options?.signal
+		});
 	}
 	async cancel(options) {
 		return await cancelClientSession({
@@ -2422,12 +2466,13 @@ var ClientSession = class ClientSession {
 			keepAlive: true
 		});
 	}
-	#messageResponse(response, input, initialStreamIndex, deliveryId) {
+	#messageResponse(response, input, initialStreamIndex, deliveryId, receipt) {
 		response.body?.cancel().catch(() => {});
 		return new MessageResponse({
 			cancelTurn: async (turnId) => await this.cancel({ turnId }),
 			createStream: (source) => this.#createEventStream(initialStreamIndex, input, deliveryId, source),
 			deliveryId,
+			receipt,
 			resumesTurn: input.inputResponses !== void 0,
 			sessionId: this.#state.sessionId
 		});
@@ -2508,14 +2553,23 @@ var ClientSession = class ClientSession {
 function followClientSession(session, options) {
 	return session[followSession](options);
 }
-async function postSessionSend(context, path, input) {
-	const readyDeadline = Date.now() + SESSION_SEND_READY_TIMEOUT_MS;
+async function postSessionSend(context, path, input, retrySessionNotReady) {
+	const startedAt = Date.now();
+	const readyDeadline = startedAt + SESSION_SEND_READY_TIMEOUT_MS;
 	let retryDelayMs = SESSION_SEND_RETRY_BASE_DELAY_MS;
 	for (;;) {
+		const attemptAt = Date.now();
 		try {
-			return await postTurn(context, path, input, false);
+			return {
+				response: await postTurn(context, path, input, false),
+				timing: {
+					startedAt,
+					notReadyMs: attemptAt - startedAt,
+					acceptedAt: Date.now()
+				}
+			};
 		} catch (error) {
-			if (!isSessionNotReady(error)) throw error;
+			if (!retrySessionNotReady || !isSessionNotReady(error)) throw error;
 			const remainingMs = readyDeadline - Date.now();
 			if (remainingMs <= 0) throw error;
 			await sleep(Math.min(retryDelayMs, remainingMs), input.signal);
@@ -4358,17 +4412,22 @@ var EveAgentStore = class {
 	}
 	prewarm() {
 		if (this.#prewarmPromise !== void 0) return this.#prewarmPromise;
-		if (this.#session !== void 0 || this.#externalSession) return Promise.resolve();
-		if (this.#activeTurn !== void 0) return this.#activeTurn.response.then((response) => {
+		if (this.#session === void 0 && this.#externalSession) return Promise.resolve();
+		if (this.#activeTurn !== void 0 && this.#session === void 0) return this.#activeTurn.response.then((response) => {
 			if (response === void 0) throw this.#error ?? new DOMException("Session creation was aborted.", "AbortError");
 		});
 		const client = this.#client;
-		if (client === void 0) return Promise.reject(/* @__PURE__ */ new Error("This eve agent store does not own a session client."));
+		const session = this.#session;
+		if (client === void 0 && session === void 0) return Promise.reject(/* @__PURE__ */ new Error("This eve agent store does not own a session client."));
 		const generation = this.#prewarmGeneration;
 		const controller = new AbortController();
 		this.#prewarmController = controller;
 		const promise = (async () => {
 			try {
+				if (session !== void 0) {
+					await session.prewarm({ signal: controller.signal });
+					return;
+				}
 				const created = await client.sessions.create({ signal: controller.signal });
 				if (generation !== this.#prewarmGeneration) return;
 				this.#error = void 0;
@@ -4376,7 +4435,7 @@ var EveAgentStore = class {
 				this.#adoptSession(created.session);
 				if (this.#followIdle) this.#ensureStream();
 			} catch (error) {
-				if (generation === this.#prewarmGeneration && this.#activeTurn === void 0 && this.#error === void 0) this.#fail(error);
+				if (session === void 0 && generation === this.#prewarmGeneration && this.#activeTurn === void 0 && this.#error === void 0) this.#fail(error);
 				throw error;
 			}
 		})();
@@ -4626,7 +4685,7 @@ var EveAgentStore = class {
 			headers: input.headers,
 			streamReconnectPolicy: input.streamReconnectPolicy
 		};
-		if (this.#prewarmPromise !== void 0) {
+		if (this.#session === void 0 && this.#prewarmPromise !== void 0) {
 			await waitWithSignal(this.#prewarmPromise.catch((error) => {
 				if (this.#session !== void 0) throw error;
 			}), input.signal);

package/dist/src/chunks/{use-eve-agent-DlznYwQk.js → use-eve-agent-ZY7NQ2VW.js}

@@ -1752,9 +1752,11 @@ function isResultCompletedEvent(event) {
 //#region src/client/message-response.ts
 const consumeResponse = Symbol("consumeMessageResponse");
 const acceptedDeliveryId = Symbol("acceptedDeliveryId");
+const sendReceipt = Symbol("sendReceipt");
 var MessageResponse = class {
 	sessionId;
 	[acceptedDeliveryId];
+	[sendReceipt];
 	#cancelTurn;
 	#cancellation;
 	#consumed = false;
@@ -1766,6 +1768,7 @@ var MessageResponse = class {
 		this.#cancelTurn = input.cancelTurn;
 		this.sessionId = input.sessionId;
 		this[acceptedDeliveryId] = input.deliveryId;
+		this[sendReceipt] = input.receipt;
 		this.#createStream = input.createStream;
 		this.#resumesTurn = input.resumesTurn ?? false;
 	}
@@ -1822,6 +1825,18 @@ function consumeMessageResponse(response, source) {
 	return response[consumeResponse](source);
 }
 
+//#endregion
+//#region src/protocol/prewarm-session.ts
+const PrewarmResponseSchema = z.object({
+	ok: z.literal(true),
+	status: z.enum([
+		"ready",
+		"accepted",
+		"unsupported",
+		"no_active_session"
+	])
+});
+
 //#endregion
 //#region src/protocol/cancel-turn.ts
 const CancelTurnResponseSchema = z.discriminatedUnion("status", [z.strictObject({
@@ -1868,6 +1883,17 @@ const ResetResponseSchema = z.discriminatedUnion("status", [z.object({
 
 //#endregion
 //#region src/client/session-controls.ts
+async function prewarmClientSession(input) {
+	const { payload } = await postJson({
+		context: input.context,
+		operation: "Prewarm",
+		path: createEveSessionRoutePath(input.sessionId),
+		signal: input.signal
+	});
+	const result = PrewarmResponseSchema.safeParse(payload);
+	if (!result.success) throw new Error("Prewarm route returned an invalid response.");
+	return { status: result.data.status };
+}
 async function cancelClientSession(input) {
 	const { signal, ...body } = input.options ?? {};
 	const { payload, response } = await postJson({
@@ -2324,14 +2350,22 @@ var ClientSession = class ClientSession {
 		this.#state = state;
 	}
 	static async create(context, input) {
+		const startedAt = Date.now();
 		const response = await postTurn(context, EVE_SESSION_ROUTE_PATH, input, true, input.stubs);
-		const { sessionId } = await readAcceptedMessage(response);
+		const acceptedAt = Date.now();
+		const { sessionId, deliveryId } = await readAcceptedMessage(response);
 		const session = new ClientSession(context, {
 			sessionId,
 			streamIndex: 0
 		});
+		const receipt = {
+			deliveryId,
+			startedAt,
+			notReadyMs: 0,
+			acceptedAt
+		};
 		return {
-			response: session.#messageResponse(response, input, 0),
+			response: session.#messageResponse(response, input, 0, void 0, receipt),
 			session
 		};
 	}
@@ -2378,11 +2412,21 @@ var ClientSession = class ClientSession {
 	async #send(input, retrySessionNotReady) {
 		const initialStreamIndex = this.#state.streamIndex;
 		const path = createEveSessionRoutePath(this.#state.sessionId);
-		const response = retrySessionNotReady ? await postSessionSend(this.#context, path, input) : await postTurn(this.#context, path, input, false);
+		const { response, timing } = await postSessionSend(this.#context, path, input, retrySessionNotReady);
 		const { sessionId: responseSessionId, deliveryId } = await readAcceptedMessage(response, this.#state.sessionId);
 		if (responseSessionId !== this.#state.sessionId) throw new Error("Message route returned a different session id.");
 		if (input.message !== void 0 && deliveryId === void 0) throw new Error("Message route did not return a delivery id. Update the server before sending with this client.");
-		return this.#messageResponse(response, input, initialStreamIndex, input.message === void 0 ? void 0 : deliveryId);
+		return this.#messageResponse(response, input, initialStreamIndex, input.message === void 0 ? void 0 : deliveryId, {
+			...timing,
+			deliveryId
+		});
+	}
+	async prewarm(options) {
+		return await prewarmClientSession({
+			context: this.#context,
+			sessionId: this.#state.sessionId,
+			signal: options?.signal
+		});
 	}
 	async cancel(options) {
 		return await cancelClientSession({
@@ -2423,12 +2467,13 @@ var ClientSession = class ClientSession {
 			keepAlive: true
 		});
 	}
-	#messageResponse(response, input, initialStreamIndex, deliveryId) {
+	#messageResponse(response, input, initialStreamIndex, deliveryId, receipt) {
 		response.body?.cancel().catch(() => {});
 		return new MessageResponse({
 			cancelTurn: async (turnId) => await this.cancel({ turnId }),
 			createStream: (source) => this.#createEventStream(initialStreamIndex, input, deliveryId, source),
 			deliveryId,
+			receipt,
 			resumesTurn: input.inputResponses !== void 0,
 			sessionId: this.#state.sessionId
 		});
@@ -2509,14 +2554,23 @@ var ClientSession = class ClientSession {
 function followClientSession(session, options) {
 	return session[followSession](options);
 }
-async function postSessionSend(context, path, input) {
-	const readyDeadline = Date.now() + SESSION_SEND_READY_TIMEOUT_MS;
+async function postSessionSend(context, path, input, retrySessionNotReady) {
+	const startedAt = Date.now();
+	const readyDeadline = startedAt + SESSION_SEND_READY_TIMEOUT_MS;
 	let retryDelayMs = SESSION_SEND_RETRY_BASE_DELAY_MS;
 	for (;;) {
+		const attemptAt = Date.now();
 		try {
-			return await postTurn(context, path, input, false);
+			return {
+				response: await postTurn(context, path, input, false),
+				timing: {
+					startedAt,
+					notReadyMs: attemptAt - startedAt,
+					acceptedAt: Date.now()
+				}
+			};
 		} catch (error) {
-			if (!isSessionNotReady(error)) throw error;
+			if (!retrySessionNotReady || !isSessionNotReady(error)) throw error;
 			const remainingMs = readyDeadline - Date.now();
 			if (remainingMs <= 0) throw error;
 			await sleep(Math.min(retryDelayMs, remainingMs), input.signal);
@@ -4359,17 +4413,22 @@ var EveAgentStore = class {
 	}
 	prewarm() {
 		if (this.#prewarmPromise !== void 0) return this.#prewarmPromise;
-		if (this.#session !== void 0 || this.#externalSession) return Promise.resolve();
-		if (this.#activeTurn !== void 0) return this.#activeTurn.response.then((response) => {
+		if (this.#session === void 0 && this.#externalSession) return Promise.resolve();
+		if (this.#activeTurn !== void 0 && this.#session === void 0) return this.#activeTurn.response.then((response) => {
 			if (response === void 0) throw this.#error ?? new DOMException("Session creation was aborted.", "AbortError");
 		});
 		const client = this.#client;
-		if (client === void 0) return Promise.reject(/* @__PURE__ */ new Error("This eve agent store does not own a session client."));
+		const session = this.#session;
+		if (client === void 0 && session === void 0) return Promise.reject(/* @__PURE__ */ new Error("This eve agent store does not own a session client."));
 		const generation = this.#prewarmGeneration;
 		const controller = new AbortController();
 		this.#prewarmController = controller;
 		const promise = (async () => {
 			try {
+				if (session !== void 0) {
+					await session.prewarm({ signal: controller.signal });
+					return;
+				}
 				const created = await client.sessions.create({ signal: controller.signal });
 				if (generation !== this.#prewarmGeneration) return;
 				this.#error = void 0;
@@ -4377,7 +4436,7 @@ var EveAgentStore = class {
 				this.#adoptSession(created.session);
 				if (this.#followIdle) this.#ensureStream();
 			} catch (error) {
-				if (generation === this.#prewarmGeneration && this.#activeTurn === void 0 && this.#error === void 0) this.#fail(error);
+				if (session === void 0 && generation === this.#prewarmGeneration && this.#activeTurn === void 0 && this.#error === void 0) this.#fail(error);
 				throw error;
 			}
 		})();
@@ -4627,7 +4686,7 @@ var EveAgentStore = class {
 			headers: input.headers,
 			streamReconnectPolicy: input.streamReconnectPolicy
 		};
-		if (this.#prewarmPromise !== void 0) {
+		if (this.#session === void 0 && this.#prewarmPromise !== void 0) {
 			await waitWithSignal(this.#prewarmPromise.catch((error) => {
 				if (this.#session !== void 0) throw error;
 			}), input.signal);

package/dist/src/cli/dev/local-server-child.js

@@ -1 +1 @@
-import{createDevelopmentServer}from"#internal/nitro/host/start-development-server.js";import{getDevelopmentSandboxRunId}from"#execution/sandbox/development-run.js";import{reconcileCleanupIntents,recordCleanupIntent}from"#cli/dev/local-server-cleanup.js";const options=JSON.parse(process.argv[2]??`{}`),server=createDevelopmentServer(process.cwd(),{...options,onBootProgress:e=>send({type:`progress`,event:e})});let stopping=!1,removeCleanupIntent;reconcileCleanupIntents(process.cwd()).catch(()=>void 0);const send=e=>{try{process.connected&&process.send?.(e,()=>{})}catch{}},stop=()=>{if(stopping)return;stopping=!0,console.log=console.warn=console.error=()=>{},process.stdout.on(`error`,()=>{}),process.stderr.on(`error`,()=>{});let e=server.close();process.connected&&process.disconnect?.(),e.then(async()=>{await intentReady.catch(()=>void 0),await removeCleanupIntent?.().catch(()=>void 0),process.exit(0)},()=>process.exit(1))};process.on(`message`,e=>{e.type===`shutdown`&&stop()}),process.once(`disconnect`,stop),process.once(`SIGINT`,stop),process.once(`SIGTERM`,stop);const intentReady=server.start().then(async e=>{let t=getDevelopmentSandboxRunId();e.kind===`started`&&t!==void 0&&(removeCleanupIntent=await recordCleanupIntent(process.cwd(),{ownerPid:process.pid,runId:t})),send({type:`started`,handle:e}),e.kind===`existing`&&process.connected&&process.disconnect?.()},e=>{let t=e instanceof Error?e:Error(String(e));send({type:`failed`,message:t.message,stack:t.stack}),process.exitCode=1,process.connected&&process.disconnect?.()});export{};
+import{getDevelopmentSandboxRunId}from"#execution/sandbox/development-run.js";import{prewarmDevelopmentBuildProcess}from"#internal/nitro/host/dev-build-host.js";prewarmDevelopmentBuildProcess();const[{createDevelopmentServer},{reconcileCleanupIntents,recordCleanupIntent}]=await Promise.all([import(`#internal/nitro/host/start-development-server.js`),import(`#cli/dev/local-server-cleanup.js`)]),options=JSON.parse(process.argv[2]??`{}`),server=createDevelopmentServer(process.cwd(),{...options,onBootProgress:e=>send({type:`progress`,event:e})});let stopping=!1,removeCleanupIntent;reconcileCleanupIntents(process.cwd()).catch(()=>void 0);const send=e=>{try{process.connected&&process.send?.(e,()=>{})}catch{}},stop=()=>{if(stopping)return;stopping=!0,console.log=console.warn=console.error=()=>{},process.stdout.on(`error`,()=>{}),process.stderr.on(`error`,()=>{});let e=server.close();process.connected&&process.disconnect?.(),e.then(async()=>{await intentReady.catch(()=>void 0),await removeCleanupIntent?.().catch(()=>void 0),process.exit(0)},()=>process.exit(1))};process.on(`message`,e=>{e.type===`shutdown`&&stop()}),process.once(`disconnect`,stop),process.once(`SIGINT`,stop),process.once(`SIGTERM`,stop);const intentReady=server.start().then(async e=>{let t=getDevelopmentSandboxRunId();e.kind===`started`&&t!==void 0&&(removeCleanupIntent=await recordCleanupIntent(process.cwd(),{ownerPid:process.pid,runId:t})),send({type:`started`,handle:e}),e.kind===`existing`&&process.connected&&process.disconnect?.()},e=>{let t=e instanceof Error?e:Error(String(e));send({type:`failed`,message:t.message,stack:t.stack}),process.exitCode=1,process.connected&&process.disconnect?.()});export{};

package/dist/src/cli/dev/local-server-cleanup.js

@@ -1 +1 @@
-import{mkdir,readFile,readdir,rm,writeFile}from"node:fs/promises";import{join}from"node:path";import{stopDevelopmentSandboxResources}from"#execution/sandbox/bindings/local.js";const PREFIX=`dev-cleanup-intent.`,SUFFIX=`.json`;async function recordCleanupIntent(e,t){let n=join(e,`.eve`),r=join(n,`${PREFIX}${t.runId}${SUFFIX}`);return await mkdir(n,{recursive:!0}),await writeFile(r,`${JSON.stringify(t)}\n`,`utf8`),async()=>await rm(r,{force:!0})}async function reconcileCleanupIntents(e){let t=join(e,`.eve`),n;try{n=await readdir(t)}catch(e){if(e instanceof Error&&`code`in e&&e.code===`ENOENT`)return;throw e}await Promise.all(n.filter(e=>e.startsWith(PREFIX)&&e.endsWith(SUFFIX)).map(async n=>{try{let r=join(t,n),i=JSON.parse(await readFile(r,`utf8`));if(typeof i.runId!=`string`||typeof i.ownerPid!=`number`||!Number.isInteger(i.ownerPid)||i.ownerPid<=0||isProcessAlive(i.ownerPid))return;await stopDevelopmentSandboxResources({appRoot:e,devRunId:i.runId}),await rm(r,{force:!0})}catch{}}))}function isProcessAlive(e){try{return process.kill(e,0),!0}catch(e){return e instanceof Error&&`code`in e&&e.code===`EPERM`}}export{reconcileCleanupIntents,recordCleanupIntent};
+import{mkdir,readFile,readdir,rm,writeFile}from"node:fs/promises";import{join}from"node:path";import{stopDevelopmentSandboxResources}from"#execution/sandbox/bindings/local.js";const PREFIX=`dev-cleanup-intent.`,SUFFIX=`.json`;async function recordCleanupIntent(e,t){let n=join(e,`.eve`),r=join(n,`${PREFIX}${t.runId}${SUFFIX}`);return await mkdir(n,{recursive:!0}),await writeFile(r,`${JSON.stringify(t)}\n`,`utf8`),async()=>await rm(r,{force:!0})}async function reconcileCleanupIntents(e){let t=join(e,`.eve`),n;try{n=await readdir(t)}catch(e){if(e instanceof Error&&`code`in e&&e.code===`ENOENT`)return;throw e}await Promise.all(n.filter(e=>e.startsWith(PREFIX)&&e.endsWith(SUFFIX)).map(async e=>{try{let n=join(t,e),r=JSON.parse(await readFile(n,`utf8`));if(typeof r.runId!=`string`||typeof r.ownerPid!=`number`||!Number.isInteger(r.ownerPid)||r.ownerPid<=0||isProcessAlive(r.ownerPid))return;await stopDevelopmentSandboxResources({devRunId:r.runId}),await rm(n,{force:!0})}catch{}}))}function isProcessAlive(e){try{return process.kill(e,0),!0}catch(e){return e instanceof Error&&`code`in e&&e.code===`EPERM`}}export{reconcileCleanupIntents,recordCleanupIntent};

package/dist/src/cli/dev/tui/question-panel.d.ts

@@ -20,9 +20,12 @@ interface QuestionPanelState {
     /** The freeform row's inline editor; focused while the cursor rests on it. */
     readonly editor: LineState;
     readonly caretVisible: boolean;
+    readonly maxRows?: number;
 }
 export declare function renderQuestionPanel(state: QuestionPanelState, theme: Theme, width: number): string[];
+export declare function renderQuestionPrompt(prompt: string, theme: Theme, width: number): string[];
+/** Window the body, keeping the focused choice or editor reachable on short terminals. */
+export declare function fitQuestionPanel(rows: readonly string[], maxRows: number, focusedRow?: number, focusedEndRow?: number): string[];
 /** Who asked for a prompt and where it sits among the open requests, for the drawer's corner. */
 export declare function inputContextLabel(context: AgentTUIInputContext | undefined, theme: Theme): string | undefined;
-export declare function renderQuestionChoices(options: readonly AgentTUIInputOption[], cursor: number, theme: Theme, forceCursor?: boolean): string[];
 export {};

package/dist/src/cli/dev/tui/question-panel.js

@@ -1 +1 @@
-import{visibleLine}from"./line-editor.js";import{clipVisible,renderInputText,renderInputWithBlockCursor,stripTerminalControls,wrapVisibleLine}from"#cli/ui/terminal-text.js";import{renderOptionRow}from"#setup/cli/option-row.js";const FREEFORM_ROW_LABEL=`Type your own answer…`;function renderQuestionPanel(e,t,n){let r=t.colors,i=[];for(let t of e.prompt.split(/\r?\n/u))for(let e of wrapVisibleLine(t,Math.max(8,n-2)))i.push(`  ${r.bold(e)}`);return i.push(``),i.push(...renderQuestionChoices(e.options,e.cursor,t)),e.allowFreeform&&i.push(renderFreeformRow(e,t,n)),i.map(e=>clipVisible(e,n))}function inputContextLabel(e,t){let n=[];return e?.requester!==void 0&&n.push(stripTerminalControls(e.requester)),e?.position!==void 0&&n.push(`${e.position.index} of ${e.position.total}`),n.length===0?void 0:n.join(` ${t.glyph.dot} `)}function renderQuestionChoices(e,t,n,r=!1){return e.flatMap((e,i)=>{let a=r||t===i,o=[`  ${renderOptionRow({colors:n.colors,glyphs:{pointer:n.glyph.pointer,selectedPointer:n.glyph.selectedPointer,success:n.glyph.success,placeholder:n.glyph.option,dot:n.glyph.dot,warning:n.glyph.warning},label:e.label,isCursor:a,state:{kind:`available`,checked:!1},placeholder:!1,presentation:`minimal`})}`];return e.description!==void 0&&e.description.length>0&&o.push(`     ${n.colors.dim(e.description)}`),o})}function renderFreeformRow(e,t,n){let r=t.colors,i=e.cursor===e.options.length,a=Math.max(4,n-6);if(!i){let n=visibleLine(e.editor,a,t.glyph.ellipsis),i=e.editor.text.length===0?FREEFORM_ROW_LABEL:`${n.before}${n.under}${n.after}`;return`     ${r.dim(i)}`}let o=e.editor.text.length===0,s=o?{text:FREEFORM_ROW_LABEL,cursor:0}:e.editor;return`     ${renderInputWithBlockCursor({...visibleLine(s,a,t.glyph.ellipsis),visible:e.caretVisible,inverse:r.inverse,render:o?e=>r.dim(renderInputText(e)):void 0})}`}export{inputContextLabel,renderQuestionChoices,renderQuestionPanel};
+import{visibleLine}from"./line-editor.js";import{clipVisible,renderInputText,renderInputWithBlockCursor,stripTerminalControls,wrapVisibleLine}from"#cli/ui/terminal-text.js";import{renderOptionRow}from"#setup/cli/option-row.js";const FREEFORM_ROW_LABEL=`Type your own answer…`;function renderQuestionPanel(e,t,n){let r=renderQuestionPrompt(e.prompt,t,n);r.push(``);let i=r.length,a=i;for(let[n,o]of e.options.entries())n===e.cursor&&(i=r.length),r.push(...renderQuestionChoice(o,n===e.cursor,t).flatMap(e=>e.split(/\r?\n/u))),n===e.cursor&&(a=r.length-1);return e.allowFreeform&&(e.cursor===e.options.length&&(i=a=r.length),r.push(renderFreeformRow(e,t,n))),fitQuestionPanel(r.map(e=>clipVisible(e,n)),e.maxRows??r.length,i,a)}function renderQuestionPrompt(e,t,n){return stripTerminalControls(e).split(/\r?\n/u).flatMap(e=>wrapVisibleLine(e,Math.max(1,n-2))).map(e=>`  ${t.colors.bold(e)}`)}function fitQuestionPanel(e,t,n=e.length-1,r=n){let i=Math.min(r,n+t-1),a=Math.max(0,Math.min(i-t+1,e.length-t));return e.slice(a,a+t)}function inputContextLabel(e,t){let n=[];return e?.requester!==void 0&&n.push(stripTerminalControls(e.requester)),e?.position!==void 0&&n.push(`${e.position.index} of ${e.position.total}`),n.length===0?void 0:n.join(` ${t.glyph.dot} `)}function renderQuestionChoice(e,t,n){let r=[`  ${renderOptionRow({colors:n.colors,glyphs:{pointer:n.glyph.pointer,selectedPointer:n.glyph.selectedPointer,success:n.glyph.success,placeholder:n.glyph.option,dot:n.glyph.dot,warning:n.glyph.warning},label:e.label,isCursor:t,state:{kind:`available`,checked:!1},placeholder:!1,presentation:`minimal`})}`];return e.description!==void 0&&e.description.length>0&&r.push(`     ${n.colors.dim(e.description)}`),r}function renderFreeformRow(e,t,n){let r=t.colors,i=e.cursor===e.options.length,a=Math.max(4,n-6);if(!i){let n=visibleLine(e.editor,a,t.glyph.ellipsis),i=e.editor.text.length===0?FREEFORM_ROW_LABEL:`${n.before}${n.under}${n.after}`;return`     ${r.dim(i)}`}let o=e.editor.text.length===0,s=o?{text:FREEFORM_ROW_LABEL,cursor:0}:e.editor;return`     ${renderInputWithBlockCursor({...visibleLine(s,a,t.glyph.ellipsis),visible:e.caretVisible,inverse:r.inverse,render:o?e=>r.dim(renderInputText(e)):void 0})}`}export{fitQuestionPanel,inputContextLabel,renderQuestionPanel,renderQuestionPrompt};