Skip to content

feat(eve): add the experimental.tasks flag, plumbing only - #1517

Open
ruiconti wants to merge 1 commit into
rui/subagents-as-tasksfrom
tasks/01-flag
Open

feat(eve): add the experimental.tasks flag, plumbing only#1517
ruiconti wants to merge 1 commit into
rui/subagents-as-tasksfrom
tasks/01-flag

Conversation

@ruiconti

@ruiconti ruiconti commented Aug 1, 2026

Copy link
Copy Markdown
Contributor

First of five implementation PRs for the subagents-as-tasks plan, which this stacks on:

  1. this — flag plumbing
  2. feat(eve): add the durable task foundation, inert #1518 — task foundation (durable task run, session index)
  3. feat(eve): add flag-gated task tools, undiscoverable by default #1519 — flag-gated task tools
  4. feat(eve): run subagents as background tasks behind experimental.tasks #1521 — delegated execution and the task wire
  5. feat(eve): add task_send for blocked and finished background tasks #1522task_send

What

Adds experimental.tasks to the authored agent config. Nothing reads it: a flag-on agent compiles and runs identically to a flag-off one.

The field travels the same path as subagentPersistentSessions, field for field: authored agent.ts → authored-definition normalization → compiler copy → strict compiled-manifest schema → manifest clone → ResolvedAgent.config.experimental.

Root-only enforcement

Subagent configs reject the flag at compile, same as experimental.workflow. That check's option was named allowWorkflowConfig; it now gates two root-only flags, so it's renamed allowRootOnlyConfig. Only rename outside the new field.

Part of #1084.

Mirrors the subagentPersistentSessions plumbing end to end: authored
normalization, compiler copy, strict compiled-manifest schema, manifest
serialization, and the ResolvedAgent projection. Subagent configs reject
the flag the same way they reject experimental.workflow, so the
root-only compile option is renamed allowRootOnlyConfig to cover both.

The flag does nothing yet; no runtime codepath reads it.

Signed-off-by: Rui Conti <ruiconti@gmail.com>
@vercel

vercel Bot commented Aug 1, 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 Aug 1, 2026 8:31pm

@github-actions

github-actions Bot commented Aug 1, 2026

Copy link
Copy Markdown
Contributor

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

Key takeaways

  • No notable deltas vs rui/subagents-as-tasks (da57e90).

Delta vs rui/subagents-as-tasks (da57e90)

Area Metric Baseline Current Delta
Package Packed tarball 7.60 MB 7.60 MB -964 B ✅
Package Unpacked publish size 28.49 MB 28.49 MB +808 B ⚠️
Package Installed footprint 85.48 MB 85.48 MB +808 B ⚠️
Package Published files 2974 2974 0
Package Installed files 6769 6769 0
Runtime Unique function payloads 2 2 0
Runtime Total function bytes 16.84 MB 16.84 MB +438 B ⚠️
Runtime Public routes 11 11 0
Changed function payloads vs rui/subagents-as-tasks (da57e90) (2)
Function Status Baseline Current Delta Route changes
functions/__server.func changed 8.42 MB 8.42 MB +219 B ⚠️ none
functions/.well-known/workflow/v1/flow.func changed 8.42 MB 8.42 MB +219 B ⚠️ none

eve init install

Metric Baseline Current Delta
Installed footprint 123.89 MB 123.89 MB +808 B ⚠️
Installed packages 128 128 0
dependencies 4 4 0
devDependencies 2 2 0
Dependency package bytes 42.87 MB 42.87 MB +808 B ⚠️
devDependency package bytes 5.04 MB 5.04 MB 0 B ➖
Build Metadata
  • Preset: vercel
  • Nitro: nitro@3.0.260610-beta
  • Output directory: apps/fixtures/weather-agent/.vercel/output
  • Build metadata timestamp: 2026-08-01T20:32:28.432Z
  • Route aliases: 11 public, 1 internal (12 total aliases)
  • Vercel routes in config: 14
  • Severity legend: 🔴 dominant/large, 🟠 notable, 🟡 watch, ⚪ small
Package Drill-Down

Package Details

  • Package: eve@0.29.4
  • Package directory: packages/eve
  • Tarball: 7.60 MB (eve-0.29.4.tgz)
  • Unpacked payload: 28.49 MB across 2974 published files
  • Installed footprint: 85.48 MB across 6769 installed files
  • Installed root package: 27.14 MB
  • Installed dependencies: 58.34 MB
  • Runtime dependencies: 2
  • Peer dependencies: 5 (4 optional)

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

Heavy installed dependencies

  • eve: 27.14 MB (31.7%)
  • @rolldown/binding-linux-x64-gnu: 19.28 MB (22.6%)
  • @rolldown/binding-wasm32-wasi: 10.66 MB (12.5%)
  • ai: 6.57 MB (7.7%)
  • zod: 5.07 MB (5.9%)
Publish payload breakdown
Published file size
🔴 dist/src/compiled/shadcn-registry/index.js       [#################.......] 9.68 MB 34.0%
🟠 dist/src/compiled/@photon-ai/chat-adapter-ime... [####....................] 2.42 MB 8.5%
🟠 dist/src/compiled/experimental-ai-sdk-code-mo... [###.....................] 1.51 MB 5.3%
🟡 dist/src/compiled/_chunks/node/undici-DWL_MYm... [#.......................] 502.4 kB 1.8%
🟡 dist/src/compiled/_chunks/workflow/undici-DWL... [#.......................] 502.4 kB 1.8%
🔴 Other published files                            [########################] 13.88 MB 48.7%
Installed footprint breakdown
Installed package size
🔴 eve                             [########################] 27.14 MB 31.7%
🔴 @rolldown/binding-linux-x64-gnu [#################.......] 19.28 MB 22.6%
🔴 @rolldown/binding-wasm32-wasi   [#########...............] 10.66 MB 12.5%
🔴 ai                              [######..................] 6.57 MB 7.7%
🔴 zod                             [####....................] 5.07 MB 5.9%
🟠 undici                          [###.....................] 3.50 MB 4.1%
🔴 Other installed packages        [############............] 13.26 MB 15.5%
Runtime dependencies (2)
Package Range Notes
nitro 3.0.260610-beta
undici 8.9.0
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: 123.89 MB across 8645 installed files
  • Installed packages: 128 total (122 transitive-only)
  • dependencies: 4 direct packages totaling 42.87 MB
  • devDependencies: 2 direct packages totaling 5.04 MB
  • Other transitive package files: 75.98 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 (22.6%)
  • eve: 27.14 MB (21.9%)
  • @rolldown/binding-linux-x64-gnu: 19.28 MB (15.6%)
  • @rolldown/binding-wasm32-wasi: 10.66 MB (8.6%)
  • zod: 9.02 MB (7.3%)
Installed footprint breakdown
Installed package size
🔴 @typescript/typescript-linux-x64 [########################] 27.95 MB 22.6%
🔴 eve                              [#######################.] 27.14 MB 21.9%
🔴 @rolldown/binding-linux-x64-gnu  [#################.......] 19.28 MB 15.6%
🔴 @rolldown/binding-wasm32-wasi    [#########...............] 10.66 MB 8.6%
🔴 zod                              [########................] 9.02 MB 7.3%
🔴 ai                               [######..................] 6.57 MB 5.3%
🔴 Other installed packages         [####################....] 23.27 MB 18.8%
dependencies (4)
Package Range Installed size Share
@vercel/connect 0.4.3 141.0 kB 0.1%
ai ^7.0.38 6.57 MB 5.3%
eve file:eve-0.29.4.tgz 27.14 MB 21.9%
zod 4.4.3 9.02 MB 7.3%
devDependencies (2)
Package Range Installed size Share
@types/node 24.x 2.54 MB 2.1%
typescript 7.0.2 2.50 MB 2.0%
Function Drill-Down

Payload Size Graph

Unique function payload size and share of total
🔴 functions/.well-known/workflow/v1/flow.func     [########################] 8.42 MB 50.0%
🔴 functions/__server.func                         [########################] 8.42 MB 50.0%

Top Function Payloads

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

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 index.mjs                       [#######################.] 2.27 MB 27.0%
🟠 _chunks/runtime-artifacts.mjs   [################........] 1.60 MB 19.0%
🟡 _libs/undici.mjs                [##########..............] 980.5 kB 11.6%
🟡 _chunks/sandbox.mjs             [########................] 769.0 kB 9.1%
🟡 _libs/@ai-sdk/gateway+[...].mjs [####....................] 432.8 kB 5.1%
🟠 Other bundled files             [########################] 2.37 MB 28.1%

🧾 Vercel Config

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

🟠 functions/__server.func • 10 public routes, 1 internal alias • 8.42 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]/cancel
/eve/v1/session/[sessionId]/stream
/eve/v1/session/reset
Internal aliases /__server
Runtime nodejs24.x
Handler index.mjs
Payload 8.42 MB
Function files 8.42 MB across 43 files
Traced dependencies 0 B
Signal 🟠 Bundled file index.mjs is 2.27 MB (27.0%)

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 index.mjs                       [#######################.] 2.27 MB 27.0%
🟠 _chunks/runtime-artifacts.mjs   [################........] 1.60 MB 19.0%
🟡 _libs/undici.mjs                [##########..............] 980.5 kB 11.6%
🟡 _chunks/sandbox.mjs             [########................] 769.0 kB 9.1%
🟡 _libs/@ai-sdk/gateway+[...].mjs [####....................] 432.8 kB 5.1%
🟠 Other bundled files             [########################] 2.36 MB 28.1%

🧾 Vercel Config

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

Build Timing: e2e/fixtures/agent-tools-sandbox

This is an informational timing measurement inside eve build, from preflight through publication. Output-size measurement and profile writing are excluded.

Build mode: deployable Vercel build with sandbox template prewarm included.

  • Build pipeline: 1.97 s -> 1.89 s (-85.8 ms) vs rui/subagents-as-tasks (da57e90).
  • Timing is informational: shared GitHub runners are too variable for a hard timing budget.
Detailed phase timings vs `rui/subagents-as-tasks (da57e90)`
Phase Baseline Current Delta
extension.check 6.2 ms 1.2 ms -5.0 ms
project.resolve 3.4 ms 0.5 ms -2.9 ms
workspace.create 2.7 ms 0.6 ms -2.1 ms
host.prepare 313.9 ms 239.3 ms -74.6 ms
vercel.service-prefix.resolve 1.5 ms 1.6 ms +0.1 ms
nitro.create 166.9 ms 178.7 ms +11.8 ms
sandbox.prewarm 276.6 ms 239.6 ms -37.0 ms
nitro.cache.prepare 0.2 ms 0.2 ms 0.0 ms
nitro.prepare 0.7 ms 0.8 ms +0.1 ms
nitro.public-assets 0.7 ms 0.7 ms 0.0 ms
nitro.prerender 0.4 ms 0.4 ms 0.0 ms
nitro.bundle 1.15 s 1.16 s +13.9 ms
nitro.cache.write 0.3 ms 0.4 ms +0.1 ms
vercel.workflow-function.materialize 46.6 ms 56.1 ms +9.5 ms
agent-summary.emit 0.5 ms 0.6 ms +0.1 ms
nitro.close 0.1 ms 0.1 ms 0.0 ms
output.publish 2.6 ms 3.0 ms +0.4 ms
workspace.remove 1.6 ms 1.7 ms +0.1 ms

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.

1 participant