Problems solved

Technical challenges this implementation handles out of the box.
  • Scaffold a durable Eve agent from a complete filesystem artifact
  • Define a typed tool with validated input and output
  • Verify agent discovery, tool calls, output, and replies before shipping
  • Run the full test loop without API keys or provider credentials

Use cases

Products and workflows this pattern is designed to support.
  • Learning Eve project conventions
  • Starting a tool-using backend agent
  • Building deterministic smoke tests for an agent
  • Validating an Eve Pattern before publishing it

Setup

Requirements, wiring steps, and what this pattern adds to your project.

Requirements

Complexity
Beginner
Setup time
~5 minutes
Node
24+
Memory
256MB

Getting started

Pick how you want to pull this pattern in — then wire env vars and routes the same way.

  1. 1

    Install into an empty project directory

    Shadcn Icon

    Copy the tokenized install command from the preview toolbar and run it in an empty directory so the Eve package and agent tree stay together.

  2. 2

    Install dependencies and run the verification suite

    With Node.js 24+, run `pnpm install`, `pnpm verify:discovery`, `pnpm typecheck`, `pnpm build`, and `pnpm eval`.

  3. 3

    Run the Eve development server

    Run `pnpm dev` after every verification gate passes.

Files added

10 files
  • package.json
  • tsconfig.json
  • README.md
  • .gitignore
  • .node-version
  • agent/agent.ts
  • agent/instructions.md
  • agent/tools/get_weather.ts
  • evals/evals.config.ts
  • evals/weather.eval.ts

Dependencies

3 total

npm packages

3
AISDKeveZod