Skip to content

feat: add ACP adapter for local and remote agents - #1347

Draft
cmpadden wants to merge 1 commit into
mainfrom
feat/acp-adapter
Draft

feat: add ACP adapter for local and remote agents#1347
cmpadden wants to merge 1 commit into
mainfrom
feat/acp-adapter

Conversation

@cmpadden

@cmpadden cmpadden commented Jul 29, 2026

Copy link
Copy Markdown
Collaborator

Description

Adds eve acp [url], a stable ACP v1 stdio bridge backed by eve’s public client-session API. Without a URL it supervises a local development server; with a URL it bridges ACP to an authenticated deployed eve agent through its existing HTTP API. It projects streamed text/reasoning/tool updates, human input, cancellation, and cleanup; adds client setup documentation, requirements, adapter tests, vendored SDK support, and a patch changeset.

Closes #100

How did you test your changes?

  • pnpm --filter eve exec vitest run --config vitest.unit.config.ts src/cli/run.test.ts src/acp/adapter.test.ts src/acp/line-limit.test.ts
  • pnpm --filter eve build
  • pnpm --filter eve exec tsc -p tsconfig.json --noEmit --pretty false
  • pnpm guard:invariants
  • pnpm docs:check
  • npx acpx@latest --agent 'pnpm exec eve acp' exec 'Reply with exactly: ACP works' from apps/fixtures/weather-agent\n\n### PR Checklist\n\n- [x] I linked an issue with prior discussion confirming this change is wanted\n- [x] I ran the relevant checks from CONTRIBUTING.md\n- [x] I added tests and documentation where relevant\n- [x] I added a changeset if this touches the published eve package\n- [x] DCO sign-off passes for every commit (git commit --signoff)

@vercel

vercel Bot commented Jul 29, 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 Jul 29, 2026 8:02pm
eve-docs-4759 Ready Ready Preview, v0 Jul 29, 2026 8:02pm

@socket-security

socket-security Bot commented Jul 29, 2026

Copy link
Copy Markdown

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff Package Supply Chain
Security
Vulnerability Quality Maintenance License
Addednpm/​@​agentclientprotocol/​sdk@​1.3.01001009498100

View full report

@github-actions

github-actions Bot commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

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

Key takeaways

  • Package delta: install footprint 91.05 MB -> 91.52 MB (+466.8 kB ⚠️).

Delta vs main (1cb5afd)

Area Metric Baseline Current Delta
Package Packed tarball 7.61 MB 7.69 MB +85.4 kB ⚠️
Package Unpacked publish size 28.75 MB 29.22 MB +466.8 kB ⚠️
Package Installed footprint 91.05 MB 91.52 MB +466.8 kB ⚠️
Package Published files 2855 2874 +19
Package Installed files 6642 6661 +19
Runtime Unique function payloads 2 2 0
Runtime Total function bytes 16.72 MB 16.72 MB -40 B ✅
Runtime Public routes 11 11 0
Changed function payloads vs main (1cb5afd) (2)
Function Status Baseline Current Delta Route changes
functions/__server.func changed 8.36 MB 8.36 MB -20 B ✅ none
functions/.well-known/workflow/v1/flow.func changed 8.36 MB 8.36 MB -20 B ✅ none

eve init install

Metric Baseline Current Delta
Installed footprint 129.45 MB 129.92 MB +466.8 kB ⚠️
Installed packages 130 130 0
dependencies 4 4 0
devDependencies 2 2 0
Dependency package bytes 43.08 MB 43.55 MB +466.8 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-29T20:02:19.884Z
  • 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.13
  • Package directory: packages/eve
  • Tarball: 7.69 MB (eve-0.27.13.tgz)
  • Unpacked payload: 29.22 MB across 2874 published files
  • Installed footprint: 91.52 MB across 6661 installed files
  • Installed root package: 27.86 MB
  • Installed dependencies: 63.66 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.86 MB (30.4%)
  • @rolldown/binding-linux-x64-gnu: 19.28 MB (21.1%)
  • @rolldown/binding-wasm32-wasi: 10.66 MB (11.6%)
  • ai: 6.53 MB (7.1%)
  • @napi-rs/wasm-runtime: 6.39 MB (7.0%)
Publish payload breakdown
Published file size
🔴 dist/src/compiled/shadcn-registry/index.js       [########################] 13.15 MB 45.0%
🟠 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.7%
🟡 dist/src/compiled/@chat-adapter/slack/index.js   [#.......................] 440.5 kB 1.5%
🔴 Other published files                            [########################] 12.98 MB 44.4%
Installed footprint breakdown
Installed package size
🔴 eve                             [########################] 27.86 MB 30.4%
🔴 @rolldown/binding-linux-x64-gnu [#################.......] 19.28 MB 21.1%
🔴 @rolldown/binding-wasm32-wasi   [#########...............] 10.66 MB 11.6%
🔴 ai                              [######..................] 6.53 MB 7.1%
🔴 @napi-rs/wasm-runtime           [######..................] 6.39 MB 7.0%
🔴 zod                             [####....................] 5.07 MB 5.5%
🔴 Other installed packages        [##############..........] 15.73 MB 17.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.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: 129.92 MB across 8529 installed files
  • Installed packages: 130 total (124 transitive-only)
  • dependencies: 4 direct packages totaling 43.55 MB
  • devDependencies: 2 direct packages totaling 5.04 MB
  • Other transitive package files: 81.33 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 (21.5%)
  • eve: 27.86 MB (21.4%)
  • @rolldown/binding-linux-x64-gnu: 19.28 MB (14.8%)
  • @rolldown/binding-wasm32-wasi: 10.66 MB (8.2%)
  • zod: 9.02 MB (6.9%)
Installed footprint breakdown
Installed package size
🔴 @typescript/typescript-linux-x64 [########################] 27.95 MB 21.5%
🔴 eve                              [########################] 27.86 MB 21.4%
🔴 @rolldown/binding-linux-x64-gnu  [#################.......] 19.28 MB 14.8%
🔴 @rolldown/binding-wasm32-wasi    [#########...............] 10.66 MB 8.2%
🔴 zod                              [########................] 9.02 MB 6.9%
🔴 ai                               [######..................] 6.53 MB 5.0%
🔴 @napi-rs/wasm-runtime            [#####...................] 6.39 MB 4.9%
🔴 Other installed packages         [###################.....] 22.23 MB 17.1%
dependencies (4)
Package Range Installed size Share
@vercel/connect 0.4.2 135.8 kB 0.1%
ai ^7.0.38 6.53 MB 5.0%
eve file:eve-0.27.13.tgz 27.86 MB 21.4%
zod 4.4.3 9.02 MB 6.9%
devDependencies (2)
Package Range Installed size Share
@types/node 24.x 2.54 MB 2.0%
typescript 7.0.2 2.50 MB 1.9%
Function Drill-Down

Payload Size Graph

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

Top Function Payloads

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

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 index.mjs                       [#######################.] 2.27 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.33 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 • 10 public routes, 1 internal alias • 8.36 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.36 MB
Function files 8.36 MB across 44 files
Traced dependencies 0 B
Signal 🟠 Bundled file index.mjs is 2.27 MB (27.1%)

🟠 🔎 Dependency Analysis

📦 Bundled files:

Bundled file size
🟠 index.mjs                       [#######################.] 2.27 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.32 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: 1.98 s -> 1.95 s (-32.1 ms) vs main (1cb5afd).
  • Timing is informational: shared GitHub runners are too variable for a hard timing budget.
Detailed phase timings vs `main (1cb5afd)`
Phase Baseline Current Delta
extension.check 1.0 ms 9.6 ms +8.6 ms
project.resolve 0.6 ms 1.3 ms +0.7 ms
workspace.create 0.7 ms 1.0 ms +0.3 ms
host.prepare 264.1 ms 235.5 ms -28.6 ms
vercel.service-prefix.resolve 1.9 ms 1.8 ms -0.1 ms
nitro.create 199.1 ms 180.1 ms -19.0 ms
sandbox.prewarm 232.0 ms 232.4 ms +0.4 ms
nitro.cache.prepare 0.2 ms 0.3 ms +0.1 ms
nitro.prepare 0.6 ms 0.8 ms +0.2 ms
nitro.public-assets 0.8 ms 0.7 ms -0.1 ms
nitro.prerender 0.4 ms 0.5 ms +0.1 ms
nitro.bundle 1.25 s 1.25 s +3.5 ms
nitro.cache.write 0.3 ms 0.3 ms 0.0 ms
vercel.workflow-function.materialize 19.1 ms 21.2 ms +2.1 ms
agent-summary.emit 0.4 ms 0.5 ms +0.1 ms
nitro.close 0.2 ms 0.1 ms -0.1 ms
output.publish 3.1 ms 3.0 ms -0.1 ms
workspace.remove 1.9 ms 1.7 ms -0.2 ms

@cmpadden cmpadden changed the title feat: add local ACP adapter feat: add ACP adapter for local and remote agents Jul 29, 2026
Signed-off-by: Colton Padden <colton.padden@vercel.com>
Comment thread docs/guides/acp.md

The initial adapter does not support:

- a deployed ACP HTTP or WebSocket endpoint;\n- ACP authentication (remote bridges use the deployed eve agent's existing HTTP authentication);

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.

Suggested change
- a deployed ACP HTTP or WebSocket endpoint;\n- ACP authentication (remote bridges use the deployed eve agent's existing HTTP authentication);
- a deployed ACP HTTP or WebSocket endpoint;
- ACP authentication (remote bridges use the deployed eve agent's existing HTTP authentication);

A literal \n escape sequence in the markdown source merges two bullet list items into one broken bullet

Fix on Vercel

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.

eve dev as acp server

1 participant