Vercel Eve Agent Diagnostic Harness

Catch silent webhook failures in eve.

A zero-config reverse-proxy inspector that audits inbound webhooks against your authored Eve channels in real time. Catches 404 route drops before they leave zero signal in your Agent Runs dashboard.

Read Documentation
v0.1.0·(release notes)·status: stable·zero-config·MIT License
Live Preflight Inspection Simulator
1 / 9
$ eve dev  # (running in Terminal 1 on :3000)
Zero code change: Eve agent runs unmodified
Proxy: :3001 ➔ Target: :3000
The Silent Failure Problem

Why webhook misconfigurations waste hours in Eve.

When an inbound event hits Vercel Eve on an unmapped path, Eve’s Nitro/H3 server drops it with a generic 404 before it ever reaches your agent dispatcher. Because execution never enters the agent lifecycle, it leaves ZERO trace in terminal output, local spans, or the Vercel Agent Runs dashboard.

Nitro Server
404 Not Found

HTTP connection dropped immediately. Sender receives generic 404 with no context.

Eve Dashboard
0 Spans / 0 Runs

No OpenTelemetry span is initialized. The run never appears on Vercel dashboard.

With Preflight
Instant Alert

Preflight logs the exact mistyped route and suggests your authored channel URL.

Before vs. After Comparison
Without eve-preflighteve dev
$ curl -X POST http://localhost:3000/api/slack/events
< HTTP/1.1 404 Not Found
Eve dev terminal status:
(idle... zero logs printed. No trace generated. Nothing to debug.)

You spend hours questioning tokens, tunnels, and webhook signers because the failure is completely silent.

With eve-preflightnpx eve-preflight
▶ POST /api/slack/events
✖ Request did NOT match any Eve channel!
Registered channels include:
- /webhook/inbound
- /eve/v1/slack
- /eve/v1/session
(+ more internal eve/v1 routes)
Suggestion: Did you mean /eve/v1/slack?

Immediate visibility in the proxy terminal. You spot and fix the path disparity in seconds.

Engineered for Developer Speed

Zero-Config Route Discovery

Shells out to eve info --json on startup to discover all registered channels dynamically without manual config files.

High-Fidelity Reverse Proxy

Sits transparently on port 3001, streaming bodies, headers, and chunks directly to your upstream Eve Nitro server on port 3000.

Slack Heuristic Detection

Detects Slack signature headers (x-slack-signature) hitting unmapped paths and gives tailored remediation advice.

Zero Production Impact

A standalone developer harness. When deploying to production on Vercel, zero changes are required to your codebase.

Start catching silent drops today.

Runs with zero installation directly inside any Eve agent repository: