Skip to content

feat(eve): add eve invoke command#1144

Open
OwenKephart wants to merge 1 commit into
mainfrom
07-23-feat_eve_add_headless_eve_dev_mode
Open

feat(eve): add eve invoke command#1144
OwenKephart wants to merge 1 commit into
mainfrom
07-23-feat_eve_add_headless_eve_dev_mode

Conversation

@OwenKephart

@OwenKephart OwenKephart commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

Description

  • Add eve invoke, a non-interactive JSON CLI for invoking local agents or existing remote deployments without opening the TUI.
  • Support both fire-and-resume and blocking execution:
    • remote invocations return a durable running result after acceptance by default
    • --wait follows the session until completion or a blocking input/authorization checkpoint
    • local invocations start a temporary development server and require --wait
  • Support durable continuation by piping a previous result into eve invoke --resume; completed sessions can receive follow-up prompts, pending input can receive an answer, and authorization checkpoints can be followed after authorization completes.
  • Emit stable machine-readable statuses, resume coordinates, exit codes, and a JSON Schema via --json-schema.
  • Reuse development-client target and credential handling for local, linked Vercel, and explicitly authenticated remote targets.

Examples:

# Run against a temporary local development server
eve invoke --wait "Summarize station telemetry"

# Submit to an existing server and return after acceptance
eve invoke --url http://localhost:2000 "Deploy the application"

# Wait for completion or a blocking checkpoint
result=$(eve invoke --url http://localhost:2000 --wait "Deploy the application")

# Resume with a follow-up or answer to a pending input
printf '%s' "$result" | eve invoke --resume --wait "approve"

# Inspect the output contract
eve invoke --json-schema

How did you test your changes?

  • pnpm --filter eve exec vitest run --config vitest.unit.config.ts src/cli/invoke/invoke.test.ts
  • Focused unit suite covering invoke CLI behavior, credentials, remote verification, and development-server shutdown ordering (89 tests)
  • pnpm --filter eve exec tsc --noEmit -p tsconfig.json
  • pnpm typecheck
  • git diff --check

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 (git commit --signoff)

@vercel

vercel Bot commented Jul 23, 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 24, 2026 11:20pm
eve-docs-1644 Ready Ready Preview, Comment, Open in v0 Jul 24, 2026 11:20pm
eve-docs-4759 Ready Ready Preview, Comment, Open in v0 Jul 24, 2026 11:20pm

Copy link
Copy Markdown
Contributor Author

This stack of pull requests is managed by Graphite. Learn more about stacking.

@github-actions

github-actions Bot commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

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

Key takeaways

  • No notable deltas vs main (0a8b63c).

Delta vs main (0a8b63c)

Area Metric Baseline Current Delta
Package Packed tarball 4.06 MB 4.07 MB +8.0 kB ⚠️
Package Unpacked publish size 14.75 MB 14.79 MB +35.5 kB ⚠️
Package Installed footprint 53.91 MB 53.94 MB +35.5 kB ⚠️
Package Published files 2773 2783 +10
Package Installed files 6013 6023 +10
Runtime Unique function payloads 2 2 0
Runtime Total function bytes 11.68 MB 11.68 MB -40 B ✅
Runtime Public routes 11 11 0
Changed function payloads vs main (0a8b63c) (2)
Function Status Baseline Current Delta Route changes
functions/__server.func changed 4.41 MB 4.41 MB -20 B ✅ none
functions/.well-known/workflow/v1/flow.func changed 7.27 MB 7.27 MB -20 B ✅ none

eve init install

Metric Baseline Current Delta
Installed footprint 92.31 MB 92.35 MB +35.5 kB ⚠️
Installed packages 122 122 0
dependencies 4 4 0
devDependencies 2 2 0
Dependency package bytes 29.03 MB 29.07 MB +35.5 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-07-24T23:21:03.475Z
  • Route aliases: 11 public, 1 internal (12 total aliases)
  • Vercel routes in config: 12
  • Severity legend: 🔴 dominant/large, 🟠 notable, 🟡 watch, ⚪ small
Package Drill-Down

Package Details

  • Package: eve@0.27.5
  • Package directory: packages/eve
  • Tarball: 4.07 MB (eve-0.27.5.tgz)
  • Unpacked payload: 14.79 MB across 2783 published files
  • Installed footprint: 53.94 MB across 6023 installed files
  • Installed root package: 13.50 MB
  • Installed dependencies: 40.44 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: 18.96 MB (35.1%)
  • eve: 13.50 MB (25.0%)
  • ai: 6.43 MB (11.9%)
  • zod: 5.04 MB (9.3%)
  • nitro: 2.41 MB (4.5%)
Publish payload breakdown
Published file size
🟠 dist/src/compiled/experimental-ai-sdk-code-mo... [###.....................] 1.51 MB 10.2%
🟡 dist/src/compiled/@vercel/sandbox/index.js       [#.......................] 632.4 kB 4.3%
🟡 dist/src/compiled/_chunks/workflow/undici-C2Z... [#.......................] 502.4 kB 3.4%
🟡 dist/src/compiled/@chat-adapter/slack/index.js   [#.......................] 440.5 kB 3.0%
🟡 dist/src/compiled/@vercel/oidc/index.js          [#.......................] 379.5 kB 2.6%
🔴 Other published files                            [########################] 11.33 MB 76.6%
Installed footprint breakdown
Installed package size
🔴 @rolldown/binding-linux-x64-gnu [########################] 18.96 MB 35.1%
🔴 eve                             [#################.......] 13.50 MB 25.0%
🔴 ai                              [########................] 6.43 MB 11.9%
🔴 zod                             [######..................] 5.04 MB 9.3%
🟠 nitro                           [###.....................] 2.41 MB 4.5%
🟡 @ai-sdk/provider-utils          [#.......................] 852.0 kB 1.6%
🔴 Other installed packages        [#########...............] 6.75 MB 12.5%
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: 92.35 MB across 7891 installed files
  • Installed packages: 122 total (116 transitive-only)
  • dependencies: 4 direct packages totaling 29.07 MB
  • devDependencies: 2 direct packages totaling 5.04 MB
  • Other transitive package files: 58.24 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.3%)
  • @rolldown/binding-linux-x64-gnu: 18.96 MB (20.5%)
  • eve: 13.50 MB (14.6%)
  • zod: 9.00 MB (9.7%)
  • ai: 6.43 MB (7.0%)
Installed footprint breakdown
Installed package size
🔴 @typescript/typescript-linux-x64 [########################] 27.95 MB 30.3%
🔴 @rolldown/binding-linux-x64-gnu  [################........] 18.96 MB 20.5%
🔴 eve                              [############............] 13.50 MB 14.6%
🔴 zod                              [########................] 9.00 MB 9.7%
🔴 ai                               [######..................] 6.43 MB 7.0%
🟠 @types/node                      [##......................] 2.54 MB 2.8%
🔴 Other installed packages         [############............] 13.97 MB 15.1%
dependencies (4)
Package Range Installed size Share
@vercel/connect 0.4.2 135.8 kB 0.1%
ai ^7.0.34 6.43 MB 7.0%
eve file:eve-0.27.5.tgz 13.50 MB 14.6%
zod 4.4.3 9.00 MB 9.7%
devDependencies (2)
Package Range Installed size Share
@types/node 24.x 2.54 MB 2.8%
typescript 7.0.2 2.50 MB 2.7%
Function Drill-Down

Payload Size Graph

Unique function payload size and share of total
🔴 functions/.well-known/workflow/v1/flow.func     [########################] 7.27 MB 62.2%
🟠 functions/__server.func                         [###############.........] 4.41 MB 37.8%

Top Function Payloads

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

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 __eve_nitro_handler__.mjs       [########################] 2.71 MB 37.2%
🟡 _chunks/world-vercel.mjs        [########................] 903.2 kB 12.4%
🟡 _chunks/sandbox.mjs             [#######.................] 767.6 kB 10.6%
🟡 _libs/@ai-sdk/gateway+[...].mjs [####....................] 432.5 kB 6.0%
🟡 _chunks/token-util-B6qBs3-0.mjs [###.....................] 379.1 kB 5.2%
🟠 Other bundled files             [##################......] 2.08 MB 28.6%

🧾 Vercel Config

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

🟠 functions/__server.func • 10 public routes, 1 internal alias • 4.41 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 4.41 MB
Function files 4.41 MB across 30 files
Traced dependencies 0 B
Signal 🟠 Bundled file _chunks/runtime-artifacts.mjs is 1.41 MB (32.0%)

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 _chunks/runtime-artifacts.mjs   [########################] 1.41 MB 32.0%
🟠 _chunks/world-vercel.mjs        [###############.........] 900.3 kB 20.4%
🟠 _chunks/sandbox.mjs             [#############...........] 767.6 kB 17.4%
🟡 _chunks/token-util-B6qBs3-0.mjs [######..................] 379.1 kB 8.6%
🟡 _chunks/dist-BX517Nmz.mjs       [######..................] 348.7 kB 7.9%
🟡 Other bundled files             [##########..............] 603.6 kB 13.7%

🧾 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.64 s -> 2.46 s (-172.8 ms) vs main (0a8b63c).
  • Timing is informational: shared GitHub runners are too variable for a hard timing budget.
Detailed phase timings vs `main (0a8b63c)`
Phase Baseline Current Delta
extension.check 7.2 ms 1.2 ms -6.0 ms
project.resolve 6.2 ms 0.7 ms -5.5 ms
workspace.create 1.1 ms 0.8 ms -0.3 ms
host.prepare 347.4 ms 155.6 ms -191.8 ms
vercel.service-prefix.resolve 2.1 ms 2.3 ms +0.2 ms
nitro.app.create 24.3 ms 27.7 ms +3.4 ms
nitro.app.cache.prepare 0.2 ms 0.3 ms +0.1 ms
nitro.app.prepare 0.9 ms 1.0 ms +0.1 ms
nitro.app.public-assets 0.7 ms 0.7 ms 0.0 ms
nitro.app.prerender 0.5 ms 0.6 ms +0.1 ms
nitro.app.bundle 654.9 ms 693.4 ms +38.5 ms
nitro.app.cache.write 0.3 ms 0.4 ms +0.1 ms
sandbox.prewarm 190.1 ms 198.0 ms +7.9 ms
nitro.flow.create 177.0 ms 177.3 ms +0.3 ms
nitro.flow.cache.prepare 0.2 ms 0.2 ms 0.0 ms
nitro.flow.prepare 0.7 ms 0.8 ms +0.1 ms
nitro.flow.public-assets 0.1 ms 0.2 ms +0.1 ms
nitro.flow.prerender 0.0 ms 0.0 ms 0.0 ms
nitro.flow.bundle 1.03 s 1.02 s -10.5 ms
nitro.flow.cache.write 0.3 ms 0.4 ms +0.1 ms
nitro.flow.close 0.2 ms 0.2 ms 0.0 ms
workflow.emit 161.8 ms 170.2 ms +8.4 ms
agent-summary.emit 0.5 ms 0.5 ms 0.0 ms
nitro.app.close 0.0 ms 0.0 ms 0.0 ms
output.publish 21.0 ms 3.6 ms -17.4 ms
workspace.remove 5.6 ms 5.2 ms -0.4 ms

Comment thread packages/eve/src/cli/invoke/invoke.ts Outdated
Signed-off-by: owenkephart <owen.kephart@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.

1 participant