Skip to content

[1/2] feat(eve): project task milestones into activity - #2711

Open
benpankow wants to merge 4 commits into
mainfrom
ben/activity-task-updates
Open

[1/2] feat(eve): project task milestones into activity#2711
benpankow wants to merge 4 commits into
mainfrom
ben/activity-task-updates

Conversation

@benpankow

@benpankow benpankow commented Aug 28, 2026

Copy link
Copy Markdown
Collaborator

Summary

Related to #1673. Shows accepted task_update messages as the latest status for a background task.

The lifecycle is:

task_update -> task workflow -> parent inbox (notifies/wakes the parent)
            -> action.result in the child session event log
            -> activity observer -> activity collector -> channel renderer

The parent notification and activity rendering are separate: activity can fail or be disabled without affecting delivery to the parent. Task settlement follows the same event-log rule, projecting terminal views from the task workflow's single-writer stream rather than posting to the collector from task code.

#2712 builds the authored-tool API on this state.

Validation

Adds focused coverage for accepted task updates, event replay, updates arriving before work starts, terminal task views, and parent workflow forwarding.

Diff size

Docs — 3 files · +91 / -0

Records the event-log rule, the implementation decision, and the release note.

Implementation — 8 files · +203 / -36

Moves task update and settlement rendering behind observers of the existing durable session and task streams. The invariant guard accounts for 31 added lines.

Tests — 6 files · +218 / -44

Replaces direct collector-submission tests with event projection and task-view observer coverage.

@vercel

vercel Bot commented Aug 28, 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, v0 Aug 28, 2026 11:56pm
eve-docs-4759 Ready Ready Preview, v0 Aug 28, 2026 11:56pm
eve-pkg Ready Ready Preview, v0 Aug 28, 2026 11:56pm

@github-actions

github-actions Bot commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

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

Key takeaways

  • No notable deltas vs main (a6b6397).

Delta vs main (a6b6397)

Area Metric Baseline Current Delta
Package Packed tarball 8.60 MB 8.60 MB +717 B ⚠️
Package Unpacked publish size 32.57 MB 32.57 MB +3.0 kB ⚠️
Package Installed footprint 77.53 MB 77.53 MB +3.0 kB ⚠️
Package Published files 3654 3656 +2
Package Installed files 7488 7490 +2
Package Installed package instances 35 35 0
Package Distinct installed package names 34 34 0
Package Installed dependency edges 53 53 0
Package Installed optional peer edges 47 47 0
Runtime Unique function payloads 2 2 0
Runtime Total function bytes 19.09 MB 19.10 MB +13.6 kB ⚠️
Runtime Public routes 17 17 0
Changed function payloads vs main (a6b6397) (2)
Function Status Baseline Current Delta Route changes
functions/__server.func changed 9.55 MB 9.55 MB +6.8 kB ⚠️ none
functions/.well-known/workflow/v1/flow.func changed 9.55 MB 9.55 MB +6.8 kB ⚠️ none

eve init install

Metric Baseline Current Delta
Installed footprint 114.76 MB 114.76 MB +3.0 kB ⚠️
Installed packages 120 120 0
dependencies 4 4 0
devDependencies 2 2 0
Dependency package bytes 47.27 MB 47.27 MB +3.0 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-28T23:58:02.152Z
  • Route aliases: 17 public, 1 internal (18 total aliases)
  • Vercel routes in config: 20
  • Severity legend: 🔴 dominant/large, 🟠 notable, 🟡 watch, ⚪ small
Package Drill-Down

Package Details

  • Package: eve@0.47.3
  • Package directory: packages/eve
  • Tarball: 8.60 MB (eve-0.47.3.tgz)
  • Unpacked payload: 32.57 MB across 3656 published files
  • Installed footprint: 77.53 MB across 7490 installed files
  • Installed root package: 31.22 MB
  • Installed dependencies: 46.31 MB
  • Installed package instances: 35
  • Distinct installed package names: 34
  • Installed dependency edges: 53
  • Installed optional peer edges: 47
  • Runtime dependencies: 2
  • Peer dependencies: 5 (4 optional)

Installed footprint is measured from an isolated temporary npm install of the packed tarball.
Graph metrics read only package.json files in package directories directly beneath a node_modules boundary, including nested boundaries. Each directory is one package instance; distinct names come from those manifests. Dependency edges count each unique name in dependencies or optionalDependencies per instance; optional peer edges count peerDependencies marked optional.

Heavy installed dependencies

  • eve: 31.22 MB (40.3%)
  • @rolldown/binding-linux-x64-gnu: 19.33 MB (24.9%)
  • ai: 6.86 MB (8.8%)
  • zod: 6.27 MB (8.1%)
  • undici: 3.50 MB (4.5%)
Publish payload breakdown
Published file size
🔴 dist/src/compiled/shadcn-registry/index.js       [#############...........] 9.76 MB 30.0%
🟠 dist/src/compiled/@photon-ai/chat-adapter-ime... [###.....................] 2.44 MB 7.5%
🟠 dist/src/compiled/experimental-ai-sdk-code-mo... [##......................] 1.51 MB 4.6%
🟡 dist/src/compiled/@vercel/blob/index.js          [#.......................] 901.8 kB 2.8%
🟡 dist/src/compiled/_chunks/workflow/undici-Dzn... [#.......................] 512.7 kB 1.6%
🔴 Other published files                            [########################] 17.45 MB 53.6%
Installed footprint breakdown
Installed package size
🔴 eve                             [########################] 31.22 MB 40.3%
🔴 @rolldown/binding-linux-x64-gnu [###############.........] 19.33 MB 24.9%
🔴 ai                              [#####...................] 6.86 MB 8.8%
🔴 zod                             [#####...................] 6.27 MB 8.1%
🟠 undici                          [###.....................] 3.50 MB 4.5%
🟠 nitro                           [##......................] 2.41 MB 3.1%
🔴 Other installed packages        [######..................] 7.94 MB 10.2%
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.1.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: 114.76 MB across 9276 installed files
  • Installed packages: 120 total (114 transitive-only)
  • dependencies: 4 direct packages totaling 47.27 MB
  • devDependencies: 2 direct packages totaling 5.04 MB
  • Other transitive package files: 62.45 MB

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

Heavy installed dependencies

  • eve: 31.22 MB (27.2%)
  • @typescript/typescript-linux-x64: 27.95 MB (24.4%)
  • @rolldown/binding-linux-x64-gnu: 19.33 MB (16.8%)
  • zod: 9.02 MB (7.9%)
  • ai: 6.86 MB (6.0%)
Installed footprint breakdown
Installed package size
🔴 eve                              [########################] 31.22 MB 27.2%
🔴 @typescript/typescript-linux-x64 [#####################...] 27.95 MB 24.4%
🔴 @rolldown/binding-linux-x64-gnu  [###############.........] 19.33 MB 16.8%
🔴 zod                              [#######.................] 9.02 MB 7.9%
🔴 ai                               [#####...................] 6.86 MB 6.0%
🟠 undici                           [###.....................] 3.50 MB 3.1%
🔴 Other installed packages         [#############...........] 16.88 MB 14.7%
dependencies (4)
Package Range Installed size Share
@vercel/connect 1.0.0 167.9 kB 0.1%
ai ^7.0.58 6.86 MB 6.0%
eve file:eve-0.47.3.tgz 31.22 MB 27.2%
zod 4.4.3 9.02 MB 7.9%
devDependencies (2)
Package Range Installed size Share
@types/node 24.x 2.54 MB 2.2%
typescript 7.0.2 2.50 MB 2.2%
Function Drill-Down

Payload Size Graph

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

Top Function Payloads

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

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 index.mjs                       [###########.............] 2.01 MB 21.1%
🟡 _libs/undici.mjs                [#####...................] 980.5 kB 10.3%
🟡 _chunks/decode_jwt-Col8JOnf.mjs [####....................] 702.6 kB 7.4%
🟡 _chunks/frames-Dl2Hcma4.mjs     [####....................] 678.7 kB 7.1%
🟡 _chunks/chatgpt-model.mjs       [####....................] 666.2 kB 7.0%
🔴 Other bundled files             [########################] 4.51 MB 47.2%

🧾 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 • 16 public routes, 1 internal alias • 9.55 MB
Metric Value
Public routes /
/eve/v1/activity/[token]
/eve/v1/callback/[token]
/eve/v1/connections/[name]/callback/[attemptId]/[token]
/eve/v1/connections/[name]/callback/[token]
/eve/v1/health
/eve/v1/info
/eve/v1/session
/eve/v1/session/[parentSessionId]/subagents/[callId]/[childSessionId]/stream
/eve/v1/session/[sessionId]
/eve/v1/session/[sessionId]/cancel
/eve/v1/session/[sessionId]/clear
/eve/v1/session/[sessionId]/compact
/eve/v1/session/[sessionId]/reset
/eve/v1/session/[sessionId]/stream
/eve/v1/task-input/[token]
Internal aliases /__server
Runtime nodejs24.x
Handler index.mjs
Payload 9.55 MB
Function files 9.55 MB across 111 files
Traced dependencies 0 B
Signal 🟠 Bundled file index.mjs is 2.01 MB (21.1%)

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 index.mjs                       [###########.............] 2.01 MB 21.1%
🟡 _libs/undici.mjs                [#####...................] 980.5 kB 10.3%
🟡 _chunks/decode_jwt-Col8JOnf.mjs [####....................] 702.6 kB 7.4%
🟡 _chunks/frames-Dl2Hcma4.mjs     [####....................] 678.7 kB 7.1%
🟡 _chunks/chatgpt-model.mjs       [####....................] 666.2 kB 7.0%
🔴 Other bundled files             [########################] 4.51 MB 47.2%

🧾 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.49 s -> 2.60 s (+108.1 ms) vs main (a6b6397).
  • Timing is informational: shared GitHub runners are too variable for a hard timing budget.
Detailed phase timings vs `main (a6b6397)`
Phase Baseline Current Delta
extension.check 1.2 ms 1.2 ms 0.0 ms
project.resolve 0.4 ms 0.3 ms -0.1 ms
workspace.create 0.8 ms 0.7 ms -0.1 ms
host.prepare 462.5 ms 442.0 ms -20.5 ms
vercel.service-prefix.resolve 2.4 ms 2.5 ms +0.1 ms
nitro.create 291.4 ms 294.9 ms +3.5 ms
sandbox.prewarm 197.0 ms 336.4 ms +139.4 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.8 ms 0.8 ms 0.0 ms
nitro.prerender 0.5 ms 0.4 ms -0.1 ms
nitro.bundle 1.48 s 1.46 s -13.5 ms
nitro.cache.write 0.4 ms 0.4 ms 0.0 ms
vercel.workflow-function.materialize 49.2 ms 48.6 ms -0.6 ms
agent-summary.emit 0.8 ms 0.8 ms 0.0 ms
nitro.close 0.1 ms 0.1 ms 0.0 ms
output.publish 3.5 ms 3.4 ms -0.1 ms
workspace.remove 2.3 ms 2.4 ms +0.1 ms

Comment on lines +166 to +174
void submitActivity({
events: projectTaskUpdateActivity({
activityObserver: input.activityObserver,
update: input.update,
updatedAt: new Date().toISOString(),
view: input.view,
}),
sink: input.activityObserver?.sink,
});

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

My existing mental model is that the only input for activity is the event stream ie it is single-writer. Thus, ad-hoc writes to it violates it and makes the model harder to reason about as consequently to maintain; see current HITL stack which allows unbounded writes to its pending batch.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I updated task_update to emit an event; the observer now forwards this event rather than adjusting when we emit to the activity stream

Signed-off-by: benpankow <ben.pankow@vercel.com>
Signed-off-by: benpankow <ben.pankow@vercel.com>
Signed-off-by: benpankow <ben.pankow@vercel.com>
Signed-off-by: benpankow <ben.pankow@vercel.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.

2 participants