Skip to content

fix(eve): isolate production build workspaces#739

Open
ctgowrie wants to merge 12 commits into
mainfrom
fix/production-build-isolation
Open

fix(eve): isolate production build workspaces#739
ctgowrie wants to merge 12 commits into
mainfrom
fix/production-build-isolation

Conversation

@ctgowrie

@ctgowrie ctgowrie commented Jul 13, 2026

Copy link
Copy Markdown
Collaborator

Why

eve build previously wrote compiler, host, Nitro, Workflow, and final output artifacts into app-owned paths shared by concurrent builds and the dev server. A build could consume another invocation's intermediate state, disrupt a running dev server, or replace the last-good output before all artifacts were ready.

What changed

Each production build now owns isolated compiler, host, Nitro, Workflow, and output workspaces. Only final publication is serialized: a journaled owner-token lock atomically promotes the completed output and summary, rolls back failures, and lets a later build recover an interrupted publication. eve start reads the compiler snapshot from the published output rather than dev-owned paths.

This PR is Stage 1 only. It establishes safe production workspace and publication ownership without changing dev workers, watchers, routing, authored loaders, or Workflow delivery. See the reviewer architecture note for the complete target model.

Follow-on stages

  • Stage 2 — immutable generations: materialize each complete authored dependency closure into a path-independent generation so admitted requests and active turns survive later removals or edits.
  • Stage 3 — parent worker and World transport: give the stable parent ownership of readiness, request and generation leases, queue ingress, cancellation, trusted client metadata, dev control endpoints, and bounded shutdown.
  • Stage 4 — transactional dev rebuilds: promote the generation pointer, routes, and a ready Nitro candidate through one rollback-safe transaction. Runtime-only edits avoid worker replacement; structural edits replace only a validated candidate.
  • Stage 5 — latest-turn Workflow delivery and pruning: keep parked session drivers generation-neutral, resolve the latest promoted generation when each child turn Workflow starts, route that child's retries and resumptions to the recorded generation, and release it when the child becomes terminal.

The follow-on design does not pin a parked session to historical authored code. An active child Workflow stays internally consistent, while the same session's next turn uses the latest successfully promoted generation.

The gray-matter vendoring change remains independent of this lifecycle stack.

Validation

  • focused output-publication integration tests: 9 passed
  • full unit tier: 4,681 passed, 1 skipped
  • full integration tier: 437 passed
  • full scenario tier: 295 passed, 15 skipped
  • formatting, lint, typecheck, and invariants passed

The scenarios cover overlapping builds while probing a dev server, failed-build preservation, atomic output/summary publication, rollback, interrupted-owner recovery, cleanup recovery, and starting the published build.

PR Checklist

  • I linked an issue with prior discussion confirming this change is wanted
  • I ran the relevant checks from CONTRIBUTING.md
  • I added tests and documentation where relevant
  • I added a changeset if this touches the published eve package
  • DCO sign-off passes for every commit

@vercel

vercel Bot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
eve-docs Ready Ready Preview, Comment, Open in v0 Jul 13, 2026 10:51pm
eve-docs-1644 Ready Ready Preview, Comment, Open in v0 Jul 13, 2026 10:51pm
eve-docs-4759 Ready Ready Preview, Comment, Open in v0 Jul 13, 2026 10:51pm

@github-actions

github-actions Bot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

Bundle + Package Summary: apps/fixtures/weather-agent

Key takeaways

  • No notable deltas vs main (ae4755b).

Delta vs main (ae4755b)

Area Metric Baseline Current Delta
Package Packed tarball 3.62 MB 3.63 MB +6.6 kB ⚠️
Package Unpacked publish size 13.14 MB 13.17 MB +29.7 kB ⚠️
Package Installed footprint 52.39 MB 52.42 MB +29.7 kB ⚠️
Package Published files 2527 2545 +18
Package Installed files 5767 5785 +18
Runtime Unique function payloads 2 2 0
Runtime Total function bytes 9.29 MB 9.29 MB -748 B ✅
Runtime Public routes 9 9 0
Changed function payloads vs main (ae4755b) (2)
Function Status Baseline Current Delta Route changes
functions/__server.func changed 3.47 MB 3.47 MB -1.5 kB ✅ none
functions/.well-known/workflow/v1/flow.func changed 5.82 MB 5.82 MB +795 B ⚠️ none

eve init install

Metric Baseline Current Delta
Installed footprint 90.65 MB 90.68 MB +29.7 kB ⚠️
Installed packages 122 122 0
dependencies 4 4 0
devDependencies 2 2 0
Dependency package bytes 27.33 MB 27.36 MB +29.7 kB ⚠️
devDependency package bytes 5.04 MB 5.04 MB 0 B ➖
Build Metadata
  • Preset: vercel
  • Nitro: [email protected]
  • Output directory: apps/fixtures/weather-agent/.vercel/output
  • Build metadata timestamp: 2026-07-13T22:52:04.931Z
  • Route aliases: 9 public, 1 internal (10 total aliases)
  • Vercel routes in config: 10
  • Severity legend: 🔴 dominant/large, 🟠 notable, 🟡 watch, ⚪ small
Package Drill-Down

Package Details

  • Package: [email protected]
  • Package directory: packages/eve
  • Tarball: 3.63 MB (eve-0.23.0.tgz)
  • Unpacked payload: 13.17 MB across 2545 published files
  • Installed footprint: 52.42 MB across 5785 installed files
  • Installed root package: 11.89 MB
  • Installed dependencies: 40.53 MB
  • Runtime dependencies: 1
  • Peer dependencies: 5 (4 optional)

Installed footprint is measured from an isolated temporary npm install of the packed tarball.

Heavy installed dependencies

  • @rolldown/binding-linux-x64-gnu: 19.13 MB (36.5%)
  • eve: 11.89 MB (22.7%)
  • ai: 6.38 MB (12.2%)
  • zod: 5.04 MB (9.6%)
  • nitro: 2.41 MB (4.6%)
Publish payload breakdown
Published file size
🟠 dist/src/compiled/experimental-ai-sdk-code-mo... [####....................] 1.51 MB 11.4%
🟡 dist/src/compiled/@vercel/sandbox/index.js       [##......................] 632.2 kB 4.8%
🟡 dist/src/compiled/_chunks/workflow/undici-fb5... [#.......................] 502.4 kB 3.8%
🟡 dist/src/compiled/@chat-adapter/slack/index.js   [#.......................] 433.8 kB 3.3%
🟡 dist/src/compiled/_chunks/workflow/dist-CQeni... [#.......................] 277.5 kB 2.1%
🔴 Other published files                            [########################] 9.81 MB 74.5%
Installed footprint breakdown
Installed package size
🔴 @rolldown/binding-linux-x64-gnu [########################] 19.13 MB 36.5%
🔴 eve                             [###############.........] 11.89 MB 22.7%
🔴 ai                              [########................] 6.38 MB 12.2%
🔴 zod                             [######..................] 5.04 MB 9.6%
🟠 nitro                           [###.....................] 2.41 MB 4.6%
🟡 @ai-sdk/provider-utils          [#.......................] 845.4 kB 1.6%
🔴 Other installed packages        [########................] 6.73 MB 12.8%
Runtime dependencies (1)
Package Range Notes
nitro 3.0.260610-beta
Peer dependencies (5)
Package Range Notes
@opentelemetry/api ^1.0.0 optional peer
ai catalog:
braintrust ^3.0.0 optional peer
just-bash ^3.0.0 optional peer
microsandbox ^0.5.0 optional peer
eve init install drill-down

eve init install details

  • Command: eve init my-agent
  • Package manager: npm
  • Installed footprint: 90.68 MB across 7603 installed files
  • Installed packages: 122 total (116 transitive-only)
  • dependencies: 4 direct packages totaling 27.36 MB
  • devDependencies: 2 direct packages totaling 5.04 MB
  • Other transitive package files: 58.28 MB

Installed footprint is measured from an isolated temporary eve init my-agent using the current packed eve tarball.

Heavy installed dependencies

  • @typescript/typescript-linux-x64: 27.95 MB (30.8%)
  • @rolldown/binding-linux-x64-gnu: 19.13 MB (21.1%)
  • eve: 11.89 MB (13.1%)
  • zod: 9.00 MB (9.9%)
  • ai: 6.38 MB (7.0%)
Installed footprint breakdown
Installed package size
🔴 @typescript/typescript-linux-x64 [########################] 27.95 MB 30.8%
🔴 @rolldown/binding-linux-x64-gnu  [################........] 19.13 MB 21.1%
🔴 eve                              [##########..............] 11.89 MB 13.1%
🔴 zod                              [########................] 9.00 MB 9.9%
🔴 ai                               [#####...................] 6.38 MB 7.0%
🟠 @types/node                      [##......................] 2.54 MB 2.8%
🔴 Other installed packages         [############............] 13.80 MB 15.2%
dependencies (4)
Package Range Installed size Share
@vercel/connect 0.2.2 98.6 kB 0.1%
ai ^7.0.0 6.38 MB 7.0%
eve file:eve-0.23.0.tgz 11.89 MB 13.1%
zod 4.4.3 9.00 MB 9.9%
devDependencies (2)
Package Range Installed size Share
@types/node 24.x 2.54 MB 2.8%
typescript 7.0.2 2.50 MB 2.8%
Function Drill-Down

Payload Size Graph

Unique function payload size and share of total
🔴 functions/.well-known/workflow/v1/flow.func     [########################] 5.82 MB 62.6%
🟠 functions/__server.func                         [##############..........] 3.47 MB 37.4%

Top Function Payloads

🟠 functions/.well-known/workflow/v1/flow.func • 1 public route • 5.82 MB
Metric Value
Public routes /.well-known/workflow/v1/flow
Runtime nodejs24.x
Handler index.mjs
Payload 5.82 MB
Function files 5.82 MB across 33 files
Traced dependencies 0 B
Signal 🟠 Bundled file __eve_nitro_handler__.mjs is 2.17 MB (37.4%)

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 __eve_nitro_handler__.mjs       [########################] 2.17 MB 37.4%
🟡 _chunks/world-vercel.mjs        [#########...............] 819.1 kB 14.1%
🟡 _chunks/sandbox.mjs             [########................] 766.3 kB 13.2%
🟡 _libs/@ai-sdk/gateway+[...].mjs [#####...................] 413.6 kB 7.1%
🟡 _chunks/dist-CQenixFf.mjs       [####....................] 348.9 kB 6.0%
🟠 Other bundled files             [##############..........] 1.29 MB 22.2%

🧾 Vercel Config

{
  "handler": "index.mjs",
  "launcherType": "Nodejs",
  "shouldAddHelpers": false,
  "supportsResponseStreaming": true,
  "runtime": "nodejs24.x",
  "environment": {
    "NODE_OPTIONS": "--experimental-require-module"
  },
  "maxDuration": "max",
  "experimentalTriggers": [
    {
      "type": "queue/v2beta",
      "topic": "__eve776561746865722d6167656e74_wkf_workflow_*",
      "consumer": "default",
      "retryAfterSeconds": 5,
      "initialDelaySeconds": 0
    }
  ]
}

🟠 functions/__server.func • 8 public routes, 1 internal alias • 3.47 MB
Metric Value
Public routes /
/eve/v1/callback/[token]
/eve/v1/connections/[name]/callback/[token]
/eve/v1/health
/eve/v1/info
/eve/v1/session
/eve/v1/session/[sessionId]
/eve/v1/session/[sessionId]/stream
Internal aliases /__server
Runtime nodejs24.x
Handler index.mjs
Payload 3.47 MB
Function files 3.47 MB across 23 files
Traced dependencies 0 B
Signal 🟠 Bundled file _chunks/runtime-artifacts.mjs is 941.9 kB (27.1%)

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 _chunks/runtime-artifacts.mjs [########################] 941.9 kB 27.1%
🟠 _chunks/world-vercel.mjs      [#####################...] 819.2 kB 23.6%
🟠 _chunks/sandbox.mjs           [####################....] 766.3 kB 22.1%
🟡 _chunks/dist-CQenixFf.mjs     [#########...............] 347.9 kB 10.0%
⚪ _libs/zod.mjs                 [###.....................] 114.2 kB 3.3%
🟡 Other bundled files           [############............] 482.4 kB 13.9%

🧾 Vercel Config

{
  "handler": "index.mjs",
  "launcherType": "Nodejs",
  "shouldAddHelpers": false,
  "supportsResponseStreaming": true,
  "runtime": "nodejs24.x"
}

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants