Skip to content

feat(eve): add eve invoke command - #1144

Merged
OwenKephart merged 1 commit into
mainfrom
07-23-feat_eve_add_headless_eve_dev_mode
Jul 28, 2026
Merged

feat(eve): add eve invoke command#1144
OwenKephart merged 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 "Summarize station telemetry"

# Run against an existing server
eve invoke --url http://localhost:2000 "Deploy the application"

# Select the Vercel team that owns a remote deployment
eve invoke --url https://agent.example.com --scope my-team "Deploy the application"

# Resume with a follow-up or answer to a pending input
result=$(eve invoke --url http://localhost:2000 "Deploy the application")
printf '%s' "$result" | eve invoke --resume "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 28, 2026 9:53pm
eve-docs-4759 Ready Ready Preview, Comment, Open in v0 Jul 28, 2026 9:53pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
eve-docs-1644 Skipped Skipped Open in v0 Jul 28, 2026 9:53pm

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 (9df880e).

Delta vs main (9df880e)

Area Metric Baseline Current Delta
Package Packed tarball 7.58 MB 7.59 MB +7.7 kB ⚠️
Package Unpacked publish size 28.67 MB 28.70 MB +32.7 kB ⚠️
Package Installed footprint 69.79 MB 69.82 MB +32.7 kB ⚠️
Package Published files 2846 2854 +8
Package Installed files 6319 6327 +8
Runtime Unique function payloads 2 2 0
Runtime Total function bytes 16.70 MB 16.70 MB -40 B ✅
Runtime Public routes 11 11 0
Changed function payloads vs main (9df880e) (2)
Function Status Baseline Current Delta Route changes
functions/__server.func changed 8.35 MB 8.35 MB -20 B ✅ none
functions/.well-known/workflow/v1/flow.func changed 8.35 MB 8.35 MB -20 B ✅ none

eve init install

Metric Baseline Current Delta
Installed footprint 108.19 MB 108.23 MB +32.7 kB ⚠️
Installed packages 123 123 0
dependencies 4 4 0
devDependencies 2 2 0
Dependency package bytes 42.98 MB 43.02 MB +32.7 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-28T21:53:10.544Z
  • 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.27.11
  • Package directory: packages/eve
  • Tarball: 7.59 MB (eve-0.27.11.tgz)
  • Unpacked payload: 28.70 MB across 2854 published files
  • Installed footprint: 69.82 MB across 6327 installed files
  • Installed root package: 27.34 MB
  • Installed dependencies: 42.48 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.34 MB (39.2%)
  • @rolldown/binding-linux-x64-gnu: 18.96 MB (27.2%)
  • ai: 6.52 MB (9.3%)
  • zod: 5.07 MB (7.3%)
  • nitro: 2.41 MB (3.4%)
Publish payload breakdown
Published file size
🔴 dist/src/compiled/shadcn-registry/index.js       [########################] 13.15 MB 45.8%
🟠 dist/src/compiled/experimental-ai-sdk-code-mo... [###.....................] 1.51 MB 5.2%
🟡 dist/src/compiled/@vercel/sandbox/index.js       [#.......................] 632.5 kB 2.2%
🟡 dist/src/compiled/_chunks/workflow/undici-DWL... [#.......................] 502.4 kB 1.8%
🟡 dist/src/compiled/@chat-adapter/slack/index.js   [#.......................] 440.5 kB 1.5%
🔴 Other published files                            [#######################.] 12.46 MB 43.4%
Installed footprint breakdown
Installed package size
🔴 eve                             [########################] 27.34 MB 39.2%
🔴 @rolldown/binding-linux-x64-gnu [#################.......] 18.96 MB 27.2%
🔴 ai                              [######..................] 6.52 MB 9.3%
🔴 zod                             [####....................] 5.07 MB 7.3%
🟠 nitro                           [##......................] 2.41 MB 3.4%
🟠 undici                          [##......................] 1.86 MB 2.7%
🔴 Other installed packages        [#######.................] 7.67 MB 11.0%
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: 108.23 MB across 8195 installed files
  • Installed packages: 123 total (117 transitive-only)
  • dependencies: 4 direct packages totaling 43.02 MB
  • devDependencies: 2 direct packages totaling 5.04 MB
  • Other transitive package files: 60.17 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.8%)
  • eve: 27.34 MB (25.3%)
  • @rolldown/binding-linux-x64-gnu: 18.96 MB (17.5%)
  • zod: 9.02 MB (8.3%)
  • ai: 6.52 MB (6.0%)
Installed footprint breakdown
Installed package size
🔴 @typescript/typescript-linux-x64 [########################] 27.95 MB 25.8%
🔴 eve                              [#######################.] 27.34 MB 25.3%
🔴 @rolldown/binding-linux-x64-gnu  [################........] 18.96 MB 17.5%
🔴 zod                              [########................] 9.02 MB 8.3%
🔴 ai                               [######..................] 6.52 MB 6.0%
🟠 @types/node                      [##......................] 2.54 MB 2.4%
🔴 Other installed packages         [##############..........] 15.90 MB 14.7%
dependencies (4)
Package Range Installed size Share
@vercel/connect 0.4.2 135.8 kB 0.1%
ai ^7.0.38 6.52 MB 6.0%
eve file:eve-0.27.11.tgz 27.34 MB 25.3%
zod 4.4.3 9.02 MB 8.3%
devDependencies (2)
Package Range Installed size Share
@types/node 24.x 2.54 MB 2.4%
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.35 MB 50.0%
🔴 functions/__server.func                         [########################] 8.35 MB 50.0%

Top Function Payloads

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

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 index.mjs                       [#######################.] 2.26 MB 27.1%
🟠 _chunks/runtime-artifacts.mjs   [################........] 1.59 MB 19.0%
🟡 _libs/undici.mjs                [##########..............] 980.5 kB 11.7%
🟡 _chunks/sandbox.mjs             [########................] 768.8 kB 9.2%
🟡 _libs/@ai-sdk/gateway+[...].mjs [####....................] 432.8 kB 5.2%
🟠 Other bundled files             [########################] 2.31 MB 27.7%

🧾 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.35 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.35 MB
Function files 8.35 MB across 44 files
Traced dependencies 0 B
Signal 🟠 Bundled file index.mjs is 2.26 MB (27.1%)

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 index.mjs                       [#######################.] 2.26 MB 27.1%
🟠 _chunks/runtime-artifacts.mjs   [################........] 1.59 MB 19.0%
🟡 _libs/undici.mjs                [##########..............] 980.5 kB 11.7%
🟡 _chunks/sandbox.mjs             [########................] 768.8 kB 9.2%
🟡 _libs/@ai-sdk/gateway+[...].mjs [####....................] 432.8 kB 5.2%
🟠 Other bundled files             [########################] 2.31 MB 27.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: 1.78 s -> 2.04 s (+251.7 ms) vs main (9df880e).
  • Timing is informational: shared GitHub runners are too variable for a hard timing budget.
Detailed phase timings vs `main (9df880e)`
Phase Baseline Current Delta
extension.check 0.9 ms 0.8 ms -0.1 ms
project.resolve 0.5 ms 0.5 ms 0.0 ms
workspace.create 0.6 ms 0.5 ms -0.1 ms
host.prepare 271.7 ms 220.6 ms -51.1 ms
vercel.service-prefix.resolve 1.5 ms 1.4 ms -0.1 ms
nitro.create 159.2 ms 157.2 ms -2.0 ms
sandbox.prewarm 313.4 ms 316.7 ms +3.3 ms
nitro.cache.prepare 0.2 ms 0.2 ms 0.0 ms
nitro.prepare 0.5 ms 0.6 ms +0.1 ms
nitro.public-assets 0.6 ms 0.6 ms 0.0 ms
nitro.prerender 0.4 ms 0.4 ms 0.0 ms
nitro.bundle 965.2 ms 1.27 s +304.1 ms
nitro.cache.write 0.2 ms 0.3 ms +0.1 ms
vercel.workflow-function.materialize 63.6 ms 61.4 ms -2.2 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.7 ms 2.6 ms -0.1 ms
workspace.remove 1.6 ms 1.5 ms -0.1 ms

Comment thread packages/eve/src/cli/invoke/invoke.ts Outdated
Comment thread docs/reference/cli.md

@vercel vercel Bot left a comment

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.

Additional Suggestion:

The registry:check build step fails because validate-channel-registry.ts validates the old meta.eve.channel / eve channels add delegation shape, which no longer matches the eve integration setup <slug> shape now used by the slack/web channel items in registry.json.

Fix on Vercel

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.

2 participants