Skip to content

feat(eve): add task_send for blocked and finished background tasks - #1522

Open
ruiconti wants to merge 1 commit into
tasks/04-delegatedfrom
tasks/05-send
Open

feat(eve): add task_send for blocked and finished background tasks#1522
ruiconti wants to merge 1 commit into
tasks/04-delegatedfrom
tasks/05-send

Conversation

@ruiconti

@ruiconti ruiconti commented Aug 1, 2026

Copy link
Copy Markdown
Contributor

Part 5/5 of the experimental.tasks stack, on top of #1521. Without this, a background child that parks on input is unreachable and a finished conversation can't be continued.

Routing by task status

  • workingAGENT_BUSY tool error. No queueing: matches handle-continuation semantics, and queueing on the task run is the reversible follow-up if busy errors prove noisy.
  • input_required + inputResponses → delivered to the parked child session with the task run's token as the caller reply target, so the child's next settled turn reports to the same task. The task returns to working.
  • terminal + message → the full delegated continuation from part 4, through the agent handle: new task on the same child session, new receipt back. The old task stays terminal.

Ownership is checked against the eve.tasks index; the child address comes from the agent handle. Input responses are local-only — remote children can't forward input requests in the first place, so a remote input_required never exists in this stack.

One seam worth review

task_send's own result is a tool-result, and the resolve path only settles handles from subagent-result outcomes — so the follow-up continuation parks its handle in-line instead of riding the receipt.

The task-control executors split into execution/tasks/{delegate,control-shared,send} (file-length cap, and it breaks an import cycle between the dispatch router and the send path). Includes the release changeset for the feature.

Part of #1084.

@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 5, 2026 6:43pm
eve-docs-4759 Ready Ready Preview, v0 Aug 5, 2026 6:43pm

@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 tasks/04-delegated (ebf9470).

Delta vs tasks/04-delegated (ebf9470)

Area Metric Baseline Current Delta
Package Packed tarball 7.67 MB 7.68 MB +5.3 kB ⚠️
Package Unpacked publish size 28.75 MB 28.76 MB +12.4 kB ⚠️
Package Installed footprint 72.08 MB 72.09 MB +12.4 kB ⚠️
Package Published files 3062 3068 +6
Package Installed files 6761 6767 +6
Runtime Unique function payloads 2 2 0
Runtime Total function bytes 17.11 MB 17.13 MB +20.2 kB ⚠️
Runtime Public routes 13 13 0
Changed function payloads vs tasks/04-delegated (ebf9470) (2)
Function Status Baseline Current Delta Route changes
functions/__server.func changed 8.56 MB 8.57 MB +10.1 kB ⚠️ none
functions/.well-known/workflow/v1/flow.func changed 8.56 MB 8.57 MB +10.1 kB ⚠️ none

eve init install

Metric Baseline Current Delta
Installed footprint 110.49 MB 110.50 MB +12.4 kB ⚠️
Installed packages 121 121 0
dependencies 4 4 0
devDependencies 2 2 0
Dependency package bytes 43.16 MB 43.17 MB +12.4 kB ⚠️
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-05T18:44:30.428Z
  • Route aliases: 13 public, 1 internal (14 total aliases)
  • Vercel routes in config: 16
  • Severity legend: 🔴 dominant/large, 🟠 notable, 🟡 watch, ⚪ small
Package Drill-Down

Package Details

  • Package: eve@0.30.7
  • Package directory: packages/eve
  • Tarball: 7.68 MB (eve-0.30.7.tgz)
  • Unpacked payload: 28.76 MB across 3068 published files
  • Installed footprint: 72.09 MB across 6767 installed files
  • Installed root package: 27.41 MB
  • Installed dependencies: 44.68 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.41 MB (38.0%)
  • @rolldown/binding-linux-x64-gnu: 19.35 MB (26.8%)
  • ai: 6.60 MB (9.2%)
  • zod: 5.07 MB (7.0%)
  • undici: 3.50 MB (4.9%)
Publish payload breakdown
Published file size
🔴 dist/src/compiled/shadcn-registry/index.js       [################........] 9.68 MB 33.7%
🟠 dist/src/compiled/@photon-ai/chat-adapter-ime... [####....................] 2.42 MB 8.4%
🟠 dist/src/compiled/experimental-ai-sdk-code-mo... [###.....................] 1.51 MB 5.2%
🟡 dist/src/compiled/_chunks/node/undici-DWL_MYm... [#.......................] 502.4 kB 1.7%
🟡 dist/src/compiled/_chunks/workflow/undici-DWL... [#.......................] 502.4 kB 1.7%
🔴 Other published files                            [########################] 14.15 MB 49.2%
Installed footprint breakdown
Installed package size
🔴 eve                             [########################] 27.41 MB 38.0%
🔴 @rolldown/binding-linux-x64-gnu [#################.......] 19.35 MB 26.8%
🔴 ai                              [######..................] 6.60 MB 9.2%
🔴 zod                             [####....................] 5.07 MB 7.0%
🟠 undici                          [###.....................] 3.50 MB 4.9%
🟠 nitro                           [##......................] 2.41 MB 3.3%
🔴 Other installed packages        [#######.................] 7.76 MB 10.8%
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: 110.50 MB across 8643 installed files
  • Installed packages: 121 total (115 transitive-only)
  • dependencies: 4 direct packages totaling 43.17 MB
  • devDependencies: 2 direct packages totaling 5.04 MB
  • Other transitive package files: 62.29 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 (25.3%)
  • eve: 27.41 MB (24.8%)
  • @rolldown/binding-linux-x64-gnu: 19.35 MB (17.5%)
  • zod: 9.02 MB (8.2%)
  • ai: 6.60 MB (6.0%)
Installed footprint breakdown
Installed package size
🔴 @typescript/typescript-linux-x64 [########################] 27.95 MB 25.3%
🔴 eve                              [########################] 27.41 MB 24.8%
🔴 @rolldown/binding-linux-x64-gnu  [#################.......] 19.35 MB 17.5%
🔴 zod                              [########................] 9.02 MB 8.2%
🔴 ai                               [######..................] 6.60 MB 6.0%
🟠 undici                           [###.....................] 3.50 MB 3.2%
🔴 Other installed packages         [##############..........] 16.67 MB 15.1%
dependencies (4)
Package Range Installed size Share
@vercel/connect 0.4.3 141.0 kB 0.1%
ai ^7.0.38 6.60 MB 6.0%
eve file:eve-0.30.7.tgz 27.41 MB 24.8%
zod 4.4.3 9.02 MB 8.2%
devDependencies (2)
Package Range Installed size Share
@types/node 24.x 2.54 MB 2.3%
typescript 7.0.2 2.50 MB 2.3%
Function Drill-Down

Payload Size Graph

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

Top Function Payloads

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

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 index.mjs                       [########################] 2.38 MB 27.7%
🟠 _chunks/runtime-artifacts.mjs   [################........] 1.63 MB 19.0%
🟡 _libs/undici.mjs                [##########..............] 980.5 kB 11.4%
🟡 _chunks/sandbox.mjs             [########................] 769.0 kB 9.0%
🟡 _libs/@ai-sdk/gateway+[...].mjs [####....................] 432.8 kB 5.1%
🟠 Other bundled files             [########################] 2.38 MB 27.8%

🧾 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 • 12 public routes, 1 internal alias • 8.57 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/clear
/eve/v1/session/compact
/eve/v1/session/reset
Internal aliases /__server
Runtime nodejs24.x
Handler index.mjs
Payload 8.57 MB
Function files 8.57 MB across 44 files
Traced dependencies 0 B
Signal 🟠 Bundled file index.mjs is 2.38 MB (27.7%)

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 index.mjs                       [########################] 2.38 MB 27.7%
🟠 _chunks/runtime-artifacts.mjs   [################........] 1.63 MB 19.0%
🟡 _libs/undici.mjs                [##########..............] 980.5 kB 11.4%
🟡 _chunks/sandbox.mjs             [########................] 769.0 kB 9.0%
🟡 _libs/@ai-sdk/gateway+[...].mjs [####....................] 432.8 kB 5.1%
🟠 Other bundled files             [########################] 2.38 MB 27.8%

🧾 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: 2.05 s -> 2.16 s (+106.7 ms) vs tasks/04-delegated (ebf9470).
  • Timing is informational: shared GitHub runners are too variable for a hard timing budget.
Detailed phase timings vs `tasks/04-delegated (ebf9470)`
Phase Baseline Current Delta
extension.check 6.7 ms 1.3 ms -5.4 ms
project.resolve 6.5 ms 0.6 ms -5.9 ms
workspace.create 1.1 ms 0.7 ms -0.4 ms
host.prepare 224.6 ms 241.7 ms +17.1 ms
vercel.service-prefix.resolve 1.6 ms 1.8 ms +0.2 ms
nitro.create 207.8 ms 232.2 ms +24.4 ms
sandbox.prewarm 300.3 ms 347.0 ms +46.7 ms
nitro.cache.prepare 0.2 ms 0.2 ms 0.0 ms
nitro.prepare 0.7 ms 0.7 ms 0.0 ms
nitro.public-assets 0.7 ms 0.7 ms 0.0 ms
nitro.prerender 0.6 ms 0.4 ms -0.2 ms
nitro.bundle 1.28 s 1.31 s +28.9 ms
nitro.cache.write 0.4 ms 0.3 ms -0.1 ms
vercel.workflow-function.materialize 16.5 ms 17.6 ms +1.1 ms
agent-summary.emit 0.5 ms 0.5 ms 0.0 ms
nitro.close 0.1 ms 0.1 ms 0.0 ms
output.publish 2.8 ms 2.9 ms +0.1 ms
workspace.remove 1.6 ms 1.6 ms 0.0 ms

task_send completes the parent-side task controls:

- an input_required task accepts an inputResponses batch, delivered to
  the parked child session with the task run as the reply target, and
  returns to working;
- a terminal task accepts a follow-up message, which runs the full
  delegated continuation through the agent handle: a new task on the
  same child session, returning the new receipt;
- a working task surfaces AGENT_BUSY instead of queueing (settled
  decision; queueing on the task run is the reversible follow-up).

Sends verify ownership through the session task index, and the
continued handle is parked directly because task_send's tool-result
never flows through the handle-settling resolve path. The task-control
executors split into execution/tasks/{delegate,control-shared,send} to
keep each file within the length cap. Includes the release changeset
for the experimental.tasks feature.

Signed-off-by: Rui Conti <ruiconti@gmail.com>
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