Skip to content

armgit / eve

Public Imported from GitHub
0

The Open Framework for Building Agents

fix(eve): use lowercase product name consistently (#32)

Rui1e2e8effda17
diff --git a/.changeset/lowercase-eve-name.md b/.changeset/lowercase-eve-name.md
new file mode 100644
index 000000000..853d889e6
--- /dev/null
+++ b/.changeset/lowercase-eve-name.md
@@ -0,0 +1,5 @@
+---
+"eve": patch
+---
+
+Standardize the product name as `eve` across documentation, CLI output, diagnostics, generated text, and runtime messages.
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
index e8fbc0194..e2300218e 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -1,5 +1,5 @@
name: Bug report
-description: Report a reproducible bug in Eve.
+description: Report a reproducible bug in eve.
labels: ["bug"]
body:
- type: markdown
@@ -9,7 +9,7 @@ body:
- type: input
id: eve-version
attributes:
- label: Eve version
+ label: eve version
description: Output of `npm ls eve` in your project (or the version from your lockfile).
placeholder: "[email protected]"
validations:
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
index 4d345d556..2a9bed661 100644
--- a/.github/ISSUE_TEMPLATE/feature_request.yml
+++ b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -1,5 +1,5 @@
name: Feature request
-description: Suggest an idea or improvement for Eve.
+description: Suggest an idea or improvement for eve.
labels: ["enhancement"]
body:
- type: textarea
diff --git a/.github/workflows/bundle-analysis.yml b/.github/workflows/bundle-analysis.yml
index 4fab9726f..72a682999 100644
--- a/.github/workflows/bundle-analysis.yml
+++ b/.github/workflows/bundle-analysis.yml
@@ -120,7 +120,7 @@ jobs:
working-directory: ${{ steps.baseline.outputs.root }}
run: pnpm install --frozen-lockfile
- - name: Build Eve package on main baseline
+ - name: Build eve package on main baseline
if: ${{ steps.mode.outputs.acknowledge_only != 'true' && github.event_name == 'pull_request' }}
working-directory: ${{ steps.baseline.outputs.root }}
run: pnpm --filter eve build
@@ -169,7 +169,7 @@ jobs:
--package-label packages/eve \
--output-json "$BASELINE_REPORT_JSON"
- - name: Build Eve package
+ - name: Build eve package
if: ${{ steps.mode.outputs.acknowledge_only != 'true' }}
run: pnpm --filter eve build
diff --git a/.github/workflows/container.yml b/.github/workflows/container.yml
index 870a721ef..1056d7e5c 100644
--- a/.github/workflows/container.yml
+++ b/.github/workflows/container.yml
@@ -71,8 +71,8 @@ jobs:
push: ${{ github.event_name != 'pull_request' }}
tags: ${{ steps.meta.outputs.tags }}
labels: |
- org.opencontainers.image.title=Eve Sandbox
- org.opencontainers.image.description=Sandbox base image for Eve agents.
+ org.opencontainers.image.title=eve Sandbox
+ org.opencontainers.image.description=Sandbox base image for eve agents.
org.opencontainers.image.source=https://github.com/vercel/eve
cache-from: type=gha
cache-to: type=gha,mode=max
diff --git a/.github/workflows/e2e-local.yml b/.github/workflows/e2e-local.yml
index a76e57648..bcc1170d8 100644
--- a/.github/workflows/e2e-local.yml
+++ b/.github/workflows/e2e-local.yml
@@ -59,7 +59,7 @@ jobs:
- name: Install dependencies
run: pnpm install --frozen-lockfile
- - name: Build Eve package
+ - name: Build eve package
# Full build, not build:js: the deployed/runtime bundles must carry the
# stamped package version (scripts/stamp-version-tokens.mjs) and docs.
run: pnpm --filter eve run build
diff --git a/.github/workflows/e2e-vercel.yml b/.github/workflows/e2e-vercel.yml
index b5a0f75d0..c5a9b7775 100644
--- a/.github/workflows/e2e-vercel.yml
+++ b/.github/workflows/e2e-vercel.yml
@@ -62,7 +62,7 @@ jobs:
- name: Install dependencies
run: pnpm install --frozen-lockfile
- - name: Build Eve package
+ - name: Build eve package
# Full build, not build:js: the deployed/runtime bundles must carry the
# stamped package version (scripts/stamp-version-tokens.mjs) and docs.
run: pnpm --filter eve run build
diff --git a/AGENTS.md b/AGENTS.md
index 6b8b7ac03..ae25419c9 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -3,11 +3,11 @@
Guidance for coding agents (and humans) working in this repository. For setup,
PR workflow, and release process, see [CONTRIBUTING.md](./CONTRIBUTING.md).
-## About Eve
+## About eve
-Eve is a filesystem-first framework for durable backend AI agents. You author
+eve is a filesystem-first framework for durable backend AI agents. You author
an agent as a directory on disk — instructions, skills, tools, connections,
-channels, subagents, and schedules are all files — and Eve compiles and runs it.
+channels, subagents, and schedules are all files — and eve compiles and runs it.
See the [README](./README.md) for the full overview and
[`docs/`](./docs) for user-facing documentation.
@@ -55,12 +55,12 @@ or scenario fixtures. Nothing is done until `typecheck`, `lint`, `fmt`,
2. **Small modules over big helpers.** Favor composable primitives with narrow
responsibilities. Split files that carry multiple concerns.
-3. **Wrap third-party dependencies.** Do not expose third-party APIs as Eve
- public APIs. Wrap them in Eve-owned surfaces so internals can change freely.
+3. **Wrap third-party dependencies.** Do not expose third-party APIs as eve
+ public APIs. Wrap them in eve-owned surfaces so internals can change freely.
Add runtime `dependencies` only as a last resort: prefer vendoring code or
generated artifacts into the repository and listing the source package under
`devDependencies`. The `eve` package should aim to keep `nitro` as its only
- runtime dependency. This keeps Eve installs as small as possible and avoids
+ runtime dependency. This keeps eve installs as small as possible and avoids
exposure to hijacked nested dependencies that are not pinned directly in the
main lockfile.
@@ -173,7 +173,7 @@ claiming verification passed. See [`e2e/README.md`](./e2e/README.md).
## Changesets
Every PR that touches the published `eve` package must include a
-changeset (`pnpm changeset`). Because Eve is pre-1.0, use `patch` in most
+changeset (`pnpm changeset`). Because eve is pre-1.0, use `patch` in most
cases, including bug fixes and new features. Use `minor` only when the change
breaks a public API. Write the body for someone reading release notes — what
changed and what they'll see differently, in 1–2 sentences.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 5a263c027..dd1875bc6 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,4 +1,4 @@
-# Contributing to Eve
+# Contributing to eve
Thanks for your interest in contributing! This guide covers everything you need to get the repo running locally and land a change.
diff --git a/Dockerfile b/Dockerfile
index 4c99ebec1..27887e0e8 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -6,7 +6,7 @@ ARG DEBIAN_FRONTEND=noninteractive
ARG NODE_MAJOR=24
ARG PNPM_VERSION=11.5.2
-LABEL org.opencontainers.image.description="Sandbox base image for Eve agents."
+LABEL org.opencontainers.image.description="Sandbox base image for eve agents."
LABEL org.opencontainers.image.source="https://github.com/vercel/eve"
SHELL ["/bin/bash", "-o", "pipefail", "-c"]
diff --git a/README.md b/README.md
index 7d9c48df8..c440635d8 100644
--- a/README.md
+++ b/README.md
@@ -2,10 +2,10 @@
<a href="https://github.com/vercel/eve">
<picture>
<source media="(prefers-color-scheme: dark)" srcset=".github/assets/eve.svg">
- <img alt="Eve logo" src=".github/assets/eve.svg" height="128">
+ <img alt="eve logo" src=".github/assets/eve.svg" height="128">
</picture>
</a>
- <h1>Eve</h1>
+ <h1>eve</h1>
<a href="https://vercel.com"><img alt="Vercel logo" src="https://img.shields.io/badge/MADE%20BY%20Vercel-000000.svg?style=for-the-badge&logo=Vercel&labelColor=000"></a>
<a href="https://www.npmjs.com/package/eve"><img alt="NPM version" src="https://img.shields.io/npm/v/eve.svg?style=for-the-badge&labelColor=000000"></a>
@@ -14,12 +14,12 @@
</div>
-Eve is a filesystem-first framework for durable AI agents. Core agent capabilities live in
+eve is a filesystem-first framework for durable AI agents. Core agent capabilities live in
conventional locations, so projects are easier to inspect, extend, and operate.
## The filesystem is the authoring interface
-A typical Eve agent has this structure:
+A typical eve agent has this structure:
```text
my-agent/
@@ -47,7 +47,7 @@ npx eve@latest init my-agent
This creates a new `my-agent` directory, installs its dependencies, initializes Git, and starts
the interactive terminal UI.
-To add Eve to an existing project, pass a path:
+To add eve to an existing project, pass a path:
```bash
cd myapp
@@ -103,7 +103,7 @@ walkthrough.
## Community
-The Eve community lives on [GitHub Discussions](https://github.com/vercel/eve/discussions),
+The eve community lives on [GitHub Discussions](https://github.com/vercel/eve/discussions),
where you can ask questions, share ideas, and show what you've built.
## Contributing
@@ -122,5 +122,5 @@ Please do not open public issues for security vulnerabilities. Instead, follow
## Beta terms
-Eve is currently in beta and subject to the [Vercel beta terms](https://vercel.com/docs/release-phases/public-beta-agreement);
+eve is currently in beta and subject to the [Vercel beta terms](https://vercel.com/docs/release-phases/public-beta-agreement);
the framework, APIs, documentation, and behavior may change before general availability.
diff --git a/SKILL.md b/SKILL.md
index c480823d0..4f6778efb 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -1,13 +1,13 @@
---
name: eve
-description: Build durable backend AI agents with the Eve framework. Use when creating, editing, or debugging an Eve project — agent instructions, skills, tools, connections, channels, sandboxes, subagents, schedules, or evals.
+description: Build durable backend AI agents with the eve framework. Use when creating, editing, or debugging an eve project — agent instructions, skills, tools, connections, channels, sandboxes, subagents, schedules, or evals.
---
-# Eve
+# eve
-Eve is a filesystem-first framework for durable backend AI agents. An agent is
+eve is a filesystem-first framework for durable backend AI agents. An agent is
a directory on disk — instructions, skills, tools, connections, channels,
-subagents, and schedules are all files — and Eve compiles and runs it.
+subagents, and schedules are all files — and eve compiles and runs it.
## Source of truth
@@ -20,7 +20,7 @@ node_modules/eve/docs/
```
Start with `node_modules/eve/docs/README.md`. It contains the full
-index and recommended reading order. Before writing any Eve code, read the
+index and recommended reading order. Before writing any eve code, read the
relevant guide there first.
If `eve` is not installed yet, install it (`npm install eve`) or scaffold a new
diff --git a/apps/docs/app/[lang]/(home)/page.tsx b/apps/docs/app/[lang]/(home)/page.tsx
index 5cb821455..16dc6536e 100644
--- a/apps/docs/app/[lang]/(home)/page.tsx
+++ b/apps/docs/app/[lang]/(home)/page.tsx
@@ -7,7 +7,7 @@ import { CTA } from "./components/cta";
import { FeatureGrid } from "./components/feature-grid";
import { FileTree } from "./components/file-tree";
-const title = "Eve";
+const title = "eve";
const tagline = "Like Next.js for web apps, but for agents.";
const description =
"Markdown for instructions and skills, TypeScript for tools. Durable by default.";
diff --git a/apps/docs/app/[lang]/integrations/page.tsx b/apps/docs/app/[lang]/integrations/page.tsx
index 297ea95fb..10a4ded03 100644
--- a/apps/docs/app/[lang]/integrations/page.tsx
+++ b/apps/docs/app/[lang]/integrations/page.tsx
@@ -5,7 +5,7 @@ import { Gallery } from "./components/gallery";
const title = "Integrations";
const description =
- "Browse every third-party service Eve connects to: messaging channels and MCP connections, each with install, quick start, and configuration steps.";
+ "Browse every third-party service eve connects to: messaging channels and MCP connections, each with install, quick start, and configuration steps.";
export const metadata: Metadata = {
title,
@@ -21,7 +21,7 @@ const IntegrationsPage = () => (
Integrations
</h1>
<p className="mt-5 max-w-2xl text-gray-900 text-lg">
- Connect Eve to the services your agent needs, including messaging channels and tool
+ Connect eve to the services your agent needs, including messaging channels and tool
connections over MCP or OpenAPI.
</p>
</section>
diff --git a/apps/docs/geistdocs.tsx b/apps/docs/geistdocs.tsx
index 52fa814e0..bf7f574e0 100644
--- a/apps/docs/geistdocs.tsx
+++ b/apps/docs/geistdocs.tsx
@@ -1,6 +1,6 @@
export const Logo = () => (
<span className="flex items-center gap-2">
- <span className="font-semibold text-gray-1000 text-lg leading-none">Eve</span>
+ <span className="font-semibold text-gray-1000 text-lg leading-none">eve</span>
<span className="rounded-full border border-blue-300 px-2 py-0.5 font-medium text-blue-700 text-xs leading-none">
Beta
</span>
@@ -36,7 +36,7 @@ export const suggestions = [
export const agent = {
product: {
- name: "Eve",
+ name: "eve",
description:
"A filesystem-first framework for building durable agents on Vercel with markdown instructions, TypeScript tools, and built-in runtime primitives.",
category: "Agent framework",
@@ -48,7 +48,7 @@ export const agent = {
],
},
instructions: [
- "To create or extend an Eve agent for the user, start from the Getting Started guide — get it as Markdown from /llms.mdx/getting-started (or via /llms.txt).",
+ "To create or extend an eve agent for the user, start from the Getting Started guide — get it as Markdown from /llms.mdx/getting-started (or via /llms.txt).",
"Ask the user only for genuine decisions (name, model, channels, provider, deploy) and for browser/OAuth steps (vercel login, vercel link, vercel connect create slack); automate everything else.",
"Verify setup with `eve info --json` and `eve channels list --json` before reporting success.",
"Use /sitemap.md to identify the most relevant documentation pages before answering broad questions.",
@@ -58,10 +58,10 @@ export const agent = {
],
};
-export const title = "Eve Documentation";
+export const title = "eve Documentation";
export const prompt =
- "You are a helpful assistant specializing in Eve, a filesystem-first framework for building durable agents on Vercel. You help users understand how to build agents using markdown for instructions, TypeScript for tools, and the framework's built-in durability, governance, and observability features.";
+ "You are a helpful assistant specializing in eve, a filesystem-first framework for building durable agents on Vercel. You help users understand how to build agents using markdown for instructions, TypeScript for tools, and the framework's built-in durability, governance, and observability features.";
export const translations = {
en: {
diff --git a/apps/docs/lib/integrations/data.ts b/apps/docs/lib/integrations/data.ts
index efb099d2d..ac8e86ac6 100644
--- a/apps/docs/lib/integrations/data.ts
+++ b/apps/docs/lib/integrations/data.ts
@@ -101,7 +101,7 @@ const channelPresentations: Record<string, ChannelPresentation> = {
logo: "slack",
docsHref: "/docs/channels/slack",
keywords: ["chat", "messaging", "bot", "webhook"],
- install: `The Eve CLI scaffolds the channel for you. \`eve channels add slack\` writes \`agent/channels/slack.ts\`, adds \`@vercel/connect\`, and runs the Connect setup flow:
+ install: `The eve CLI scaffolds the channel for you. \`eve channels add slack\` writes \`agent/channels/slack.ts\`, adds \`@vercel/connect\`, and runs the Connect setup flow:
\`\`\`bash
eve channels add slack
@@ -130,7 +130,7 @@ Link the project and pull OIDC env vars so Connect can authenticate locally:
vercel link
vercel env pull
\`\`\``,
- configure: `Create a Slack Connect client and copy its UID (for example \`slack/my-agent\`), then attach this project as the webhook trigger destination at the route Eve serves (\`/eve/v1/slack\`):
+ configure: `Create a Slack Connect client and copy its UID (for example \`slack/my-agent\`), then attach this project as the webhook trigger destination at the route eve serves (\`/eve/v1/slack\`):
\`\`\`bash
vercel connect create slack --triggers
@@ -158,7 +158,7 @@ export default discordChannel({
publicKey: () => process.env.DISCORD_PUBLIC_KEY!,
});
\`\`\``,
- configure: `Create a Discord application, add a bot, and set the interactions endpoint URL to the route Eve serves (\`/eve/v1/discord\`). Provide the bot token and public key through environment variables. See the [Discord channel docs](/docs/channels/discord) for intents and slash-command setup.`,
+ configure: `Create a Discord application, add a bot, and set the interactions endpoint URL to the route eve serves (\`/eve/v1/discord\`). Provide the bot token and public key through environment variables. See the [Discord channel docs](/docs/channels/discord) for intents and slash-command setup.`,
},
teams: {
logo: "teams",
@@ -180,7 +180,7 @@ export default teamsChannel({
appPassword: () => process.env.TEAMS_APP_PASSWORD!,
});
\`\`\``,
- configure: `Register an Azure Bot, configure the messaging endpoint to Eve's route (\`/eve/v1/teams\`), and supply the app ID and password via environment variables. See the [Teams channel docs](/docs/channels/teams) for the full provisioning checklist.`,
+ configure: `Register an Azure Bot, configure the messaging endpoint to eve's route (\`/eve/v1/teams\`), and supply the app ID and password via environment variables. See the [Teams channel docs](/docs/channels/teams) for the full provisioning checklist.`,
},
telegram: {
logo: "telegram",
@@ -201,7 +201,7 @@ export default telegramChannel({
botToken: () => process.env.TELEGRAM_BOT_TOKEN!,
});
\`\`\``,
- configure: `Create a bot with [@BotFather](https://t.me/botfather), then register the webhook to point at Eve's route (\`/eve/v1/telegram\`). Store the bot token in an environment variable. See the [Telegram channel docs](/docs/channels/telegram) for group privacy and command setup.`,
+ configure: `Create a bot with [@BotFather](https://t.me/botfather), then register the webhook to point at eve's route (\`/eve/v1/telegram\`). Store the bot token in an environment variable. See the [Telegram channel docs](/docs/channels/telegram) for group privacy and command setup.`,
},
twilio: {
logo: "twilio",
@@ -223,7 +223,7 @@ export default twilioChannel({
authToken: () => process.env.TWILIO_AUTH_TOKEN!,
});
\`\`\``,
- configure: `In the Twilio console, point your messaging service or phone number webhook at Eve's route (\`/eve/v1/twilio\`). Provide the account SID and auth token via environment variables. See the [Twilio channel docs](/docs/channels/twilio) for SMS vs. WhatsApp specifics.`,
+ configure: `In the Twilio console, point your messaging service or phone number webhook at eve's route (\`/eve/v1/twilio\`). Provide the account SID and auth token via environment variables. See the [Twilio channel docs](/docs/channels/twilio) for SMS vs. WhatsApp specifics.`,
},
github: {
logo: "github",
@@ -246,7 +246,7 @@ export default githubChannel({
webhookSecret: () => process.env.GITHUB_WEBHOOK_SECRET!,
});
\`\`\``,
- configure: `Create a GitHub App, subscribe to issue and pull-request events, and set the webhook URL to Eve's route (\`/eve/v1/github\`). Provide the app ID, private key, and webhook secret through environment variables. See the [GitHub channel docs](/docs/channels/github) for required permissions.`,
+ configure: `Create a GitHub App, subscribe to issue and pull-request events, and set the webhook URL to eve's route (\`/eve/v1/github\`). Provide the app ID, private key, and webhook secret through environment variables. See the [GitHub channel docs](/docs/channels/github) for required permissions.`,
},
"linear-agent": {
logo: "linear",
@@ -270,13 +270,13 @@ export default linearChannel({
},
});
\`\`\``,
- configure: `Create a Linear OAuth app with Agent Session events enabled, make the app assignable and mentionable, and point the webhook at Eve's route (\`/eve/v1/linear\`). Provide the app access token and webhook secret through environment variables. See the [Linear channel docs](/docs/channels/linear) for scopes and Agent Activity behavior.`,
+ configure: `Create a Linear OAuth app with Agent Session events enabled, make the app assignable and mentionable, and point the webhook at eve's route (\`/eve/v1/linear\`). Provide the app access token and webhook secret through environment variables. See the [Linear channel docs](/docs/channels/linear) for scopes and Agent Activity behavior.`,
},
eve: {
logo: "eve",
docsHref: "/docs/channels/eve",
keywords: ["web", "chat", "ui", "embed", "frontend"],
- install: `The Eve CLI scaffolds the full Next.js web chat app alongside \`agent/channels/eve.ts\`:
+ install: `The eve CLI scaffolds the full Next.js web chat app alongside \`agent/channels/eve.ts\`:
\`\`\`bash
eve channels add web
@@ -287,7 +287,7 @@ To wire it up by hand instead, install the framework:
\`\`\`bash
npm install eve@latest
\`\`\``,
- quickStart: `The Eve channel is on by default. Add \`agent/channels/eve.ts\` only when you want to override the default session routes or auth:
+ quickStart: `The eve channel is on by default. Add \`agent/channels/eve.ts\` only when you want to override the default session routes or auth:
\`\`\`ts
// agent/channels/eve.ts
@@ -296,8 +296,8 @@ import { eveChannel } from "eve/channels/eve";
export default eveChannel();
\`\`\`
-Point your frontend at the session routes Eve serves (\`/eve/v1/session\`) and stream responses with the Eve web client.`,
- configure: `The Eve channel is the lowest-friction way to talk to your agent, with no third-party provisioning required. Layer in auth and route protection as needed. See the [Eve channel docs](/docs/channels/eve) and the [Frontend guide](/docs/guides/frontend/overview).`,
+Point your frontend at the session routes eve serves (\`/eve/v1/session\`) and stream responses with the eve web client.`,
+ configure: `The eve channel is the lowest-friction way to talk to your agent, with no third-party provisioning required. Layer in auth and route protection as needed. See the [eve channel docs](/docs/channels/eve) and the [Frontend guide](/docs/guides/frontend/overview).`,
},
};
diff --git a/apps/docs/package.json b/apps/docs/package.json
index fba9fd38f..6625af244 100644
--- a/apps/docs/package.json
+++ b/apps/docs/package.json
@@ -2,7 +2,7 @@
"name": "eve-docs",
"version": "0.0.1",
"private": true,
- "description": "Eve documentation site.",
+ "description": "eve documentation site.",
"type": "module",
"scripts": {
"build": "next build",
diff --git a/apps/fixtures/README.md b/apps/fixtures/README.md
index 7e0653f69..5bc2c15dd 100644
--- a/apps/fixtures/README.md
+++ b/apps/fixtures/README.md
@@ -1,6 +1,6 @@
# App fixtures
-These apps are shared development fixtures. They are real Eve apps that CI or
+These apps are shared development fixtures. They are real eve apps that CI or
local smokes may build and boot, so package names are part of the test target
surface.
diff --git a/apps/fixtures/weather-agent/README.md b/apps/fixtures/weather-agent/README.md
index 9bad9a323..8e4cf36f7 100644
--- a/apps/fixtures/weather-agent/README.md
+++ b/apps/fixtures/weather-agent/README.md
@@ -1,8 +1,8 @@
# Weather agent
-The weather-focused Eve fixture. It backs the repo root `pnpm dev`, the
+The weather-focused eve fixture. It backs the repo root `pnpm dev`, the
bundle-analysis workflow, and manual smoke testing as a small representative
-Eve app:
+eve app:
- `agent/agent.ts` — model config (`openai/gpt-5.5` with adaptive
thinking)
diff --git a/apps/frameworks/README.md b/apps/frameworks/README.md
index 5fc2bf788..f36feef15 100644
--- a/apps/frameworks/README.md
+++ b/apps/frameworks/README.md
@@ -1,6 +1,6 @@
# Framework apps
-These apps verify Eve's frontend framework integrations and act as runnable examples for maintainers.
+These apps verify eve's frontend framework integrations and act as runnable examples for maintainers.
- `framework-next` covers `eve/next` and `withEve()`.
- `framework-nuxt` covers the `eve/nuxt` module.
diff --git a/apps/frameworks/next/.gitignore b/apps/frameworks/next/.gitignore
index 8fee41785..2756c2b01 100644
--- a/apps/frameworks/next/.gitignore
+++ b/apps/frameworks/next/.gitignore
@@ -33,7 +33,7 @@ yarn-error.log*
# env files (can opt-in for committing if needed)
.env*
-# Eve
+# eve
.eve
.swc
.output
diff --git a/apps/frameworks/next/README.md b/apps/frameworks/next/README.md
index 4891d1547..114b89c63 100644
--- a/apps/frameworks/next/README.md
+++ b/apps/frameworks/next/README.md
@@ -1,4 +1,4 @@
-# Next.js with Eve demo
+# Next.js with eve demo
To run locally, call
@@ -7,20 +7,20 @@ pnpm --filter framework-next dev
```
The Next.js config uses `withEve()` from `eve/next`. In local
-development it starts Eve on a random available port and rewrites same-origin
-Eve endpoints like `/eve/v1/session` to that server.
+development it starts eve on a random available port and rewrites same-origin
+eve endpoints like `/eve/v1/session` to that server.
-Set `EVE_BASE_URL` before starting Next.js to reuse an already-running Eve
+Set `EVE_BASE_URL` before starting Next.js to reuse an already-running eve
server instead of letting `withEve()` start one.
When a linked Vercel project is detected, `withEve()` writes generated
`experimentalServices` to `.vercel/output/config.json` for Next.js at `/` and
-Eve behind the private `/_eve_internal/eve` service prefix. Next.js rewrites
-the public Eve endpoints to that private service so the Eve index route is not
+eve behind the private `/_eve_internal/eve` service prefix. Next.js rewrites
+the public eve endpoints to that private service so the eve index route is not
exposed at the site root.
For non-Vercel production hosts, set `EVE_NEXT_PRODUCTION_ORIGIN` to the public
-origin that serves the Eve service namespace before building the Next.js app.
+origin that serves the eve service namespace before building the Next.js app.
For local production builds, `withEve()` uses `http://127.0.0.1:4274` as the
-stable Eve origin. Set `EVE_NEXT_PRODUCTION_PORT` before `next build` and
+stable eve origin. Set `EVE_NEXT_PRODUCTION_PORT` before `next build` and
`next start` to choose a different local port.
diff --git a/apps/frameworks/next/app/_chat/App.tsx b/apps/frameworks/next/app/_chat/App.tsx
index c0b171884..fee46a885 100644
--- a/apps/frameworks/next/app/_chat/App.tsx
+++ b/apps/frameworks/next/app/_chat/App.tsx
@@ -164,7 +164,7 @@ export function App() {
</div>
) : (
<div className="empty-state">
- <h1 className="wordmark">Eve Agent</h1>
+ <h1 className="wordmark">eve Agent</h1>
{composerForm}
</div>
)}
diff --git a/apps/frameworks/next/app/layout.tsx b/apps/frameworks/next/app/layout.tsx
index 43e7c7248..38565cbed 100644
--- a/apps/frameworks/next/app/layout.tsx
+++ b/apps/frameworks/next/app/layout.tsx
@@ -13,7 +13,7 @@ const geistMono = Geist_Mono({
});
export const metadata: Metadata = {
- title: "Next.js + Eve",
+ title: "Next.js + eve",
};
export default function RootLayout({
diff --git a/apps/frameworks/next/eslint.config.mjs b/apps/frameworks/next/eslint.config.mjs
index a3351feb4..657e6cee0 100644
--- a/apps/frameworks/next/eslint.config.mjs
+++ b/apps/frameworks/next/eslint.config.mjs
@@ -13,7 +13,7 @@ const eslintConfig = defineConfig([
"out/**",
"build/**",
"next-env.d.ts",
- // Chat UI is a thin wrapper around the Eve runtime HTTP surface. Skip the
+ // Chat UI is a thin wrapper around the eve runtime HTTP surface. Skip the
// Next.js lints here so it can stay focused on the agent transport contract.
"app/_chat/**",
]),
diff --git a/apps/frameworks/nuxt/.gitignore b/apps/frameworks/nuxt/.gitignore
index 9e0a5821d..b7b235fab 100644
--- a/apps/frameworks/nuxt/.gitignore
+++ b/apps/frameworks/nuxt/.gitignore
@@ -6,7 +6,7 @@
.cache
dist
-# Eve runtime data
+# eve runtime data
.eve
.workflow-data
diff --git a/apps/frameworks/nuxt/README.md b/apps/frameworks/nuxt/README.md
index 4037c3f2e..193dfe786 100644
--- a/apps/frameworks/nuxt/README.md
+++ b/apps/frameworks/nuxt/README.md
@@ -1,6 +1,6 @@
-# Nuxt with Eve demo
+# Nuxt with eve demo
-A Nuxt 4 app with an embedded Eve agent, integrated through the `eve/nuxt`
+A Nuxt 4 app with an embedded eve agent, integrated through the `eve/nuxt`
module:
```ts
@@ -10,8 +10,8 @@ export default defineNuxtConfig({
```
The agent lives in `agent/` (instructions, tools, channels) next to the Nuxt
-`app/` directory. In local development the module starts the Eve runtime
-alongside the Nuxt dev server and proxies same-origin Eve endpoints to it.
+`app/` directory. In local development the module starts the eve runtime
+alongside the Nuxt dev server and proxies same-origin eve endpoints to it.
## Run locally
@@ -21,6 +21,6 @@ pnpm --filter framework-nuxt dev
## Deploy
-`vercel.json` declares two services: the Nuxt app at `/` and Eve behind the
+`vercel.json` declares two services: the Nuxt app at `/` and eve behind the
private `/_eve_internal/eve` service prefix. See
[the Nuxt frontend docs](../../../docs/guides/frontend/nuxt.mdx) for details.
diff --git a/apps/frameworks/nuxt/app/components/EveAgentConsole.vue b/apps/frameworks/nuxt/app/components/EveAgentConsole.vue
index 0acc8dff4..86be6bcc7 100644
--- a/apps/frameworks/nuxt/app/components/EveAgentConsole.vue
+++ b/apps/frameworks/nuxt/app/components/EveAgentConsole.vue
@@ -91,7 +91,7 @@ function partKey(part: EveMessagePart, index: number): string {
v-if="isEmpty"
class="flex flex-1 flex-col items-center justify-center gap-2 px-6 py-16 text-center"
>
- <h1 class="text-xl font-medium tracking-tight">Eve Agent</h1>
+ <h1 class="text-xl font-medium tracking-tight">eve Agent</h1>
<p class="max-w-sm text-sm text-muted-foreground">
Ask for the weather in Vienna, or tell the agent to explain the tools it called.
</p>
diff --git a/apps/frameworks/nuxt/app/pages/index.vue b/apps/frameworks/nuxt/app/pages/index.vue
index 42b7bfa4d..0a9c12750 100644
--- a/apps/frameworks/nuxt/app/pages/index.vue
+++ b/apps/frameworks/nuxt/app/pages/index.vue
@@ -1,6 +1,6 @@
<script setup lang="ts">
useSeoMeta({
- title: "Nuxt Eve Agent",
+ title: "Nuxt eve Agent",
description: "A Nuxt app for testing useEveAgent.",
});
</script>
diff --git a/apps/frameworks/sveltekit/README.md b/apps/frameworks/sveltekit/README.md
index 09de8c08b..fd982e5cc 100644
--- a/apps/frameworks/sveltekit/README.md
+++ b/apps/frameworks/sveltekit/README.md
@@ -1,6 +1,6 @@
-# SvelteKit with Eve demo
+# SvelteKit with eve demo
-A SvelteKit app with an embedded Eve agent, integrated through the
+A SvelteKit app with an embedded eve agent, integrated through the
`eveSvelteKit()` Vite plugin:
```ts
@@ -12,7 +12,7 @@ export default defineConfig({
```
The agent lives in `agent/` (instructions, tools, channels). The UI in
-`src/lib/` is a small agent console built on Eve's Svelte hooks, with
+`src/lib/` is a small agent console built on eve's Svelte hooks, with
streaming, reasoning, and tool-call rendering.
## Run locally
@@ -23,7 +23,7 @@ pnpm --filter framework-sveltekit dev
## Deploy
-`vercel.json` declares two services: the SvelteKit app at `/` and Eve behind
+`vercel.json` declares two services: the SvelteKit app at `/` and eve behind
the private `/_eve_internal/eve` service prefix, with rewrites exposing the
public `/eve/v1/*` endpoints. See
[the SvelteKit frontend docs](../../../docs/guides/frontend/sveltekit.mdx) for
diff --git a/apps/frameworks/sveltekit/src/lib/EveAgentConsole.svelte b/apps/frameworks/sveltekit/src/lib/EveAgentConsole.svelte
index 8c5fae902..8e7d7fae0 100644
--- a/apps/frameworks/sveltekit/src/lib/EveAgentConsole.svelte
+++ b/apps/frameworks/sveltekit/src/lib/EveAgentConsole.svelte
@@ -97,7 +97,7 @@
{#if isEmpty}
<div class="flex flex-1 flex-col items-center justify-center gap-2 px-6 py-16 text-center">
- <h1 class="text-xl font-medium tracking-tight">Eve Agent</h1>
+ <h1 class="text-xl font-medium tracking-tight">eve Agent</h1>
<p class="max-w-sm text-sm text-muted-foreground">
Ask for the weather in Vienna, or tell the agent to explain the tools it called.
</p>
diff --git a/apps/frameworks/sveltekit/src/routes/+page.svelte b/apps/frameworks/sveltekit/src/routes/+page.svelte
index 70f14950a..2e6d1e059 100644
--- a/apps/frameworks/sveltekit/src/routes/+page.svelte
+++ b/apps/frameworks/sveltekit/src/routes/+page.svelte
@@ -3,10 +3,10 @@
</script>
<svelte:head>
- <title>Eve Agent</title>
+ <title>eve Agent</title>
<meta
name="description"
- content="Ask an Eve agent questions and inspect streamed reasoning and tool calls."
+ content="Ask an eve agent questions and inspect streamed reasoning and tool calls."
/>
</svelte:head>
diff --git a/apps/templates/web-chat-next/README.md b/apps/templates/web-chat-next/README.md
index 0b972a693..006316d58 100644
--- a/apps/templates/web-chat-next/README.md
+++ b/apps/templates/web-chat-next/README.md
@@ -1,6 +1,6 @@
# Web Chat Next template
-A small Next.js app that acts as the source for Eve's generated Web Chat template.
+A small Next.js app that acts as the source for eve's generated Web Chat template.
## Usage
@@ -11,11 +11,11 @@ pnpm --filter web-chat-next-template dev
```
The Next.js config uses `withEve()` from `eve/next`. In local
-development it starts the app-local Eve agent on a random available port and
-rewrites same-origin Eve endpoints like `/eve/v1/session` to that server, so
+development it starts the app-local eve agent on a random available port and
+rewrites same-origin eve endpoints like `/eve/v1/session` to that server, so
the client component can use `useEveAgent()` without configuring a host.
-Set `EVE_BASE_URL` before starting Next.js to reuse an already-running Eve
+Set `EVE_BASE_URL` before starting Next.js to reuse an already-running eve
server instead of letting `withEve()` start one:
```bash
@@ -24,8 +24,8 @@ EVE_BASE_URL=http://localhost:3000 pnpm --filter web-chat-next-template dev
When a linked Vercel project is detected, `withEve()` writes generated
`experimentalServices` to `.vercel/output/config.json` so Next.js deploys at
-`/` and the app-local Eve agent runs behind the private
-`/_eve_internal/eve` service prefix, then rewrites public Eve endpoints to that
+`/` and the app-local eve agent runs behind the private
+`/_eve_internal/eve` service prefix, then rewrites public eve endpoints to that
private service.
## Scaffold Source
diff --git a/apps/templates/web-chat-next/agent/channels/eve.ts b/apps/templates/web-chat-next/agent/channels/eve.ts
index 35f8a0856..9c665bea5 100644
--- a/apps/templates/web-chat-next/agent/channels/eve.ts
+++ b/apps/templates/web-chat-next/agent/channels/eve.ts
@@ -5,7 +5,7 @@ export default eveChannel({
auth: [
// Open on localhost for `eve dev` and the REPL; ignored in production.
localDev(),
- // Lets the Eve TUI and your Vercel deployments reach the deployed agent.
+ // Lets the eve TUI and your Vercel deployments reach the deployed agent.
vercelOidc(),
// This placeholder will not allow browser requests in production.
// Replace it with your app's auth provider, like Auth.js or Clerk,
diff --git a/apps/templates/web-chat-next/agent/instructions.md b/apps/templates/web-chat-next/agent/instructions.md
index e3fc0546b..f7bd5f2d2 100644
--- a/apps/templates/web-chat-next/agent/instructions.md
+++ b/apps/templates/web-chat-next/agent/instructions.md
@@ -1,3 +1,3 @@
-You are a concise assistant for an Eve and Next.js starter app.
+You are a concise assistant for an eve and Next.js starter app.
Use the randomize tool whenever the user wants a random number, a coin flip, a dice roll, or a random pick from a list of options. When you use a tool, summarize the result in a clear, conversational response.
diff --git a/apps/templates/web-chat-next/app/layout.tsx b/apps/templates/web-chat-next/app/layout.tsx
index 220f6e5e0..e7c6b3739 100644
--- a/apps/templates/web-chat-next/app/layout.tsx
+++ b/apps/templates/web-chat-next/app/layout.tsx
@@ -20,8 +20,8 @@ const mono = Geist_Mono({
});
export const metadata: Metadata = {
- title: "Eve Next.js Starter",
- description: "A Next.js starter for Eve agents with AI Elements.",
+ title: "eve Next.js Starter",
+ description: "A Next.js starter for eve agents with AI Elements.",
};
export default function RootLayout({ children }: { readonly children: ReactNode }) {
diff --git a/docs/README.md b/docs/README.md
index 64fe1e164..636bda82e 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,28 +1,28 @@
-# Eve Public Docs
+# eve Public Docs
-This folder is for app authors using Eve as a framework.
+This folder is for app authors using eve as a framework.
-If you want to understand how to build agents with Eve, start here.
+If you want to understand how to build agents with eve, start here.
Important naming note:
-- The framework is called Eve.
+- The framework is called eve.
- The current published package name is `eve`.
- The CLI binary is `eve`.
## Legal and safeguards
-Eve is currently a preview and subject to the Vercel beta terms; the framework, APIs, documentation, and behavior may change before general availability.
+eve is currently a preview and subject to the Vercel beta terms; the framework, APIs, documentation, and behavior may change before general availability.
As the deployer, it is your responsibility to ensure your agent complies with applicable laws.
You are responsible for configuring approval policies, tool restrictions, connection scopes, route/session authorization, sandbox controls, telemetry exports, and other safeguards appropriate for your use case.
-Before using Eve with non-public, sensitive, regulated, or production data, review which default tools, custom tools, MCP tools, shell/file/web tools, connected services, subagents, schedules, and external actions are available to the agent.
+Before using eve with non-public, sensitive, regulated, or production data, review which default tools, custom tools, MCP tools, shell/file/web tools, connected services, subagents, schedules, and external actions are available to the agent.
Require human approval or other safeguards for sensitive, irreversible, regulated, financial, healthcare, employment, housing, legal, safety-impacting, user-impacting, or external side-effecting actions.
-Unless you configure stricter controls, Eve agents may operate with permissive settings, including tool execution without human approval where approval is omitted and sandbox network egress that is not deny-all. Do not rely on model behavior alone to prevent sensitive or irreversible actions.
+Unless you configure stricter controls, eve agents may operate with permissive settings, including tool execution without human approval where approval is omitted and sandbox network egress that is not deny-all. Do not rely on model behavior alone to prevent sensitive or irreversible actions.
Casing convention:
@@ -56,7 +56,7 @@ Read in this order:
## The public mental model
-Eve is a filesystem-first framework for durable backend agents.
+eve is a filesystem-first framework for durable backend agents.
You author an agent as files on disk:
@@ -71,7 +71,7 @@ You author an agent as files on disk:
- recurring jobs in `schedules/`
- additive runtime config in `agent.ts`
-Eve then gives you:
+eve then gives you:
- a stable HTTP message route
- optional channel webhook routes
@@ -89,7 +89,7 @@ know:
- the harness does one unit of AI work and decides whether to continue, wait, or finish
- the runtime persists session state, streams events, and owns workflow orchestration
-That is why Eve exposes two identifiers:
+That is why eve exposes two identifiers:
- `continuationToken` for the next user message
- `sessionId` for streaming and inspection
diff --git a/docs/agent-config.md b/docs/agent-config.md
index 6d975f025..a5e0d3345 100644
--- a/docs/agent-config.md
+++ b/docs/agent-config.md
@@ -17,7 +17,7 @@ export default defineAgent({
});
```
-The root `agent.ts` can be omitted when no runtime config is needed. In that case, Eve defaults
+The root `agent.ts` can be omitted when no runtime config is needed. In that case, eve defaults
to `anthropic/claude-sonnet-4.6`. When `agent.ts` is present, `model` is required.
`model` accepts a gateway model id string, which routes through the [Vercel AI Gateway](https://vercel.com/docs/ai-gateway). To call a provider directly and configure the model in code, pass a provider-authored `LanguageModel`:
@@ -57,7 +57,7 @@ See [Default harness](./concepts/default-harness#compaction) for how the loop ap
| `modelOptions` | `AgentModelOptionsDefinition` | none | Provider option overrides forwarded to the model call. |
| `experimental` | `{ codeMode?: boolean }` | flags unset | Opt-in flags that can change or disappear in any release. Treat them as unstable. `codeMode` routes executable tools through a sandboxed code-execution wrapper, where the model writes JavaScript that calls the tools inside the [sandbox](./sandbox). |
| `outputSchema` | Standard Schema or a JSON Schema object | none | Structured return type for task-mode runs (a subagent, schedule, or remote job). Interactive conversation turns ignore it unless the client supplies a per-message schema. |
-| `build` | `{ externalDependencies?: string[] }` | none | Hosted-build packaging controls. `externalDependencies` keeps listed packages external while Eve compiles authored modules such as tools and channels, and traces those packages into the hosted output. |
+| `build` | `{ externalDependencies?: string[] }` | none | Hosted-build packaging controls. `externalDependencies` keeps listed packages external while eve compiles authored modules such as tools and channels, and traces those packages into the hosted output. |
`codeMode` is experimental and may change or be removed.
diff --git a/docs/channels/custom.mdx b/docs/channels/custom.mdx
index 78412e092..a0c0d40c9 100644
--- a/docs/channels/custom.mdx
+++ b/docs/channels/custom.mdx
@@ -3,7 +3,7 @@ title: "Custom Channels"
description: "Author custom HTTP and WebSocket channels with routes, events, metadata, continuation tokens, and file uploads."
---
-When Eve doesn't ship a channel for your surface, you build one. Custom channels expose HTTP or WebSocket endpoints, parse incoming requests, start or resume sessions, observe runtime events, and own delivery back to your platform.
+When eve doesn't ship a channel for your surface, you build one. Custom channels expose HTTP or WebSocket endpoints, parse incoming requests, start or resume sessions, observe runtime events, and own delivery back to your platform.
## File location and identity
@@ -53,7 +53,7 @@ Declare routes with the `POST()` and `GET()` helpers. Each route handler receive
- `waitUntil(promise)` extends the request lifetime for background work.
- `requestIp` is the client IP, or `null` when the host cannot provide it.
-Event handlers like `"message.completed"` are declared under the `events` key. They receive `(eventData, channel, ctx)`, where `eventData` is the event payload, `channel` carries platform handles and session continuation operations, and `ctx` is the Eve `SessionContext`. Every channel kind shares this signature. The one exception is `session.failed`, which receives only `(eventData, channel)` with no `ctx`.
+Event handlers like `"message.completed"` are declared under the `events` key. They receive `(eventData, channel, ctx)`, where `eventData` is the event payload, `channel` carries platform handles and session continuation operations, and `ctx` is the eve `SessionContext`. Every channel kind shares this signature. The one exception is `session.failed`, which receives only `(eventData, channel)` with no `ctx`.
## WebSocket routes
@@ -76,11 +76,11 @@ export default defineChannel({
});
```
-`WS()` handlers receive the same helpers as HTTP route handlers: `send`, `getSession`, `receive`, `params`, `waitUntil`, and `requestIp`. The returned hooks are Eve-owned structural types compatible with Nitro/H3 websocket routing, including `upgrade`, `open`, `message`, `close`, and `error`.
+`WS()` handlers receive the same helpers as HTTP route handlers: `send`, `getSession`, `receive`, `params`, `waitUntil`, and `requestIp`. The returned hooks are eve-owned structural types compatible with Nitro/H3 websocket routing, including `upgrade`, `open`, `message`, `close`, and `error`.
### Node upgrade server escape hatch
-Prefer the `WS()` lifecycle hooks above when you own the websocket behavior. Eve also exposes `createWebSocketUpgradeServer()` for the narrower case where a third-party SDK or framework expects to bind directly to a Node `http.Server` with `server.on("upgrade", ...)`.
+Prefer the `WS()` lifecycle hooks above when you own the websocket behavior. eve also exposes `createWebSocketUpgradeServer()` for the narrower case where a third-party SDK or framework expects to bind directly to a Node `http.Server` with `server.on("upgrade", ...)`.
```ts
import { defineChannel, WS, createWebSocketUpgradeServer } from "eve/channels";
@@ -94,7 +94,7 @@ export default defineChannel({
});
```
-The bridge server does not listen on its own port. It receives only upgrade events that matched the Eve route, and only on hosts where Nitro exposes the raw Node upgrade request, socket, and head. Treat it as a compatibility adapter for libraries with server-binding APIs, not the primary way to build websocket channels in Eve.
+The bridge server does not listen on its own port. It receives only upgrade events that matched the eve route, and only on hosts where Nitro exposes the raw Node upgrade request, socket, and head. Treat it as a compatibility adapter for libraries with server-binding APIs, not the primary way to build websocket channels in eve.
## Cross-channel hand-off
diff --git a/docs/channels/discord.mdx b/docs/channels/discord.mdx
index 587423bab..390064d63 100644
--- a/docs/channels/discord.mdx
+++ b/docs/channels/discord.mdx
@@ -4,7 +4,7 @@ description: "Reach your agent from Discord HTTP Interactions, including slash c
type: integration
---
-The Discord channel wires your agent into Discord's HTTP Interactions, including slash and application commands, message components, and modal submissions. Discord enforces a three-second ACK deadline, so the channel verifies the Ed25519 signature headers, acknowledges the command right away, and runs the Eve work in the background. See [Channels](./overview) for the contract this builds on.
+The Discord channel wires your agent into Discord's HTTP Interactions, including slash and application commands, message components, and modal submissions. Discord enforces a three-second ACK deadline, so the channel verifies the Ed25519 signature headers, acknowledges the command right away, and runs the eve work in the background. See [Channels](./overview) for the contract this builds on.
## Add the channel
@@ -24,12 +24,12 @@ To skip env vars, pass the same values through `credentials: { applicationId, bo
## Register a command
-Registering commands is on you, not the channel. Use Discord's API or the Developer Portal. A string option named `message` lines up with Eve's default prompt extraction:
+Registering commands is on you, not the channel. Use Discord's API or the Developer Portal. A string option named `message` lines up with eve's default prompt extraction:
```bash
curl -X PUT "https://discord.com/api/v10/applications/$DISCORD_APPLICATION_ID/commands" \
-H "Authorization: Bot $DISCORD_BOT_TOKEN" -H "Content-Type: application/json" \
- -d '[{"name":"ask","description":"Ask the Eve agent","type":1,
+ -d '[{"name":"ask","description":"Ask the eve agent","type":1,
"options":[{"name":"message","description":"What should the agent do?","type":3,"required":true}]}]'
```
diff --git a/docs/channels/eve.mdx b/docs/channels/eve.mdx
index 64d4f0400..6f443f77a 100644
--- a/docs/channels/eve.mdx
+++ b/docs/channels/eve.mdx
@@ -1,9 +1,9 @@
---
-title: "Eve"
+title: "eve"
description: "The default HTTP API for an agent, covering session routes, auth, and customization."
---
-The Eve channel is the framework's default HTTP API. It's what the terminal UI, [`useEveAgent`](../guides/frontend/overview), `curl`, and any SDK client talk to when they start sessions, send messages, and stream events. `eveChannel()` mounts the canonical session routes under `/eve/v1/session*`, and they are enabled by default even when `agent/channels/eve.ts` does not exist.
+The eve channel is the framework's default HTTP API. It's what the terminal UI, [`useEveAgent`](../guides/frontend/overview), `curl`, and any SDK client talk to when they start sessions, send messages, and stream events. `eveChannel()` mounts the canonical session routes under `/eve/v1/session*`, and they are enabled by default even when `agent/channels/eve.ts` does not exist.
Reach for it when something needs HTTP access to your agent, including local tooling, a browser frontend, the terminal UI, or another API client. Most apps never write this file. Add `agent/channels/eve.ts` only to override the defaults, usually the route auth policy.
@@ -54,7 +54,7 @@ The `auth` option decides who can call these routes. The built-in helpers cover
Neither admits browser users or external clients in production. For a public app, wire the channel to your own auth (Clerk, Auth.js, or your own OIDC/JWT verification).
-`eve init` scaffolds an `agent/channels/eve.ts` with a production placeholder so you replace it before going live. The generated channel allows Vercel OIDC and localhost, and includes `placeholderAuth()`, which returns a setup-focused 401 in production until you swap it for real auth. Delete the file and Eve falls back to `[localDev(), vercelOidc()]`, which still does not admit browser users in production.
+`eve init` scaffolds an `agent/channels/eve.ts` with a production placeholder so you replace it before going live. The generated channel allows Vercel OIDC and localhost, and includes `placeholderAuth()`, which returns a setup-focused 401 in production until you swap it for real auth. Delete the file and eve falls back to `[localDev(), vercelOidc()]`, which still does not admit browser users in production.
For the full auth model and helper list, see [Auth & route protection](../guides/auth-and-route-protection).
@@ -77,7 +77,7 @@ export default eveChannel({
},
events: {
"message.completed"(eventData, channel, ctx) {
- console.log("Eve response completed", {
+ console.log("eve response completed", {
continuationToken: channel.continuationToken,
sessionId: ctx.session.id,
});
@@ -88,13 +88,13 @@ export default eveChannel({
## Clients
-The browser side of this API lives in the [Frontend](../guides/frontend/overview) docs, where `useEveAgent` drives the Eve channel from React UI.
+The browser side of this API lives in the [Frontend](../guides/frontend/overview) docs, where `useEveAgent` drives the eve channel from React UI.
For scripts, server-to-server calls, evals, tests, and custom clients, use the [TypeScript SDK](../guides/client/overview). It wraps the session routes, continuation token, stream cursor, and reconnect loop.
## What to read next
-- [Frontend](../guides/frontend/overview): drive the Eve channel from browser UI with `useEveAgent`
-- [TypeScript SDK](../guides/client/overview): call the Eve channel from TypeScript
+- [Frontend](../guides/frontend/overview): drive the eve channel from browser UI with `useEveAgent`
+- [TypeScript SDK](../guides/client/overview): call the eve channel from TypeScript
- [Auth & route protection](../guides/auth-and-route-protection): the route auth policy
- [Sessions, runs & streaming](../concepts/sessions-runs-and-streaming): the routes this channel exposes
diff --git a/docs/channels/linear.mdx b/docs/channels/linear.mdx
index 48d9118fe..429f1e3ea 100644
--- a/docs/channels/linear.mdx
+++ b/docs/channels/linear.mdx
@@ -4,7 +4,7 @@ description: "Reach your agent through Linear Agent Sessions, with native Agent
type: integration
---
-The Linear channel uses Linear's Agent Session surface rather than ordinary comments. Users delegate work to the agent from Linear, Eve receives `AgentSessionEvent` webhooks at `/eve/v1/linear`, and the channel replies with native Agent Activities, including `thought`, `action`, `elicitation`, `response`, and `error`. See [Channels](./overview) for the contract this builds on.
+The Linear channel uses Linear's Agent Session surface rather than ordinary comments. Users delegate work to the agent from Linear, eve receives `AgentSessionEvent` webhooks at `/eve/v1/linear`, and the channel replies with native Agent Activities, including `thought`, `action`, `elicitation`, `response`, and `error`. See [Channels](./overview) for the contract this builds on.
## Add the channel
@@ -36,21 +36,21 @@ https://<deployment>/eve/v1/linear
For Linear's agent surface, configure the OAuth authorize URL with `actor=app` and grant the app scopes that let it appear as an agent in Linear, including `app:assignable` and `app:mentionable`. Subscribe to the `AgentSessionEvent` webhook category so Linear sends `created` events when the agent is delegated or mentioned and `prompted` events when the user continues the session.
-Linear sends webhook signatures in `Linear-Signature`; Eve verifies the HMAC over the raw body and rejects stale `webhookTimestamp` values. If a trusted gateway verifies Linear before the request reaches Eve, pass `credentials.webhookVerifier` instead of a webhook secret.
+Linear sends webhook signatures in `Linear-Signature`; eve verifies the HMAC over the raw body and rejects stale `webhookTimestamp` values. If a trusted gateway verifies Linear before the request reaches eve, pass `credentials.webhookVerifier` instead of a webhook secret.
## How the channel handles messages
### Dispatch
-The default hook dispatches `created` and `prompted` Agent Session events. Eve adds a Linear context block with the agent session, issue, comment, and organization identifiers, then continues the same session with `agent-session:<id>`.
+The default hook dispatches `created` and `prompted` Agent Session events. eve adds a Linear context block with the agent session, issue, comment, and organization identifiers, then continues the same session with `agent-session:<id>`.
### Delivery
-Turn start posts an ephemeral `thought`, tool calls post ephemeral `action` activities, final assistant text posts a durable `response`, and failures post `error` activities. When the model emits text before a tool call, Eve buffers the first non-empty line and uses it as the next ephemeral Linear `thought`, mirroring Slack's typing-status behavior.
+Turn start posts an ephemeral `thought`, tool calls post ephemeral `action` activities, final assistant text posts a durable `response`, and failures post `error` activities. When the model emits text before a tool call, eve buffers the first non-empty line and uses it as the next ephemeral Linear `thought`, mirroring Slack's typing-status behavior.
### Human-in-the-loop (HITL)
-Human-in-the-loop (HITL) input requests render as Linear `elicitation` activities. When the user replies to the Agent Session, the channel resolves that prompt back to the pending Eve input request and resumes with `inputResponses`.
+Human-in-the-loop (HITL) input requests render as Linear `elicitation` activities. When the user replies to the Agent Session, the channel resolves that prompt back to the pending eve input request and resumes with `inputResponses`.
### Proactive sessions
@@ -153,7 +153,7 @@ export default defineSchedule({
});
```
-For issue or comment targets, the channel calls Linear's proactive Agent Session mutations before starting the Eve turn. For an existing `agentSessionId`, it skips session creation and only seeds the continuation token.
+For issue or comment targets, the channel calls Linear's proactive Agent Session mutations before starting the eve turn. For an existing `agentSessionId`, it skips session creation and only seeds the continuation token.
## What to read next
diff --git a/docs/channels/overview.mdx b/docs/channels/overview.mdx
index f60ff7b8e..04c6fdf47 100644
--- a/docs/channels/overview.mdx
+++ b/docs/channels/overview.mdx
@@ -1,6 +1,6 @@
---
title: "Overview"
-description: "How users reach your agent: the channel contract, the base Eve HTTP channel, and authoring custom channels."
+description: "How users reach your agent: the channel contract, the base eve HTTP channel, and authoring custom channels."
---
A channel is the edge adapter between a platform and your agent. It does three things:
@@ -9,7 +9,7 @@ A channel is the edge adapter between a platform and your agent. It does three t
- Owns the `continuationToken`, the resume handle for a conversation on that surface.
- Decides delivery, meaning how, where, and whether a response goes back.
-Eve ships a base HTTP channel plus first-class platform channels, and you can author your own. Browse the full set in the [Integrations](/integrations) gallery.
+eve ships a base HTTP channel plus first-class platform channels, and you can author your own. Browse the full set in the [Integrations](/integrations) gallery.
Each channel has its own provider terms, data flow, auth model, and user-consent expectations. Before sending non-public, sensitive, regulated, or production data through a channel, confirm that the channel provider and your configured scopes, signature checks, route auth, and delivery behavior are appropriate for your use case.
@@ -28,26 +28,26 @@ agent/
Scaffold a channel file with `eve channels add` (interactive), or pass a kind: `eve channels add slack` or `eve channels add web`. You can also author the file by hand.
-## The Eve HTTP channel (default)
+## The eve HTTP channel (default)
-The Eve channel is the framework's default HTTP session API, the routes the terminal UI, [`useEveAgent`](../guides/frontend/overview), and `curl` all talk to. It is enabled by default, even with no `agent/channels/eve.ts` file. Add that file only to override the defaults, most often the route auth policy. See [HTTP channel](./eve) for routes, auth, and customization.
+The eve channel is the framework's default HTTP session API, the routes the terminal UI, [`useEveAgent`](../guides/frontend/overview), and `curl` all talk to. It is enabled by default, even with no `agent/channels/eve.ts` file. Add that file only to override the defaults, most often the route auth policy. See [HTTP channel](./eve) for routes, auth, and customization.
## Custom channels
-When Eve doesn't ship a channel for your surface, build one with `defineChannel` from `eve/channels`. A custom channel declares route handlers (`GET`, `POST`, `PUT`, `PATCH`, `DELETE`, `WS`), an `events` map, and a `send` call inside a handler to start or resume a session. See [Custom channels](./custom) for the full walkthrough, including WebSocket routes, cross-channel hand-off, channel metadata, continuation tokens, and file uploads.
+When eve doesn't ship a channel for your surface, build one with `defineChannel` from `eve/channels`. A custom channel declares route handlers (`GET`, `POST`, `PUT`, `PATCH`, `DELETE`, `WS`), an `events` map, and a `send` call inside a handler to start or resume a session. See [Custom channels](./custom) for the full walkthrough, including WebSocket routes, cross-channel hand-off, channel metadata, continuation tokens, and file uploads.
## Relationship to the Chat SDK
-Eve uses the Chat SDK's **card-builder components** (Cards, Buttons, Actions, etc.) for composing rich Slack messages. When you build a card with the [Slack channel](./slack), the underlying primitives come from the Chat SDK and get converted to Slack Block Kit at post time.
+eve uses the Chat SDK's **card-builder components** (Cards, Buttons, Actions, etc.) for composing rich Slack messages. When you build a card with the [Slack channel](./slack), the underlying primitives come from the Chat SDK and get converted to Slack Block Kit at post time.
-Eve does **not** use the Chat SDK's runtime. The `Chat`, `Adapter`, and `Thread` primitives are never imported or reachable through Eve's public API. Eve implements its own channel layer (webhook handling, signature verification, event parsing, and thread management). Building Slack messages works like Chat SDK cards, but wiring a channel means authoring against Eve's `defineChannel(...)` API, not a Chat SDK adapter.
+eve does **not** use the Chat SDK's runtime. The `Chat`, `Adapter`, and `Thread` primitives are never imported or reachable through eve's public API. eve implements its own channel layer (webhook handling, signature verification, event parsing, and thread management). Building Slack messages works like Chat SDK cards, but wiring a channel means authoring against eve's `defineChannel(...)` API, not a Chat SDK adapter.
## Which channel?
| You want… | Use |
| ------------------------------------------- | ---------------------------------------------------------- |
-| A web app / browser chat UI | Eve channel + [`useEveAgent`](../guides/frontend/overview) |
-| Local tooling, SDK clients, `curl` | Eve channel (default) |
+| A web app / browser chat UI | eve channel + [`useEveAgent`](../guides/frontend/overview) |
+| Local tooling, SDK clients, `curl` | eve channel (default) |
| Slack mentions, DMs, buttons | [Slack](./slack) |
| Discord slash commands, components | [Discord](./discord) |
| Microsoft Teams messages + Adaptive Cards | [Teams](./teams) |
@@ -61,11 +61,11 @@ Eve does **not** use the Chat SDK's runtime. The `Chat`, `Adapter`, and `Thread`
As the deployer, it is your responsibility to ensure your agent complies with applicable laws.
-Where an Eve agent communicates with people, you may be required to disclose that they are interacting with an automated AI system where law requires it. Eve does not add this disclosure automatically; configure it in your instructions and/or channel responses.
+Where an eve agent communicates with people, you may be required to disclose that they are interacting with an automated AI system where law requires it. eve does not add this disclosure automatically; configure it in your instructions and/or channel responses.
## What to read next
- [Slack](./slack): the most common platform channel, end to end
- [Custom channels](./custom): build a channel for any surface with `defineChannel`
-- [Frontend](../guides/frontend/overview): browser chat on the Eve channel with `useEveAgent`
+- [Frontend](../guides/frontend/overview): browser chat on the eve channel with `useEveAgent`
- [Integrations](/integrations): browse every built-in channel and connection in one gallery
diff --git a/docs/channels/slack.mdx b/docs/channels/slack.mdx
index 7800053b2..51ea2bf3b 100644
--- a/docs/channels/slack.mdx
+++ b/docs/channels/slack.mdx
@@ -8,7 +8,7 @@ The Slack channel puts your agent inside a workspace. It answers `@mentions` and
## Set up Connect
-Create a Slack Connect client and copy its UID (e.g. `slack/my-agent`), then attach this project as the trigger destination at Eve's Slack route:
+Create a Slack Connect client and copy its UID (e.g. `slack/my-agent`), then attach this project as the trigger destination at eve's Slack route:
```bash
npm install -g vercel@latest && export FF_CONNECT_ENABLED=1
@@ -17,7 +17,7 @@ vercel connect detach <uid> --yes
vercel connect attach <uid> --triggers --trigger-path /eve/v1/slack --yes
```
-`FF_CONNECT_ENABLED=1` turns on the Connect commands, which are feature-flagged in the Vercel CLI today. The `create` step provisions a destination at the default Connect path. `detach` then `attach --trigger-path /eve/v1/slack` re-points the trigger at the Eve Slack route, since Eve does not serve the default Connect path. `--triggers` turns on Slack Event Subscriptions; without it, Slack never delivers `app_mention` or `message.im`. You can also create the client from the [Connect dashboard](https://vercel.com/d?to=/%5Bteam%5D/~/connect&title=Go+to+Connect).
+`FF_CONNECT_ENABLED=1` turns on the Connect commands, which are feature-flagged in the Vercel CLI today. The `create` step provisions a destination at the default Connect path. `detach` then `attach --trigger-path /eve/v1/slack` re-points the trigger at the eve Slack route, since eve does not serve the default Connect path. `--triggers` turns on Slack Event Subscriptions; without it, Slack never delivers `app_mention` or `message.im`. You can also create the client from the [Connect dashboard](https://vercel.com/d?to=/%5Bteam%5D/~/connect&title=Go+to+Connect).
## Add the channel
@@ -42,7 +42,7 @@ export default slackChannel({
VERCEL_USE_EXPERIMENTAL_FRAMEWORKS=1 vercel deploy --prod
```
-`VERCEL_USE_EXPERIMENTAL_FRAMEWORKS=1` lets the Vercel CLI recognize Eve as a framework during the build. Eve's own setup commands set the same flag.
+`VERCEL_USE_EXPERIMENTAL_FRAMEWORKS=1` lets the Vercel CLI recognize eve as a framework during the build. eve's own setup commands set the same flag.
## How the channel handles messages
@@ -54,7 +54,7 @@ Inbound hooks decide whether to dispatch a turn and with what `auth`. Return `{
- `onDirectMessage(ctx, message)` handles `message.im` events (needs `im:history` scope). Bot-authored messages and edits are filtered out first.
- `onInteraction(action, ctx)` handles `block_actions` callbacks not consumed by HITL.
-You get the triggering mention by default, but not the earlier replies in the thread. Pull them in with `loadThreadContextMessages` and return them as `context`, which Eve appends to history as user messages the model sees on every later turn. Use `since: "last-agent-reply"` so repeated mentions in one thread inject only what is new:
+You get the triggering mention by default, but not the earlier replies in the thread. Pull them in with `loadThreadContextMessages` and return them as `context`, which eve appends to history as user messages the model sees on every later turn. Use `since: "last-agent-reply"` so repeated mentions in one thread inject only what is new:
```ts
import { defaultSlackAuth, loadThreadContextMessages, slackChannel } from "eve/channels/slack";
diff --git a/docs/channels/teams.mdx b/docs/channels/teams.mdx
index 8169fe707..4f60d3b2a 100644
--- a/docs/channels/teams.mdx
+++ b/docs/channels/teams.mdx
@@ -26,7 +26,7 @@ By default the channel mounts at `POST /eve/v1/teams`. Point your Azure Bot or T
### Dispatch
-The default `onMessage` handles two cases: personal-chat messages, and channel or group-chat messages that mention the bot directly. Ambient resource-specific-consent messages are dropped unless you override it. Before dispatch, Eve strips the mention, adds a `<teams_context>` block, and scopes channel and group threads by root activity id (`replyToId ?? id`).
+The default `onMessage` handles two cases: personal-chat messages, and channel or group-chat messages that mention the bot directly. Ambient resource-specific-consent messages are dropped unless you override it. Before dispatch, eve strips the mention, adds a `<teams_context>` block, and scopes channel and group threads by root activity id (`replyToId ?? id`).
```ts
import { defaultTeamsAuth, teamsChannel } from "eve/channels/teams";
@@ -45,7 +45,7 @@ Replies post as Markdown (`textFormat: "markdown"`), with oversized text split a
### Human-in-the-loop (HITL)
-A human-in-the-loop (HITL) `input.requested` event renders as an Adaptive Card. Buttons and options map to `Action.Submit`, selects to `Input.ChoiceSet`, and freeform to `Input.Text`. When the user submits, the activity converts to Eve `inputResponses` for you. For invokes that aren't HITL, handle them in `onInvoke(ctx, activity)`.
+A human-in-the-loop (HITL) `input.requested` event renders as an Adaptive Card. Buttons and options map to `Action.Submit`, selects to `Input.ChoiceSet`, and freeform to `Input.Text`. When the user submits, the activity converts to eve `inputResponses` for you. For invokes that aren't HITL, handle them in `onInvoke(ctx, activity)`.
### Proactive sessions
diff --git a/docs/channels/telegram.mdx b/docs/channels/telegram.mdx
index 7caf47c3e..d6a4d7dcc 100644
--- a/docs/channels/telegram.mdx
+++ b/docs/channels/telegram.mdx
@@ -21,7 +21,7 @@ TELEGRAM_BOT_TOKEN=123456:... # replies, typing, callbacks, proactive sen
TELEGRAM_WEBHOOK_SECRET_TOKEN=... # must match the secret_token you register
```
-You can pass the same values via `credentials: { botToken, webhookSecretToken }`. The channel mounts `POST /eve/v1/telegram`. Register the deployed URL yourself; Eve does not call `setWebhook`:
+You can pass the same values via `credentials: { botToken, webhookSecretToken }`. The channel mounts `POST /eve/v1/telegram`. Register the deployed URL yourself; eve does not call `setWebhook`:
```bash
curl -X POST "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/setWebhook" \
@@ -47,7 +47,7 @@ The default `message.completed` handler sends plain text via `sendMessage`. It p
### Human-in-the-loop (HITL)
-Human-in-the-loop (HITL) turns option requests into inline-keyboard buttons and freeform requests into `ForceReply`. Telegram caps `callback_data` at 64 bytes, so Eve keeps compact callback ids in channel state instead. It acknowledges its own callbacks with `answerCallbackQuery`; anything it doesn't recognize goes to `onCallbackQuery`.
+Human-in-the-loop (HITL) turns option requests into inline-keyboard buttons and freeform requests into `ForceReply`. Telegram caps `callback_data` at 64 bytes, so eve keeps compact callback ids in channel state instead. It acknowledges its own callbacks with `answerCallbackQuery`; anything it doesn't recognize goes to `onCallbackQuery`.
### Proactive sessions
@@ -55,7 +55,7 @@ Start a session without an inbound message through `receive(telegram, { message,
### Attachments
-Inbound photos and documents are supported. Eve fetches them on demand via `getFile`, only when an upload policy allows the type:
+Inbound photos and documents are supported. eve fetches them on demand via `getFile`, only when an upload policy allows the type:
```ts
export default telegramChannel({
diff --git a/docs/channels/twilio.mdx b/docs/channels/twilio.mdx
index 62dd6b4b6..3a44b1813 100644
--- a/docs/channels/twilio.mdx
+++ b/docs/channels/twilio.mdx
@@ -4,7 +4,7 @@ description: "Reach your agent over SMS and speech-transcribed phone calls with
type: integration
---
-The Twilio channel puts your agent on a phone number, so people can text it or call it. Inbound SMS arrives as a webhook. Inbound calls are answered with TwiML `<Gather input="speech">`, and the resulting transcript feeds the same Eve session that SMS uses, so a caller and a texter look identical downstream. Every request is checked against `X-Twilio-Signature` before anything else runs. The raw continuation token is `From:To`. See [Channels](./overview) for the contract this builds on.
+The Twilio channel puts your agent on a phone number, so people can text it or call it. Inbound SMS arrives as a webhook. Inbound calls are answered with TwiML `<Gather input="speech">`, and the resulting transcript feeds the same eve session that SMS uses, so a caller and a texter look identical downstream. Every request is checked against `X-Twilio-Signature` before anything else runs. The raw continuation token is `From:To`. See [Channels](./overview) for the contract this builds on.
## Add the channel
diff --git a/docs/concepts/context-control.md b/docs/concepts/context-control.md
index 0b27dfa63..88be833f4 100644
--- a/docs/concepts/context-control.md
+++ b/docs/concepts/context-control.md
@@ -1,9 +1,9 @@
---
title: "Context Control"
-description: "Control what an Eve agent's model sees and when, across instructions, skills, the workspace, and subagents."
+description: "Control what an eve agent's model sees and when, across instructions, skills, the workspace, and subagents."
---
-Eve gives you a few levers for controlling what the model sees and when. `instructions.md` (or `instructions.ts`) is always on, `skills/` are available but loaded on demand, and the workspace and sandbox are visible through tools rather than pasted into the prompt.
+eve gives you a few levers for controlling what the model sees and when. `instructions.md` (or `instructions.ts`) is always on, `skills/` are available but loaded on demand, and the workspace and sandbox are visible through tools rather than pasted into the prompt.
## Base identity with `instructions.md`
@@ -29,11 +29,11 @@ export default defineInstructions({
});
```
-Module-backed instructions run once at build time. Eve captures the resulting markdown into the compiled manifest, so the runtime serves the same prompt every session without re-running the module.
+Module-backed instructions run once at build time. eve captures the resulting markdown into the compiled manifest, so the runtime serves the same prompt every session without re-running the module.
## Load procedures on demand with `skills/`
-Skills stay out of the always-on prompt by default, which keeps rich procedures available without bloating every turn. Eve advertises the available skills and adds a framework-owned `load_skill` tool. When the request clearly matches a skill description, or the user names a skill explicitly, the model activates that skill, and Eve appends the skill's markdown to the active instructions for later turn work.
+Skills stay out of the always-on prompt by default, which keeps rich procedures available without bloating every turn. eve advertises the available skills and adds a framework-owned `load_skill` tool. When the request clearly matches a skill description, or the user names a skill explicitly, the model activates that skill, and eve appends the skill's markdown to the active instructions for later turn work.
### Flat skill
@@ -58,7 +58,7 @@ See [Skills](../skills) for the full authoring model and install notes.
## Put runtime files in the workspace, not the prompt
-Eve does not inline the entire authored surface into the prompt. Instead, it gives the model a shallow workspace hint and runtime tools to inspect deeper when needed. Skill files are available under the active workspace root, and the model inspects them with the shared `bash` tool, which keeps prompts smaller and makes file and command work explicit.
+eve does not inline the entire authored surface into the prompt. Instead, it gives the model a shallow workspace hint and runtime tools to inspect deeper when needed. Skill files are available under the active workspace root, and the model inspects them with the shared `bash` tool, which keeps prompts smaller and makes file and command work explicit.
See [Sandbox](../sandbox) for the workspace and sandbox model.
diff --git a/docs/concepts/default-harness.md b/docs/concepts/default-harness.md
index 53447a8ef..7225fb4b2 100644
--- a/docs/concepts/default-harness.md
+++ b/docs/concepts/default-harness.md
@@ -1,9 +1,9 @@
---
title: "The Harness"
-description: "The out-of-the-box Eve agent loop and the built-in tools every agent ships with, plus how to override or disable them."
+description: "The out-of-the-box eve agent loop and the built-in tools every agent ships with, plus how to override or disable them."
---
-The default harness is what every Eve agent ships with. It includes the framework-owned agent loop plus a set of built-in tools the model can call without you writing a line. You extend it with capabilities specific to your agent. The loop itself, how a turn runs and checkpoints and resumes, lives in [Execution model and durability](./execution-model-and-durability).
+The default harness is what every eve agent ships with. It includes the framework-owned agent loop plus a set of built-in tools the model can call without you writing a line. You extend it with capabilities specific to your agent. The loop itself, how a turn runs and checkpoints and resumes, lives in [Execution model and durability](./execution-model-and-durability).
## Compaction
diff --git a/docs/concepts/execution-model-and-durability.md b/docs/concepts/execution-model-and-durability.md
index a1ec2424b..a7e7960d2 100644
--- a/docs/concepts/execution-model-and-durability.md
+++ b/docs/concepts/execution-model-and-durability.md
@@ -1,9 +1,9 @@
---
title: "Execution Model and Durability"
-description: "How an Eve session runs. Durable conversations, turns that checkpoint at steps, and parked work that resumes later."
+description: "How an eve session runs. Durable conversations, turns that checkpoint at steps, and parked work that resumes later."
---
-An Eve session is a durable conversation. It can run for days and survives process restarts and redeploys without any work on your part. You write the capabilities (tools, instructions, channels) and Eve runs the loop.
+An eve session is a durable conversation. It can run for days and survives process restarts and redeploys without any work on your part. You write the capabilities (tools, instructions, channels) and eve runs the loop.
## Sessions, turns, and steps
@@ -13,15 +13,15 @@ Work nests in three levels:
- **turn**: one user message and all the work it triggers (model calls, tool calls, reasoning) until the agent produces its response.
- **step**: a durable checkpoint inside a turn (one model call and the tool calls it makes).
-Every turn runs as a durable workflow, built on the open-source [Workflow SDK](https://workflow-sdk.dev/) (Vercel Workflow when you deploy on Vercel). Eve checkpoints progress and serializes durable state at each step boundary. Your code runs inside a managed step, so tools, the sandbox, and subagents feel synchronous even though the session underneath them is durable.
+Every turn runs as a durable workflow, built on the open-source [Workflow SDK](https://workflow-sdk.dev/) (Vercel Workflow when you deploy on Vercel). eve checkpoints progress and serializes durable state at each step boundary. Your code runs inside a managed step, so tools, the sandbox, and subagents feel synchronous even though the session underneath them is durable.
## Resuming after a crash
-Crash the process, hit a timeout, or redeploy mid-turn, and the run picks up from the last completed step rather than replaying the whole turn. Completed steps never re-run; Eve replays the recorded result. A step interrupted mid-execution re-runs, so make non-idempotent side effects like charges or emails idempotent, or gate them with approval.
+Crash the process, hit a timeout, or redeploy mid-turn, and the run picks up from the last completed step rather than replaying the whole turn. Completed steps never re-run; eve replays the recorded result. A step interrupted mid-execution re-runs, so make non-idempotent side effects like charges or emails idempotent, or gate them with approval.
-There's nothing to configure. Eve owns the workflow lifecycle, and sessions are durable by default.
+There's nothing to configure. eve owns the workflow lifecycle, and sessions are durable by default.
-You don't write workflow code directly. Workflow primitives (`start()`, `resumeHook()`, etc.) are an implementation detail of Eve's runtime layer; channels, tools, and hooks never touch them. Two surfaces give your own code session data: tools read the current session's metadata (id, turn, auth, parent lineage) via `ctx.session`, and [`defineState`](../guides/state) reads or writes session-scoped durable state. See [State](../guides/state) for the read/write model.
+You don't write workflow code directly. Workflow primitives (`start()`, `resumeHook()`, etc.) are an implementation detail of eve's runtime layer; channels, tools, and hooks never touch them. Two surfaces give your own code session data: tools read the current session's metadata (id, turn, auth, parent lineage) via `ctx.session`, and [`defineState`](../guides/state) reads or writes session-scoped durable state. See [State](../guides/state) for the read/write model.
## Parked work
@@ -29,9 +29,9 @@ Some work has to wait, including a human approving a [tool](../tools), an intera
## Message delivery and queueing
-Eve does not maintain a durable FIFO queue of user messages for a session. The `continuationToken` is a resume handle for the session's current workflow hook, not a general message-queue address.
+eve does not maintain a durable FIFO queue of user messages for a session. The `continuationToken` is a resume handle for the session's current workflow hook, not a general message-queue address.
-When a session is waiting, a delivery to the current continuation token wakes the session and starts the next turn. When a turn is already active, the hook may accept additional deliveries, but the runtime only drains them at specific workflow boundaries. If more than one delivery is ready when the driver checks, Eve may fold them into the next turn; that drain is best-effort and depends on workflow and transport timing.
+When a session is waiting, a delivery to the current continuation token wakes the session and starts the next turn. When a turn is already active, the hook may accept additional deliveries, but the runtime only drains them at specific workflow boundaries. If more than one delivery is ready when the driver checks, eve may fold them into the next turn; that drain is best-effort and depends on workflow and transport timing.
So don't rely on concurrent sends to the same session behaving like a typical ordered chat queue. For deterministic behavior, send one user turn at a time and wait for `session.waiting` before sending the next message to the same session. If your channel can receive bursts while the agent is working, keep your own per-session queue in the channel or app layer, then deliver the next message after the session parks again. Separate sessions still run independently.
@@ -39,7 +39,7 @@ So don't rely on concurrent sends to the same session behaving like a typical or
A turn can hand work off to a [subagent](../subagents). Each subagent gets its own context and its own durable session; a declared subagent also gets its own sandbox, skills, and state. Nothing crosses the boundary implicitly.
-## How Eve orders session history
+## How eve orders session history
Conversation history within a session is append-only. Turns land in order, and the tool calls inside a turn (plus their results) keep their order too. Read a session back and you see events in the order they happened.
diff --git a/docs/concepts/security-model.md b/docs/concepts/security-model.md
index d1132282b..0b67a79f9 100644
--- a/docs/concepts/security-model.md
+++ b/docs/concepts/security-model.md
@@ -1,9 +1,9 @@
---
title: "Security Model"
-description: "Eve's trust boundaries, where secrets live, how credentials reach hosts, and what fails closed by default."
+description: "eve's trust boundaries, where secrets live, how credentials reach hosts, and what fails closed by default."
---
-Your Eve agent runs across two contexts, with a trust boundary between them and every secret kept on the trusted side. Use this mental model when deciding what an agent (and the model driving it) is allowed to reach.
+Your eve agent runs across two contexts, with a trust boundary between them and every secret kept on the trusted side. Use this mental model when deciding what an agent (and the model driving it) is allowed to reach.
## Trust boundaries
@@ -25,7 +25,7 @@ A concrete trace makes the boundary clear. When the model calls a custom `charge
```mermaid
flowchart LR
User["User or channel provider"] --> Channel["Channel route and route auth"]
- Channel --> Runtime["Eve app runtime and durable session"]
+ Channel --> Runtime["eve app runtime and durable session"]
Runtime --> Model["Configured model provider or Vercel AI Gateway"]
Runtime --> Tools["Authored tools and connections"]
Tools --> Services["Customer-selected external services"]
@@ -34,23 +34,23 @@ flowchart LR
Runtime --> Telemetry["Configured telemetry or eval provider"]
```
-Eve sends data where your agent configuration and runtime choices send it:
+eve sends data where your agent configuration and runtime choices send it:
-- Inbound channel data flows through the channel provider you configure, then into the Eve app runtime.
+- Inbound channel data flows through the channel provider you configure, then into the eve app runtime.
- Model inputs and outputs flow to the model or routing path selected in `agent.ts`, such as a Vercel AI Gateway model id or a provider-authored `LanguageModel`.
- Tool and connection calls flow to the external services, MCP servers, OpenAPI endpoints, and channels you configure.
- Sandbox commands can reach network destinations allowed by the sandbox network policy.
- Telemetry and eval data flows to the exporters and providers you configure in `instrumentation.ts` or eval settings.
-Eve stores durable session and workflow state needed to resume conversations, stream events, replay completed steps, and show run observability. You are responsible for deciding whether the selected channels, model providers, connected services, sandbox egress destinations, telemetry exporters, retention settings, and deletion controls are appropriate for your data and use case.
+eve stores durable session and workflow state needed to resume conversations, stream events, replay completed steps, and show run observability. You are responsible for deciding whether the selected channels, model providers, connected services, sandbox egress destinations, telemetry exporters, retention settings, and deletion controls are appropriate for your data and use case.
## Credential brokering
-Credential brokering gives the model _authenticated_ network access from inside the sandbox, like a `git clone` of a private repo or an authenticated `curl`, when there's no [tool](../tools) or [connection](../connections) to route it through. On the Vercel Sandbox backend, auth headers get injected at the sandbox's network firewall for matching domains. The secret stays in the app runtime; the sandbox process only ever sees the response. See [Vercel Sandbox Credential Brokering](https://vercel.com/docs/sandbox/concepts/firewall#credentials-brokering) for the platform mechanism, and [Sandbox](../sandbox) for the Eve policy API.
+Credential brokering gives the model _authenticated_ network access from inside the sandbox, like a `git clone` of a private repo or an authenticated `curl`, when there's no [tool](../tools) or [connection](../connections) to route it through. On the Vercel Sandbox backend, auth headers get injected at the sandbox's network firewall for matching domains. The secret stays in the app runtime; the sandbox process only ever sees the response. See [Vercel Sandbox Credential Brokering](https://vercel.com/docs/sandbox/concepts/firewall#credentials-brokering) for the platform mechanism, and [Sandbox](../sandbox) for the eve policy API.
## Connection credentials
-[Connection](../connections) tokens (MCP and OpenAPI) come from either `getToken()` or an interactive OAuth flow, and Eve injects the resolved token into every outbound request. The token is cached per step and never serialized to durable state.
+[Connection](../connections) tokens (MCP and OpenAPI) come from either `getToken()` or an interactive OAuth flow, and eve injects the resolved token into every outbound request. The token is cached per step and never serialized to durable state.
## Channel verification
@@ -70,7 +70,7 @@ A custom channel that accepts dashboard-style webhooks should follow the same sh
## Authored markdown is data
-[Skill](../skills) and [schedule](../schedules) files are markdown with YAML frontmatter, and Eve treats that frontmatter strictly as data. The code-capable engines (`---js` / `---javascript`, which would `eval()` the frontmatter body the moment the file is parsed) are disabled, so such a fence throws rather than running. Frontmatter has to parse to a plain YAML object.
+[Skill](../skills) and [schedule](../schedules) files are markdown with YAML frontmatter, and eve treats that frontmatter strictly as data. The code-capable engines (`---js` / `---javascript`, which would `eval()` the frontmatter body the moment the file is parsed) are disabled, so such a fence throws rather than running. Frontmatter has to parse to a plain YAML object.
## Auth fails closed
diff --git a/docs/concepts/sessions-runs-and-streaming.md b/docs/concepts/sessions-runs-and-streaming.md
index 7993ec14a..823604f5b 100644
--- a/docs/concepts/sessions-runs-and-streaming.md
+++ b/docs/concepts/sessions-runs-and-streaming.md
@@ -3,7 +3,7 @@ title: "Sessions, Runs & Streaming"
description: "The session and run contract you touch: continuation tokens, stream handles, the NDJSON event stream, and reconnecting."
---
-Every Eve app speaks the same stable HTTP API to a [durable session](./execution-model-and-durability). This page is the contract you hold: the handles you get back, the events you stream, and how to reconnect.
+Every eve app speaks the same stable HTTP API to a [durable session](./execution-model-and-durability). This page is the contract you hold: the handles you get back, the events you stream, and how to reconnect.
## The two handles
@@ -14,7 +14,7 @@ Two handles do two jobs, and mixing them up is the most common mistake. One hand
A session has one active continuation at a time: each follow-up uses the current `continuationToken`, and a stale one is rejected.
-React, Vue, and Svelte apps reach for [`useEveAgent()`](../guides/frontend/overview) instead of calling these routes by hand. Next.js and Nuxt apps can proxy them to the Eve runtime from the same origin.
+React, Vue, and Svelte apps reach for [`useEveAgent()`](../guides/frontend/overview) instead of calling these routes by hand. Next.js and Nuxt apps can proxy them to the eve runtime from the same origin.
## Start a session
@@ -24,7 +24,7 @@ curl -X POST http://127.0.0.1:3000/eve/v1/session \
-d '{"message":"Summarize the latest forecast."}'
```
-Eve responds right away. The JSON body carries a `sessionId` and a `continuationToken`, and the `x-eve-session-id` header names the durable session to stream.
+eve responds right away. The JSON body carries a `sessionId` and a `continuationToken`, and the `x-eve-session-id` header names the durable session to stream.
## Stream a session
diff --git a/docs/connections.mdx b/docs/connections.mdx
index f75a0a6ae..4390b078e 100644
--- a/docs/connections.mdx
+++ b/docs/connections.mdx
@@ -3,7 +3,7 @@ title: "Connections"
description: "Expose external MCP and OpenAPI servers to the model, with connection tokens the model never sees."
---
-A connection wires an agent into an external server you don't author, either an MCP server (Linear, GitHub, a warehouse) or any HTTP API with an OpenAPI document. Eve handles the parts you'd otherwise hand-roll, discovering the remote tools, surfacing them to the model, and brokering auth.
+A connection wires an agent into an external server you don't author, either an MCP server (Linear, GitHub, a warehouse) or any HTTP API with an OpenAPI document. eve handles the parts you'd otherwise hand-roll, discovering the remote tools, surfacing them to the model, and brokering auth.
Connections live under `agent/connections/`. The runtime name comes from the filename, so `agent/connections/linear.ts` registers as `"linear"`. The model never sees a connection's URL or credentials. It discovers tools through the built-in `connection__search` and calls them by their qualified name, `connection__<connection>__<tool>` (e.g. `connection__linear__list_issues`).
@@ -27,11 +27,11 @@ The `url` must speak Streamable HTTP or SSE. Write the `description` for the mod
### Static-token auth
-`getToken` returns a `TokenResult` (`{ token, expiresAt? }`), and Eve sends it as `Authorization: Bearer <token>` on every request. Because it runs on each connection attempt, you can mint a fresh token from wherever you keep secrets, including an env var, a secrets manager, an internal vault, or your own OAuth exchange. If the token has a known TTL, set `expiresAt` (milliseconds since epoch) and Eve refreshes ahead of time rather than waiting for a `401`.
+`getToken` returns a `TokenResult` (`{ token, expiresAt? }`), and eve sends it as `Authorization: Bearer <token>` on every request. Because it runs on each connection attempt, you can mint a fresh token from wherever you keep secrets, including an env var, a secrets manager, an internal vault, or your own OAuth exchange. If the token has a known TTL, set `expiresAt` (milliseconds since epoch) and eve refreshes ahead of time rather than waiting for a `401`.
When `getToken` is the only auth, `principalType` defaults to `"app"`: one shared credential keyed across all sessions. Switch to `principalType: "user"` when each end-user carries their own token.
-Eve resolves and caches connection tokens per step; they never land in conversation history or reach the model.
+eve resolves and caches connection tokens per step; they never land in conversation history or reach the model.
### No auth
@@ -44,7 +44,7 @@ export default defineMcpClientConnection({
});
```
-We recommend using no-auth connections only for services that are intentionally public, local-only, or otherwise protected outside Eve. Do not use no-auth connections for sensitive third-party services.
+We recommend using no-auth connections only for services that are intentionally public, local-only, or otherwise protected outside eve. Do not use no-auth connections for sensitive third-party services.
### Headers
@@ -92,7 +92,7 @@ For connection tools that can create, modify, delete, transmit, purchase, messag
## OpenAPI connections
-`defineOpenAPIConnection` turns any OpenAPI 3.x document into connection tools, one per operation. Pass an HTTPS URL Eve fetches at runtime, or an inline parsed object:
+`defineOpenAPIConnection` turns any OpenAPI 3.x document into connection tools, one per operation. Pass an HTTPS URL eve fetches at runtime, or an inline parsed object:
```ts title="agent/connections/petstore.ts"
import { defineOpenAPIConnection } from "eve/connections";
@@ -104,7 +104,7 @@ export default defineOpenAPIConnection({
});
```
-Each operation becomes `connection__<connection>__<operationId>` (e.g. `connection__petstore__getInventory`). When an operation has no `operationId`, Eve derives a deterministic `<method>_<sanitized-path>` name instead.
+Each operation becomes `connection__<connection>__<operationId>` (e.g. `connection__petstore__getInventory`). When an operation has no `operationId`, eve derives a deterministic `<method>_<sanitized-path>` name instead.
`auth`, `headers`, and `approval` work exactly as they do for MCP. There are two fields specific to OpenAPI:
@@ -115,7 +115,7 @@ Each operation becomes `connection__<connection>__<operationId>` (e.g. `connecti
## Interactive OAuth via Vercel Connect
-When the server uses OAuth and you want each end-user to sign in through their own browser, turn on interactive authorization with [Vercel Connect](https://vercel.com/docs/connect). The `connect()` helper from `@vercel/connect/eve` handles consent, encrypted token storage, and refresh, then hooks all of that into Eve's authorization flow:
+When the server uses OAuth and you want each end-user to sign in through their own browser, turn on interactive authorization with [Vercel Connect](https://vercel.com/docs/connect). The `connect()` helper from `@vercel/connect/eve` handles consent, encrypted token storage, and refresh, then hooks all of that into eve's authorization flow:
```ts title="agent/connections/linear.ts"
import { connect } from "@vercel/connect/eve";
@@ -132,7 +132,7 @@ export default defineMcpClientConnection({
## Self-hosted interactive OAuth
-To run your own OAuth, use `defineInteractiveAuthorization` from `eve/connections`, which takes a three-method form and needs no Vercel Connect. Eve mints a callback URL, parks (durably suspends) the turn on a framework-owned webhook, and resumes once the token comes back. Interactive auth is always `principalType: "user"`, and the factory pins that for you.
+To run your own OAuth, use `defineInteractiveAuthorization` from `eve/connections`, which takes a three-method form and needs no Vercel Connect. eve mints a callback URL, parks (durably suspends) the turn on a framework-owned webhook, and resumes once the token comes back. Interactive auth is always `principalType: "user"`, and the factory pins that for you.
```ts title="agent/connections/linear.ts"
import {
@@ -205,7 +205,7 @@ To narrow a caught error, use `isConnectionAuthorizationRequiredError(err)` and
### Handling a revoked token mid-call
-`getToken` only runs _before_ a tool call, so a grant revoked while a tool is mid-flight first surfaces as a downstream `401` inside your `execute`. A plain throw there is only a tool error, so the model sees a failure and the cached bearer sticks around. Instead, map a provider `401` to `ctx.requireAuth()` (or rethrow `ConnectionAuthorizationRequiredError`). Eve then evicts the rejected token from its per-step cache and re-runs the consent flow with a fresh one, exactly as it does for a connection whose server rejects the bearer.
+`getToken` only runs _before_ a tool call, so a grant revoked while a tool is mid-flight first surfaces as a downstream `401` inside your `execute`. A plain throw there is only a tool error, so the model sees a failure and the cached bearer sticks around. Instead, map a provider `401` to `ctx.requireAuth()` (or rethrow `ConnectionAuthorizationRequiredError`). eve then evicts the rejected token from its per-step cache and re-runs the consent flow with a fresh one, exactly as it does for a connection whose server rejects the bearer.
```ts title="agent/tools/list_issues.ts"
import { defineTool } from "eve/tools";
@@ -229,11 +229,11 @@ export default defineTool({
### Authorization and approval together
-A tool can require both sign-in (`auth`) and a human approval. The model's approval gate runs before the tool's `execute`, so the order the user sees is **approve, then sign in**. Eve records the approval on session state the moment it's granted, and that record survives the sign-in park, so when the turn resumes after authorization the tool is not put through approval again. You get one approval and one sign-in, never a double prompt.
+A tool can require both sign-in (`auth`) and a human approval. The model's approval gate runs before the tool's `execute`, so the order the user sees is **approve, then sign in**. eve records the approval on session state the moment it's granted, and that record survives the sign-in park, so when the turn resumes after authorization the tool is not put through approval again. You get one approval and one sign-in, never a double prompt.
## What to read next
-- [Integrations](/integrations): browse every channel and connection Eve ships, in one gallery.
+- [Integrations](/integrations): browse every channel and connection eve ships, in one gallery.
- [Tools](./tools): authored tools live alongside connection-provided tools; the same approval helpers apply.
- [Auth & route protection](./guides/auth-and-route-protection): the full interactive-OAuth flow with Vercel Connect.
- [Security model](./concepts/security-model): how connection credentials stay out of the model's reach.
diff --git a/docs/evals/judge.mdx b/docs/evals/judge.mdx
index e6e633206..5560d8fe3 100644
--- a/docs/evals/judge.mdx
+++ b/docs/evals/judge.mdx
@@ -3,7 +3,7 @@ title: "Judge"
description: "Grade evals with an LLM judge via t.judge.autoevals, set thresholds on the assertion, and configure the judge model."
---
-When no deterministic [assertion](./assertions) captures what "good" means (factual correctness, summary quality, free-form criteria), grade the run with an LLM judge. The `t.judge.*` assertions are the only model-backed ones, and they use a judge model that is resolved separately from the agent under test. Eve only uses it for scoring, never to swap out the agent.
+When no deterministic [assertion](./assertions) captures what "good" means (factual correctness, summary quality, free-form criteria), grade the run with an LLM judge. The `t.judge.*` assertions are the only model-backed ones, and they use a judge model that is resolved separately from the agent under test. eve only uses it for scoring, never to swap out the agent.
```ts
import { defineEval } from "eve/evals";
@@ -19,7 +19,7 @@ export default defineEval({
## The graders
-The judges live under `t.judge.autoevals`. The namespace names the [Braintrust autoevals](https://github.com/braintrustdata/autoevals) grader family, so the factuality and closedQA semantics are autoevals', not Eve-invented. Each grader scores `t.reply` by default and is soft by default (tracked, no gate):
+The judges live under `t.judge.autoevals`. The namespace names the [Braintrust autoevals](https://github.com/braintrustdata/autoevals) grader family, so the factuality and closedQA semantics are autoevals', not eve-invented. Each grader scores `t.reply` by default and is soft by default (tracked, no gate):
| Grader | Grades |
| ---------------------------------------- | -------------------------------------------------------------------------------------- |
diff --git a/docs/evals/overview.mdx b/docs/evals/overview.mdx
index 88a86d005..c6936038e 100644
--- a/docs/evals/overview.mdx
+++ b/docs/evals/overview.mdx
@@ -1,6 +1,6 @@
---
title: "Overview"
-description: "Define repeatable scored checks for an Eve agent with defineEval and run them with eve eval."
+description: "Define repeatable scored checks for an eve agent with defineEval and run them with eve eval."
---
An eval is a scored check that runs your agent against real sessions and grades the result, catching regressions when you change a prompt or a tool. Drive the agent through one or more turns, assert on what it did (the run completed, the right tool ran, the reply contains the right text), and optionally ship the results to Braintrust.
@@ -9,7 +9,7 @@ Evals exercise the same HTTP surface your users hit. The runner boots (or target
## `defineEval`
-Eve discovers evals under the app-root `evals/` directory, in `.eval.ts` files. Each file is one eval by default. A file can also default-export an array to fan out over a dataset (see [Cases](./cases)). The file path is the eval's identity, so you don't author an `id` or `name`. Directories group related evals (`evals/weather/brooklyn-forecast.eval.ts` becomes id `weather/brooklyn-forecast`).
+eve discovers evals under the app-root `evals/` directory, in `.eval.ts` files. Each file is one eval by default. A file can also default-export an array to fan out over a dataset (see [Cases](./cases)). The file path is the eval's identity, so you don't author an `id` or `name`. Directories group related evals (`evals/weather/brooklyn-forecast.eval.ts` becomes id `weather/brooklyn-forecast`).
```text
my-agent/
diff --git a/docs/evals/reporters.mdx b/docs/evals/reporters.mdx
index 745cb7e7f..0bfc055a9 100644
--- a/docs/evals/reporters.mdx
+++ b/docs/evals/reporters.mdx
@@ -1,9 +1,9 @@
---
title: "Reporters"
-description: "Ship eval results to Braintrust experiments or JUnit XML. Eve runs and scores everything itself."
+description: "Ship eval results to Braintrust experiments or JUnit XML. eve runs and scores everything itself."
---
-Eve runs and grades everything itself; reporters ship the results out. The CLI prints a console summary by default (one line per eval, with failed assertions and their messages), and reporters from `eve/evals/reporters` add destinations on top.
+eve runs and grades everything itself; reporters ship the results out. The CLI prints a console summary by default (one line per eval, with failed assertions and their messages), and reporters from `eve/evals/reporters` add destinations on top.
You are responsible for ensuring any observability or eval provider is approved for the data exported to it.
diff --git a/docs/getting-started.mdx b/docs/getting-started.mdx
index cfc6d2b29..e2030ccdd 100644
--- a/docs/getting-started.mdx
+++ b/docs/getting-started.mdx
@@ -1,12 +1,12 @@
---
title: "Getting Started"
-description: "Install Eve, scaffold your first agent, give it a tool, and run it locally."
+description: "Install eve, scaffold your first agent, give it a tool, and run it locally."
---
-Eve is a filesystem-first framework for durable agents. You write capabilities under `agent/`, and Eve runs the model loop, persists every session, and serves the agent over HTTP and platform channels. You'll scaffold an app, add a tool, run it locally, then create, stream, and continue a session over HTTP.
+eve is a filesystem-first framework for durable agents. You write capabilities under `agent/`, and eve runs the model loop, persists every session, and serves the agent over HTTP and platform channels. You'll scaffold an app, add a tool, run it locally, then create, stream, and continue a session over HTTP.
<Callout>
- Eve is currently in beta and subject to the [Vercel beta
+ eve is currently in beta and subject to the [Vercel beta
terms](https://vercel.com/docs/release-phases/public-beta-agreement); the framework, APIs,
documentation, and behavior may change before general availability.
</Callout>
@@ -28,7 +28,7 @@ If you skip this, the dev TUI flags the missing credential and its `/model` comm
## Quick start
-`npx` runs `eve init` without installing Eve first:
+`npx` runs `eve init` without installing eve first:
```bash
npx eve@latest init my-agent
@@ -36,7 +36,7 @@ npx eve@latest init my-agent
The command:
-- Creates an npm-managed child directory and uses Eve's default model
+- Creates an npm-managed child directory and uses eve's default model
- Installs dependencies and initializes Git
- Starts the development server and opens the interactive [terminal UI](./guides/dev-tui)
@@ -44,11 +44,11 @@ Type a message and watch the model loop run. Pass `--channel-web-nextjs` to add
`eve init` holds the terminal, so stop it with Ctrl+C to get your shell back before editing the generated agent. The command does not create a Vercel project or deploy.
-To add Eve to an existing project, run `eve init .` from a directory that already has a `package.json` and no `agent/` files yet. Eve adds the missing `eve`, `ai`, and `zod` dependencies without touching anything else the project owns. The Eve dependency and the Node engine come from the same release. Eve pins `engines.node` to the lowest major that release supports (for example `24.x`). It keeps an existing range only when every version that range allows stays within that major; otherwise it replaces the range and prints a warning.
+To add eve to an existing project, run `eve init .` from a directory that already has a `package.json` and no `agent/` files yet. eve adds the missing `eve`, `ai`, and `zod` dependencies without touching anything else the project owns. The eve dependency and the Node engine come from the same release. eve pins `engines.node` to the lowest major that release supports (for example `24.x`). It keeps an existing range only when every version that range allows stays within that major; otherwise it replaces the range and prints a warning.
## Manual installation
-To wire Eve into an existing app by hand instead of using `eve init`, first declare a compatible Node runtime in `package.json`:
+To wire eve into an existing app by hand instead of using `eve init`, first declare a compatible Node runtime in `package.json`:
```json
{
@@ -135,7 +135,7 @@ The same CLI can point at a deployment. `npx eve dev https://your-app.vercel.app
## Send a message
-Every Eve app exposes the same stable HTTP API. Start a durable session:
+Every eve app exposes the same stable HTTP API. Start a durable session:
```bash
curl -X POST http://127.0.0.1:3000/eve/v1/session \
@@ -186,8 +186,8 @@ See [Sessions, runs and streaming](./concepts/sessions-runs-and-streaming) for t
If a coding agent (Claude Code, Cursor, and the like) is doing the setup, hand it this prompt:
-<CopyPrompt text="Set up an Eve agent for the user. Eve is a filesystem-first TypeScript framework for durable agents, published as the npm package eve. Read its docs: once eve is installed they are bundled in the package at node_modules/eve/docs; before eve is installed, read the published Introduction and Getting Started pages. If the project has no Eve app, scaffold one with `npx eve@latest init <name>`; add `--channel-web-nextjs` only when the user wants Web Chat. The init command installs dependencies, initializes Git, and starts the dev server, so run it in a controllable process and stop it with Ctrl+C before editing. To add Eve to an existing app, run `eve init .`, or install the dependencies by hand with `npm install eve@latest ai zod` (init adds ai and zod; the by-hand path needs all three). Make sure agent/agent.ts and agent/instructions.md exist, then add a first typed tool at agent/tools/get_weather.ts using defineTool from eve/tools with a Zod inputSchema and an inline execute. Start the dev server again, then exercise the HTTP API: create a session with POST /eve/v1/session, attach to GET /eve/v1/session/:id/stream, and send a follow-up with the returned continuationToken. Verify with the project's typecheck, adapt model and provider choices to the project, and do not commit unless the user asks.">
- Set up an Eve agent: read the Eve docs (bundled at node_modules/eve/docs once eve is
+<CopyPrompt text="Set up an eve agent for the user. eve is a filesystem-first TypeScript framework for durable agents, published as the npm package eve. Read its docs: once eve is installed they are bundled in the package at node_modules/eve/docs; before eve is installed, read the published Introduction and Getting Started pages. If the project has no eve app, scaffold one with `npx eve@latest init <name>`; add `--channel-web-nextjs` only when the user wants Web Chat. The init command installs dependencies, initializes Git, and starts the dev server, so run it in a controllable process and stop it with Ctrl+C before editing. To add eve to an existing app, run `eve init .`, or install the dependencies by hand with `npm install eve@latest ai zod` (init adds ai and zod; the by-hand path needs all three). Make sure agent/agent.ts and agent/instructions.md exist, then add a first typed tool at agent/tools/get_weather.ts using defineTool from eve/tools with a Zod inputSchema and an inline execute. Start the dev server again, then exercise the HTTP API: create a session with POST /eve/v1/session, attach to GET /eve/v1/session/:id/stream, and send a follow-up with the returned continuationToken. Verify with the project's typecheck, adapt model and provider choices to the project, and do not commit unless the user asks.">
+ Set up an eve agent: read the eve docs (bundled at node_modules/eve/docs once eve is
installed), scaffold with `npx eve@latest init <name>` (or `npm install eve@latest ai zod` in an existing app), add
a typed tool at agent/tools/get_weather.ts, run it with `npm run dev`, then create a session, stream
it, and send a follow-up.
diff --git a/docs/guides/auth-and-route-protection.md b/docs/guides/auth-and-route-protection.md
index ae24dad53..6802e5fe4 100644
--- a/docs/guides/auth-and-route-protection.md
+++ b/docs/guides/auth-and-route-protection.md
@@ -3,7 +3,7 @@ title: "Auth & Route Protection"
description: "Secure your agent's HTTP routes with an ordered auth walk, verifier helpers, and connection OAuth via Vercel Connect."
---
-Eve has two independent auth systems:
+eve has two independent auth systems:
- **Route auth** (inbound) decides who can reach your agent's HTTP routes. It runs at the channel layer, gating the request before any model work runs.
- **Tool and connection auth** (outbound) is how your agent signs in to an external service it calls, like an OAuth MCP server. It happens later, when a tool or connection actually reaches out.
@@ -18,7 +18,7 @@ The route-auth policy lives on the HTTP channel factory (`agent/channels/eve.ts`
- `POST /eve/v1/session/:sessionId`
- `GET /eve/v1/session/:sessionId/stream`
-These routes are protected by the channel's auth policy. Eve fails closed by default: production browser traffic is rejected unless you configure an authenticator that accepts it, and anonymous access requires an explicit `none()`.
+These routes are protected by the channel's auth policy. eve fails closed by default: production browser traffic is rejected unless you configure an authenticator that accepts it, and anonymous access requires an explicit `none()`.
`GET /eve/v1/health` is always public and skips the walk entirely, so load balancers and uptime monitors can probe it without credentials.
@@ -33,7 +33,7 @@ export default eveChannel({
## The ordered auth walk
-`auth` takes a single `AuthFn` or an array that Eve walks in order. Each entry has three possible outcomes:
+`auth` takes a single `AuthFn` or an array that eve walks in order. Each entry has three possible outcomes:
- returns a `SessionAuthContext`: accept the request and stop the walk
- returns `null` / `undefined`: skip to the next entry
@@ -92,7 +92,7 @@ Any other thrown error follows the normal channel failure path. When building a
| `httpBasic(...)` | Operator or service access via a shared username/password. |
| `jwtHmac(...)` | You control a shared-secret JWT signer. |
| `jwtEcdsa(...)` | You verify asymmetric JWTs minted by another system. |
-| `oidc(...)` | You want Eve to verify OIDC-issued tokens from an arbitrary issuer. |
+| `oidc(...)` | You want eve to verify OIDC-issued tokens from an arbitrary issuer. |
Exercise caution for agents that process non-public, sensitive, regulated, or production data unless you have implemented other access controls.
@@ -199,7 +199,7 @@ export default eveChannel({
});
```
-In production, `placeholderAuth()` returns a structured `401` so a generated web chat app can say "auth isn't configured yet" instead of throwing an internal error. Replace it before a browser caller submits a production request: swap in your app's `AuthFn` or one of the shipped helpers. Delete the authored channel file entirely and Eve falls back to the framework default `[localDev(), vercelOidc()]`, which also rejects production browser traffic.
+In production, `placeholderAuth()` returns a structured `401` so a generated web chat app can say "auth isn't configured yet" instead of throwing an internal error. Replace it before a browser caller submits a production request: swap in your app's `AuthFn` or one of the shipped helpers. Delete the authored channel file entirely and eve falls back to the framework default `[localDev(), vercelOidc()]`, which also rejects production browser traffic.
Keep secret values (`ROUTE_AUTH_BASIC_PASSWORD`, signing keys) in environment variables. Route-auth secrets never land in compiled artifacts. The runtime re-materializes them from the authored channel definition at boot.
@@ -218,7 +218,7 @@ Route auth does not enforce session ownership. If multiple users or tenants can
## Tool and connection auth
-Tool and connection auth is how your agent reaches an external service that wants an interactive sign-in, like an OAuth MCP server. Both a connection and an individual tool can declare an `auth` strategy; Eve drives the sign-in, caches the token per step, and re-runs the call once the caller authorizes.
+Tool and connection auth is how your agent reaches an external service that wants an interactive sign-in, like an OAuth MCP server. Both a connection and an individual tool can declare an `auth` strategy; eve drives the sign-in, caches the token per step, and re-runs the call once the caller authorizes.
### On a connection
diff --git a/docs/guides/client/continuations.mdx b/docs/guides/client/continuations.mdx
index a41509755..070e01c59 100644
--- a/docs/guides/client/continuations.mdx
+++ b/docs/guides/client/continuations.mdx
@@ -1,9 +1,9 @@
---
title: "Continuations"
-description: "Persist and resume Eve client sessions with continuation tokens, session IDs, and stream cursors."
+description: "Persist and resume eve client sessions with continuation tokens, session IDs, and stream cursors."
---
-Every Eve client turn returns two handles, and mixing them up is a common mistake. The TypeScript client tracks both for you:
+Every eve client turn returns two handles, and mixing them up is a common mistake. The TypeScript client tracks both for you:
- `continuationToken`: the resume handle. Use it to send the next user turn.
- `sessionId`: the stream-and-inspect handle. Use it to attach to event history.
@@ -115,4 +115,4 @@ for await (const event of session.stream()) {
- [Streaming](./streaming): stream events and reconnect by index
- [Sessions, runs & streaming](../../concepts/sessions-runs-and-streaming): the raw HTTP contract
-- [Eve channel](../../channels/eve): where continuation tokens come from
+- [eve channel](../../channels/eve): where continuation tokens come from
diff --git a/docs/guides/client/output-schema.mdx b/docs/guides/client/output-schema.mdx
index 0a6f8d660..36a9207c0 100644
--- a/docs/guides/client/output-schema.mdx
+++ b/docs/guides/client/output-schema.mdx
@@ -1,6 +1,6 @@
---
title: "Output Schema"
-description: "Request structured results from Eve client turns and read typed data from MessageResult."
+description: "Request structured results from eve client turns and read typed data from MessageResult."
---
Pass `outputSchema` on a client turn when the caller needs structured data instead of only assistant text. The runtime makes the model satisfy the schema before the turn settles, then emits the final payload as `result.completed`.
diff --git a/docs/guides/client/overview.mdx b/docs/guides/client/overview.mdx
index c92a274a7..0d213ebf2 100644
--- a/docs/guides/client/overview.mdx
+++ b/docs/guides/client/overview.mdx
@@ -1,9 +1,9 @@
---
title: "TypeScript SDK Overview"
-description: "Call an Eve agent from TypeScript with Client, sessions, auth, and health checks."
+description: "Call an eve agent from TypeScript with Client, sessions, auth, and health checks."
---
-The `eve/client` entrypoint is the typed client for Eve's default HTTP API. Use it from scripts, server-to-server integrations, tests, evals, backend jobs, or custom UIs that want the session protocol without hand-writing the POST and NDJSON (newline-delimited JSON) stream loop.
+The `eve/client` entrypoint is the typed client for eve's default HTTP API. Use it from scripts, server-to-server integrations, tests, evals, backend jobs, or custom UIs that want the session protocol without hand-writing the POST and NDJSON (newline-delimited JSON) stream loop.
For browser chat UIs, start with [`useEveAgent`](../frontend/overview). For wire-level details, read [Sessions, runs & streaming](../../concepts/sessions-runs-and-streaming). The client sits between those two: lower level than the frontend hooks, higher level than raw HTTP.
@@ -19,7 +19,7 @@ const client = new Client({
});
```
-`host` is the origin where the Eve routes are mounted. In a same-origin browser integration this is often `""`; scripts and backend services usually name the full URL.
+`host` is the origin where the eve routes are mounted. In a same-origin browser integration this is often `""`; scripts and backend services usually name the full URL.
## Check health
@@ -34,7 +34,7 @@ Non-2xx responses throw `ClientError`, which carries the HTTP `status` and respo
## Authentication
-Pass `auth` when the [Eve channel](../../channels/eve) route requires credentials:
+Pass `auth` when the [eve channel](../../channels/eve) route requires credentials:
```ts
const client = new Client({
@@ -111,6 +111,6 @@ The next pages cover the session lifecycle:
## What to read next
-- [Eve channel](../../channels/eve): the HTTP API this client calls
+- [eve channel](../../channels/eve): the HTTP API this client calls
- [Sessions, runs & streaming](../../concepts/sessions-runs-and-streaming): the raw HTTP contract
- [Frontend](../frontend/overview): browser UI with `useEveAgent`
diff --git a/docs/guides/client/streaming.mdx b/docs/guides/client/streaming.mdx
index 97a2062a8..054e27d4f 100644
--- a/docs/guides/client/streaming.mdx
+++ b/docs/guides/client/streaming.mdx
@@ -1,6 +1,6 @@
---
title: "Streaming"
-description: "Consume Eve client stream events live, reconnect by event index, and aggregate turn results."
+description: "Consume eve client stream events live, reconnect by event index, and aggregate turn results."
---
Every `ClientSession.send()` call posts the turn, then reads the session's NDJSON (newline-delimited JSON) event stream. `MessageResponse` gives you two ways to consume that stream, aggregating it with `result()` or iterating it live.
diff --git a/docs/guides/deployment.md b/docs/guides/deployment.md
index 7e76a579a..6b96dedf5 100644
--- a/docs/guides/deployment.md
+++ b/docs/guides/deployment.md
@@ -1,9 +1,9 @@
---
title: "Deployment"
-description: "A production checklist for shipping an Eve agent on Vercel, covering build output, env and secrets, sandbox backend, prewarm, auth, deploy, and verify."
+description: "A production checklist for shipping an eve agent on Vercel, covering build output, env and secrets, sandbox backend, prewarm, auth, deploy, and verify."
---
-Eve runs the same way locally and on Vercel, so taking an agent from `eve dev` to production is mostly mechanical. Work through this checklist in order.
+eve runs the same way locally and on Vercel, so taking an agent from `eve dev` to production is mostly mechanical. Work through this checklist in order.
## 1. Build
@@ -13,7 +13,7 @@ Eve runs the same way locally and on Vercel, so taking an agent from `eve dev` t
eve build
```
-When `VERCEL` is set (every hosted Vercel build sets it), `eve build` writes the Vercel output bundle under `.vercel/output`. A plain local `eve build` skips that bundle. Either way you get Eve's compiled framework artifacts under `.eve/`, including the discovery manifest, compiled manifest, diagnostics, and module map. Open those to see which authored surface a deployment will load. For the artifact guide and what to do when `eve build` fails, see [Observability](./instrumentation).
+When `VERCEL` is set (every hosted Vercel build sets it), `eve build` writes the Vercel output bundle under `.vercel/output`. A plain local `eve build` skips that bundle. Either way you get eve's compiled framework artifacts under `.eve/`, including the discovery manifest, compiled manifest, diagnostics, and module map. Open those to see which authored surface a deployment will load. For the artifact guide and what to do when `eve build` fails, see [Observability](./instrumentation).
## 2. Environment variables and secrets
@@ -37,11 +37,11 @@ export default defineSandbox({
});
```
-Leave `backend` off and Eve falls back to `defaultBackend()`, which picks the Vercel backend on hosted builds and the local backend everywhere else. One definition, both environments.
+Leave `backend` off and eve falls back to `defaultBackend()`, which picks the Vercel backend on hosted builds and the local backend everywhere else. One definition, both environments.
## 4. Build-time sandbox prewarm
-During hosted builds, Eve prewarms reusable Vercel sandbox templates so the first session doesn't pay the cold-start cost:
+During hosted builds, eve prewarms reusable Vercel sandbox templates so the first session doesn't pay the cold-start cost:
- Prewarm runs only when both `VERCEL` and `VERCEL_DEPLOYMENT_ID` are present.
- A sandbox with no `bootstrap()` and no workspace seed files gets skipped.
@@ -103,9 +103,9 @@ Once the agent is deployed, the platform auto-detects `eve` as the framework and
Agent Runs is separate from the OpenTelemetry exporters configured in [Observability](./instrumentation). Those still work and are the recommended path if you want spans in Braintrust, Datadog, or another third-party backend.
-## How Eve sits behind a host framework
+## How eve sits behind a host framework
-You can deploy an Eve app on its own, or mount it inside a host web framework that owns the rest of the site (marketing pages, a dashboard, other API routes). The host keeps its own routing and serves Eve's routes through the framework integration. Either way, the agent surface and HTTP contract are identical. For mounting Eve in Next.js (`withEve`) and the other supported frameworks, see [Frontend](./frontend/nextjs).
+You can deploy an eve app on its own, or mount it inside a host web framework that owns the rest of the site (marketing pages, a dashboard, other API routes). The host keeps its own routing and serves eve's routes through the framework integration. Either way, the agent surface and HTTP contract are identical. For mounting eve in Next.js (`withEve`) and the other supported frameworks, see [Frontend](./frontend/nextjs).
## Checklist
diff --git a/docs/guides/dev-tui.md b/docs/guides/dev-tui.md
index 44bc580f0..e306f5d21 100644
--- a/docs/guides/dev-tui.md
+++ b/docs/guides/dev-tui.md
@@ -1,6 +1,6 @@
---
title: "Dev TUI"
-description: "Drive an Eve agent locally in an interactive terminal UI. Chat, stream, approve tools, answer questions, tune the display, and point it at a deployment."
+description: "Drive an eve agent locally in an interactive terminal UI. Chat, stream, approve tools, answer questions, tune the display, and point it at a deployment."
---
`eve dev` boots the local runtime and drops you into an interactive terminal UI. You chat with the agent, watch it stream, approve its tool calls, and answer the questions it asks back.
@@ -46,7 +46,7 @@ Each command echoes as an invocation line, asks through a bordered panel that ta
### Configure the model and provider
-Bare `/model` opens the configure menu. "Change model" runs the same searchable model picker setup uses (the Vercel AI Gateway catalog, pre-selected on the model the runtime is serving). A model change is written into your agent's authored source, and the command reports success only after Eve confirms the new id. `/model <provider/model-id>` applies one directly, skipping the menu.
+Bare `/model` opens the configure menu. "Change model" runs the same searchable model picker setup uses (the Vercel AI Gateway catalog, pre-selected on the model the runtime is serving). A model change is written into your agent's authored source, and the command reports success only after eve confirms the new id. `/model <provider/model-id>` applies one directly, skipping the menu.
The provider row opens the provider questions: which model provider to use, and how to connect. Picking something other than Vercel AI Gateway shows wiring instructions for your own provider and stops there, leaving any existing setup untouched. For Vercel AI Gateway, you either paste your own `AI_GATEWAY_API_KEY` (saved straight to `.env.local`) or connect via a project. Connecting via a project asks for a Vercel team, opens that team's existing-project list (picking again re-links), then pulls the project's environment so an AI Gateway credential lands in `.env.local`. The dev server reloads env files automatically, with no restart needed.
diff --git a/docs/guides/frontend/nextjs.mdx b/docs/guides/frontend/nextjs.mdx
index 6110d08a0..62521f127 100644
--- a/docs/guides/frontend/nextjs.mdx
+++ b/docs/guides/frontend/nextjs.mdx
@@ -1,14 +1,14 @@
---
title: "Next.js"
-description: "Run an Eve agent and a Next.js app as one project with withEve."
+description: "Run an eve agent and a Next.js app as one project with withEve."
---
-`eve/next` ships a Next.js frontend and an Eve agent as a single project. Wrap your config with `withEve()` to run both from one dev server and one Vercel deploy. [`useEveAgent`](./overview) finds the mounted routes on its own, so there's no CORS to configure and no URL env vars to keep in sync.
+`eve/next` ships a Next.js frontend and an eve agent as a single project. Wrap your config with `withEve()` to run both from one dev server and one Vercel deploy. [`useEveAgent`](./overview) finds the mounted routes on its own, so there's no CORS to configure and no URL env vars to keep in sync.
## Prerequisites
- The `eve` package installed in your project (`npm install eve@latest`).
-- An existing Eve agent directory. If you don't have one, start from [Getting started](../../getting-started).
+- An existing eve agent directory. If you don't have one, start from [Getting started](../../getting-started).
- A Next.js app to mount the agent in.
## Wrap the Next.js config
@@ -36,10 +36,10 @@ All fields are optional.
| Option | Type | Default | Purpose |
| -------------------- | -------- | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `eveRoot` | `string` | Next.js app root | Path to the Eve app root, relative to `process.cwd()` unless absolute. Set it when the agent lives outside the Next.js project. |
-| `eveBuildCommand` | `string` | `"eve build"` | Build command for the generated Eve Vercel service. Use it when the Eve service needs project-specific prework, without changing the Next.js build. |
-| `servicePrefix` | `string` | `"/_eve_internal/eve"` | Private Vercel route namespace for the Eve service. Must match the Eve service's mount in your Vercel Build Output config when you set it manually. |
-| `devServerTimeoutMs` | `number` | `180000` | Maximum time to wait for the Eve development server to become available. |
+| `eveRoot` | `string` | Next.js app root | Path to the eve app root, relative to `process.cwd()` unless absolute. Set it when the agent lives outside the Next.js project. |
+| `eveBuildCommand` | `string` | `"eve build"` | Build command for the generated eve Vercel service. Use it when the eve service needs project-specific prework, without changing the Next.js build. |
+| `servicePrefix` | `string` | `"/_eve_internal/eve"` | Private Vercel route namespace for the eve service. Must match the eve service's mount in your Vercel Build Output config when you set it manually. |
+| `devServerTimeoutMs` | `number` | `180000` | Maximum time to wait for the eve development server to become available. |
For slow cold starts, increase the development timeout:
@@ -51,7 +51,7 @@ export default withEve(nextConfig, {
## Call the hook
-With `withEve()` in `next.config.ts`, the Eve routes are same-origin, so client code can call [`useEveAgent`](./overview) without naming a host. Cookie-based auth (Auth.js or any session cookie) needs no extra wiring, since the browser already sends those cookies on every Eve request. For non-cookie schemes, attach the credentials yourself:
+With `withEve()` in `next.config.ts`, the eve routes are same-origin, so client code can call [`useEveAgent`](./overview) without naming a host. Cookie-based auth (Auth.js or any session cookie) needs no extra wiring, since the browser already sends those cookies on every eve request. For non-cookie schemes, attach the credentials yourself:
```tsx
const agent = useEveAgent({
@@ -61,7 +61,7 @@ const agent = useEveAgent({
});
```
-The default Eve channel is fail-closed. With no `agent/channels/eve.ts` authored, Eve registers `eveChannel({ auth: [localDev(), vercelOidc()] })`: `localDev()` opens the routes on localhost, `vercelOidc()` admits Vercel OIDC callers in production, and everything else gets a `401`. To run your app's own auth policy, add `agent/channels/eve.ts`:
+The default eve channel is fail-closed. With no `agent/channels/eve.ts` authored, eve registers `eveChannel({ auth: [localDev(), vercelOidc()] })`: `localDev()` opens the routes on localhost, `vercelOidc()` admits Vercel OIDC callers in production, and everything else gets a `401`. To run your app's own auth policy, add `agent/channels/eve.ts`:
```ts title="agent/channels/eve.ts"
import { eveChannel } from "eve/channels/eve";
@@ -74,8 +74,8 @@ For a public demo, use `none()` (also from `eve/channels/auth`) to skip authenti
## Dev vs deploy topology
-- **Local dev.** `npm run dev` boots the Eve dev server next to `next dev` and rewrites the Eve routes over to it. The browser only ever talks to the Next.js origin.
-- **Vercel.** The web app and the Eve runtime deploy as a single project. The web app stays public; the Eve runtime sits behind it on the same site origin. When the agent needs its own build step, set `eveBuildCommand`:
+- **Local dev.** `npm run dev` boots the eve dev server next to `next dev` and rewrites the eve routes over to it. The browser only ever talks to the Next.js origin.
+- **Vercel.** The web app and the eve runtime deploy as a single project. The web app stays public; the eve runtime sits behind it on the same site origin. When the agent needs its own build step, set `eveBuildCommand`:
```ts
export default withEve(nextConfig, {
@@ -83,13 +83,13 @@ For a public demo, use `none()` (also from `eve/channels/auth`) to skip authenti
});
```
-- **Local production build.** `next build && next start` serves the Eve runtime from its built `.output/server/index.mjs` on a stable local port (`4274`) and proxies the Eve routes to it. Run `eve build` first so that output exists. Change the port with `EVE_NEXT_PRODUCTION_PORT`:
+- **Local production build.** `next build && next start` serves the eve runtime from its built `.output/server/index.mjs` on a stable local port (`4274`) and proxies the eve routes to it. Run `eve build` first so that output exists. Change the port with `EVE_NEXT_PRODUCTION_PORT`:
```bash
EVE_NEXT_PRODUCTION_PORT=5000 npm run build && npm start
```
-- **Non-Vercel hosts.** When the Eve service lives on a separate origin, tell Next.js where to find it with `EVE_NEXT_PRODUCTION_ORIGIN`:
+- **Non-Vercel hosts.** When the eve service lives on a separate origin, tell Next.js where to find it with `EVE_NEXT_PRODUCTION_ORIGIN`:
```bash
EVE_NEXT_PRODUCTION_ORIGIN=https://agent.example.com npm run build
diff --git a/docs/guides/frontend/nuxt.mdx b/docs/guides/frontend/nuxt.mdx
index 0bd04e427..832ad0947 100644
--- a/docs/guides/frontend/nuxt.mdx
+++ b/docs/guides/frontend/nuxt.mdx
@@ -1,14 +1,14 @@
---
title: "Nuxt"
-description: "Run an Eve agent and a Nuxt app as one project with the eve/nuxt module."
+description: "Run an eve agent and a Nuxt app as one project with the eve/nuxt module."
---
-The `eve/nuxt` module runs a Nuxt frontend and an Eve agent as a single project from one dev server and one Vercel deploy. The auto-imported [`useEveAgent`](./use-eve-agent-vue) composable finds the mounted routes on its own, so there's no CORS to configure and no URL env vars to keep in sync.
+The `eve/nuxt` module runs a Nuxt frontend and an eve agent as a single project from one dev server and one Vercel deploy. The auto-imported [`useEveAgent`](./use-eve-agent-vue) composable finds the mounted routes on its own, so there's no CORS to configure and no URL env vars to keep in sync.
## Prerequisites
- The `eve` package installed in your project (`npm install eve@latest`).
-- An existing Eve agent directory. If you don't have one, start from [Getting started](../../getting-started).
+- An existing eve agent directory. If you don't have one, start from [Getting started](../../getting-started).
- A Nuxt app to mount the agent in.
## Register the module
@@ -60,7 +60,7 @@ async function handleSubmit() {
</template>
```
-The default Eve channel is fail-closed. With no `agent/channels/eve.ts` authored, Eve registers `eveChannel({ auth: [localDev(), vercelOidc()] })`: `localDev()` opens the routes on localhost, `vercelOidc()` admits Vercel OIDC callers in production, and everything else gets a `401`. To run your own auth policy, add `agent/channels/eve.ts`:
+The default eve channel is fail-closed. With no `agent/channels/eve.ts` authored, eve registers `eveChannel({ auth: [localDev(), vercelOidc()] })`: `localDev()` opens the routes on localhost, `vercelOidc()` admits Vercel OIDC callers in production, and everything else gets a `401`. To run your own auth policy, add `agent/channels/eve.ts`:
```ts title="agent/channels/eve.ts"
import { eveChannel } from "eve/channels/eve";
@@ -73,8 +73,8 @@ For a public demo, use `none()` (also from `eve/channels/auth`) to skip authenti
## Dev vs deploy topology
-- **Local dev.** `npm run dev` starts the Eve dev server next to `nuxt dev` and proxies the Eve routes through it. As far as the browser knows, everything is the Nuxt origin.
-- **Vercel.** A single Vercel project carries both the Nuxt app and the Eve runtime. The web app stays public; the runtime sits behind it on the same origin. Set `eveBuildCommand` when the agent needs its own build step:
+- **Local dev.** `npm run dev` starts the eve dev server next to `nuxt dev` and proxies the eve routes through it. As far as the browser knows, everything is the Nuxt origin.
+- **Vercel.** A single Vercel project carries both the Nuxt app and the eve runtime. The web app stays public; the runtime sits behind it on the same origin. Set `eveBuildCommand` when the agent needs its own build step:
```ts
export default defineNuxtConfig({
@@ -85,7 +85,7 @@ For a public demo, use `none()` (also from `eve/channels/auth`) to skip authenti
});
```
-- **Non-Vercel hosts.** Point Nuxt at a separate Eve origin with `EVE_NUXT_PRODUCTION_ORIGIN`. To override the local port (default `4274`), use `EVE_NUXT_PRODUCTION_PORT`:
+- **Non-Vercel hosts.** Point Nuxt at a separate eve origin with `EVE_NUXT_PRODUCTION_ORIGIN`. To override the local port (default `4274`), use `EVE_NUXT_PRODUCTION_PORT`:
```bash
EVE_NUXT_PRODUCTION_ORIGIN=https://agent.example.com npm run build
diff --git a/docs/guides/frontend/overview.mdx b/docs/guides/frontend/overview.mdx
index b32e37092..95a586491 100644
--- a/docs/guides/frontend/overview.mdx
+++ b/docs/guides/frontend/overview.mdx
@@ -1,16 +1,16 @@
---
title: "Overview"
-description: "Put an Eve agent behind a browser chat UI with useEveAgent."
+description: "Put an eve agent behind a browser chat UI with useEveAgent."
---
-The frontend helpers put a browser chat or agent UI on top of an Eve agent. `useEveAgent()` opens a durable session, sends turns, streams the reply back, and turns the raw event stream into render-ready state. React is the reference implementation; [Vue](./use-eve-agent-vue) and [Svelte](./use-eve-agent-svelte) ship the same surface.
+The frontend helpers put a browser chat or agent UI on top of an eve agent. `useEveAgent()` opens a durable session, sends turns, streams the reply back, and turns the raw event stream into render-ready state. React is the reference implementation; [Vue](./use-eve-agent-vue) and [Svelte](./use-eve-agent-svelte) ship the same surface.
## The integration model
-A browser UI is a client of the agent's HTTP routes (the [Eve channel](../../channels/overview)). Two layers wire it up:
+A browser UI is a client of the agent's HTTP routes (the [eve channel](../../channels/overview)). Two layers wire it up:
-- **The framework integration** mounts the Eve routes on your app's origin, so the browser never crosses a CORS boundary or reads an env var to find the agent. Pick yours: [Next.js](./nextjs) (`withEve`), [Nuxt](./nuxt) (the `eve/nuxt` module), or [SvelteKit](./sveltekit) (the `eveSvelteKit` Vite plugin). On any other stack the hook talks to same-origin `/eve/v1/*` routes directly, or you pass an explicit `host`.
-- **The hook** (`useEveAgent`) holds the session state, streaming, errors, and composer status. It defaults to same-origin Eve routes such as `/eve/v1/session`.
+- **The framework integration** mounts the eve routes on your app's origin, so the browser never crosses a CORS boundary or reads an env var to find the agent. Pick yours: [Next.js](./nextjs) (`withEve`), [Nuxt](./nuxt) (the `eve/nuxt` module), or [SvelteKit](./sveltekit) (the `eveSvelteKit` Vite plugin). On any other stack the hook talks to same-origin `/eve/v1/*` routes directly, or you pass an explicit `host`.
+- **The hook** (`useEveAgent`) holds the session state, streaming, errors, and composer status. It defaults to same-origin eve routes such as `/eve/v1/session`.
The per-framework pages below walk through the wiring step by step: [Next.js](./nextjs), [Nuxt](./nuxt), and [SvelteKit](./sveltekit).
@@ -66,7 +66,7 @@ export function Chat() {
| `data` | Projected UI state from the reducer. Defaults to `{ messages }`. |
| `status` | `"ready"`, `"submitted"`, `"streaming"`, or `"error"`. Drives the composer. |
| `error` | The last `Error` thrown, if any. |
-| `events` | Raw Eve stream events for this session. |
+| `events` | Raw eve stream events for this session. |
| `session` | Serializable session cursor (`sessionId`, `continuationToken`, `streamIndex`). |
| `send` | Send text or the full turn payload (multi-part messages, HITL responses). |
| `stop` | Abort the active request. |
@@ -115,7 +115,7 @@ if (request) {
}
```
-`request.prompt` and `request.options` give you what you need to render the approve and deny UI. The default reducer marks the part as responded immediately, then updates it again once Eve streams the resumed result.
+`request.prompt` and `request.options` give you what you need to render the approve and deny UI. The default reducer marks the part as responded immediately, then updates it again once eve streams the resumed result.
## Attach page context per turn
@@ -143,7 +143,7 @@ const agent = useEveAgent({
On top of `onSessionChange`, the hook takes a few per-turn callbacks:
-- `onEvent(event)`: fires for each Eve stream event as it arrives.
+- `onEvent(event)`: fires for each eve stream event as it arrives.
- `onError(error)`: fires with the last `Error` when a turn fails.
- `onFinish(snapshot)`: fires with the final `{ data, status, session, ... }` snapshot once a turn settles.
@@ -157,7 +157,7 @@ const agent = useEveAgent({
Two more options tune turn behavior:
-- `optimistic` (default `true`): projects submitted user messages into `data` before Eve confirms them with a `message.received` event. These are reducer-facing projection events only. `events` stays the authoritative Eve stream.
+- `optimistic` (default `true`): projects submitted user messages into `data` before eve confirms them with a `message.received` event. These are reducer-facing projection events only. `events` stays the authoritative eve stream.
- `maxReconnectAttempts` (default `3`): stream reconnection budget per turn.
## Custom reducer
@@ -182,7 +182,7 @@ const agent = useEveAgent({ reducer: toolCounter });
// agent.data is ToolLog
```
-`reduce(data, event)` receives both authoritative Eve stream events and client projection events (`client.message.submitted`, `client.message.failed`, `client.input.responded`). Handle the client events too if you want optimistic and HITL state in your projection. Otherwise, return `data` unchanged for them.
+`reduce(data, event)` receives both authoritative eve stream events and client projection events (`client.message.submitted`, `client.message.failed`, `client.input.responded`). Handle the client events too if you want optimistic and HITL state in your projection. Otherwise, return `data` unchanged for them.
## Resumable sessions
@@ -206,7 +206,7 @@ Store the full `session` object (`sessionId`, `continuationToken`, `streamIndex`
## Custom hosts and headers
-Pass `host` when the Eve server isn't same-origin, and pass `auth` or `headers` when the channel needs credentials. Function values are re-resolved before every HTTP request, reconnects included:
+Pass `host` when the eve server isn't same-origin, and pass `auth` or `headers` when the channel needs credentials. Function values are re-resolved before every HTTP request, reconnects included:
```tsx
const agent = useEveAgent({
@@ -231,4 +231,4 @@ const agent = useEveAgent({
- [Sessions, runs & streaming](../../concepts/sessions-runs-and-streaming): the event stream and session cursor
- [Channels](../../channels/overview): the HTTP routes the hook talks to
- [TypeScript SDK](../client/overview): the lower-level client underneath the frontend hooks
-- [Next.js](./nextjs): step-by-step setup for wiring Eve into a Next.js app
+- [Next.js](./nextjs): step-by-step setup for wiring eve into a Next.js app
diff --git a/docs/guides/frontend/sveltekit.mdx b/docs/guides/frontend/sveltekit.mdx
index aad460a71..0ae554cf0 100644
--- a/docs/guides/frontend/sveltekit.mdx
+++ b/docs/guides/frontend/sveltekit.mdx
@@ -1,14 +1,14 @@
---
title: "SvelteKit"
-description: "Run an Eve agent and a SvelteKit app as one project with the eveSvelteKit Vite plugin."
+description: "Run an eve agent and a SvelteKit app as one project with the eveSvelteKit Vite plugin."
---
-`eve/sveltekit` runs a SvelteKit frontend and an Eve agent as one project instead of two services. The `eveSvelteKit()` Vite plugin puts both on one dev server and one Vercel deploy, and [`useEveAgent`](./use-eve-agent-svelte) finds the mounted routes on its own. There's no CORS to configure and no URL env vars to keep in sync.
+`eve/sveltekit` runs a SvelteKit frontend and an eve agent as one project instead of two services. The `eveSvelteKit()` Vite plugin puts both on one dev server and one Vercel deploy, and [`useEveAgent`](./use-eve-agent-svelte) finds the mounted routes on its own. There's no CORS to configure and no URL env vars to keep in sync.
## Prerequisites
- The `eve` package installed in your project (`npm install eve@latest`).
-- An existing Eve agent directory. If you don't have one, start from [Getting started](../../getting-started).
+- An existing eve agent directory. If you don't have one, start from [Getting started](../../getting-started).
- A SvelteKit app to mount the agent in.
## Register the Vite plugin
@@ -69,7 +69,7 @@ With the plugin in `vite.config.ts`, components call [`useEveAgent`](./use-eve-a
</form>
```
-The default Eve channel is fail-closed. With no `agent/channels/eve.ts` authored, Eve registers `eveChannel({ auth: [localDev(), vercelOidc()] })`: `localDev()` opens the routes on localhost, `vercelOidc()` admits Vercel OIDC callers in production, and everything else gets a `401`. To set your own auth policy, add `agent/channels/eve.ts`:
+The default eve channel is fail-closed. With no `agent/channels/eve.ts` authored, eve registers `eveChannel({ auth: [localDev(), vercelOidc()] })`: `localDev()` opens the routes on localhost, `vercelOidc()` admits Vercel OIDC callers in production, and everything else gets a `401`. To set your own auth policy, add `agent/channels/eve.ts`:
```ts title="agent/channels/eve.ts"
import { eveChannel } from "eve/channels/eve";
@@ -82,8 +82,8 @@ For a public demo, use `none()` (also from `eve/channels/auth`) to skip authenti
## Dev vs deploy topology
-- **Local dev.** `npm run dev` boots the Eve dev server next to SvelteKit and proxies the Eve routes to it, so the browser only ever hits the SvelteKit origin. `npm run build && npm run preview` behaves the same way: the preview server gets its own Eve route proxy and either reuses the shared Eve server or starts one.
-- **Vercel.** The SvelteKit app and the Eve runtime deploy as a single project. The web app is public; the Eve runtime sits behind it on the same origin. Use `eveBuildCommand` for a project-specific agent build:
+- **Local dev.** `npm run dev` boots the eve dev server next to SvelteKit and proxies the eve routes to it, so the browser only ever hits the SvelteKit origin. `npm run build && npm run preview` behaves the same way: the preview server gets its own eve route proxy and either reuses the shared eve server or starts one.
+- **Vercel.** The SvelteKit app and the eve runtime deploy as a single project. The web app is public; the eve runtime sits behind it on the same origin. Use `eveBuildCommand` for a project-specific agent build:
```ts
export default defineConfig({
@@ -96,7 +96,7 @@ For a public demo, use `none()` (also from `eve/channels/auth`) to skip authenti
});
```
-- **Non-Vercel hosts.** When the Eve service runs on a separate origin, pass `host` directly to `useEveAgent`:
+- **Non-Vercel hosts.** When the eve service runs on a separate origin, pass `host` directly to `useEveAgent`:
```ts
const agent = useEveAgent({
diff --git a/docs/guides/frontend/use-eve-agent-svelte.mdx b/docs/guides/frontend/use-eve-agent-svelte.mdx
index a961c8e1e..6ec911ca6 100644
--- a/docs/guides/frontend/use-eve-agent-svelte.mdx
+++ b/docs/guides/frontend/use-eve-agent-svelte.mdx
@@ -1,9 +1,9 @@
---
title: "useEveAgent (Svelte)"
-description: "Svelte 5 binding that drives an Eve agent session from the browser."
+description: "Svelte 5 binding that drives an eve agent session from the browser."
---
-`useEveAgent()` from `eve/svelte` is the browser side of an Eve session in a Svelte 5 app. Call it once for a long-lived session you can send turns to, with every stream event projected into rune-friendly reactive data. On SvelteKit, the [Vite plugin](./sveltekit) wires up the routes. The [frontend overview](./overview) covers the model shared across frameworks.
+`useEveAgent()` from `eve/svelte` is the browser side of an eve session in a Svelte 5 app. Call it once for a long-lived session you can send turns to, with every stream event projected into rune-friendly reactive data. On SvelteKit, the [Vite plugin](./sveltekit) wires up the routes. The [frontend overview](./overview) covers the model shared across frameworks.
## Basic usage
@@ -117,7 +117,7 @@ const agent = useEveAgent({
## Custom host and credentials
-Point `host` at an Eve server on a different origin, and pass credentials through `auth` or `headers`. When you supply a function, it re-resolves before every request:
+Point `host` at an eve server on a different origin, and pass credentials through `auth` or `headers`. When you supply a function, it re-resolves before every request:
```ts
const agent = useEveAgent({
@@ -154,7 +154,7 @@ const agent = useEveAgent({
The binding takes a few per-turn callbacks:
-- `onEvent(event)`: fires for each Eve stream event as it arrives.
+- `onEvent(event)`: fires for each eve stream event as it arrives.
- `onError(error)`: fires with the last `Error` when a turn fails.
- `onFinish(snapshot)`: fires with the final snapshot once a turn settles.
- `onSessionChange(session)`: fires when the session cursor advances. Persist it to resume across reloads.
@@ -169,7 +169,7 @@ const agent = useEveAgent({
Two more options tune turn behavior:
-- `optimistic` (default `true`): projects submitted user messages into `data` before Eve confirms them with a `message.received` event. These are reducer-facing projection events only; `events` stays the authoritative Eve stream.
+- `optimistic` (default `true`): projects submitted user messages into `data` before eve confirms them with a `message.received` event. These are reducer-facing projection events only; `events` stays the authoritative eve stream.
- `maxReconnectAttempts` (default `3`): stream reconnection budget per turn.
## Custom reducer
@@ -194,7 +194,7 @@ const agent = useEveAgent({ reducer: toolCounter });
// agent.data is ToolLog
```
-`reduce(data, event)` receives both authoritative Eve stream events and client projection events (`client.message.submitted`, `client.message.failed`, `client.input.responded`). Handle the client events too if you want optimistic and HITL state in your projection. Otherwise, return `data` unchanged for them.
+`reduce(data, event)` receives both authoritative eve stream events and client projection events (`client.message.submitted`, `client.message.failed`, `client.input.responded`). Handle the client events too if you want optimistic and HITL state in your projection. Otherwise, return `data` unchanged for them.
## What to read next
diff --git a/docs/guides/frontend/use-eve-agent-vue.mdx b/docs/guides/frontend/use-eve-agent-vue.mdx
index e5318d3dd..efdcebe97 100644
--- a/docs/guides/frontend/use-eve-agent-vue.mdx
+++ b/docs/guides/frontend/use-eve-agent-vue.mdx
@@ -1,9 +1,9 @@
---
title: "useEveAgent (Vue)"
-description: "Vue composable that drives an Eve agent session from the browser."
+description: "Vue composable that drives an eve agent session from the browser."
---
-`useEveAgent()` from `eve/vue` is how a Vue app talks to an Eve session. It opens a long-lived session, sends turns, and folds every stream event into reactive data you can bind in a template. Nuxt auto-imports it through the [module](./nuxt), and the [frontend overview](./overview) covers the shared model.
+`useEveAgent()` from `eve/vue` is how a Vue app talks to an eve session. It opens a long-lived session, sends turns, and folds every stream event into reactive data you can bind in a template. Nuxt auto-imports it through the [module](./nuxt), and the [frontend overview](./overview) covers the shared model.
## Basic usage
@@ -130,7 +130,7 @@ const agent = useEveAgent({
## Custom host and credentials
-When your Eve server lives somewhere other than the same origin, point at it with `host` and attach credentials through `auth` or `headers`. Pass a function and it re-resolves before each request:
+When your eve server lives somewhere other than the same origin, point at it with `host` and attach credentials through `auth` or `headers`. Pass a function and it re-resolves before each request:
```ts
const agent = useEveAgent({
@@ -167,7 +167,7 @@ const agent = useEveAgent({
The composable takes a few per-turn callbacks:
-- `onEvent(event)`: fires for each Eve stream event as it arrives.
+- `onEvent(event)`: fires for each eve stream event as it arrives.
- `onError(error)`: fires with the last `Error` when a turn fails.
- `onFinish(snapshot)`: fires with the final snapshot once a turn settles.
- `onSessionChange(session)`: fires when the session cursor advances. Persist it to resume across reloads.
@@ -182,7 +182,7 @@ const agent = useEveAgent({
Two more options tune turn behavior:
-- `optimistic` (default `true`): projects submitted user messages into `data` before Eve confirms them with a `message.received` event. These are reducer-facing projection events only; `events` stays the authoritative Eve stream.
+- `optimistic` (default `true`): projects submitted user messages into `data` before eve confirms them with a `message.received` event. These are reducer-facing projection events only; `events` stays the authoritative eve stream.
- `maxReconnectAttempts` (default `3`): stream reconnection budget per turn.
## Custom reducer
@@ -207,7 +207,7 @@ const agent = useEveAgent({ reducer: toolCounter });
// agent.data.value is ToolLog
```
-`reduce(data, event)` receives both authoritative Eve stream events and client projection events (`client.message.submitted`, `client.message.failed`, `client.input.responded`). Handle the client events too if you want optimistic and HITL state in your projection. Otherwise, return `data` unchanged for them.
+`reduce(data, event)` receives both authoritative eve stream events and client projection events (`client.message.submitted`, `client.message.failed`, `client.input.responded`). Handle the client events too if you want optimistic and HITL state in your projection. Otherwise, return `data` unchanged for them.
## What to read next
diff --git a/docs/guides/hooks.md b/docs/guides/hooks.md
index 0e7d5252b..0a4732b6d 100644
--- a/docs/guides/hooks.md
+++ b/docs/guides/hooks.md
@@ -3,7 +3,7 @@ title: "Hooks"
description: "Subscribe to runtime stream events from agent/hooks/."
---
-Hooks are Eve's authored extension points for the runtime event stream. A hook subscribes to stream events and runs side effects after each event is durably recorded, such as audit logging, metrics and alerting, or persisting every session and message to your own database for analytics. Reach for one to observe what the agent does without writing a tool, a context provider (a value made available across a step), or a channel adapter handler (a handler defined on a channel's adapter; see [Channels](../channels)).
+Hooks are eve's authored extension points for the runtime event stream. A hook subscribes to stream events and runs side effects after each event is durably recorded, such as audit logging, metrics and alerting, or persisting every session and message to your own database for analytics. Reach for one to observe what the agent does without writing a tool, a context provider (a value made available across a step), or a channel adapter handler (a handler defined on a channel's adapter; see [Channels](../channels)).
## Define a hook
@@ -83,7 +83,7 @@ Hooks always run after the event is durably recorded, so if a hook throws, the s
## What happens when a hook throws
-A thrown handler propagates through the emit composer and surfaces as `turn.failed`. If a hook subscribed to a failure-cascade event also throws, it escalates to `session.failed`. For belt-and-suspenders semantics inside a hook, wrap the body in `try`/`catch`. Eve treats a thrown hook as a real failure.
+A thrown handler propagates through the emit composer and surfaces as `turn.failed`. If a hook subscribed to a failure-cascade event also throws, it escalates to `session.failed`. For belt-and-suspenders semantics inside a hook, wrap the body in `try`/`catch`. eve treats a thrown hook as a real failure.
## Subagent isolation
diff --git a/docs/guides/instrumentation.md b/docs/guides/instrumentation.md
index e16c44ead..97eafbf06 100644
--- a/docs/guides/instrumentation.md
+++ b/docs/guides/instrumentation.md
@@ -1,15 +1,15 @@
---
title: "instrumentation.ts"
-description: "Trace an agent with OpenTelemetry in instrumentation.ts, read the workflow run tags Eve emits, and debug discovery with eve info and the common-failures table."
+description: "Trace an agent with OpenTelemetry in instrumentation.ts, read the workflow run tags eve emits, and debug discovery with eve info and the common-failures table."
---
-`instrumentation.ts` is where you configure how an Eve agent is observed. The framework auto-discovers `agent/instrumentation.ts` and runs it at server startup before any agent code. Its presence implicitly enables telemetry, so there is no separate `isEnabled` toggle.
+`instrumentation.ts` is where you configure how an eve agent is observed. The framework auto-discovers `agent/instrumentation.ts` and runs it at server startup before any agent code. Its presence implicitly enables telemetry, so there is no separate `isEnabled` toggle.
If you intend to export telemetry, review the exporter destination, data categories, and required legal approvals before enabling telemetry.
## Three observability surfaces
-Eve observes an agent through three distinct surfaces. They do not all live in this file, and they write to different places:
+eve observes an agent through three distinct surfaces. They do not all live in this file, and they write to different places:
| Surface | Configured in `instrumentation.ts`? | What it is |
| -------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -17,7 +17,7 @@ Eve observes an agent through three distinct surfaces. They do not all live in t
| **OpenTelemetry export** | Yes: `setup`, `recordInputs`, `recordOutputs`, `functionId` | Where AI SDK spans are exported and what they record. |
| **Runtime context events** | Yes: `events["step.started"]` | Per-model-call values written into the AI SDK's runtime context, which the AI SDK carries onto its spans. |
-The two configurable surfaces send AI SDK spans to your OpenTelemetry backend. Workflow run tags are a separate system, queryable in the Workflow dashboard rather than on your OTel spans. The sections below cover what you configure here; [Workflow run tags](#workflow-run-tags) documents what Eve emits on its own.
+The two configurable surfaces send AI SDK spans to your OpenTelemetry backend. Workflow run tags are a separate system, queryable in the Workflow dashboard rather than on your OTel spans. The sections below cover what you configure here; [Workflow run tags](#workflow-run-tags) documents what eve emits on its own.
## Define instrumentation
@@ -60,7 +60,7 @@ The third configurable surface, [runtime context events](#runtime-context), atta
## Runtime context
-_Runtime context_ is an [AI SDK concept](https://ai-sdk.dev/docs/reference/ai-sdk-core/stream-text): a user-defined object that flows through a generation lifecycle. Eve exposes it through `events["step.started"]`, a callback that runs once Eve has assembled the model input for an attempt and returns `{ runtimeContext }`. Because Eve registers the AI SDK's OpenTelemetry integration with runtime context enabled, those returned values ride onto the model-call span and its children. The field is named `runtimeContext`, not `metadata`, because AI SDK v7 carries per-call attributes on runtime context rather than a dedicated metadata field.
+_Runtime context_ is an [AI SDK concept](https://ai-sdk.dev/docs/reference/ai-sdk-core/stream-text): a user-defined object that flows through a generation lifecycle. eve exposes it through `events["step.started"]`, a callback that runs once eve has assembled the model input for an attempt and returns `{ runtimeContext }`. Because eve registers the AI SDK's OpenTelemetry integration with runtime context enabled, those returned values ride onto the model-call span and its children. The field is named `runtimeContext`, not `metadata`, because AI SDK v7 carries per-call attributes on runtime context rather than a dedicated metadata field.
Use it when the values depend on the current session, turn, step, channel, or model input:
@@ -94,7 +94,7 @@ The callback receives:
- `channel`: the channel's `kind` and the metadata projected by the active channel
- `modelInput`: the final instructions and messages passed to the model call
-A channel exposes its identity through `kind`, the discriminant you narrow on. For authored channels it is `channel:<name>`, where `<name>` is the channel's filename under `agent/channels/`, so `agent/channels/support.ts` is `channel:support`. Framework channels use `http`, `schedule`, or `subagent`, and an unrecognized or absent kind normalizes to `unknown`. The kind is also emitted as the `eve.channel.kind` span attribute. Eve emits compiler-owned typings keyed by the channel filename, so you can narrow either by checking `input.channel.kind === "channel:support"` or by using `isChannel(input.channel, supportChannel)`.
+A channel exposes its identity through `kind`, the discriminant you narrow on. For authored channels it is `channel:<name>`, where `<name>` is the channel's filename under `agent/channels/`, so `agent/channels/support.ts` is `channel:support`. Framework channels use `http`, `schedule`, or `subagent`, and an unrecognized or absent kind normalizes to `unknown`. The kind is also emitted as the `eve.channel.kind` span attribute. eve emits compiler-owned typings keyed by the channel filename, so you can narrow either by checking `input.channel.kind === "channel:support"` or by using `isChannel(input.channel, supportChannel)`.
Channel metadata is channel-owned. Built-in channels expose only the fields they choose to make observable; Slack, for example, projects `channelId`, `teamId`, `threadTs`, and `triggeringUserId` from its durable channel state. User-authored channels expose their own projection by returning `metadata(state)` from `defineChannel`. Runtime instrumentation never falls back to raw channel state.
@@ -113,11 +113,11 @@ ai.eve.turn {eve.session.id}
+-- ai.streamText step 3 (final text)
```
-Eve creates the `ai.eve.turn` parent span per turn and passes enriched telemetry to the AI SDK so model calls and tool executions are traced automatically. Session, turn, step, and channel context is injected as the framework half of the runtime context (`eve.version`, `eve.session.id`, `eve.environment`, `eve.turn.id`, `eve.turn.sequence`, `eve.step.index`, `eve.channel.kind`) and rides onto the spans alongside any values your `events["step.started"]` callback returns under `runtimeContext`.
+eve creates the `ai.eve.turn` parent span per turn and passes enriched telemetry to the AI SDK so model calls and tool executions are traced automatically. Session, turn, step, and channel context is injected as the framework half of the runtime context (`eve.version`, `eve.session.id`, `eve.environment`, `eve.turn.id`, `eve.turn.sequence`, `eve.step.index`, `eve.channel.kind`) and rides onto the spans alongside any values your `events["step.started"]` callback returns under `runtimeContext`.
## Workflow run tags
-Separately from OpenTelemetry, Eve tags every workflow run with reserved `$eve.*` attributes. These live on the Vercel Workflow run, queryable in the Workflow dashboard, not on OTel spans, and you do not configure them: they are framework-owned and emitted automatically on every session, turn, and subagent run, whether or not an `instrumentation.ts` file is present. Authored code cannot set or override the `$eve.` namespace.
+Separately from OpenTelemetry, eve tags every workflow run with reserved `$eve.*` attributes. These live on the Vercel Workflow run, queryable in the Workflow dashboard, not on OTel spans, and you do not configure them: they are framework-owned and emitted automatically on every session, turn, and subagent run, whether or not an `instrumentation.ts` file is present. Authored code cannot set or override the `$eve.` namespace.
They let a dashboard reconstruct the tree of runs behind a single agent invocation and surface model and token usage without reading run bodies.
@@ -144,14 +144,14 @@ Note: By default, telemetry records full message history and model outputs You m
## Debugging
-`eve info` is the fastest way to see what Eve actually picked up: the active tools, skills, subagents, schedules, routes, and discovery diagnostics. Eve also writes inspectable artifacts under `.eve/`, kept even when discovery hits errors:
+`eve info` is the fastest way to see what eve actually picked up: the active tools, skills, subagents, schedules, routes, and discovery diagnostics. eve also writes inspectable artifacts under `.eve/`, kept even when discovery hits errors:
| Artifact | Tells you |
| ------------------------------- | ------------------------------------------- |
-| `agent-discovery-manifest.json` | what Eve found on disk |
+| `agent-discovery-manifest.json` | what eve found on disk |
| `diagnostics.json` | authored-shape errors and warnings |
-| `compiled-agent-manifest.json` | the serialized surface Eve loads at runtime |
-| `module-map.mjs` | compiled module entrypoints Eve imports |
+| `compiled-agent-manifest.json` | the serialized surface eve loads at runtime |
+| `module-map.mjs` | compiled module entrypoints eve imports |
When `eve build` fails on discovery errors, the CLI prints the full diagnostics report (severity, message, source path) and the path to the diagnostics artifact.
diff --git a/docs/guides/remote-agents.md b/docs/guides/remote-agents.md
index c396e328f..bc68da496 100644
--- a/docs/guides/remote-agents.md
+++ b/docs/guides/remote-agents.md
@@ -1,9 +1,9 @@
---
title: "Remote Agents"
-description: "Call another Eve deployment as a subagent with defineRemoteAgent: same lowered tool shape, outbound auth, durable callback dispatch."
+description: "Call another eve deployment as a subagent with defineRemoteAgent: same lowered tool shape, outbound auth, durable callback dispatch."
---
-`defineRemoteAgent` calls a separately deployed Eve agent as if it were a local subagent. Reach for it when the specialist you delegate to is a separately owned agent behind its own URL rather than a directory in your repo.
+`defineRemoteAgent` calls a separately deployed eve agent as if it were a local subagent. Reach for it when the specialist you delegate to is a separately owned agent behind its own URL rather than a directory in your repo.
The file lives under `agent/subagents/`, so its tool name is derived from the path. There's no `name` field.
@@ -22,7 +22,7 @@ export default defineRemoteAgent({
| Parameter | Type | Required | Default | Description |
| -------------- | ------------------------------- | -------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
-| `url` | `string` | Yes | n/a | Base URL of the remote Eve deployment to call. |
+| `url` | `string` | Yes | n/a | Base URL of the remote eve deployment to call. |
| `description` | `string` | Yes | n/a | Model-visible delegation description. |
| `auth` | `OutboundAuthFn` | No | none | Outbound auth hook from `eve/agents/auth`. |
| `headers` | `HeadersValue` | No | none | Static or lazily resolved request headers. |
@@ -43,7 +43,7 @@ A remote agent lowers to the same `{ message, outputSchema? }` tool shape as a l
| `bearer(token)` | `Authorization: Bearer <token>` (static or lazily resolved) |
| `basic({ username, password })` | `Authorization: Basic …` |
-If you are calling another Vercel-deployed Eve agent, reach for `vercelOidc()`. The remote verifies the OIDC token to authorize the caller. See [Auth & route protection](./auth-and-route-protection) for the receiving side.
+If you are calling another Vercel-deployed eve agent, reach for `vercelOidc()`. The remote verifies the OIDC token to authorize the caller. See [Auth & route protection](./auth-and-route-protection) for the receiving side.
## How remote dispatch and callbacks work
diff --git a/docs/guides/session-context.md b/docs/guides/session-context.md
index c8dc9dd94..c3bad69ea 100644
--- a/docs/guides/session-context.md
+++ b/docs/guides/session-context.md
@@ -3,7 +3,7 @@ title: "Session Context"
description: "Runtime helpers: ctx.session, ctx.getSandbox, ctx.getSkill, and defineState."
---
-Eve exposes runtime state through the `ctx` parameter passed to tool `execute`, hook handlers, and channel event handlers:
+eve exposes runtime state through the `ctx` parameter passed to tool `execute`, hook handlers, and channel event handlers:
- `ctx.session`: session metadata, turn, auth, and parent lineage
- `ctx.getSandbox()`: live sandbox handle for the current agent
@@ -66,7 +66,7 @@ const result = await sandbox.run({ command: "npm test" });
Behavior:
- It takes no arguments. Each agent has exactly one sandbox.
-- It is async because Eve binds or restores sandbox state lazily.
+- It is async because eve binds or restores sandbox state lazily.
- It only works when sandbox access is attached to the active runtime path.
- Visibility is node-local. A subagent sees its own sandbox, not the parent's.
@@ -119,7 +119,7 @@ export const budget = defineState<BudgetState>("myapp.budget", () => ({
Safe places:
- inside `defineTool(...).execute(input, ctx)`
-- inside authored callbacks Eve runs inside the runtime
+- inside authored callbacks eve runs inside the runtime
- after asynchronous boundaries inside the same authored execution chain
Unsafe places:
@@ -128,7 +128,7 @@ Unsafe places:
- build scripts
- discovery-time code paths
-If you call them outside an active Eve runtime context, they throw immediately with a message explaining the required scope.
+If you call them outside an active eve runtime context, they throw immediately with a message explaining the required scope.
## How it works
diff --git a/docs/guides/state.md b/docs/guides/state.md
index 601deda95..93532b786 100644
--- a/docs/guides/state.md
+++ b/docs/guides/state.md
@@ -42,7 +42,7 @@ export default defineTool({
});
```
-`get()` and `update()` require an active Eve context. Calling them outside tools, hooks, or framework-managed code throws.
+`get()` and `update()` require an active eve context. Calling them outside tools, hooks, or framework-managed code throws.
## Reset state between turns
diff --git a/docs/instructions.mdx b/docs/instructions.mdx
index 547ac1a1f..d4a622803 100644
--- a/docs/instructions.mdx
+++ b/docs/instructions.mdx
@@ -3,7 +3,7 @@ title: "Instructions"
description: "Author the agent's always-on system prompt with instructions.md or instructions.ts."
---
-Instructions are the always-on system prompt, the agent's permanent identity rather than a procedure it pulls in when the moment calls for it. Use them for anything that should hold on every turn, such as a rule, a persona, or a constraint. Eve prepends the instructions to every model call in the session.
+Instructions are the always-on system prompt, the agent's permanent identity rather than a procedure it pulls in when the moment calls for it. Use them for anything that should hold on every turn, such as a rule, a persona, or a constraint. eve prepends the instructions to every model call in the session.
## Author instructions
@@ -28,11 +28,11 @@ export default defineInstructions({
});
```
-`defineInstructions` takes one field, `markdown`, the resolved prompt text. A module-backed prompt runs once at build time. Eve captures the resulting markdown into the compiled manifest, so the runtime serves the same prompt every session and never re-runs the module.
+`defineInstructions` takes one field, `markdown`, the resolved prompt text. A module-backed prompt runs once at build time. eve captures the resulting markdown into the compiled manifest, so the runtime serves the same prompt every session and never re-runs the module.
## Split instructions across a directory
-For more than one file, add an `agent/instructions/` directory. Eve reads its entries non-recursively and accepts both `.md` files and `.ts` modules (a `.ts` file can wrap `defineInstructions` or `defineDynamic`). Entries combine in alphabetical order by filename (`localeCompare`).
+For more than one file, add an `agent/instructions/` directory. eve reads its entries non-recursively and accepts both `.md` files and `.ts` modules (a `.ts` file can wrap `defineInstructions` or `defineDynamic`). Entries combine in alphabetical order by filename (`localeCompare`).
A flat `agent/instructions.md` (or `.ts`) at the agent root and the directory can coexist. The root file's content comes first, then the sorted directory entries. You cannot author both `instructions.md` and `instructions.ts` at the root; that pairing is a build error.
@@ -57,7 +57,7 @@ To resolve the prompt at runtime from session context (auth, tenant, or channel)
As the deployer, it is your responsibility to ensure your agent complies with applicable laws.
-Where an Eve agent communicates with people, you may be required to disclose that they are interacting with an automated AI system where law requires it. Eve does not add this disclosure automatically; configure it in your instructions and/or channel responses.
+Where an eve agent communicates with people, you may be required to disclose that they are interacting with an automated AI system where law requires it. eve does not add this disclosure automatically; configure it in your instructions and/or channel responses.
## What to read next
diff --git a/docs/introduction.mdx b/docs/introduction.mdx
index a2a8dbfed..82f8a7138 100644
--- a/docs/introduction.mdx
+++ b/docs/introduction.mdx
@@ -1,21 +1,21 @@
---
title: "Introduction"
-description: "How an Eve agent is laid out as files, what runs when a message arrives, and the building blocks you add as it grows."
+description: "How an eve agent is laid out as files, what runs when a message arrives, and the building blocks you add as it grows."
---
-Eve is a framework for building durable agents as ordinary files in a TypeScript project.
+eve is a framework for building durable agents as ordinary files in a TypeScript project.
-Instead of one large configuration object, each part of your agent gets a clear home. Instructions go in one file, tools in one folder, channels in another. Eve discovers that structure and turns it into an agent that runs locally, serves HTTP, connects to other platforms, and keeps working across many turns.
+Instead of one large configuration object, each part of your agent gets a clear home. Instructions go in one file, tools in one folder, channels in another. eve discovers that structure and turns it into an agent that runs locally, serves HTTP, connects to other platforms, and keeps working across many turns.
<Callout>
- Eve is currently in beta and subject to the [Vercel beta
+ eve is currently in beta and subject to the [Vercel beta
terms](https://vercel.com/docs/release-phases/public-beta-agreement); the framework, APIs,
documentation, and behavior may change before general availability.
</Callout>
-## An Eve project at a glance
+## An eve project at a glance
-A small Eve app looks like this:
+A small eve app looks like this:
```text
my-agent/
@@ -31,7 +31,7 @@ my-agent/
└── slack.ts
```
-You can understand most Eve projects by reading that tree:
+You can understand most eve projects by reading that tree:
- `instructions.md` tells the agent who it is and how it should behave.
- [`agent.ts`](./agent-config) chooses the model and configures runtime options.
@@ -43,7 +43,7 @@ Start with only `instructions.md` and `agent.ts`. Add the other folders when the
## The files are the interface
-Eve is [filesystem-first](./reference/project-layout). A file's location says what it does, and its path usually gives it a name. For example, this file:
+eve is [filesystem-first](./reference/project-layout). A file's location says what it does, and its path usually gives it a name. For example, this file:
```text
agent/tools/get_weather.ts
@@ -64,17 +64,17 @@ export default defineTool({
});
```
-There is no separate registry to keep in sync. Add the file and Eve discovers it; move or rename it and its identity moves with it. See [Tools](./tools) for the complete API.
+There is no separate registry to keep in sync. Add the file and eve discovers it; move or rename it and its identity moves with it. See [Tools](./tools) for the complete API.
## What happens when a message arrives
-The same flow runs whether a message comes from a web app, the terminal, or Slack. Eve turns the platform input into a message, gives the model its instructions, skills, tools, and conversation history, runs the work (calling tools and subagents as needed), saves the session and streams events, then delivers the result back in the form the platform expects.
+The same flow runs whether a message comes from a web app, the terminal, or Slack. eve turns the platform input into a message, gives the model its instructions, skills, tools, and conversation history, runs the work (calling tools and subagents as needed), saves the session and streams events, then delivers the result back in the form the platform expects.
That keeps agent behavior portable. Your weather tool does not need to know whether the question came from a browser or from Slack.
## Durable by default
-An Eve session is more than one request and one response. It can:
+An eve session is more than one request and one response. It can:
- Stream progress while work is happening
- Call tools and subagents
@@ -82,7 +82,7 @@ An Eve session is more than one request and one response. It can:
- Resume after that answer arrives
- Keep durable state across turns
-Under the hood, Eve uses the open-source [Workflow SDK](https://workflow-sdk.dev) to make sessions durable, resumable, and crash-safe. Eve handles that machinery so your tools focus on the work itself.
+Under the hood, eve uses the open-source [Workflow SDK](https://workflow-sdk.dev) to make sessions durable, resumable, and crash-safe. eve handles that machinery so your tools focus on the work itself.
## Grow the project by adding capabilities
diff --git a/docs/reference/cli.md b/docs/reference/cli.md
index a21ce07ad..5b7730d9b 100644
--- a/docs/reference/cli.md
+++ b/docs/reference/cli.md
@@ -65,11 +65,11 @@ Useful artifacts written under `.eve/` (preserved even on partial failure):
| Artifact | Description |
| ---------------------------------------------- | ---------------------------------------------------- |
-| `.eve/discovery/agent-discovery-manifest.json` | What Eve found on disk |
+| `.eve/discovery/agent-discovery-manifest.json` | What eve found on disk |
| `.eve/discovery/diagnostics.json` | Authored-shape errors and warnings |
-| `.eve/compile/compiled-agent-manifest.json` | The serialized authored surface Eve loads at runtime |
+| `.eve/compile/compiled-agent-manifest.json` | The serialized authored surface eve loads at runtime |
| `.eve/compile/compile-metadata.json` | Build-time metadata and paths |
-| `.eve/compile/module-map.mjs` | Compiled module entrypoints Eve imports at runtime |
+| `.eve/compile/module-map.mjs` | Compiled module entrypoints eve imports at runtime |
## `eve start`
@@ -109,7 +109,7 @@ Pass a bare URL as the only argument and the UI connects to that server instead
| `--context-size <tokens>` | number | none | Model context window size, shown as a usage percentage |
| `--logs <mode>` | enum | `stderr` | Server/agent logs to show: `all` \| `stderr` \| `sandbox` \| `none` |
-Local dev writes the active server process ID to `.eve/dev-process.pid`. If another `eve dev` starts for the same agent while that process is still running, Eve exits with a message that includes the command to stop the existing server.
+Local dev writes the active server process ID to `.eve/dev-process.pid`. If another `eve dev` starts for the same agent while that process is still running, eve exits with a message that includes the command to stop the existing server.
Local dev keeps immutable runtime source snapshots under `.eve/dev-runtime/snapshots/` so in-flight sessions hold a consistent code revision while new prompts pick up rebuilds. On startup, `eve dev` prunes stale runtime snapshots and old local sandbox templates in the background. For manual cleanup, stop `eve dev` and delete `.eve/dev-runtime/snapshots/` or `.eve/sandbox-cache/local/templates/`.
@@ -119,7 +119,7 @@ Local dev keeps immutable runtime source snapshots under `.eve/dev-runtime/snaps
eve link
```
-Links the current directory to an existing Vercel project. You select a team and then a project, and Eve pulls the project's environment so an AI Gateway credential (`VERCEL_OIDC_TOKEN` or `AI_GATEWAY_API_KEY`) lands in `.env.local`, then verifies one actually did. Running it again re-links: the pickers always run, and the new choice wins. The command is interactive only; in CI, use `vercel link --project <name> --yes` instead. A running `eve dev` reloads env files automatically, so you don't need to restart after the pull.
+Links the current directory to an existing Vercel project. You select a team and then a project, and eve pulls the project's environment so an AI Gateway credential (`VERCEL_OIDC_TOKEN` or `AI_GATEWAY_API_KEY`) lands in `.env.local`, then verifies one actually did. Running it again re-links: the pickers always run, and the new choice wins. The command is interactive only; in CI, use `vercel link --project <name> --yes` instead. A running `eve dev` reloads env files automatically, so you don't need to restart after the pull.
## `eve deploy`
diff --git a/docs/reference/project-layout.md b/docs/reference/project-layout.md
index 10e9a797e..b4239801a 100644
--- a/docs/reference/project-layout.md
+++ b/docs/reference/project-layout.md
@@ -3,7 +3,7 @@ title: "Project Layout"
description: "Authored slots under agent/ and the path-derived naming rule."
---
-Eve builds an agent by walking the filesystem under `agent/`. Each directory is an authored slot, and the slot a file lands in determines how Eve loads it.
+eve builds an agent by walking the filesystem under `agent/`. Each directory is an authored slot, and the slot a file lands in determines how eve loads it.
## Naming rule
@@ -64,7 +64,7 @@ The Subagents column states whether a local subagent (`subagents/<id>/`) can aut
## What reaches the runtime workspace
-Eve does not mount the whole tree. Only two sources land in the sandbox workspace:
+eve does not mount the whole tree. Only two sources land in the sandbox workspace:
- `skills/` files → `/workspace/skills/...`
- `agent/sandbox/workspace/**` → `/workspace/...` at session bootstrap
@@ -111,9 +111,9 @@ my-agent/
Prefer the nested layout. It keeps the app root separate from the authored surface.
-## Why didn't Eve discover my file?
+## Why didn't eve discover my file?
-Run `eve info`. It lists the discovered surface and prints discovery diagnostics. From there, check that the file sits in the right authored slot (per the slot table above) and that the root-vs-subagent boundary is valid. Eve also writes inspectable artifacts under `.eve/`. See the debugging artifacts in [instrumentation.ts](../guides/instrumentation) and the [CLI](./cli) reference.
+Run `eve info`. It lists the discovered surface and prints discovery diagnostics. From there, check that the file sits in the right authored slot (per the slot table above) and that the root-vs-subagent boundary is valid. eve also writes inspectable artifacts under `.eve/`. See the debugging artifacts in [instrumentation.ts](../guides/instrumentation) and the [CLI](./cli) reference.
## What to read next
diff --git a/docs/responsible-use.md b/docs/responsible-use.md
index e9f38b7be..54d9af04f 100644
--- a/docs/responsible-use.md
+++ b/docs/responsible-use.md
@@ -1,14 +1,14 @@
---
title: "Responsible Use"
-description: "Deployer responsibility and safeguards to review before using Eve with sensitive, regulated, or production data."
+description: "Deployer responsibility and safeguards to review before using eve with sensitive, regulated, or production data."
---
As the deployer, it is your responsibility to ensure your agent complies with applicable laws.
You are responsible for configuring approval policies, tool restrictions, connection scopes, route/session authorization, sandbox controls, telemetry exports, and other safeguards appropriate for your use case.
-Before using Eve with non-public, sensitive, regulated, or production data, review which default tools, custom tools, MCP tools, shell/file/web tools, connected services, subagents, schedules, and external actions are available to the agent.
+Before using eve with non-public, sensitive, regulated, or production data, review which default tools, custom tools, MCP tools, shell/file/web tools, connected services, subagents, schedules, and external actions are available to the agent.
Require human approval or other safeguards for sensitive, irreversible, regulated, financial, healthcare, employment, housing, legal, safety-impacting, user-impacting, or external side-effecting actions.
-Unless you configure stricter controls, Eve agents may operate with permissive settings, including tool execution without human approval where approval is omitted and sandbox network egress that is not deny-all. Do not rely on model behavior alone to prevent sensitive or irreversible actions.
+Unless you configure stricter controls, eve agents may operate with permissive settings, including tool execution without human approval where approval is omitted and sandbox network egress that is not deny-all. Do not rely on model behavior alone to prevent sensitive or irreversible actions.
diff --git a/docs/sandbox.mdx b/docs/sandbox.mdx
index dbdab038c..b324cf7bd 100644
--- a/docs/sandbox.mdx
+++ b/docs/sandbox.mdx
@@ -3,7 +3,7 @@ title: "Sandbox"
description: "The agent's isolated bash environment, including built-in file tools, a seeded /workspace, backends, lifecycle, and network policy."
---
-The sandbox is the agent's isolated bash environment: a filesystem rooted at `/workspace` where it can run shell commands, execute scripts, and read or write files without ever touching your app runtime. Every Eve agent has exactly one. The built-in `bash`, `read_file`, `write_file`, `glob`, and `grep` tools already target it, and your authored code can too.
+The sandbox is the agent's isolated bash environment: a filesystem rooted at `/workspace` where it can run shell commands, execute scripts, and read or write files without ever touching your app runtime. Every eve agent has exactly one. The built-in `bash`, `read_file`, `write_file`, `glob`, and `grep` tools already target it, and your authored code can too.
A working sandbox exists by default, with nothing to author. Override it only to add setup, seed files, pick a backend, or lock down the network.
@@ -82,7 +82,7 @@ agent/sandbox/
scripts/run.sh ← lands at /workspace/scripts/run.sh
```
-Every file under `workspace/` mirrors into the sandbox cwd with its structure intact, and Eve lists the top-level entries to the model in the prompt automatically. One subtree is off limits. Skill discovery already seeds skill files under `/workspace/skills/`, so authoring `agent/sandbox/workspace/skills/...` is rejected; put those under `agent/skills/` instead.
+Every file under `workspace/` mirrors into the sandbox cwd with its structure intact, and eve lists the top-level entries to the model in the prompt automatically. One subtree is off limits. Skill discovery already seeds skill files under `/workspace/skills/`, so authoring `agent/sandbox/workspace/skills/...` is rejected; put those under `agent/skills/` instead.
## Overriding the sandbox
@@ -112,7 +112,7 @@ export default defineSandbox({
## Backends
-The backend decides where the sandbox runs. Eve ships four pinned factories from nested `eve/sandbox/*` imports plus an availability-aware default from `eve/sandbox`:
+The backend decides where the sandbox runs. eve ships four pinned factories from nested `eve/sandbox/*` imports plus an availability-aware default from `eve/sandbox`:
| Backend | Runs the sandbox |
| ------------------ | ---------------------------------------------------------------------------------------------- |
@@ -124,7 +124,7 @@ The backend decides where the sandbox runs. Eve ships four pinned factories from
Configuring a pinned factory uses that backend unconditionally. `docker()` always requires a reachable Docker daemon, and `vercel()` always creates hosted sandboxes (including from local dev, with Vercel credentials).
-With `backend` omitted, Eve uses `defaultBackend()`, which resolves on first use in priority order:
+With `backend` omitted, eve uses `defaultBackend()`, which resolves on first use in priority order:
1. **Vercel Sandbox** when deploying on Vercel (`process.env.VERCEL` is set), since local container/VM runtimes can't run there.
2. **Docker** when a daemon is reachable through a Docker-compatible `docker` CLI (Docker Desktop, OrbStack, Colima, Podman via its docker-compatible CLI; override the binary with `EVE_DOCKER_PATH`).
@@ -147,11 +147,11 @@ export default defineSandbox({
### Docker
-`docker()` drives the Docker CLI directly. The default base image is `ghcr.io/vercel/eve:latest`, Eve's published sandbox runtime image. Eve creates `/workspace` and verifies Bash during framework setup, before authored bootstrap code runs. Configure it through `docker({ image, env, pullPolicy, networkPolicy })`, and install authored runtime tools in sandbox bootstrap or provide them through a custom image. Templates are committed as local Docker images and reused across sessions when the sandbox source, seed files, `revalidationKey`, and Docker backend options still match. Sessions run as long-lived containers whose filesystems persist `/workspace` changes across turns for the same durable session. `eve dev` prunes stale template images in the background.
+`docker()` drives the Docker CLI directly. The default base image is `ghcr.io/vercel/eve:latest`, eve's published sandbox runtime image. eve creates `/workspace` and verifies Bash during framework setup, before authored bootstrap code runs. Configure it through `docker({ image, env, pullPolicy, networkPolicy })`, and install authored runtime tools in sandbox bootstrap or provide them through a custom image. Templates are committed as local Docker images and reused across sessions when the sandbox source, seed files, `revalidationKey`, and Docker backend options still match. Sessions run as long-lived containers whose filesystems persist `/workspace` changes across turns for the same durable session. `eve dev` prunes stale template images in the background.
### microsandbox
-`microsandbox()` runs each sandbox in a lightweight local VM with snapshot-backed templates, a `vercel-sandbox` user, and a firewall capable of domain-level network policies and credential brokering. It is the closest local match to hosted Vercel Sandbox. The default base image is `ghcr.io/vercel/eve:latest`, Eve's published sandbox runtime image. During framework setup, before authored bootstrap code runs, Eve verifies Bash and creates `/workspace` and the sandbox user. Install authored runtime tools in sandbox bootstrap or provide them through a custom image. Supported hosts are macOS on Apple Silicon, or Linux (glibc) with KVM. The `microsandbox` npm package and its VM runtime are not bundled with Eve, so `eve dev` installs both automatically when missing (disable with `setup: { autoInstall: false }`); production processes fail with actionable install errors instead.
+`microsandbox()` runs each sandbox in a lightweight local VM with snapshot-backed templates, a `vercel-sandbox` user, and a firewall capable of domain-level network policies and credential brokering. It is the closest local match to hosted Vercel Sandbox. The default base image is `ghcr.io/vercel/eve:latest`, eve's published sandbox runtime image. During framework setup, before authored bootstrap code runs, eve verifies Bash and creates `/workspace` and the sandbox user. Install authored runtime tools in sandbox bootstrap or provide them through a custom image. Supported hosts are macOS on Apple Silicon, or Linux (glibc) with KVM. The `microsandbox` npm package and its VM runtime are not bundled with eve, so `eve dev` installs both automatically when missing (disable with `setup: { autoInstall: false }`); production processes fail with actionable install errors instead.
### just-bash
@@ -163,7 +163,7 @@ You can also write your own backend. A `SandboxBackend` is an object with a `nam
There are two hooks, scoped differently:
-- **`bootstrap({ use })`** is template-scoped and runs once when the template is built. Put reusable setup here that every later session inherits, such as cloning a baseline repo, installing dependencies, or seeding files. Call `use()` to get a `SandboxSession`. Only template filesystem state and supported backend metadata carry into later sessions; config like network policy does not. If external inputs affect what bootstrap produces, set `revalidationKey: () => string` so Eve knows when to rebuild the template (authored sandbox source and seed contents are already tracked for you).
+- **`bootstrap({ use })`** is template-scoped and runs once when the template is built. Put reusable setup here that every later session inherits, such as cloning a baseline repo, installing dependencies, or seeding files. Call `use()` to get a `SandboxSession`. Only template filesystem state and supported backend metadata carry into later sessions; config like network policy does not. If external inputs affect what bootstrap produces, set `revalidationKey: () => string` so eve knows when to rebuild the template (authored sandbox source and seed contents are already tracked for you).
- **`onSession({ use, ctx })`** is durable-session-scoped and runs once per session. Put per-session setup here, including network policy, resources, timeout, per-user credentials, and one-time markers. Because it runs inside the active runtime context, it can read `ctx.session` and derive the current principal without baking credentials into the template. Call `use(opts?)` to get a `SandboxSession`; `opts` flow to the backend's update path after create.
If you require a network policy or other configuration for every session, configure it on the backend factory or in `onSession`; do not rely on bootstrap-only configuration.
@@ -183,7 +183,7 @@ export default defineSandbox({
});
```
-Sessions are persistent, and how the underlying runtime idles out depends on the backend. On the Vercel backend, the VM times out after a period of inactivity (default 30 minutes); Eve preserves the filesystem and resumes the sandbox on the next message as if nothing happened, even days later. The Docker backend keeps a long-lived container per durable session and persists `/workspace` across turns without that timeout, and the just-bash backend stores its virtual filesystem under `.eve/sandbox-cache/`. In every case, `/workspace` survives between turns for the same session.
+Sessions are persistent, and how the underlying runtime idles out depends on the backend. On the Vercel backend, the VM times out after a period of inactivity (default 30 minutes); eve preserves the filesystem and resumes the sandbox on the next message as if nothing happened, even days later. The Docker backend keeps a long-lived container per durable session and persists `/workspace` across turns without that timeout, and the just-bash backend stores its virtual filesystem under `.eve/sandbox-cache/`. In every case, `/workspace` survives between turns for the same session.
## Network policy
diff --git a/docs/schedules.mdx b/docs/schedules.mdx
index c9635c460..4bca85c3f 100644
--- a/docs/schedules.mdx
+++ b/docs/schedules.mdx
@@ -31,7 +31,7 @@ interface ScheduleHandlerArgs {
## Markdown form (fire-and-forget)
-This is the minimal schedule. Eve runs the agent on the prompt and throws away the output, though the agent can still call tools, write to backends, and log along the way. We call this task mode. A task-mode session runs to completion or fails, and cannot park to wait for a person or an OAuth sign-in.
+This is the minimal schedule. eve runs the agent on the prompt and throws away the output, though the agent can still call tools, write to backends, and log along the way. We call this task mode. A task-mode session runs to completion or fails, and cannot park to wait for a person or an OAuth sign-in.
```ts title="agent/schedules/heartbeat.ts"
import { defineSchedule } from "eve/schedules";
diff --git a/docs/skills.mdx b/docs/skills.mdx
index fc2c5bbee..746d481f0 100644
--- a/docs/skills.mdx
+++ b/docs/skills.mdx
@@ -3,11 +3,11 @@ title: "Skills"
description: "Author load-on-demand procedures the model pulls into context with load_skill."
---
-A skill is a model-loadable procedure that follows the `SKILL.md` convention. It is a markdown document, optionally a packaged directory with supporting files, that the model pulls into context on demand rather than carrying on every turn. Eve advertises each skill's description, and the model loads the full body only when a turn calls for it. This is progressive disclosure, the same model the broader Agent Skills standard uses, so a skill authored against that standard ports over as-is.
+A skill is a model-loadable procedure that follows the `SKILL.md` convention. It is a markdown document, optionally a packaged directory with supporting files, that the model pulls into context on demand rather than carrying on every turn. eve advertises each skill's description, and the model loads the full body only when a turn calls for it. This is progressive disclosure, the same model the broader Agent Skills standard uses, so a skill authored against that standard ports over as-is.
## How loading works
-Eve scans the files under `agent/skills/` and exposes each one's description to the model alongside a framework-owned `load_skill` tool. When a request matches a skill's description (or you name the skill outright), the model calls `load_skill`, and Eve appends that skill's markdown to the active turn's context.
+eve scans the files under `agent/skills/` and exposes each one's description to the model alongside a framework-owned `load_skill` tool. When a request matches a skill's description (or you name the skill outright), the model calls `load_skill`, and eve appends that skill's markdown to the active turn's context.
The description is a routing hint, not a label. Write it as the task that should trigger activation:
@@ -25,7 +25,7 @@ The smallest skill is a flat markdown file. The content is the procedure, and th
Use the weather tool before answering forecast or temperature questions.
```
-A flat markdown skill can skip the `description` frontmatter. When it does, Eve advertises the first non-empty, non-code-fence line of the body with any leading `#`, `>`, `*`, or `-` marker stripped. If the body has no such line, Eve falls back to the literal `Instructions for the <name> skill.`, which is a weak routing hint, so add a `description` when you want the model to route on intent.
+A flat markdown skill can skip the `description` frontmatter. When it does, eve advertises the first non-empty, non-code-fence line of the body with any leading `#`, `>`, `*`, or `-` marker stripped. If the body has no such line, eve falls back to the literal `Instructions for the <name> skill.`, which is a weak routing hint, so add a `description` when you want the model to route on intent.
A packaged skill is a directory with a `SKILL.md` plus sibling files like `references/`, `assets/`, and `scripts/`. The packaged `SKILL.md` must carry `description` frontmatter; it has no filename slug to fall back on.
@@ -53,7 +53,7 @@ export default defineSkill({
});
```
-Eve generates `SKILL.md` from `markdown`, and each `files` entry becomes a package-relative sibling. Start with plain markdown and move to `defineSkill` only when you hit its limits.
+eve generates `SKILL.md` from `markdown`, and each `files` entry becomes a package-relative sibling. Start with plain markdown and move to `defineSkill` only when you hit its limits.
## Skills are scoped per agent
diff --git a/docs/subagents.mdx b/docs/subagents.mdx
index eb0bf2beb..8d8ab1e27 100644
--- a/docs/subagents.mdx
+++ b/docs/subagents.mdx
@@ -75,7 +75,7 @@ The built-in `agent` tool is the exception. Its children share the parent's sand
## What the parent sees
-Eve lowers every subagent (built-in copy, declared, or [remote](./guides/remote-agents)) into a model-visible tool with the same `{ message, outputSchema? }` shape. The parent packs `message` with everything the child needs, since the child never sees the parent's history. Set `outputSchema` to run the child in task mode, returning structured output as the tool result.
+eve lowers every subagent (built-in copy, declared, or [remote](./guides/remote-agents)) into a model-visible tool with the same `{ message, outputSchema? }` shape. The parent packs `message` with everything the child needs, since the child never sees the parent's history. Set `outputSchema` to run the child in task mode, returning structured output as the tool result.
A declared subagent's tool name is the bare path-derived name, with no prefix. `agent/subagents/researcher/` registers as the tool `researcher`. Unlike connection tools (`connection__<connection>__<tool>`), it carries no namespace, so the model, approvals, logs, and evals all reference it by that name. Its input schema is:
@@ -86,7 +86,7 @@ A declared subagent's tool name is the bare path-derived name, with no prefix. `
}
```
-Because the name lives in the same runtime tool namespace as authored tools, a subagent named `researcher` collides with a tool named `researcher`. Eve rejects the build rather than picking a winner, so keep subagent directory names distinct from tool names.
+Because the name lives in the same runtime tool namespace as authored tools, a subagent named `researcher` collides with a tool named `researcher`. eve rejects the build rather than picking a winner, so keep subagent directory names distinct from tool names.
Do not rely on subagent delegation by itself as an approval boundary. Put sensitive tools behind `needsApproval`, connection approval, route/session authorization, or other controls wherever those tools can be called.
@@ -98,5 +98,5 @@ Split out a subagent when the task needs a different prompt or specialist role,
## What to read next
-- [Remote agents](./guides/remote-agents): call another Eve deployment as a subagent.
+- [Remote agents](./guides/remote-agents): call another eve deployment as a subagent.
- [Dynamic workflows](./guides/dynamic-workflows): have the model orchestrate its subagents programmatically (fan-out, map-reduce).
diff --git a/docs/tools/human-in-the-loop.md b/docs/tools/human-in-the-loop.md
index f387aaafd..03b9dd525 100644
--- a/docs/tools/human-in-the-loop.md
+++ b/docs/tools/human-in-the-loop.md
@@ -61,7 +61,7 @@ The built-in `ask_question` tool lets the model pause and ask the user, rather t
Approvals and questions share one protocol:
1. The model requests input (an approval, or an `ask_question`).
-2. Eve emits an `input.requested` stream event carrying the pending requests.
+2. eve emits an `input.requested` stream event carrying the pending requests.
3. The turn parks at `session.waiting`, durably, for as long as it takes.
4. The client answers with `inputResponses` (structured, keyed by `requestId`) or a normal follow-up `message`. A follow-up whose text matches an option label (case-insensitive) resolves automatically.
diff --git a/docs/tools/overview.mdx b/docs/tools/overview.mdx
index 98536c797..a2c5386ce 100644
--- a/docs/tools/overview.mdx
+++ b/docs/tools/overview.mdx
@@ -40,9 +40,9 @@ When a tool returns structured data, add an optional `outputSchema`. With Zod or
- `ctx.getSandbox()`: the live [sandbox](../sandbox) handle.
- `ctx.getSkill(id)`: read a packaged [skill](../skills)'s metadata and files.
-Running in the app runtime is what lets a tool import shared code from `lib/`, read `process.env`, and take part in Eve’s durable pause/resume model.
+Running in the app runtime is what lets a tool import shared code from `lib/`, read `process.env`, and take part in eve’s durable pause/resume model.
-Eve never runs authored tools during discovery. The model sees descriptors first, and only what it actually calls gets executed. Completed steps never re-run; Eve replays the recorded result. A step interrupted mid-execution re-runs, so make non-idempotent side effects like charges or emails idempotent, or gate them with approval.
+eve never runs authored tools during discovery. The model sees descriptors first, and only what it actually calls gets executed. Completed steps never re-run; eve replays the recorded result. A step interrupted mid-execution re-runs, so make non-idempotent side effects like charges or emails idempotent, or gate them with approval.
## Gate a tool on human approval
@@ -63,7 +63,7 @@ export default defineTool({
});
```
-Approval is one half of Eve's [human-in-the-loop](./human-in-the-loop) model — the page covers the `always/once/never` helpers, input-dependent predicates, and how a gated call pauses and resumes durably.
+Approval is one half of eve's [human-in-the-loop](./human-in-the-loop) model — the page covers the `always/once/never` helpers, input-dependent predicates, and how a gated call pauses and resumes durably.
## Shape what the model sees with `toModelOutput`
diff --git a/docs/tutorial/connect-a-warehouse.mdx b/docs/tutorial/connect-a-warehouse.mdx
index ee41b05b3..e15784739 100644
--- a/docs/tutorial/connect-a-warehouse.mdx
+++ b/docs/tutorial/connect-a-warehouse.mdx
@@ -3,7 +3,7 @@ title: "Connect a Warehouse"
description: "Part 4 of the Build an Agent tutorial. Let each user connect their own warehouse over an OAuth MCP via Vercel Connect."
---
-The sample dataset got the analytics assistant running, but it's a stand-in. Now point the agent at a real warehouse and let each user connect their own by signing in through their browser. That's what a connection is for. It's an MCP server the model reaches through tools, with auth that Eve drives for you.
+The sample dataset got the analytics assistant running, but it's a stand-in. Now point the agent at a real warehouse and let each user connect their own by signing in through their browser. That's what a connection is for. It's an MCP server the model reaches through tools, with auth that eve drives for you.
This step depends on Vercel Connect, which is in private beta. No Connect access? Keep the Step 3 sample dataset and read this step for the connection model. Steps 5 through 9 work against the sample dataset, so you can complete the tutorial without a warehouse.
@@ -24,7 +24,7 @@ export default defineMcpClientConnection({
});
```
-`"warehouse"` is the UID you chose when registering the Connect client. By default this OAuth is user-scoped. Each end-user authorizes in their own browser, and Eve resolves that user's token before every tool call.
+`"warehouse"` is the UID you chose when registering the Connect client. By default this OAuth is user-scoped. Each end-user authorizes in their own browser, and eve resolves that user's token before every tool call.
Once Connect is enabled on your account, wire it up:
@@ -47,7 +47,7 @@ The first time, the model picks a warehouse tool but there's no token yet, so th
## The token never reaches the model
-Right before each request to the MCP server, Eve resolves the bearer and sends it as `Authorization: Bearer <token>`. The model only ever sees tool names, descriptions, and results. The credential stays out of its reach.
+Right before each request to the MCP server, eve resolves the bearer and sends it as `Authorization: Bearer <token>`. The model only ever sees tool names, descriptions, and results. The credential stays out of its reach.
If you want more control, gate the connection behind approval (`approval: once()`) or narrow which tools the model sees (`tools.allow`). See [Connections](../connections).
diff --git a/docs/tutorial/first-agent.mdx b/docs/tutorial/first-agent.mdx
index 6a1c35976..59c4e5350 100644
--- a/docs/tutorial/first-agent.mdx
+++ b/docs/tutorial/first-agent.mdx
@@ -12,7 +12,7 @@ Step 1 gets it talking. The scaffold bundles a small sample dataset, so your fir
- Node 24 or newer and npm.
- A model credential. The scaffold's default model goes through the [Vercel AI Gateway](../getting-started), so you need `AI_GATEWAY_API_KEY` (or `VERCEL_OIDC_TOKEN` pulled via `vercel link`). A direct provider id like `anthropic/claude-opus-4.8` instead needs that provider's key, here `ANTHROPIC_API_KEY`.
-If you have not run Eve before, complete [Getting Started](../getting-started) first. Without a credential, "Run the agent" below fails when the runtime tries to reach the model; the dev TUI's `/model` flow walks you through pasting a key or linking a project.
+If you have not run eve before, complete [Getting Started](../getting-started) first. Without a credential, "Run the agent" below fails when the runtime tries to reach the model; the dev TUI's `/model` flow walks you through pasting a key or linking a project.
## Scaffold the agent
@@ -21,7 +21,7 @@ npx eve@latest init analytics-assistant
cd analytics-assistant
```
-The command writes the starter agent with Eve's default model and built-in HTTP API
+The command writes the starter agent with eve's default model and built-in HTTP API
channel (`agent/channels/eve.ts`), installs dependencies, initializes Git, and
starts the development server. Stop the server before continuing with the edits
below. It does not create a Vercel project or deploy. `init` creates the
diff --git a/docs/tutorial/how-it-runs.mdx b/docs/tutorial/how-it-runs.mdx
index 217bf4d24..1cc9862c1 100644
--- a/docs/tutorial/how-it-runs.mdx
+++ b/docs/tutorial/how-it-runs.mdx
@@ -11,7 +11,7 @@ The analytics assistant sent one message and got one answer. Three terms describ
| **turn** | One message you send and the work it triggers. |
| **step** | A durable checkpoint within the turn. |
-Each turn runs as a durable workflow, and Eve saves progress at every step. Completed steps never re-run; Eve replays the recorded result. A step interrupted mid-execution re-runs, so make non-idempotent side effects like charges or emails idempotent, or gate them with approval. A turn that's waiting on you (an approval, a question) resumes whenever you answer, even if that's much later.
+Each turn runs as a durable workflow, and eve saves progress at every step. Completed steps never re-run; eve replays the recorded result. A step interrupted mid-execution re-runs, so make non-idempotent side effects like charges or emails idempotent, or gate them with approval. A turn that's waiting on you (an approval, a question) resumes whenever you answer, even if that's much later.
That's why the features in the rest of this tutorial work the way they do:
@@ -19,7 +19,7 @@ That's why the features in the rest of this tutorial work the way they do:
- The metric glossary in Step 6 survives across turns. State is checkpointed at step boundaries, so it sticks.
- The spend approval in Step 8 pauses the turn on your yes/no, then picks up exactly where it left off.
-You author capabilities, including tools, instructions, channels, and skills. Eve drives the model-to-tool loop and decides when a turn continues, waits, or ends. You never write that loop yourself.
+You author capabilities, including tools, instructions, channels, and skills. eve drives the model-to-tool loop and decides when a turn continues, waits, or ends. You never write that loop yourself.
→ Next: [Step 3: Query sample data](./query-sample-data)
diff --git a/docs/tutorial/query-sample-data.mdx b/docs/tutorial/query-sample-data.mdx
index 010d7dc6e..8384d1e76 100644
--- a/docs/tutorial/query-sample-data.mdx
+++ b/docs/tutorial/query-sample-data.mdx
@@ -74,7 +74,7 @@ Restart the dev server with `npm run dev` and ask:
Which customer has spent the most, and how much?
```
-Watch the loop play out in the TUI. The model emits a `run_sql` call, Eve runs your `execute`, and the rows come back as a tool result. The model reads them and answers with a real number. Eve drove the whole loop. All you supplied was the tool.
+Watch the loop play out in the TUI. The model emits a `run_sql` call, eve runs your `execute`, and the rows come back as a tool result. The model reads them and answers with a real number. eve drove the whole loop. All you supplied was the tool.
→ Next: [Connect a warehouse](./connect-a-warehouse)
diff --git a/docs/tutorial/ship-it.mdx b/docs/tutorial/ship-it.mdx
index 0943b3ee6..50d56786c 100644
--- a/docs/tutorial/ship-it.mdx
+++ b/docs/tutorial/ship-it.mdx
@@ -13,7 +13,7 @@ Step 1 scaffolded the agent without a web frontend. Add one now with `eve channe
npx eve channels add web
```
-This adds a Next.js app (`next.config.ts`, `app/page.tsx`, `app/_components/`) wired to the existing Eve channel, plus the chat UI components and their dependencies. Run `npm install` afterward to install the added packages. The generated `next.config.ts` wraps your config with `withEve`, which wires the Eve routes automatically:
+This adds a Next.js app (`next.config.ts`, `app/page.tsx`, `app/_components/`) wired to the existing eve channel, plus the chat UI components and their dependencies. Run `npm install` afterward to install the added packages. The generated `next.config.ts` wraps your config with `withEve`, which wires the eve routes automatically:
```ts title="next.config.ts"
import type { NextConfig } from "next";
@@ -26,7 +26,7 @@ export default withEve(nextConfig);
## A dashboard with `useEveAgent`
-The dashboard talks to the built-in Eve HTTP channel (`agent/channels/eve.ts`). On the browser side, `useEveAgent` handles session creation, streaming, and HITL. The scaffold renders its chat from `app/_components/agent-chat.tsx`, mounted by `app/page.tsx`. That component is fuller than you need to start, so replace its contents with this minimal version:
+The dashboard talks to the built-in eve HTTP channel (`agent/channels/eve.ts`). On the browser side, `useEveAgent` handles session creation, streaming, and HITL. The scaffold renders its chat from `app/_components/agent-chat.tsx`, mounted by `app/page.tsx`. That component is fuller than you need to start, so replace its contents with this minimal version:
```tsx title="app/_components/agent-chat.tsx"
"use client";
@@ -125,7 +125,7 @@ That `team` attribute is exactly what the dynamic playbook in [Step 7](./team-pl
vercel deploy
```
-On Vercel, the web app stays public and the Eve runtime sits behind it on the same origin, with the sandbox running on Vercel Sandbox. You can smoke-test the deployment without leaving the CLI:
+On Vercel, the web app stays public and the eve runtime sits behind it on the same origin, with the sandbox running on Vercel Sandbox. You can smoke-test the deployment without leaving the CLI:
```bash
npx eve dev https://your-analytics-app.vercel.app
@@ -138,7 +138,7 @@ That's the full assistant, deployed and authed. It queries the warehouse, runs a
Across the nine steps you built and shipped one agent, and along the way you used:
- **Tools** to give the model typed actions (`run_sql`, `chart_series`, `define_metric`).
-- **Connections** to reach a warehouse over an OAuth MCP, with per-user tokens Eve resolves for you.
+- **Connections** to reach a warehouse over an OAuth MCP, with per-user tokens eve resolves for you.
- **The sandbox** to compute and chart beyond SQL in an isolated `/workspace`.
- **State** (`defineState`) to remember the team's glossary across turns.
- **Dynamic skills** (`defineDynamic`) to load the right team playbook per caller.
diff --git a/e2e/README.md b/e2e/README.md
index f3a8fe8bc..b5b629be4 100644
--- a/e2e/README.md
+++ b/e2e/README.md
@@ -79,7 +79,7 @@ When adding e2e coverage:
## CI
-`.github/workflows/e2e-local.yml` builds the Eve package once per matrix leg,
+`.github/workflows/e2e-local.yml` builds the eve package once per matrix leg,
then runs one fixture directory:
```sh
diff --git a/e2e/provision/tools-sandbox.ts b/e2e/provision/tools-sandbox.ts
index 171dd7bfa..1f819e9c7 100644
--- a/e2e/provision/tools-sandbox.ts
+++ b/e2e/provision/tools-sandbox.ts
@@ -34,7 +34,7 @@ await provision("tools-sandbox", async (ctx) => {
});
/**
- * Builds an author snapshot outside Eve: create a standalone Vercel Sandbox,
+ * Builds an author snapshot outside eve: create a standalone Vercel Sandbox,
* write a fresh marker token outside `/workspace`, snapshot it, and delete
* the seed. The fixture's sandbox definition rebinds its backend to
* `vercel({ source: { type: "snapshot", snapshotId } })` when
diff --git a/package.json b/package.json
index 1e08f90d0..0e8b6fc46 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
"name": "eve-monorepo",
"version": "0.0.0",
"private": true,
- "description": "Monorepo for Eve, a filesystem-first framework for durable backend agents on Vercel.",
+ "description": "Monorepo for eve, a filesystem-first framework for durable backend agents on Vercel.",
"workspaces": [
"apps/*",
"apps/*/*",
diff --git a/packages/eve-catalog/package.json b/packages/eve-catalog/package.json
index f795413f8..99919f92c 100644
--- a/packages/eve-catalog/package.json
+++ b/packages/eve-catalog/package.json
@@ -2,7 +2,7 @@
"name": "@vercel/eve-catalog",
"version": "0.0.1",
"private": true,
- "description": "Single source of truth for Eve integration identity (channels and connections).",
+ "description": "Single source of truth for eve integration identity (channels and connections).",
"license": "Apache-2.0",
"type": "module",
"sideEffects": false,
diff --git a/packages/eve-catalog/src/index.ts b/packages/eve-catalog/src/index.ts
index b97c2b907..363cd4dd7 100644
--- a/packages/eve-catalog/src/index.ts
+++ b/packages/eve-catalog/src/index.ts
@@ -1,5 +1,5 @@
/**
- * Shared identity for Eve integrations. This package is the single source of
+ * Shared identity for eve integrations. This package is the single source of
* truth for *which* integrations exist (channels and connections) and how a
* connection is wired (transport + model-facing description).
*
@@ -46,9 +46,9 @@ export interface ConnectionIdentity {
openapi?: OpenApiTransport;
}
-/** Which Eve surfaces an integration is available on today. */
+/** Which eve surfaces an integration is available on today. */
export interface IntegrationSurfaces {
- /** The Eve CLI can scaffold this integration without further work. */
+ /** The eve CLI can scaffold this integration without further work. */
scaffoldable: boolean;
/** Listed in the docs integrations gallery. */
gallery: boolean;
@@ -77,12 +77,12 @@ export function connectionProtocols(connection: ConnectionIdentity): ConnectionP
}
/**
- * The canonical set of Eve integrations. Order is display order. Each entry
+ * The canonical set of eve integrations. Order is display order. Each entry
* carries only shared identity; the scaffolder and docs overlay their own
* surface-specific data keyed by {@link IntegrationEntry.slug}.
*
* `surfaces.scaffoldable` reflects what the CLI can scaffold today: Slack and
- * Eve Web Chat for channels, and every curated connection. The remaining
+ * eve Web Chat for channels, and every curated connection. The remaining
* channels are runtime modules that are still configured by hand, so they
* appear in the gallery but not the CLI picker.
*/
@@ -138,7 +138,7 @@ export const INTEGRATIONS: readonly IntegrationEntry[] = [
},
{
slug: "eve",
- name: "Eve Web Chat",
+ name: "eve Web Chat",
kind: "channel",
tagline: "Embed a first-party web chat UI backed by your agent.",
surfaces: { scaffoldable: true, gallery: true },
diff --git a/packages/eve/CHANGELOG.md b/packages/eve/CHANGELOG.md
index 62ab5b480..045cadea9 100644
--- a/packages/eve/CHANGELOG.md
+++ b/packages/eve/CHANGELOG.md
@@ -10,7 +10,7 @@
### Patch Changes
-- e7cdefd: Handle missing sandbox template and session state more gracefully across Vercel, Microsandbox, and Docker backends. Eve now treats stale Vercel template references, missing Microsandbox session/template snapshots, and Docker template image races as recoverable provisioning misses so the runtime can rebuild or create a fresh sandbox automatically.
+- e7cdefd: Handle missing sandbox template and session state more gracefully across Vercel, Microsandbox, and Docker backends. eve now treats stale Vercel template references, missing Microsandbox session/template snapshots, and Docker template image races as recoverable provisioning misses so the runtime can rebuild or create a fresh sandbox automatically.
## 0.11.0
@@ -27,4 +27,4 @@
### Minor Changes
-- c2ac540: Initial public release of the Eve framework
+- c2ac540: Initial public release of the eve framework
diff --git a/packages/eve/README.md b/packages/eve/README.md
index 9a6e2c172..04f27c32b 100644
--- a/packages/eve/README.md
+++ b/packages/eve/README.md
@@ -1,26 +1,26 @@
-# Eve
+# eve
-Eve is a filesystem-first framework for durable backend agents on Vercel.
+eve is a filesystem-first framework for durable backend agents on Vercel.
You author an agent as a directory on disk. The directory is the contract — markdown for the parts a human should read like a spec, TypeScript for the parts that benefit from real types and runtime behavior.
-The framework is called Eve. The published npm package is `eve`. The CLI binary is `eve`.
+The framework is called eve. The published npm package is `eve`. The CLI binary is `eve`.
## Preview Terms and Safeguards
-Eve is currently a preview and subject to the Vercel beta terms; the framework, APIs, documentation, and behavior may change before general availability.
+eve is currently a preview and subject to the Vercel beta terms; the framework, APIs, documentation, and behavior may change before general availability.
As the deployer, it is your responsibility to ensure your agent complies with applicable laws.
You are responsible for configuring approval policies, tool restrictions, connection scopes, route/session authorization, sandbox controls, telemetry exports, and other safeguards appropriate for your use case.
-Before using Eve with non-public, sensitive, regulated, or production data, review which default tools, custom tools, MCP tools, shell/file/web tools, connected services, subagents, schedules, and external actions are available to the agent.
+Before using eve with non-public, sensitive, regulated, or production data, review which default tools, custom tools, MCP tools, shell/file/web tools, connected services, subagents, schedules, and external actions are available to the agent.
Require human approval or other safeguards for sensitive, irreversible, regulated, financial, healthcare, employment, housing, legal, safety-impacting, user-impacting, or external side-effecting actions.
-Unless you configure stricter controls, Eve agents may operate with permissive settings, including tool execution without human approval where approval is omitted and sandbox network egress that is not deny-all. Do not rely on model behavior alone to prevent sensitive or irreversible actions.
+Unless you configure stricter controls, eve agents may operate with permissive settings, including tool execution without human approval where approval is omitted and sandbox network egress that is not deny-all. Do not rely on model behavior alone to prevent sensitive or irreversible actions.
-## What Eve Prioritizes
+## What eve Prioritizes
- Markdown-first authoring for instructions and procedures
- TypeScript where typed runtime behavior matters
@@ -122,7 +122,7 @@ export default defineAgent({
npx eve@latest init my-agent
```
-`eve init` writes a new agent with Eve's default model. Pass `--channel-web-nextjs` to add the
+`eve init` writes a new agent with eve's default model. Pass `--channel-web-nextjs` to add the
Web Chat application. It installs dependencies, initializes Git, and starts the
development server. Targeting an existing project directory (`eve init .`) adds
the agent files and missing dependencies instead. It does not create a Vercel
@@ -138,7 +138,7 @@ CLI commands:
## Deploying
-Eve is built for Vercel. The runtime is Nitro + Vercel Workflows. Read [`./docs/guides/deployment.md`](./docs/guides/deployment.md) for the deployment path, environment variables, and Vercel-specific configuration.
+eve is built for Vercel. The runtime is Nitro + Vercel Workflows. Read [`./docs/guides/deployment.md`](./docs/guides/deployment.md) for the deployment path, environment variables, and Vercel-specific configuration.
## Read Next
@@ -157,9 +157,9 @@ By runtime concern: [Sessions and Streaming](./docs/concepts/sessions-runs-and-s
## Architecture (Internals)
-You do not need this section to author an Eve agent — it documents the public HTTP protocol contracts so Eve composes predictably with other systems.
+You do not need this section to author an eve agent — it documents the public HTTP protocol contracts so eve composes predictably with other systems.
-Eve's internal split is:
+eve's internal split is:
- the **channel** normalizes inbound transport, applies auth and delivery policy, and owns `continuationToken`
- the **harness** does one unit of AI work and returns `{ session, next }`
diff --git a/packages/eve/bin/eve.d.ts b/packages/eve/bin/eve.d.ts
index a49343b1c..b0fccb810 100644
--- a/packages/eve/bin/eve.d.ts
+++ b/packages/eve/bin/eve.d.ts
@@ -71,7 +71,7 @@ export function ensureBuiltCli(
): Promise<string>;
/**
- * Runs the compiled Eve CLI, building the workspace package on demand when needed.
+ * Runs the compiled eve CLI, building the workspace package on demand when needed.
*/
export function runEveCli(
argv?: string[],
diff --git a/packages/eve/bin/eve.js b/packages/eve/bin/eve.js
index 6e7c2e4af..1dc8f1cc8 100755
--- a/packages/eve/bin/eve.js
+++ b/packages/eve/bin/eve.js
@@ -164,7 +164,7 @@ async function loadVendoredSemver(options, dependencies = {}) {
}
if (!(await exists(semverPath))) {
- throw new Error(`Building Eve's vendored dependencies did not produce ${semverPath}.`);
+ throw new Error(`Building eve's vendored dependencies did not produce ${semverPath}.`);
}
const module = await importModule(pathToFileURL(semverPath).href);
@@ -183,7 +183,7 @@ async function assertSupportedNodeVersion(
const semver = await loadVendoredSemver(options, dependencies);
if (semver.validRange(requiredRange) === null) {
- throw new Error(`Eve declares an invalid Node.js engine range: "${requiredRange}".`);
+ throw new Error(`eve declares an invalid Node.js engine range: "${requiredRange}".`);
}
if (semver.satisfies(version, requiredRange)) {
return;
@@ -191,7 +191,7 @@ async function assertSupportedNodeVersion(
throw new Error(
[
- `Eve requires Node.js ${requiredRange}.`,
+ `eve requires Node.js ${requiredRange}.`,
`You are running ${version}.`,
"Please install a compatible Node.js version and try again.",
].join(" "),
@@ -270,7 +270,7 @@ export async function ensureBuiltCli(overrides = {}, dependencies = {}) {
if (!packageCanBuildCli) {
throw new Error(
- `Eve package at ${options.packageRoot} does not include the sources required to rebuild the CLI.`,
+ `eve package at ${options.packageRoot} does not include the sources required to rebuild the CLI.`,
);
}
@@ -295,7 +295,7 @@ export async function ensureBuiltCli(overrides = {}, dependencies = {}) {
}
/**
- * Runs the compiled Eve CLI, building the workspace package on demand when needed.
+ * Runs the compiled eve CLI, building the workspace package on demand when needed.
*/
export async function runEveCli(argv = process.argv.slice(2), overrides = {}, dependencies = {}) {
const options = createBootstrapOptions(overrides);
@@ -311,7 +311,7 @@ export async function runEveCli(argv = process.argv.slice(2), overrides = {}, de
const cliModule = await importModule(pathToFileURL(cliEntrypointPath).href);
if (typeof cliModule.runCli !== "function") {
- throw new Error(`The Eve CLI module at ${cliEntrypointPath} does not export runCli().`);
+ throw new Error(`The eve CLI module at ${cliEntrypointPath} does not export runCli().`);
}
await cliModule.runCli(argv);
diff --git a/packages/eve/scripts/check-bin-runtime-dependencies.mjs b/packages/eve/scripts/check-bin-runtime-dependencies.mjs
index 8d4b15905..98de63e3f 100644
--- a/packages/eve/scripts/check-bin-runtime-dependencies.mjs
+++ b/packages/eve/scripts/check-bin-runtime-dependencies.mjs
@@ -69,7 +69,7 @@ if (violations.length > 0) {
for (const violation of violations) {
process.stderr.write(
`${violation.path} imports "${violation.specifier}", but "${violation.dependency}" is not ` +
- "declared in package.json dependencies. Eve's bin files ship unbundled, so every bare " +
+ "declared in package.json dependencies. eve's bin files ship unbundled, so every bare " +
"import must be available in production installs.\n",
);
}
diff --git a/packages/eve/scripts/stamp-version-tokens.mjs b/packages/eve/scripts/stamp-version-tokens.mjs
index e16a81f7c..4ffc30e47 100644
--- a/packages/eve/scripts/stamp-version-tokens.mjs
+++ b/packages/eve/scripts/stamp-version-tokens.mjs
@@ -29,7 +29,7 @@ async function resolveCatalogVersion(packageName) {
// These tokens are authored in source so scaffold templates can pin the same
// versions as the package build. The setup scaffold (src/setup/scaffold) is now
-// part of the Eve source, so its templates ride into the CLI bundle; this stamp
+// part of the eve source, so its templates ride into the CLI bundle; this stamp
// rewrites them in the final bundled output after rolldown has emitted every chunk.
// Source of truth for the engine range scaffolded projects declare. Fail loudly
// rather than stamp `undefined` into a generated package.json. Kept in sync with
diff --git a/packages/eve/scripts/vendor-compiled/@vercel/oidc.mjs b/packages/eve/scripts/vendor-compiled/@vercel/oidc.mjs
index f9b01d120..0631eb9c2 100644
--- a/packages/eve/scripts/vendor-compiled/@vercel/oidc.mjs
+++ b/packages/eve/scripts/vendor-compiled/@vercel/oidc.mjs
@@ -3,7 +3,7 @@ import { fileURLToPath } from "node:url";
import { loadDeclaration } from "../_shared.mjs";
/**
- * Vendor config for `@vercel/oidc`. Eve uses only `getVercelOidcToken`,
+ * Vendor config for `@vercel/oidc`. eve uses only `getVercelOidcToken`,
* so the declaration narrows the upstream surface to that single function
* (the multi-file `dist/` declaration tree is intentionally not copied).
*
diff --git a/packages/eve/scripts/vendor-compiled/@workflow/core.mjs b/packages/eve/scripts/vendor-compiled/@workflow/core.mjs
index 50f56cd39..ecb4b1890 100644
--- a/packages/eve/scripts/vendor-compiled/@workflow/core.mjs
+++ b/packages/eve/scripts/vendor-compiled/@workflow/core.mjs
@@ -11,7 +11,7 @@ async function discoverDeclarationFiles({ distDir }) {
return (
files
.map((file) => relative(distDir, file).replaceAll("\\", "/"))
- // Eve flattens dist/workflow/index.js to workflow.js, so workflow.d.ts
+ // eve flattens dist/workflow/index.js to workflow.js, so workflow.d.ts
// is owned by the shim entry below instead of upstream's VM-runner file.
.filter((file) => file !== "workflow.d.ts")
.sort()
diff --git a/packages/eve/scripts/vendor-compiled/declarations/@vercel/detect-agent.d.ts b/packages/eve/scripts/vendor-compiled/declarations/@vercel/detect-agent.d.ts
index 27f788794..db0c4463a 100644
--- a/packages/eve/scripts/vendor-compiled/declarations/@vercel/detect-agent.d.ts
+++ b/packages/eve/scripts/vendor-compiled/declarations/@vercel/detect-agent.d.ts
@@ -1,5 +1,5 @@
// Minimal declaration for the vendored slice of `@vercel/detect-agent`.
-// Eve only asks "was this launch agent-driven?", so the per-agent name
+// eve only asks "was this launch agent-driven?", so the per-agent name
// union upstream declares is collapsed to `string`; widen this if a
// future caller branches on specific agents.
diff --git a/packages/eve/src/channel/routes.ts b/packages/eve/src/channel/routes.ts
index be2f49954..a747f73ff 100644
--- a/packages/eve/src/channel/routes.ts
+++ b/packages/eve/src/channel/routes.ts
@@ -36,14 +36,14 @@ export interface SendPayload {
readonly message?: string | UserContent;
readonly inputResponses?: readonly InputResponse[];
/**
- * Context strings contributed by the channel. Eve appends each entry
+ * Context strings contributed by the channel. eve appends each entry
* as a `role: "user"` message to `session.history` before the delivery
* message and persists it across the session.
*/
readonly context?: readonly string[];
/**
* Run-scoped JSON schema the turn's result must match. Orthogonal to
- * {@link BaseSendOptions.mode}: Eve enforces the schema in either mode; mode
+ * {@link BaseSendOptions.mode}: eve enforces the schema in either mode; mode
* only decides the failure behavior. A conversation run parks recoverably and
* waits for more input; a task run (which cannot wait) finishes as an error.
*/
@@ -266,8 +266,8 @@ export function DELETE<TState = undefined>(
* Declares a WebSocket channel route.
*
* The handler runs once per upgrade request and returns lifecycle hooks for
- * that connection. The hooks are Eve-owned structural types so channel authors
- * can use CrossWS-compatible helpers without Eve exposing CrossWS directly.
+ * that connection. The hooks are eve-owned structural types so channel authors
+ * can use CrossWS-compatible helpers without eve exposing CrossWS directly.
*/
export function WS<TState = undefined>(
path: string,
diff --git a/packages/eve/src/channel/types.ts b/packages/eve/src/channel/types.ts
index 9eb1b0920..0fbd89d51 100644
--- a/packages/eve/src/channel/types.ts
+++ b/packages/eve/src/channel/types.ts
@@ -28,7 +28,7 @@ export interface SessionTurn {
}
/**
- * Lineage metadata for the Eve parent execution that delegated this session.
+ * Lineage metadata for the eve parent execution that delegated this session.
*
* `sessionId` and `turn` describe the **immediate** parent that dispatched
* this child. `rootSessionId` denormalizes the top of the dispatch chain so
@@ -181,7 +181,7 @@ export interface SessionCallback {
// ---------------------------------------------------------------------------
/**
- * Runtime capabilities granted to one Eve session.
+ * Runtime capabilities granted to one eve session.
*
* Capabilities describe what the session may do mid-turn: a session-level
* contract, orthogonal to {@link RunInput.mode} which decides done-vs-park on
diff --git a/packages/eve/src/channel/websocket-upgrade-server.ts b/packages/eve/src/channel/websocket-upgrade-server.ts
index d3056c368..537417774 100644
--- a/packages/eve/src/channel/websocket-upgrade-server.ts
+++ b/packages/eve/src/channel/websocket-upgrade-server.ts
@@ -26,12 +26,12 @@ interface NodeWebSocketUpgradeRequest extends WebSocketUpgradeRequest {
/**
* Escape hatch for SDKs and frameworks that need a Node HTTP server-shaped
- * upgrade target inside an Eve `WS()` route.
+ * upgrade target inside an eve `WS()` route.
*
- * Prefer normal `WS()` lifecycle hooks for Eve-owned websocket behavior. Use
+ * Prefer normal `WS()` lifecycle hooks for eve-owned websocket behavior. Use
* this bridge only when an integration expects to register
* `httpServer.on("upgrade", ...)` handlers itself. The server is intentionally
- * not listening on a port; Eve forwards only the matched route's raw Node
+ * not listening on a port; eve forwards only the matched route's raw Node
* upgrade into it.
*/
export interface WebSocketUpgradeServerBridge {
diff --git a/packages/eve/src/cli/banner.ts b/packages/eve/src/cli/banner.ts
index 62929bf07..6023344e4 100644
--- a/packages/eve/src/cli/banner.ts
+++ b/packages/eve/src/cli/banner.ts
@@ -5,7 +5,7 @@ import { resolveInstalledPackageInfo } from "#internal/application/package.js";
export const EVE_WORDMARK = "eve";
export const EVE_BETA_TERMS_URL = "https://vercel.com/docs/release-phases/public-beta-agreement";
export const EVE_PREVIEW_NOTICE =
- "Eve is currently a preview and subject to the Vercel beta terms; the framework, APIs, documentation, and behavior may change before general availability.";
+ "eve is currently a preview and subject to the Vercel beta terms; the framework, APIs, documentation, and behavior may change before general availability.";
/**
* The boot banner shared by every CLI command that announces itself: the eve
diff --git a/packages/eve/src/cli/commands/channel-add-conflicts.ts b/packages/eve/src/cli/commands/channel-add-conflicts.ts
index c522d41c0..dd6b6d53d 100644
--- a/packages/eve/src/cli/commands/channel-add-conflicts.ts
+++ b/packages/eve/src/cli/commands/channel-add-conflicts.ts
@@ -79,7 +79,7 @@ export function assertCanAddSelectedChannels(
);
if (conflictingOwner !== undefined) {
throw new Error(
- `Cannot scaffold Web Chat because agent/${conflictingOwner} already defines POST ${EVE_CREATE_SESSION_ROUTE_PATH}. Web Chat scaffolds the same Eve session routes.`,
+ `Cannot scaffold Web Chat because agent/${conflictingOwner} already defines POST ${EVE_CREATE_SESSION_ROUTE_PATH}. Web Chat scaffolds the same eve session routes.`,
);
}
}
diff --git a/packages/eve/src/cli/commands/channels.integration.test.ts b/packages/eve/src/cli/commands/channels.integration.test.ts
index b3d55aece..d2856e16d 100644
--- a/packages/eve/src/cli/commands/channels.integration.test.ts
+++ b/packages/eve/src/cli/commands/channels.integration.test.ts
@@ -146,14 +146,14 @@ afterEach(() => {
});
describe("runChannelsAddCommand", () => {
- test("refuses a directory without an Eve agent using the shared init guidance", async () => {
+ test("refuses a directory without an eve agent using the shared init guidance", async () => {
const projectRoot = await mkdtemp(join(tmpdir(), "eve-channels-empty-"));
const logger = new TestLogger();
await runChannelsAddCommand(logger, projectRoot, { kind: "web", options: {} });
expect(logger.errors).toEqual([
- "No Eve agent in this directory. Run `eve init <name>`, then run this command from inside the new project.",
+ "No eve agent in this directory. Run `eve init <name>`, then run this command from inside the new project.",
]);
expect(process.exitCode).toBe(1);
});
@@ -339,7 +339,7 @@ describe("runChannelsAddCommand", () => {
expect(process.exitCode).toBeUndefined();
});
- test("does not scaffold Web Chat over an existing Eve session channel", async () => {
+ test("does not scaffold Web Chat over an existing eve session channel", async () => {
const projectRoot = await createAgentProject();
const logger = new TestLogger();
const authModulePath = sourceImportSpecifier("../../public/channels/auth.ts");
@@ -370,7 +370,7 @@ describe("runChannelsAddCommand", () => {
await expect(readFile(join(projectRoot, "agent/channels/web.ts"), "utf8")).rejects.toThrow();
expect(logger.errors).toEqual([
- "Cannot scaffold Web Chat because agent/channels/custom.ts already defines POST /eve/v1/session. Web Chat scaffolds the same Eve session routes.",
+ "Cannot scaffold Web Chat because agent/channels/custom.ts already defines POST /eve/v1/session. Web Chat scaffolds the same eve session routes.",
]);
expect(process.exitCode).toBe(1);
});
diff --git a/packages/eve/src/cli/commands/channels.ts b/packages/eve/src/cli/commands/channels.ts
index 0ab1749da..abfb502ac 100644
--- a/packages/eve/src/cli/commands/channels.ts
+++ b/packages/eve/src/cli/commands/channels.ts
@@ -77,7 +77,7 @@ async function runAddChannelsFlow(
}
const prompter = dependencies.createPrompter?.() ?? createPrompter();
- prompter.intro("Add channels to your Eve agent");
+ prompter.intro("Add channels to your eve agent");
prompter.log.message("Checking the current Vercel project...");
// The detected on-disk link is the only seeded fact; there are no onboarding
// plans in this command, so the rest of the state keeps its defaults. The
diff --git a/packages/eve/src/cli/commands/deploy.integration.test.ts b/packages/eve/src/cli/commands/deploy.integration.test.ts
index 542791ce6..b11e67e29 100644
--- a/packages/eve/src/cli/commands/deploy.integration.test.ts
+++ b/packages/eve/src/cli/commands/deploy.integration.test.ts
@@ -62,7 +62,7 @@ afterEach(() => {
});
describe("runDeployCommand", () => {
- test("refuses a directory without an Eve agent", async () => {
+ test("refuses a directory without an eve agent", async () => {
const projectRoot = await mkdtemp(join(tmpdir(), "eve-deploy-empty-"));
const logger = new TestLogger();
@@ -72,7 +72,7 @@ describe("runDeployCommand", () => {
});
expect(logger.errors).toEqual([
- "No Eve agent in this directory. Run `eve init <name>`, then run this command from inside the new project.",
+ "No eve agent in this directory. Run `eve init <name>`, then run this command from inside the new project.",
]);
expect(process.exitCode).toBe(1);
});
diff --git a/packages/eve/src/cli/commands/deploy.ts b/packages/eve/src/cli/commands/deploy.ts
index 75c164b0e..a511f161e 100644
--- a/packages/eve/src/cli/commands/deploy.ts
+++ b/packages/eve/src/cli/commands/deploy.ts
@@ -42,7 +42,7 @@ export async function runDeployCommand(
}
const prompter = dependencies.createPrompter?.() ?? createPrompter();
- prompter.intro("Deploy your Eve agent to Vercel");
+ prompter.intro("Deploy your eve agent to Vercel");
try {
const result = await runDeployFlow({
appRoot,
diff --git a/packages/eve/src/cli/commands/info.ts b/packages/eve/src/cli/commands/info.ts
index 5b457c379..6221bb84c 100644
--- a/packages/eve/src/cli/commands/info.ts
+++ b/packages/eve/src/cli/commands/info.ts
@@ -219,7 +219,7 @@ export async function printApplicationInfo(
[
renderCliBanner(theme, {
subtitle: "Resolved application paths and the active message contract.",
- title: "Eve Info",
+ title: "eve Info",
}),
"",
renderCliSection(theme, {
diff --git a/packages/eve/src/cli/commands/init-agent-instructions.md b/packages/eve/src/cli/commands/init-agent-instructions.md
index a28e3f76d..3f0d6682c 100644
--- a/packages/eve/src/cli/commands/init-agent-instructions.md
+++ b/packages/eve/src/cli/commands/init-agent-instructions.md
@@ -1,4 +1,4 @@
-# Set up an Eve agent
+# Set up an eve agent
Ask the user these questions one at a time. Use the coding harness's prompt
tools when available. Do not guess.
diff --git a/packages/eve/src/cli/commands/init-git.ts b/packages/eve/src/cli/commands/init-git.ts
index 4f2f6a60c..b4c9c0891 100644
--- a/packages/eve/src/cli/commands/init-git.ts
+++ b/packages/eve/src/cli/commands/init-git.ts
@@ -76,7 +76,7 @@ export function tryInitializeGit(projectPath: string): GitInitResult {
}
execSync("git add -A", { cwd: projectPath, stdio: "ignore", timeout: GIT_TIMEOUT_MS });
- execSync('git commit -m "Initial commit from Eve"', {
+ execSync('git commit -m "Initial commit from eve"', {
cwd: projectPath,
stdio: "ignore",
timeout: GIT_TIMEOUT_MS,
diff --git a/packages/eve/src/cli/commands/init.integration.test.ts b/packages/eve/src/cli/commands/init.integration.test.ts
index dd7e86b94..e8dbb7bc3 100644
--- a/packages/eve/src/cli/commands/init.integration.test.ts
+++ b/packages/eve/src/cli/commands/init.integration.test.ts
@@ -107,7 +107,7 @@ afterEach(() => {
});
describe("runInitCommand", () => {
- it("creates the base agent with the runtime default model and invoking Eve dependency", async () => {
+ it("creates the base agent with the runtime default model and invoking eve dependency", async () => {
const parentDirectory = await mkdtemp(join(tmpdir(), "eve-init-base-"));
const output = logger();
const deps = dependencies();
@@ -264,7 +264,7 @@ describe("runInitCommand", () => {
);
});
- it("adds Web Chat without Vercel configuration and preserves the invoking Eve dependency", async () => {
+ it("adds Web Chat without Vercel configuration and preserves the invoking eve dependency", async () => {
const parentDirectory = await mkdtemp(join(tmpdir(), "eve-init-web-"));
const output = logger();
const deps = dependencies();
diff --git a/packages/eve/src/cli/commands/init.ts b/packages/eve/src/cli/commands/init.ts
index a7e213f24..b96411fc8 100644
--- a/packages/eve/src/cli/commands/init.ts
+++ b/packages/eve/src/cli/commands/init.ts
@@ -215,7 +215,7 @@ function startSpinner(logger: InitCliLogger, message: string): { stop(): void }
}
/**
- * Creates a new Eve agent (`target` is a project name), or adds one to an
+ * Creates a new eve agent (`target` is a project name), or adds one to an
* existing project (`target` is a directory), without prompts or external
* provisioning.
*
diff --git a/packages/eve/src/cli/commands/link.integration.test.ts b/packages/eve/src/cli/commands/link.integration.test.ts
index fd7c05824..86c952cdf 100644
--- a/packages/eve/src/cli/commands/link.integration.test.ts
+++ b/packages/eve/src/cli/commands/link.integration.test.ts
@@ -99,7 +99,7 @@ afterEach(() => {
});
describe("runLinkCommand", () => {
- test("refuses a directory without an Eve agent", async () => {
+ test("refuses a directory without an eve agent", async () => {
const projectRoot = await mkdtemp(join(tmpdir(), "eve-link-empty-"));
const logger = new TestLogger();
@@ -109,7 +109,7 @@ describe("runLinkCommand", () => {
});
expect(logger.errors).toEqual([
- "No Eve agent in this directory. Run `eve init <name>`, then run this command from inside the new project.",
+ "No eve agent in this directory. Run `eve init <name>`, then run this command from inside the new project.",
]);
expect(process.exitCode).toBe(1);
});
@@ -147,7 +147,7 @@ describe("runLinkCommand", () => {
expect(logger.errors).toEqual([]);
expect(process.exitCode).toBeUndefined();
- expect(fake.prompter.intro).toHaveBeenCalledWith("Link your Eve agent to Vercel");
+ expect(fake.prompter.intro).toHaveBeenCalledWith("Link your eve agent to Vercel");
expect(fake.prompter.outro).toHaveBeenCalledWith("Project linked.");
expect(flowDeps.linkProject?.linkProject).toHaveBeenCalled();
});
diff --git a/packages/eve/src/cli/commands/link.ts b/packages/eve/src/cli/commands/link.ts
index 8c129d138..d16537cfa 100644
--- a/packages/eve/src/cli/commands/link.ts
+++ b/packages/eve/src/cli/commands/link.ts
@@ -49,7 +49,7 @@ export async function runLinkCommand(
}
const prompter = dependencies.createPrompter?.() ?? createPrompter();
- prompter.intro("Link your Eve agent to Vercel");
+ prompter.intro("Link your eve agent to Vercel");
try {
const result = await runLinkFlow({ appRoot, prompter, deps: dependencies.flowDeps });
prompter.outro(result.kind === "cancelled" ? "Cancelled." : "Project linked.");
diff --git a/packages/eve/src/cli/commands/preconditions.ts b/packages/eve/src/cli/commands/preconditions.ts
index c83081b03..ac9f2eae8 100644
--- a/packages/eve/src/cli/commands/preconditions.ts
+++ b/packages/eve/src/cli/commands/preconditions.ts
@@ -1,9 +1,9 @@
/**
* Refusal shown by agent-scoped commands (`eve link`, `eve deploy`,
- * `eve channels …`) when the working directory holds no Eve agent.
+ * `eve channels …`) when the working directory holds no eve agent.
*/
export const NOT_AN_AGENT_MESSAGE =
- "No Eve agent in this directory. Run `eve init <name>`, then run this command from inside the new project.";
+ "No eve agent in this directory. Run `eve init <name>`, then run this command from inside the new project.";
/** True when stdin and stdout are both TTYs — the default interactivity gate. */
export function hasInteractiveTerminal(): boolean {
diff --git a/packages/eve/src/cli/dev/environment.ts b/packages/eve/src/cli/dev/environment.ts
index ec4d2092a..a7275d17a 100644
--- a/packages/eve/src/cli/dev/environment.ts
+++ b/packages/eve/src/cli/dev/environment.ts
@@ -27,7 +27,7 @@ interface DevelopmentEnvironmentLoader {
const developmentEnvironmentLoaders = new Map<string, DevelopmentEnvironmentLoader>();
/**
- * Returns the local development environment files Eve loads from an
+ * Returns the local development environment files eve loads from an
* application root, ordered from highest to lowest precedence.
*/
export function getDevelopmentEnvironmentFilePaths(appRoot: string): string[] {
diff --git a/packages/eve/src/cli/dev/tui/prompt-command-handler.ts b/packages/eve/src/cli/dev/tui/prompt-command-handler.ts
index 4f0517bdb..5dcee2bdf 100644
--- a/packages/eve/src/cli/dev/tui/prompt-command-handler.ts
+++ b/packages/eve/src/cli/dev/tui/prompt-command-handler.ts
@@ -46,7 +46,7 @@ export function createPromptCommandHandler(
formatApplyModelOutcome,
modelChangeRefusalForUneditableModel,
} = await import("#setup/flows/model.js");
- // A source-backed model (an SDK model call) isn't a string literal Eve
+ // A source-backed model (an SDK model call) isn't a string literal eve
// can rewrite; refuse with a clear reason rather than silently no-op.
const checkRefusal = options.modelChangeRefusal ?? modelChangeRefusalForUneditableModel;
const refusal = await checkRefusal(appRoot);
diff --git a/packages/eve/src/cli/dev/tui/runner.test.ts b/packages/eve/src/cli/dev/tui/runner.test.ts
index 39eb16677..4c5662603 100644
--- a/packages/eve/src/cli/dev/tui/runner.test.ts
+++ b/packages/eve/src/cli/dev/tui/runner.test.ts
@@ -543,7 +543,7 @@ describe("EveTUIRunner initial input", () => {
});
describe("EveTUIRunner native continuation state", () => {
- it("continues an input request from Eve-native turn state", async () => {
+ it("continues an input request from eve-native turn state", async () => {
const prompts: Array<string | undefined> = ["approve this", undefined];
const session = sessionYieldingTurns([
[
diff --git a/packages/eve/src/cli/dev/tui/runner.ts b/packages/eve/src/cli/dev/tui/runner.ts
index 7e67a8f3a..b95701469 100644
--- a/packages/eve/src/cli/dev/tui/runner.ts
+++ b/packages/eve/src/cli/dev/tui/runner.ts
@@ -396,7 +396,7 @@ export class EveTUIRunner {
/**
* approval-id → input-request map populated as `input.requested` events
* stream in. Used to translate the renderer's approval responses back into
- * Eve `InputResponse[]` payloads on the next `send()`.
+ * eve `InputResponse[]` payloads on the next `send()`.
*/
readonly #pendingInputRequests = new Map<string, InputRequest>();
/**
@@ -442,7 +442,7 @@ export class EveTUIRunner {
this.#session = options.session;
if (options.client !== undefined) this.#client = options.client;
this.#renderer = createRenderer(options);
- this.#name = options.name ?? "Eve";
+ this.#name = options.name ?? "eve";
this.#tools = options.tools ?? "full";
this.#reasoning = options.reasoning ?? "full";
this.#subagents = options.subagents ?? "full";
@@ -1399,8 +1399,8 @@ type EveStreamTranslatorInput = {
};
/**
- * Reduces one Eve session-stream turn into renderer-native TUI events.
- * Eve events name assistant/reasoning sections by `turnId` + `stepIndex`;
+ * Reduces one eve session-stream turn into renderer-native TUI events.
+ * eve events name assistant/reasoning sections by `turnId` + `stepIndex`;
* those ids become stable block ids in the terminal renderer.
*/
async function* eveEventsToTUIStream(
@@ -1859,7 +1859,7 @@ function reasoningPartId(turnId: string, stepIndex: number): string {
/**
* Per-part-key accumulation state for one assistant text or reasoning trace.
*
- * Eve names parts by `turnId:stepIndex`, but the harness reuses `stepIndex`
+ * eve names parts by `turnId:stepIndex`, but the harness reuses `stepIndex`
* across the model calls of one turn (the post-park call restarts at the same
* index). `generation` disambiguates: each fresh model call that reuses a
* completed key opens generation N+1, which renders as its own block.
diff --git a/packages/eve/src/cli/dev/tui/terminal-renderer.test.ts b/packages/eve/src/cli/dev/tui/terminal-renderer.test.ts
index 509dfd4f2..c5a4a8d66 100644
--- a/packages/eve/src/cli/dev/tui/terminal-renderer.test.ts
+++ b/packages/eve/src/cli/dev/tui/terminal-renderer.test.ts
@@ -780,9 +780,9 @@ describe("TerminalRenderer (inline scrollback)", () => {
});
renderer.renderAgentHeader({ name: "Weather Agent", serverUrl: "http://localhost:3000" });
- process.stdout.write('Eve: sandbox template "root" (microsandbox): checking cached snapshot\n');
- process.stdout.write("Eve: initializing 3 sandbox templates...\n");
- process.stdout.write('Eve: built sandbox template "root" on backend "microsandbox".\n');
+ process.stdout.write('eve: sandbox template "root" (microsandbox): checking cached snapshot\n');
+ process.stdout.write("eve: initializing 3 sandbox templates...\n");
+ process.stdout.write('eve: built sandbox template "root" on backend "microsandbox".\n');
process.stdout.write("ordinary stdout log\n");
renderer.shutdown();
@@ -809,7 +809,7 @@ describe("TerminalRenderer (inline scrollback)", () => {
});
renderer.renderAgentHeader({ name: "Weather Agent", serverUrl: "http://localhost:3000" });
- process.stdout.write('Eve: built sandbox template "root" on backend "microsandbox".\n');
+ process.stdout.write('eve: built sandbox template "root" on backend "microsandbox".\n');
renderer.shutdown();
const snapshot = screen.snapshot();
@@ -829,7 +829,7 @@ describe("TerminalRenderer (inline scrollback)", () => {
});
renderer.renderAgentHeader({ name: "Weather Agent", serverUrl: "http://localhost:3000" });
- process.stdout.write('Eve: built sandbox template "root" on backend "microsandbox".\n');
+ process.stdout.write('eve: built sandbox template "root" on backend "microsandbox".\n');
process.stdout.write("ordinary stdout log\n");
renderer.shutdown();
@@ -852,9 +852,9 @@ describe("TerminalRenderer (inline scrollback)", () => {
});
renderer.renderAgentHeader({ name: "Weather Agent", serverUrl: "http://localhost:3000" });
- renderer.renderSandboxLog?.('Eve: sandbox template "root" (docker): checking Docker daemon');
- renderer.renderSandboxLog?.("Eve: initializing 3 sandbox templates...");
- renderer.renderSandboxLog?.('Eve: built sandbox template "root" on backend "docker".');
+ renderer.renderSandboxLog?.('eve: sandbox template "root" (docker): checking Docker daemon');
+ renderer.renderSandboxLog?.("eve: initializing 3 sandbox templates...");
+ renderer.renderSandboxLog?.('eve: built sandbox template "root" on backend "docker".');
renderer.renderSandboxLog?.("ordinary stdout log");
renderer.shutdown();
diff --git a/packages/eve/src/cli/dev/tui/terminal-renderer.ts b/packages/eve/src/cli/dev/tui/terminal-renderer.ts
index cf7114229..f45e69548 100644
--- a/packages/eve/src/cli/dev/tui/terminal-renderer.ts
+++ b/packages/eve/src/cli/dev/tui/terminal-renderer.ts
@@ -295,7 +295,7 @@ export class TerminalRenderer implements AgentTUIRenderer {
#typeahead?: CommandTypeaheadState;
#working = false;
#status: string = STATUS.processing;
- #title = "Eve";
+ #title = "eve";
#isInteractive = false;
#interrupted = false;
#caretVisible = true;
@@ -2765,11 +2765,11 @@ function leadsWithGap(block: Block, previous: PreviousBlock | undefined): boolea
function parseSandboxLogLine(line: string): string | undefined {
const trimmed = line.trim();
- if (!trimmed.startsWith("Eve: ")) {
+ if (!trimmed.startsWith("eve: ")) {
return undefined;
}
- const message = trimmed.slice("Eve: ".length);
+ const message = trimmed.slice("eve: ".length);
return /\bsandbox\b/i.test(message) && !isLowValueSandboxLogLine(message) ? message : undefined;
}
diff --git a/packages/eve/src/cli/dev/tui/theme.ts b/packages/eve/src/cli/dev/tui/theme.ts
index 066fcbb84..2811283e5 100644
--- a/packages/eve/src/cli/dev/tui/theme.ts
+++ b/packages/eve/src/cli/dev/tui/theme.ts
@@ -57,7 +57,7 @@ export interface ThemeColors {
* the terminal can't be trusted with wide/box-drawing characters).
*/
export interface ThemeGlyphs {
- /** `▲` — the Vercel/Eve brand mark; prefixes the agent's own output. */
+ /** `▲` — the Vercel/eve brand mark; prefixes the agent's own output. */
brand: string;
/** `▌` — left gutter bar marking a user message. */
user: string;
diff --git a/packages/eve/src/cli/dev/tui/tui.ts b/packages/eve/src/cli/dev/tui/tui.ts
index 3f62dc5d3..b4799f2f3 100644
--- a/packages/eve/src/cli/dev/tui/tui.ts
+++ b/packages/eve/src/cli/dev/tui/tui.ts
@@ -15,7 +15,7 @@ import type { TuiDisplayOptions } from "./types.js";
*/
export interface RunDevelopmentTuiInput extends TuiDisplayOptions {
/**
- * The Eve server URL the TUI connects to — either the in-process dev
+ * The eve server URL the TUI connects to — either the in-process dev
* server started by `eve dev`, or a remote `--url` target.
*/
readonly serverUrl: string;
diff --git a/packages/eve/src/cli/dev/url.ts b/packages/eve/src/cli/dev/url.ts
index 06d81c777..3a48b9a03 100644
--- a/packages/eve/src/cli/dev/url.ts
+++ b/packages/eve/src/cli/dev/url.ts
@@ -9,7 +9,7 @@ function assertDevelopmentServerProtocol(url: URL, value: string): void {
}
/**
- * Parse and normalize an Eve server URL for the development REPL.
+ * Parse and normalize an eve server URL for the development REPL.
*/
export function parseDevelopmentServerUrl(value: string): string {
const normalizedValue = value.trim();
diff --git a/packages/eve/src/cli/run.ts b/packages/eve/src/cli/run.ts
index ed6525cb0..d9395d10b 100644
--- a/packages/eve/src/cli/run.ts
+++ b/packages/eve/src/cli/run.ts
@@ -354,7 +354,7 @@ function createCliProgram(logger: CliLogger, runtime: CliRuntimeOverrides): Comm
program
.name("eve")
- .description("Build and run an Eve application.")
+ .description("Build and run an eve application.")
.version(packageVersion)
.showHelpAfterError()
.exitOverride()
@@ -399,7 +399,7 @@ function createCliProgram(logger: CliLogger, runtime: CliRuntimeOverrides): Comm
// Optional: a missing target scaffolds or updates the current directory,
// matching `eve init .`.
.command("init [target]")
- .description("Create a new Eve agent, or add one to an existing project directory.")
+ .description("Create a new eve agent, or add one to an existing project directory.")
.option("--channel-web-nextjs", "Add the Web Chat application (Next.js)")
.action(async (target: string | undefined, options: { channelWebNextjs?: boolean }) => {
const { runInitCommand } = await import("#cli/commands/init.js");
@@ -410,7 +410,7 @@ function createCliProgram(logger: CliLogger, runtime: CliRuntimeOverrides): Comm
program
.command("build")
- .description("Build the current Eve application.")
+ .description("Build the current eve application.")
.action(async () => {
const { loadDevelopmentEnvironmentFiles } = await import("#cli/dev/environment.js");
@@ -429,7 +429,7 @@ function createCliProgram(logger: CliLogger, runtime: CliRuntimeOverrides): Comm
program
.command("start")
- .description("Start a built Eve application.")
+ .description("Start a built eve application.")
.option("--host <host>", "Host interface to bind")
.option("--port <port>", "Port to listen on (defaults to $PORT, then 3000)", parsePortOption)
.action(async (options: ProductionCliOptions) => {
@@ -456,7 +456,7 @@ function createCliProgram(logger: CliLogger, runtime: CliRuntimeOverrides): Comm
program
.command("dev")
- .description("Start the Eve development server or connect to an existing URL.")
+ .description("Start the eve development server or connect to an existing URL.")
.option("--host <host>", "Host interface to bind")
.option("--port <port>", "Port to listen on (defaults to $PORT, then 2000)", parsePortOption)
.option("-u, --url <url>", "Connect to an existing server URL", parseDevelopmentServerUrl)
@@ -624,7 +624,7 @@ function createCliProgram(logger: CliLogger, runtime: CliRuntimeOverrides): Comm
program
.command("eval")
- .description("Run evals against an Eve agent.")
+ .description("Run evals against an eve agent.")
.argument(
"[evalIds...]",
"Eval ids (or directory prefixes) to run (all discovered evals when omitted)",
@@ -648,7 +648,7 @@ function createCliProgram(logger: CliLogger, runtime: CliRuntimeOverrides): Comm
}
/**
- * Runs the Eve CLI entrypoint.
+ * Runs the eve CLI entrypoint.
*/
export async function runCli(
argv: string[] = process.argv.slice(2),
diff --git a/packages/eve/src/cli/ui/output.test.ts b/packages/eve/src/cli/ui/output.test.ts
index ec803301a..a69ba801e 100644
--- a/packages/eve/src/cli/ui/output.test.ts
+++ b/packages/eve/src/cli/ui/output.test.ts
@@ -75,8 +75,8 @@ describe("CLI renderers", () => {
it("sanitize banner and section fields before rendering", () => {
const theme = createCliTheme({ color: false });
- expect(renderCliBanner(theme, { subtitle: `sub${dcs}title`, title: `Ev${oscTitle}e` })).toBe(
- "Eve\n===\nsubtitle",
+ expect(renderCliBanner(theme, { subtitle: `sub${dcs}title`, title: `ev${oscTitle}e` })).toBe(
+ "eve\n===\nsubtitle",
);
expect(
renderCliSection(theme, {
diff --git a/packages/eve/src/cli/ui/output.ts b/packages/eve/src/cli/ui/output.ts
index e19e3cf23..938e309c1 100644
--- a/packages/eve/src/cli/ui/output.ts
+++ b/packages/eve/src/cli/ui/output.ts
@@ -11,7 +11,7 @@ type CliMessageTone =
| "warning";
/**
- * Shared color palette used by the Eve CLI.
+ * Shared color palette used by the eve CLI.
*/
export interface CliTheme {
readonly color: boolean;
diff --git a/packages/eve/src/client/client-error.test.ts b/packages/eve/src/client/client-error.test.ts
index b90917e31..fb75cce02 100644
--- a/packages/eve/src/client/client-error.test.ts
+++ b/packages/eve/src/client/client-error.test.ts
@@ -3,7 +3,7 @@ import { describe, expect, it } from "vitest";
import { ClientError } from "#client/client-error.js";
describe("ClientError", () => {
- it("uses structured Eve JSON error bodies as the public message", () => {
+ it("uses structured eve JSON error bodies as the public message", () => {
const error = new ClientError(
401,
JSON.stringify({
diff --git a/packages/eve/src/client/client-error.ts b/packages/eve/src/client/client-error.ts
index a90d96f49..0729f4f1f 100644
--- a/packages/eve/src/client/client-error.ts
+++ b/packages/eve/src/client/client-error.ts
@@ -1,7 +1,7 @@
import { isObject } from "#shared/guards.js";
/**
- * Error thrown when the Eve server returns a non-successful HTTP response.
+ * Error thrown when the eve server returns a non-successful HTTP response.
*/
export class ClientError extends Error {
/**
diff --git a/packages/eve/src/client/client.ts b/packages/eve/src/client/client.ts
index 769d4cc95..18978199c 100644
--- a/packages/eve/src/client/client.ts
+++ b/packages/eve/src/client/client.ts
@@ -14,7 +14,7 @@ import type {
} from "#client/types.js";
/**
- * HTTP client for talking to a deployed Eve agent.
+ * HTTP client for talking to a deployed eve agent.
*
* A single client is bound to one host and auth configuration. It can create
* many concurrent {@link ClientSession | sessions}, each tracking their own
@@ -36,7 +36,7 @@ export class Client {
}
/**
- * Checks the health of the Eve agent server.
+ * Checks the health of the eve agent server.
*
* @throws {ClientError} If the server returns a non-successful status.
*/
@@ -76,7 +76,7 @@ export class Client {
}
/**
- * Performs an authenticated fetch against a path on this Eve target.
+ * Performs an authenticated fetch against a path on this eve target.
*
* This is the raw escape hatch for framework-owned routes (for example
* channel ingress or dev-only schedule dispatch) while preserving the same
diff --git a/packages/eve/src/client/eve-agent-store.ts b/packages/eve/src/client/eve-agent-store.ts
index bd0a8a077..9fc73a22d 100644
--- a/packages/eve/src/client/eve-agent-store.ts
+++ b/packages/eve/src/client/eve-agent-store.ts
@@ -81,7 +81,7 @@ interface PendingMessageSubmission {
}
/**
- * Framework-agnostic state machine for an Eve agent session.
+ * Framework-agnostic state machine for an eve agent session.
*
* Manages the send/stream lifecycle, optimistic projection, and subscriber
* notification; framework integrations (React, Vue) wrap it with their own
@@ -147,7 +147,7 @@ export class EveAgentStore<TData> {
async send<TOutput = unknown>(input: SendTurnPayload<TOutput>): Promise<void> {
if (this.#status === "streaming" || this.#status === "submitted") {
- throw new Error("Eve session is already processing a turn.");
+ throw new Error("eve session is already processing a turn.");
}
const operationId = this.#startOperation();
@@ -241,7 +241,7 @@ export class EveAgentStore<TData> {
#createOwnedSession(): ClientSession {
if (!this.#createSession) {
- throw new Error("Cannot create an owned Eve session from an external session.");
+ throw new Error("Cannot create an owned eve session from an external session.");
}
return this.#createSession();
}
diff --git a/packages/eve/src/client/message-reducer-types.ts b/packages/eve/src/client/message-reducer-types.ts
index a0d57c97c..417f13dba 100644
--- a/packages/eve/src/client/message-reducer-types.ts
+++ b/packages/eve/src/client/message-reducer-types.ts
@@ -1,14 +1,14 @@
import type { InputResponse } from "#runtime/input/types.js";
/**
- * UIMessage-compatible Eve message projection for chat and agent UIs.
+ * UIMessage-compatible eve message projection for chat and agent UIs.
*/
export interface EveMessageData {
readonly messages: readonly EveMessage[];
}
/**
- * Eve-owned message shape that follows the AI SDK UIMessage convention.
+ * eve-owned message shape that follows the AI SDK UIMessage convention.
*/
export interface EveMessage {
readonly id: string;
@@ -156,7 +156,7 @@ export type EveDynamicToolPart = {
);
/**
- * Eve-specific metadata attached to an {@link EveDynamicToolPart}. `eve.kind`
+ * eve-specific metadata attached to an {@link EveDynamicToolPart}. `eve.kind`
* classifies the action (`"tool-call"`, `"subagent-call"`, `"load-skill"`, or
* `"unknown"`), `eve.name` is the resolved action name, and `eve.inputRequest`
* and `eve.inputResponse` store the HITL prompt and submitted response when the
diff --git a/packages/eve/src/client/message-reducer.ts b/packages/eve/src/client/message-reducer.ts
index 563bf75cc..43125f247 100644
--- a/packages/eve/src/client/message-reducer.ts
+++ b/packages/eve/src/client/message-reducer.ts
@@ -30,13 +30,13 @@ interface ActionDescriptor {
}
/**
- * Creates a UIMessage-compatible Eve reducer for chat and agent UIs.
+ * Creates a UIMessage-compatible eve reducer for chat and agent UIs.
*
- * The returned projection keeps Eve-owned types while following the AI SDK
+ * The returned projection keeps eve-owned types while following the AI SDK
* `messages[].parts[]` rendering convention used by AI Elements. It projects
* text, reasoning, tool calls, tool results, tool approvals, and submitted
* HITL responses. Connection authorization stream events remain available to
- * custom reducers through the reducer event contract until Eve has a dedicated
+ * custom reducers through the reducer event contract until eve has a dedicated
* message-part shape for authorization UI.
*/
export function defaultMessageReducer(): EveAgentReducer<EveMessageData> {
diff --git a/packages/eve/src/client/output-schema.ts b/packages/eve/src/client/output-schema.ts
index d9752dabb..b758b9125 100644
--- a/packages/eve/src/client/output-schema.ts
+++ b/packages/eve/src/client/output-schema.ts
@@ -6,7 +6,7 @@ import type { JsonObject } from "#shared/json.js";
/**
* Normalizes a client-supplied output schema into the wire-safe JSON Schema
- * representation accepted by Eve message routes.
+ * representation accepted by eve message routes.
*/
export function normalizeOutputSchemaForRequest<TOutput>(
schema: StandardJSONSchemaV1<unknown, TOutput> | JsonObject | undefined,
diff --git a/packages/eve/src/client/reducer.ts b/packages/eve/src/client/reducer.ts
index 0e03f996a..e2c745775 100644
--- a/packages/eve/src/client/reducer.ts
+++ b/packages/eve/src/client/reducer.ts
@@ -2,7 +2,7 @@ import type { HandleMessageStreamEvent } from "#protocol/message.js";
import type { InputResponse } from "#runtime/input/types.js";
/**
- * Client-side reducer event emitted before Eve confirms a submitted user
+ * Client-side reducer event emitted before eve confirms a submitted user
* message with a `message.received` stream event.
*/
export interface ClientMessageSubmittedEvent {
@@ -16,7 +16,7 @@ export interface ClientMessageSubmittedEvent {
/**
* Client-side reducer event emitted when a submitted user message fails before
- * Eve confirms it with a `message.received` stream event.
+ * eve confirms it with a `message.received` stream event.
*/
export interface ClientMessageFailedEvent {
readonly data: {
@@ -43,9 +43,9 @@ export interface ClientInputRespondedEvent {
}
/**
- * Event consumed by Eve agent reducers.
+ * Event consumed by eve agent reducers.
*
- * Server events are authoritative Eve stream events. They include text,
+ * Server events are authoritative eve stream events. They include text,
* reasoning, tool/action requests and results, HITL input requests, connection
* authorization events, subagent events, and session lifecycle events. Client
* events are projection-only events created by client state machines for local
@@ -58,7 +58,7 @@ export type EveAgentReducerEvent =
| HandleMessageStreamEvent;
/**
- * Projects Eve stream events into accumulated consumer data.
+ * Projects eve stream events into accumulated consumer data.
*/
export interface EveAgentReducer<TData> {
/**
diff --git a/packages/eve/src/client/session.ts b/packages/eve/src/client/session.ts
index 5043b793b..20d9e77a4 100644
--- a/packages/eve/src/client/session.ts
+++ b/packages/eve/src/client/session.ts
@@ -28,7 +28,7 @@ interface SessionContext {
}
/**
- * One conversation with an Eve agent.
+ * One conversation with an eve agent.
*
* A session tracks conversation state (continuation token, session ID, stream
* cursor) automatically across {@link send} calls. Read the state from
diff --git a/packages/eve/src/client/types.ts b/packages/eve/src/client/types.ts
index 45c423212..8acfb99f6 100644
--- a/packages/eve/src/client/types.ts
+++ b/packages/eve/src/client/types.ts
@@ -35,7 +35,7 @@ export type ClientAuth =
*/
export interface ClientOptions {
/**
- * Base URL of the Eve agent server.
+ * Base URL of the eve agent server.
*/
readonly host: string;
diff --git a/packages/eve/src/client/url.ts b/packages/eve/src/client/url.ts
index 1b6d8f9e3..4f49be6cd 100644
--- a/packages/eve/src/client/url.ts
+++ b/packages/eve/src/client/url.ts
@@ -1,9 +1,9 @@
/**
- * Builds a fetchable URL from a caller-provided host and an Eve route path.
+ * Builds a fetchable URL from a caller-provided host and an eve route path.
*
* `host` may be an absolute origin (`https://agent.example.com`) or a
* same-origin prefix (`/api`). Prefixes are important for browser clients that
- * talk to an app-owned proxy instead of the Eve deployment directly.
+ * talk to an app-owned proxy instead of the eve deployment directly.
*/
export function createClientUrl(
host: string,
diff --git a/packages/eve/src/compiler/channel-instrumentation-types.test.ts b/packages/eve/src/compiler/channel-instrumentation-types.test.ts
index 4cf97ee80..20fe2b211 100644
--- a/packages/eve/src/compiler/channel-instrumentation-types.test.ts
+++ b/packages/eve/src/compiler/channel-instrumentation-types.test.ts
@@ -88,7 +88,7 @@ describe("createChannelInstrumentationTypesSource", () => {
expect(source).toBe(
[
- "// Generated by Eve. Do not edit by hand.",
+ "// Generated by eve. Do not edit by hand.",
'import type { InferChannelMetadata } from "eve/channels";',
"",
'declare module "eve/channels" {',
@@ -123,7 +123,7 @@ describe("createChannelInstrumentationTypesSource", () => {
expect(source).toBe(
[
- "// Generated by Eve. Do not edit by hand.",
+ "// Generated by eve. Do not edit by hand.",
'import type { InferChannelMetadata } from "eve/channels";',
"",
'declare module "eve/channels" {',
diff --git a/packages/eve/src/compiler/channel-instrumentation-types.ts b/packages/eve/src/compiler/channel-instrumentation-types.ts
index 354bfb872..7ed39e8f3 100644
--- a/packages/eve/src/compiler/channel-instrumentation-types.ts
+++ b/packages/eve/src/compiler/channel-instrumentation-types.ts
@@ -38,7 +38,7 @@ export function createChannelInstrumentationTypesSource(
];
return [
- "// Generated by Eve. Do not edit by hand.",
+ "// Generated by eve. Do not edit by hand.",
'import type { InferChannelMetadata } from "eve/channels";',
"",
'declare module "eve/channels" {',
diff --git a/packages/eve/src/compiler/model-catalog.ts b/packages/eve/src/compiler/model-catalog.ts
index 16bd5903c..8960d595c 100644
--- a/packages/eve/src/compiler/model-catalog.ts
+++ b/packages/eve/src/compiler/model-catalog.ts
@@ -36,7 +36,7 @@ export type CatalogModelProvider = z.infer<typeof catalogModelProviderSchema>;
export type CatalogModel = z.infer<typeof catalogModelSchema>;
/**
- * Stable runtime model limits that Eve can embed in compiled artifacts without
+ * Stable runtime model limits that eve can embed in compiled artifacts without
* resolving provider metadata at runtime.
*/
export type CompiledRuntimeModelLimits = z.infer<typeof compiledRuntimeModelLimitsSchema>;
diff --git a/packages/eve/src/compiler/module-map.ts b/packages/eve/src/compiler/module-map.ts
index 310463ee5..a434b6b92 100644
--- a/packages/eve/src/compiler/module-map.ts
+++ b/packages/eve/src/compiler/module-map.ts
@@ -95,7 +95,7 @@ export function createCompiledModuleMapSource(input: CreateCompiledModuleMapSour
);
return [
- "// Generated by Eve. Do not edit by hand.",
+ "// Generated by eve. Do not edit by hand.",
"",
...imports,
...(imports.length > 0 ? [""] : []),
diff --git a/packages/eve/src/compiler/normalize-agent-config.ts b/packages/eve/src/compiler/normalize-agent-config.ts
index 2849ba717..af3726b4c 100644
--- a/packages/eve/src/compiler/normalize-agent-config.ts
+++ b/packages/eve/src/compiler/normalize-agent-config.ts
@@ -39,8 +39,8 @@ export async function compileAgentConfig(
source: configModule,
}),
configModule === undefined
- ? `Expected the default agent config to match the public Eve shape.`
- : `Expected the agent config export "${configModule.exportName ?? "default"}" from "${configModulePath}" to match the public Eve shape.`,
+ ? `Expected the default agent config to match the public eve shape.`
+ : `Expected the agent config export "${configModule.exportName ?? "default"}" from "${configModulePath}" to match the public eve shape.`,
);
const model = await normalizeAuthoredModelReference({
modelCatalog: context.modelCatalog,
diff --git a/packages/eve/src/compiler/normalize-channel.ts b/packages/eve/src/compiler/normalize-channel.ts
index d43ddb58b..e3c0a9471 100644
--- a/packages/eve/src/compiler/normalize-channel.ts
+++ b/packages/eve/src/compiler/normalize-channel.ts
@@ -45,7 +45,7 @@ export async function compileChannelDefinition(
const definition = normalizeChannelDefinition(
rawValue,
- `Expected the channel export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public Eve shape.`,
+ `Expected the channel export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public eve shape.`,
);
return definition.routes.map((route) => ({
diff --git a/packages/eve/src/compiler/normalize-connection.ts b/packages/eve/src/compiler/normalize-connection.ts
index f499f1ac6..a2684ae7f 100644
--- a/packages/eve/src/compiler/normalize-connection.ts
+++ b/packages/eve/src/compiler/normalize-connection.ts
@@ -40,7 +40,7 @@ export async function compileConnectionDefinition(
source,
});
const protocol = readConnectionProtocol(loaded);
- const message = `Expected the connection export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public Eve shape.`;
+ const message = `Expected the connection export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public eve shape.`;
const shared = {
connectionName: source.connectionName,
diff --git a/packages/eve/src/compiler/normalize-instructions.ts b/packages/eve/src/compiler/normalize-instructions.ts
index a6a3d3684..67442fd81 100644
--- a/packages/eve/src/compiler/normalize-instructions.ts
+++ b/packages/eve/src/compiler/normalize-instructions.ts
@@ -46,7 +46,7 @@ export async function compileInstructionsEntry(
if (source.sourceKind === "markdown") {
const definition = normalizeInstructionsDefinition(
source.definition,
- `Expected the compiled instructions definition at "${source.logicalPath}" to match the public Eve shape.`,
+ `Expected the compiled instructions definition at "${source.logicalPath}" to match the public eve shape.`,
);
return {
kind: "instructions",
@@ -84,7 +84,7 @@ export async function compileInstructionsEntry(
const definition = normalizeInstructionsDefinition(
exportValue,
- `Expected the instructions export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public Eve shape.`,
+ `Expected the instructions export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public eve shape.`,
);
return {
diff --git a/packages/eve/src/compiler/normalize-sandbox.ts b/packages/eve/src/compiler/normalize-sandbox.ts
index 41d5643f2..ed8e5f8b4 100644
--- a/packages/eve/src/compiler/normalize-sandbox.ts
+++ b/packages/eve/src/compiler/normalize-sandbox.ts
@@ -20,7 +20,7 @@ export async function compileSandboxDefinition(
source: SandboxSourceRef,
options: ModuleBackedDefinitionLoadOptions = {},
): Promise<CompiledSandboxDefinition> {
- const message = `Expected the sandbox export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public Eve shape.`;
+ const message = `Expected the sandbox export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public eve shape.`;
const normalized = normalizeSandboxDefinition(
await loadModuleBackedDefinition({
agentRoot,
diff --git a/packages/eve/src/compiler/normalize-schedule.ts b/packages/eve/src/compiler/normalize-schedule.ts
index 8b68c7109..458c96222 100644
--- a/packages/eve/src/compiler/normalize-schedule.ts
+++ b/packages/eve/src/compiler/normalize-schedule.ts
@@ -28,7 +28,7 @@ export async function compileScheduleDefinition(
source.sourceKind === "markdown"
? normalizeScheduleDefinition(
source.definition,
- `Expected the compiled schedule definition at "${source.logicalPath}" to match the public Eve shape.`,
+ `Expected the compiled schedule definition at "${source.logicalPath}" to match the public eve shape.`,
)
: normalizeScheduleDefinition(
await loadModuleBackedDefinition({
@@ -37,7 +37,7 @@ export async function compileScheduleDefinition(
kind: "schedule",
source,
}),
- `Expected the schedule export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public Eve shape.`,
+ `Expected the schedule export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public eve shape.`,
);
const compiled: CompiledScheduleDefinition = {
diff --git a/packages/eve/src/compiler/normalize-skill.ts b/packages/eve/src/compiler/normalize-skill.ts
index b40e39be0..907d73184 100644
--- a/packages/eve/src/compiler/normalize-skill.ts
+++ b/packages/eve/src/compiler/normalize-skill.ts
@@ -40,7 +40,7 @@ export async function compileSkillSource(
if (source.sourceKind === "markdown") {
const definition = normalizeSkillDefinition(
source.definition,
- `Expected the compiled skill definition at "${source.logicalPath}" to match the public Eve shape.`,
+ `Expected the compiled skill definition at "${source.logicalPath}" to match the public eve shape.`,
);
return {
kind: "skill",
@@ -88,7 +88,7 @@ export async function compileSkillSource(
const definition = normalizeSkillDefinition(
exportValue,
- `Expected the skill export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public Eve shape.`,
+ `Expected the skill export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public eve shape.`,
);
return {
diff --git a/packages/eve/src/compiler/normalize-subagent.ts b/packages/eve/src/compiler/normalize-subagent.ts
index 738a8ed45..8b6c82d41 100644
--- a/packages/eve/src/compiler/normalize-subagent.ts
+++ b/packages/eve/src/compiler/normalize-subagent.ts
@@ -223,7 +223,7 @@ function compileRemoteAgent(input: {
const moduleSource = createSubagentConfigModuleSourceRef(input.source, configModule);
const definition = normalizeRemoteAgentDefinition(
input.value,
- `Expected the remote agent config export "${configModule.exportName ?? "default"}" from "${moduleSource.logicalPath}" to match the public Eve shape.`,
+ `Expected the remote agent config export "${configModule.exportName ?? "default"}" from "${moduleSource.logicalPath}" to match the public eve shape.`,
);
return {
diff --git a/packages/eve/src/compiler/normalize-tool.ts b/packages/eve/src/compiler/normalize-tool.ts
index 1aeab7959..221e34961 100644
--- a/packages/eve/src/compiler/normalize-tool.ts
+++ b/packages/eve/src/compiler/normalize-tool.ts
@@ -44,7 +44,7 @@ export async function compileToolEntry(
kind: "tool",
source,
}),
- `Expected the tool export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public Eve shape.`,
+ `Expected the tool export "${source.exportName ?? "default"}" from "${source.logicalPath}" to match the public eve shape.`,
);
const toolName = stripLogicalPathExtension(source.logicalPath)
.replace(/^tools\//, "")
diff --git a/packages/eve/src/compiler/workspace-resources.ts b/packages/eve/src/compiler/workspace-resources.ts
index 6b2f0b2ae..df7f17d09 100644
--- a/packages/eve/src/compiler/workspace-resources.ts
+++ b/packages/eve/src/compiler/workspace-resources.ts
@@ -80,7 +80,7 @@ async function materializeNode(input: {
for (const workspace of input.manifest.sandboxWorkspaces) {
if (workspace.rootEntries.some((entry) => entry === "skills/" || entry === "skills")) {
throw new Error(
- `Sandbox workspace "${workspace.logicalPath}" cannot define "skills" because Eve manages that workspace entry.`,
+ `Sandbox workspace "${workspace.logicalPath}" cannot define "skills" because eve manages that workspace entry.`,
);
}
}
diff --git a/packages/eve/src/context/accessors.integration.test.ts b/packages/eve/src/context/accessors.integration.test.ts
index b4a831e51..1f9b32134 100644
--- a/packages/eve/src/context/accessors.integration.test.ts
+++ b/packages/eve/src/context/accessors.integration.test.ts
@@ -18,7 +18,7 @@ import type { SandboxSession } from "#public/definitions/sandbox.js";
describe("buildCallbackContext – session", () => {
it("throws when no authored runtime session is active", () => {
- expect(() => buildCallbackContext()).toThrow("No active Eve context");
+ expect(() => buildCallbackContext()).toThrow("No active eve context");
});
it("returns the active session identity across async boundaries", async () => {
@@ -77,7 +77,7 @@ describe("buildCallbackContext – session", () => {
describe("buildCallbackContext – getSandbox", () => {
it("throws when no authored runtime context is active", () => {
- expect(() => buildCallbackContext()).toThrow("No active Eve context");
+ expect(() => buildCallbackContext()).toThrow("No active eve context");
});
it("returns the active authored sandbox across async boundaries", async () => {
@@ -126,7 +126,7 @@ describe("buildCallbackContext – getSandbox", () => {
describe("buildCallbackContext – getSkill", () => {
it("throws when no authored runtime context is active", () => {
- expect(() => buildCallbackContext()).toThrow("No active Eve context");
+ expect(() => buildCallbackContext()).toThrow("No active eve context");
});
it("throws when authored runtime execution does not include skill access", async () => {
@@ -134,7 +134,7 @@ describe("buildCallbackContext – getSkill", () => {
await expect(
runtime.runAsSession({}, () => buildCallbackContext().getSkill("semantic-model")),
- ).rejects.toThrow("Eve sandbox runtime access is unavailable in the current async context.");
+ ).rejects.toThrow("eve sandbox runtime access is unavailable in the current async context.");
});
it("resolves visible skill files across async boundaries", async () => {
diff --git a/packages/eve/src/context/build-callback-context.ts b/packages/eve/src/context/build-callback-context.ts
index 07a66b280..74defda28 100644
--- a/packages/eve/src/context/build-callback-context.ts
+++ b/packages/eve/src/context/build-callback-context.ts
@@ -27,7 +27,7 @@ export function buildCallbackContext(): SessionContext {
const access = ctx.get(SandboxKey);
if (access === undefined) {
throw new Error(
- "Eve sandbox runtime access is unavailable in the current async context. " +
+ "eve sandbox runtime access is unavailable in the current async context. " +
"Call ctx.getSandbox() only from authored runtime functions such as tools, hooks, and channel events.",
);
}
@@ -43,7 +43,7 @@ export function buildCallbackContext(): SessionContext {
const access = ctx.get(SandboxKey);
if (access === undefined) {
throw new Error(
- "Eve sandbox runtime access is unavailable in the current async context. " +
+ "eve sandbox runtime access is unavailable in the current async context. " +
"Call ctx.getSkill() only from authored runtime functions such as tools, hooks, and channel events.",
);
}
diff --git a/packages/eve/src/context/container.ts b/packages/eve/src/context/container.ts
index f5db00bcf..3f73956d5 100644
--- a/packages/eve/src/context/container.ts
+++ b/packages/eve/src/context/container.ts
@@ -5,7 +5,7 @@ import { type ContextAccessor, type ContextKey, resolveKey } from "#context/key.
const EVE_CONTEXT_STORAGE_KEY = Symbol.for("eve.context-storage");
/**
- * Keyed value container that backs one Eve execution scope.
+ * Keyed value container that backs one eve execution scope.
*
* Durable values are serialized across workflow steps and turns. Virtual
* values are rebuilt each step by context providers and are never
@@ -104,13 +104,13 @@ if (globalContextStorage[EVE_CONTEXT_STORAGE_KEY] === undefined) {
}
/**
- * Process-wide AsyncLocalStorage used by every Eve module copy in the current
+ * Process-wide AsyncLocalStorage used by every eve module copy in the current
* runtime.
*
- * Nitro step bundles can inline parts of Eve while authored modules still
+ * Nitro step bundles can inline parts of eve while authored modules still
* import `eve/*` from disk. Backing the storage with a global
* symbol keeps those copies on the same ALS instance so authored tools,
- * model callbacks, and step code observe one unified Eve context.
+ * model callbacks, and step code observe one unified eve context.
*/
export const contextStorage = globalContextStorage[EVE_CONTEXT_STORAGE_KEY];
@@ -121,7 +121,7 @@ export function loadContext(): AlsContext {
const ctx = contextStorage.getStore();
if (ctx === undefined) {
throw new Error(
- "No active Eve context. " +
+ "No active eve context. " +
"Call this function only from authored runtime code such as tools, steps, and model callbacks.",
);
}
diff --git a/packages/eve/src/context/key.ts b/packages/eve/src/context/key.ts
index 8ee5ca4ba..c3ffc2f3a 100644
--- a/packages/eve/src/context/key.ts
+++ b/packages/eve/src/context/key.ts
@@ -3,7 +3,7 @@
* by the {@link ContextKey} constructor so `deserializeContext` can resolve
* string names back to typed keys without an explicit list.
*
- * Rooted on `globalThis` so Nitro-inlined Eve and disk-imported Eve share one
+ * Rooted on `globalThis` so Nitro-inlined eve and disk-imported eve share one
* registry. Each Nitro workflow chunk can carry its own evaluated copy of
* `key.ts`; without a shared registry, a key registered by one chunk is
* invisible to `resolveKey()` in another, and `serializeContext` /
diff --git a/packages/eve/src/discover/diagnostics.ts b/packages/eve/src/discover/diagnostics.ts
index ee08648a6..3e249f7ed 100644
--- a/packages/eve/src/discover/diagnostics.ts
+++ b/packages/eve/src/discover/diagnostics.ts
@@ -55,7 +55,7 @@ export const discoverDiagnosticsSummarySchema = z
.strict();
/**
- * Root-resolution error code emitted when discovery cannot locate an Eve agent.
+ * Root-resolution error code emitted when discovery cannot locate an eve agent.
*/
export const DISCOVER_PROJECT_NOT_FOUND = "discover/project-not-found";
diff --git a/packages/eve/src/discover/project.integration.test.ts b/packages/eve/src/discover/project.integration.test.ts
index 0612e0803..df871ae06 100644
--- a/packages/eve/src/discover/project.integration.test.ts
+++ b/packages/eve/src/discover/project.integration.test.ts
@@ -62,7 +62,7 @@ describe("resolveDiscoveryProject (memory)", () => {
});
});
- it("raises a structured resolution error when no Eve agent root can be found", async () => {
+ it("raises a structured resolution error when no eve agent root can be found", async () => {
const project = buildMemoryAgentProject({
appFiles: {
"README.md": "not an agent",
diff --git a/packages/eve/src/discover/project.ts b/packages/eve/src/discover/project.ts
index 57e857e21..7f57cf225 100644
--- a/packages/eve/src/discover/project.ts
+++ b/packages/eve/src/discover/project.ts
@@ -28,7 +28,7 @@ export interface ResolvedDiscoveryProject {
}
/**
- * Error raised when discovery cannot resolve an Eve agent root from a
+ * Error raised when discovery cannot resolve an eve agent root from a
* {@link ProjectSource}.
*/
export class DiscoveryProjectResolutionError extends Error {
@@ -42,7 +42,7 @@ export class DiscoveryProjectResolutionError extends Error {
}
/**
- * Resolves the nearest Eve app root and agent root from an arbitrary
+ * Resolves the nearest eve app root and agent root from an arbitrary
* starting path.
*
* By default the resolver walks the real filesystem. Callers that want to
@@ -96,7 +96,7 @@ export async function resolveDiscoveryProject(
throw new DiscoveryProjectResolutionError(
createDiscoverErrorDiagnostic({
code: DISCOVER_PROJECT_NOT_FOUND,
- message: `Could not resolve an Eve agent root from "${startDirectory}".`,
+ message: `Could not resolve an eve agent root from "${startDirectory}".`,
sourcePath: startDirectory,
}),
);
diff --git a/packages/eve/src/evals/cli/eval-client.ts b/packages/eve/src/evals/cli/eval-client.ts
index 0a6878553..bce98aa00 100644
--- a/packages/eve/src/evals/cli/eval-client.ts
+++ b/packages/eve/src/evals/cli/eval-client.ts
@@ -37,7 +37,7 @@ export function resolveEvalClientOptions(
}
/**
- * Creates the Eve {@link Client} for an eval target from
+ * Creates the eve {@link Client} for an eval target from
* {@link resolveEvalClientOptions}.
*/
export function createEvalClient(target: Pick<EveEvalTargetHandle, "kind" | "url">): Client {
diff --git a/packages/eve/src/evals/define-eval.ts b/packages/eve/src/evals/define-eval.ts
index 2a779f6ba..f57a703d6 100644
--- a/packages/eve/src/evals/define-eval.ts
+++ b/packages/eve/src/evals/define-eval.ts
@@ -1,7 +1,7 @@
import type { EveEvalDefinition, EveEvalInput } from "#evals/types.js";
/**
- * Defines one Eve eval. Each eval file is exactly one case: an imperative
+ * Defines one eve eval. Each eval file is exactly one case: an imperative
* `test(t)` function that drives the agent (`t.send`, `t.respond`, …) and
* asserts on what it produced (`t.completed()`, `t.check(...)`,
* `t.judge.autoevals.*`). Organize related evals with directory nesting under
diff --git a/packages/eve/src/evals/runner/execute-eval.ts b/packages/eve/src/evals/runner/execute-eval.ts
index a2ff67978..12f18a519 100644
--- a/packages/eve/src/evals/runner/execute-eval.ts
+++ b/packages/eve/src/evals/runner/execute-eval.ts
@@ -22,7 +22,7 @@ export interface ExecuteEvalOptions {
/** Overrides the eval's own `timeoutMs` when set (CLI `--timeout`). */
readonly timeoutMs?: number;
/**
- * Pre-configured client for communicating with the Eve agent.
+ * Pre-configured client for communicating with the eve agent.
* The CLI constructs this once with the appropriate auth and headers,
* and every eval creates fresh sessions from it.
*/
diff --git a/packages/eve/src/evals/runner/execute-task.ts b/packages/eve/src/evals/runner/execute-task.ts
index 015aa5ec8..50c4e2233 100644
--- a/packages/eve/src/evals/runner/execute-task.ts
+++ b/packages/eve/src/evals/runner/execute-task.ts
@@ -39,7 +39,7 @@ export interface ExecuteTaskResult {
}
/**
- * Executes one eval's `test(t)` against an Eve agent target: drives the
+ * Executes one eval's `test(t)` against an eve agent target: drives the
* session(s), captures the run, then finalizes the recorded assertions
* against the completed task result.
*/
diff --git a/packages/eve/src/evals/types.ts b/packages/eve/src/evals/types.ts
index 0ee2f92de..749436711 100644
--- a/packages/eve/src/evals/types.ts
+++ b/packages/eve/src/evals/types.ts
@@ -76,7 +76,7 @@ export interface EveEvalSessionResult {
}
/**
- * Full result of executing one eval against an Eve agent.
+ * Full result of executing one eval against an eve agent.
*/
export interface EveEvalTaskResult {
/**
@@ -104,7 +104,7 @@ export interface EveEvalTaskResult {
readonly sessions?: readonly EveEvalSessionResult[];
/**
* Runtime identity metadata captured from the `session.started` stream event.
- * Present when the Eve server populates the event with its runtime metadata.
+ * Present when the eve server populates the event with its runtime metadata.
*/
readonly runtimeIdentity?: RuntimeIdentity;
}
@@ -178,7 +178,7 @@ export interface EveEvalSession {
readonly pendingInputRequests: readonly InputRequest[];
/** Serializable cursor for resuming this session. */
readonly state: SessionState;
- /** Eve session id after the first successful send. */
+ /** eve session id after the first successful send. */
readonly sessionId: string | undefined;
/** Assert the last turn parked on HITL input and return matching requests. */
expectInputRequests(filter?: {
@@ -237,8 +237,8 @@ export interface JudgeOpts {
/**
* Braintrust autoevals graders, bound to the resolved judge model. The grader
* family is named so its semantics are explicit: `factuality`'s consistency
- * buckets and `closedQA`'s yes/no grading are autoevals' behavior, not Eve's.
- * These are Eve-owned wrappers, not the raw library.
+ * buckets and `closedQA`'s yes/no grading are autoevals' behavior, not eve's.
+ * These are eve-owned wrappers, not the raw library.
*/
export interface AutoevalsJudges {
factuality(expected: string, opts?: JudgeOpts): AssertionHandle;
@@ -306,7 +306,7 @@ export interface EveEvalContext extends EveEvalSession {
}
/**
- * Describes the Eve server an eval runs against.
+ * Describes the eve server an eval runs against.
*/
export interface EveEvalTarget {
/**
diff --git a/packages/eve/src/execution/durable-session-migrations/chain.ts b/packages/eve/src/execution/durable-session-migrations/chain.ts
index c2875e8be..9203be1ae 100644
--- a/packages/eve/src/execution/durable-session-migrations/chain.ts
+++ b/packages/eve/src/execution/durable-session-migrations/chain.ts
@@ -53,7 +53,7 @@ export function runMigrationChain<TOut extends { readonly version: number }>(inp
if (current.version > input.targetVersion) {
throw new Error(
`${input.label}: encountered version ${current.version}, which is newer than the supported version ${input.targetVersion}. ` +
- `This usually indicates the wire was written by a newer Eve deployment than the one reading it.`,
+ `This usually indicates the wire was written by a newer eve deployment than the one reading it.`,
);
}
while (current.version < input.targetVersion) {
diff --git a/packages/eve/src/execution/durable-session-store.test.ts b/packages/eve/src/execution/durable-session-store.test.ts
index 5fa68da36..76862ab8f 100644
--- a/packages/eve/src/execution/durable-session-store.test.ts
+++ b/packages/eve/src/execution/durable-session-store.test.ts
@@ -78,7 +78,7 @@ describe("durable-session-store cross-version contract", () => {
});
it("preserves unrecognized DurableSessionState fields via spread (forward compat)", () => {
- // Hypothetical state shape introduced by a newer Eve version.
+ // Hypothetical state shape introduced by a newer eve version.
const futureState: DurableSessionState & { futureFlag: { hint: string } } = {
continuationToken: "http:test",
emissionState: { sequence: 0, sessionStarted: false, stepIndex: 0, turnId: "" },
diff --git a/packages/eve/src/execution/node-step.ts b/packages/eve/src/execution/node-step.ts
index 818674531..ac929d37a 100644
--- a/packages/eve/src/execution/node-step.ts
+++ b/packages/eve/src/execution/node-step.ts
@@ -77,7 +77,7 @@ export function createExecutionNodeStep(input: CreateExecutionNodeStepInput): St
/**
* Builds a {@link RuntimeIdentity} from the resolved runtime agent node
- * and the current Eve package installation.
+ * and the current eve package installation.
*/
function buildRuntimeIdentity(node: ResolvedRuntimeAgentNode): RuntimeIdentity {
const packageInfo = resolveInstalledPackageInfo();
diff --git a/packages/eve/src/execution/runtime-context.test.ts b/packages/eve/src/execution/runtime-context.test.ts
index 6e09f0b75..aa9abb88d 100644
--- a/packages/eve/src/execution/runtime-context.test.ts
+++ b/packages/eve/src/execution/runtime-context.test.ts
@@ -94,7 +94,7 @@ describe("contextStorage", () => {
describe("loadContext", () => {
it("throws when called outside of a context scope", () => {
- expect(() => loadContext()).toThrow("No active Eve context");
+ expect(() => loadContext()).toThrow("No active eve context");
});
});
diff --git a/packages/eve/src/execution/sandbox/bash-tool.test.ts b/packages/eve/src/execution/sandbox/bash-tool.test.ts
index 3889f6c78..643d177ad 100644
--- a/packages/eve/src/execution/sandbox/bash-tool.test.ts
+++ b/packages/eve/src/execution/sandbox/bash-tool.test.ts
@@ -34,8 +34,8 @@ describe("executeBashOnSandbox", () => {
stdout: "weather-codes.md\n",
truncated: false,
});
- expect(log).toHaveBeenCalledWith("Eve: starting sandbox command: ls -la /workspace");
- expect(log).toHaveBeenCalledWith("Eve: sandbox command finished (exit 0): ls -la /workspace");
+ expect(log).toHaveBeenCalledWith("eve: starting sandbox command: ls -la /workspace");
+ expect(log).toHaveBeenCalledWith("eve: sandbox command finished (exit 0): ls -la /workspace");
});
});
diff --git a/packages/eve/src/execution/sandbox/bash-tool.ts b/packages/eve/src/execution/sandbox/bash-tool.ts
index b155c2cdc..5212a5e00 100644
--- a/packages/eve/src/execution/sandbox/bash-tool.ts
+++ b/packages/eve/src/execution/sandbox/bash-tool.ts
@@ -82,7 +82,7 @@ async function runWithDevelopmentSandboxProgress(
sandbox: SandboxSession,
command: string,
): Promise<Awaited<ReturnType<SandboxSession["run"]>>> {
- logDevelopmentSandboxCommand(`Eve: starting sandbox command: ${formatCommand(command)}`);
+ logDevelopmentSandboxCommand(`eve: starting sandbox command: ${formatCommand(command)}`);
if (!isEveDevEnvironment()) {
return await sandbox.run({ command });
}
@@ -91,7 +91,7 @@ async function runWithDevelopmentSandboxProgress(
const timer = setInterval(() => {
const elapsedSeconds = Math.round((Date.now() - startedAt) / 1000);
logDevelopmentSandboxCommand(
- `Eve: waiting for sandbox command (${elapsedSeconds}s elapsed): ${formatCommand(command)}`,
+ `eve: waiting for sandbox command (${elapsedSeconds}s elapsed): ${formatCommand(command)}`,
);
}, 5_000);
timer.unref?.();
@@ -99,11 +99,11 @@ async function runWithDevelopmentSandboxProgress(
try {
const result = await sandbox.run({ command });
logDevelopmentSandboxCommand(
- `Eve: sandbox command finished (exit ${result.exitCode}): ${formatCommand(command)}`,
+ `eve: sandbox command finished (exit ${result.exitCode}): ${formatCommand(command)}`,
);
return result;
} catch (error) {
- logDevelopmentSandboxCommand(`Eve: sandbox command failed: ${formatCommand(command)}`);
+ logDevelopmentSandboxCommand(`eve: sandbox command failed: ${formatCommand(command)}`);
throw error;
} finally {
clearInterval(timer);
diff --git a/packages/eve/src/execution/sandbox/bindings/docker-options.test.ts b/packages/eve/src/execution/sandbox/bindings/docker-options.test.ts
index c0d8dee00..b9dd979ac 100644
--- a/packages/eve/src/execution/sandbox/bindings/docker-options.test.ts
+++ b/packages/eve/src/execution/sandbox/bindings/docker-options.test.ts
@@ -7,7 +7,7 @@ import {
} from "#execution/sandbox/bindings/docker-options.js";
describe("resolveDockerSandboxOptions", () => {
- it("defaults to Eve's published sandbox runtime image with permissive networking", () => {
+ it("defaults to eve's published sandbox runtime image with permissive networking", () => {
expect(resolveDockerSandboxOptions()).toEqual({
env: {},
image: DEFAULT_DOCKER_SANDBOX_IMAGE,
diff --git a/packages/eve/src/execution/sandbox/bindings/docker-options.ts b/packages/eve/src/execution/sandbox/bindings/docker-options.ts
index b0b73ab2d..59f617381 100644
--- a/packages/eve/src/execution/sandbox/bindings/docker-options.ts
+++ b/packages/eve/src/execution/sandbox/bindings/docker-options.ts
@@ -7,7 +7,7 @@ import type {
} from "#public/sandbox/docker-sandbox.js";
/**
- * Default base image for the Docker backend: Eve's published sandbox
+ * Default base image for the Docker backend: eve's published sandbox
* runtime image.
*/
export const DEFAULT_DOCKER_SANDBOX_IMAGE = "ghcr.io/vercel/eve:latest";
diff --git a/packages/eve/src/execution/sandbox/bindings/just-bash-runtime.ts b/packages/eve/src/execution/sandbox/bindings/just-bash-runtime.ts
index fe0ce96cd..c98477aab 100644
--- a/packages/eve/src/execution/sandbox/bindings/just-bash-runtime.ts
+++ b/packages/eve/src/execution/sandbox/bindings/just-bash-runtime.ts
@@ -45,8 +45,8 @@ let justBashModulePromise: Promise<JustBashModule> | undefined;
/**
* Loads `just-bash` from the application's own dependency tree. The
- * package is intentionally not bundled with Eve — the backend is
- * opt-in — so when it is missing Eve installs it into the project
+ * package is intentionally not bundled with eve — the backend is
+ * opt-in — so when it is missing eve installs it into the project
* during `eve dev` (unless `autoInstall: false`) and otherwise fails
* with an actionable install error.
*/
@@ -60,7 +60,7 @@ async function loadJustBashModule(input: {
importModule: async () => await import("just-bash"),
missingMessage:
"The just-bash sandbox backend requires the `just-bash` package, which is not bundled " +
- "with Eve. Install it in your application (for example `pnpm add -D just-bash`), or use " +
+ "with eve. Install it in your application (for example `pnpm add -D just-bash`), or use " +
"docker() / defaultSandbox() instead.",
packageName: JUST_BASH_PACKAGE_NAME,
}).catch((error: unknown) => {
diff --git a/packages/eve/src/execution/sandbox/bindings/microsandbox-runtime.ts b/packages/eve/src/execution/sandbox/bindings/microsandbox-runtime.ts
index b3dc247b5..dfd32e28c 100644
--- a/packages/eve/src/execution/sandbox/bindings/microsandbox-runtime.ts
+++ b/packages/eve/src/execution/sandbox/bindings/microsandbox-runtime.ts
@@ -424,7 +424,7 @@ async function restoreMicrosandboxSessionSnapshot(input: {
const MICROSANDBOX_MISSING_PACKAGE_MESSAGE =
"The microsandbox sandbox backend requires the `microsandbox` package, which is not bundled " +
- "with Eve. Install it in your application (for example `pnpm add -D microsandbox`), or use " +
+ "with eve. Install it in your application (for example `pnpm add -D microsandbox`), or use " +
"docker() / vercel() instead.";
/**
diff --git a/packages/eve/src/execution/sandbox/bindings/microsandbox.test.ts b/packages/eve/src/execution/sandbox/bindings/microsandbox.test.ts
index 1953f2abb..d55548daa 100644
--- a/packages/eve/src/execution/sandbox/bindings/microsandbox.test.ts
+++ b/packages/eve/src/execution/sandbox/bindings/microsandbox.test.ts
@@ -19,7 +19,7 @@ describe.skipIf(onWindows)("createMicrosandboxSandboxBackend", () => {
expect(createMicrosandboxSandboxBackend().name).toBe("microsandbox");
});
- it("defaults to Eve's published sandbox runtime image", () => {
+ it("defaults to eve's published sandbox runtime image", () => {
expect(MICROSANDBOX_DEFAULT_IMAGE).toBe("ghcr.io/vercel/eve:latest");
expect(resolveMicrosandboxOptions(undefined).image).toBe(MICROSANDBOX_DEFAULT_IMAGE);
});
diff --git a/packages/eve/src/execution/sandbox/bindings/vercel.test.ts b/packages/eve/src/execution/sandbox/bindings/vercel.test.ts
index bc7632fb6..41fb6eb14 100644
--- a/packages/eve/src/execution/sandbox/bindings/vercel.test.ts
+++ b/packages/eve/src/execution/sandbox/bindings/vercel.test.ts
@@ -81,7 +81,7 @@ afterEach(() => {
});
describe("createVercelSandbox", () => {
- it("creates fresh Vercel sandboxes through the SDK with the Eve image", async () => {
+ it("creates fresh Vercel sandboxes through the SDK with the eve image", async () => {
const templateSandbox = createMockSandbox({ name: "template-key" });
const fetch = vi.fn();
const sandboxModule = {
@@ -659,7 +659,7 @@ describe("createVercelSandbox", () => {
/*
* The real Vercel SDK pre-populates `currentSnapshotId` on a
* freshly-created sandbox when the create call passed a snapshot
- * source. The template sandbox mock mirrors that — if Eve's
+ * source. The template sandbox mock mirrors that — if eve's
* "template already has a snapshot, reuse it" guard fires on a
* newly-created template, it returns the author's snapshotId
* instead of running bootstrap/seed/`sandbox.snapshot()`, so the
@@ -717,7 +717,7 @@ describe("createVercelSandbox", () => {
* `sandbox.snapshot()`) leaves a named template sandbox in the
* project whose `currentSnapshotId` is still the author's source
* snapshot. Without explicit handling, `getNamedSandbox` would
- * find it and Eve would treat the author's snapshot as the
+ * find it and eve would treat the author's snapshot as the
* framework's prewarmed snapshot, skipping setup/bootstrap/seeds
* forever. This test pins that we ignore that exact value and
* proceed with prewarm on the existing sandbox.
@@ -1016,7 +1016,7 @@ describe("createVercelSandbox", () => {
}
});
- it("adds Eve sandbox tags to Vercel template and session creation", async () => {
+ it("adds eve sandbox tags to Vercel template and session creation", async () => {
const templateSandbox = createMockSandbox({ name: "template" });
const sessionSandbox = createMockSandbox({ name: "session" });
const create = vi
diff --git a/packages/eve/src/execution/sandbox/bindings/vercel.ts b/packages/eve/src/execution/sandbox/bindings/vercel.ts
index bcf51f291..0989a4b0d 100644
--- a/packages/eve/src/execution/sandbox/bindings/vercel.ts
+++ b/packages/eve/src/execution/sandbox/bindings/vercel.ts
@@ -640,7 +640,7 @@ function resolveVercelSandboxTags(
if (count > VERCEL_SANDBOX_TAG_LIMIT) {
throw new Error(
`Vercel Sandbox supports at most ${VERCEL_SANDBOX_TAG_LIMIT} tags. ` +
- 'Eve reserves "agent", "channel", and "sessionId"; remove or consolidate custom tags passed to vercel().',
+ 'eve reserves "agent", "channel", and "sessionId"; remove or consolidate custom tags passed to vercel().',
);
}
diff --git a/packages/eve/src/execution/sandbox/development-prewarm.test.ts b/packages/eve/src/execution/sandbox/development-prewarm.test.ts
index 576501c37..33ee1b4ec 100644
--- a/packages/eve/src/execution/sandbox/development-prewarm.test.ts
+++ b/packages/eve/src/execution/sandbox/development-prewarm.test.ts
@@ -111,7 +111,7 @@ describe("development sandbox prewarm coordination", () => {
appRoot,
compiledArtifactsSource,
});
- prewarmLog?.('Eve: sandbox template "root" (microsandbox): preparing base runtime inside VM');
+ prewarmLog?.('eve: sandbox template "root" (microsandbox): preparing base runtime inside VM');
const logs: string[] = [];
const wait = waitForDevelopmentSandboxPrewarm({
@@ -120,15 +120,15 @@ describe("development sandbox prewarm coordination", () => {
log: (message) => logs.push(message),
});
await Promise.resolve();
- prewarmLog?.('Eve: sandbox template "root" (microsandbox): apt-get update');
+ prewarmLog?.('eve: sandbox template "root" (microsandbox): apt-get update');
prewarm.resolve();
await wait;
expect(logs).toEqual(
expect.arrayContaining([
- 'Eve: sandbox template "root" (microsandbox): preparing base runtime inside VM',
- 'Eve: sandbox template "root" (microsandbox): apt-get update',
+ 'eve: sandbox template "root" (microsandbox): preparing base runtime inside VM',
+ 'eve: sandbox template "root" (microsandbox): apt-get update',
]),
);
});
@@ -147,23 +147,23 @@ describe("development sandbox prewarm coordination", () => {
appRoot,
compiledArtifactsSource,
});
- prewarmLog?.('Eve: built sandbox template "root" on backend "docker".');
+ prewarmLog?.('eve: built sandbox template "root" on backend "docker".');
const logs: string[] = [];
const unsubscribe = subscribeDevelopmentSandboxPrewarmLogs({
appRoot,
log: (message) => logs.push(message),
});
- prewarmLog?.('Eve: sandbox template "root" (docker): apt-get update');
+ prewarmLog?.('eve: sandbox template "root" (docker): apt-get update');
unsubscribe();
- prewarmLog?.('Eve: sandbox template "root" (docker): apt-get install curl');
+ prewarmLog?.('eve: sandbox template "root" (docker): apt-get install curl');
prewarm.resolve();
await prewarm.promise;
expect(logs).toEqual([
- 'Eve: built sandbox template "root" on backend "docker".',
- 'Eve: sandbox template "root" (docker): apt-get update',
+ 'eve: built sandbox template "root" on backend "docker".',
+ 'eve: sandbox template "root" (docker): apt-get update',
]);
});
@@ -171,7 +171,7 @@ describe("development sandbox prewarm coordination", () => {
const appRoot = "/tmp/eve-completed-app";
const compiledArtifactsSource = createDiskRuntimeCompiledArtifactsSource(appRoot);
mocks.prewarmAppSandboxes.mockImplementationOnce(async (input) => {
- input.log?.('Eve: built sandbox template "root" on backend "docker".');
+ input.log?.('eve: built sandbox template "root" on backend "docker".');
});
startDevelopmentSandboxPrewarmInBackground({
@@ -192,7 +192,7 @@ describe("development sandbox prewarm coordination", () => {
log: (message) => secondLogs.push(message),
});
- expect(firstLogs).toEqual(['Eve: built sandbox template "root" on backend "docker".']);
+ expect(firstLogs).toEqual(['eve: built sandbox template "root" on backend "docker".']);
expect(secondLogs).toEqual([]);
});
diff --git a/packages/eve/src/execution/sandbox/development-prewarm.ts b/packages/eve/src/execution/sandbox/development-prewarm.ts
index 56ed42278..5172fc161 100644
--- a/packages/eve/src/execution/sandbox/development-prewarm.ts
+++ b/packages/eve/src/execution/sandbox/development-prewarm.ts
@@ -57,7 +57,7 @@ export function startDevelopmentSandboxPrewarmInBackground(input: {
.catch((error) => {
recordPrewarmLog(
record,
- `Eve: failed to initialize sandbox templates in the background: ${toErrorMessage(error)}`,
+ `eve: failed to initialize sandbox templates in the background: ${toErrorMessage(error)}`,
input.log,
);
})
diff --git a/packages/eve/src/execution/sandbox/ensure.test.ts b/packages/eve/src/execution/sandbox/ensure.test.ts
index fbc560d5b..423ec7c0c 100644
--- a/packages/eve/src/execution/sandbox/ensure.test.ts
+++ b/packages/eve/src/execution/sandbox/ensure.test.ts
@@ -236,7 +236,7 @@ describe("ensureSandboxAccess", () => {
);
});
- it("runs onSession inside the active Eve context", async () => {
+ it("runs onSession inside the active eve context", async () => {
const ctx = new ContextContainer();
const session = createSession();
ctx.set(SessionKey, session);
diff --git a/packages/eve/src/execution/sandbox/ensure.ts b/packages/eve/src/execution/sandbox/ensure.ts
index 118428e06..b44fd29c1 100644
--- a/packages/eve/src/execution/sandbox/ensure.ts
+++ b/packages/eve/src/execution/sandbox/ensure.ts
@@ -90,7 +90,7 @@ export async function ensureSandboxAccess(input: EnsureSandboxAccessInput): Prom
compiledArtifactsSource: input.compiledArtifactsSource,
log: (message) =>
logDevelopmentSandbox(
- `Eve: sandbox template "${formatNodeLabel(input.nodeId)}" (${backend.name}): ${message}`,
+ `eve: sandbox template "${formatNodeLabel(input.nodeId)}" (${backend.name}): ${message}`,
),
});
await waitForSandboxTemplatePrewarmLock({
@@ -98,7 +98,7 @@ export async function ensureSandboxAccess(input: EnsureSandboxAccessInput): Prom
backendName: backend.name,
log: (message) =>
logDevelopmentSandbox(
- `Eve: sandbox template "${formatNodeLabel(input.nodeId)}" (${backend.name}): ${message}`,
+ `eve: sandbox template "${formatNodeLabel(input.nodeId)}" (${backend.name}): ${message}`,
),
templateKey: keys.templateKey,
});
@@ -117,8 +117,8 @@ export async function ensureSandboxAccess(input: EnsureSandboxAccessInput): Prom
};
const handle = await withDevelopmentSandboxProgress(
- `Eve: opening sandbox session "${formatNodeLabel(input.nodeId)}" on backend "${backend.name}"...`,
- `Eve: opening sandbox session "${formatNodeLabel(input.nodeId)}" on backend "${backend.name}"`,
+ `eve: opening sandbox session "${formatNodeLabel(input.nodeId)}" on backend "${backend.name}"...`,
+ `eve: opening sandbox session "${formatNodeLabel(input.nodeId)}" on backend "${backend.name}"`,
async () =>
await createBackendHandleWithPrewarmRetry({
appRoot,
@@ -199,10 +199,10 @@ async function createBackendHandleWithPrewarmRetry(input: {
await waitForSandboxTemplatePrewarmLock({
appRoot: input.appRoot,
backendName: input.backend.name,
- log: (message) => logDevelopmentSandbox(`Eve: ${message}`),
+ log: (message) => logDevelopmentSandbox(`eve: ${message}`),
templateKey: input.createInput.templateKey,
});
- logDevelopmentSandbox("Eve: sandbox template is ready; retrying sandbox creation...");
+ logDevelopmentSandbox("eve: sandbox template is ready; retrying sandbox creation...");
return await input.backend.create(input.createInput);
}
}
diff --git a/packages/eve/src/execution/sandbox/prewarm.scenario.test.ts b/packages/eve/src/execution/sandbox/prewarm.scenario.test.ts
index dedf4c087..f88b1fdd0 100644
--- a/packages/eve/src/execution/sandbox/prewarm.scenario.test.ts
+++ b/packages/eve/src/execution/sandbox/prewarm.scenario.test.ts
@@ -390,8 +390,8 @@ describe("prewarmAppSandboxes", () => {
// authored default.
expect(events.templateKeys).toHaveLength(1);
expect(log.mock.calls.map(([message]) => message)).toEqual([
- "Eve: initializing 1 sandbox template...",
- "Eve: initialized 1 sandbox template (0 reused, 1 built).",
+ "eve: initializing 1 sandbox template...",
+ "eve: initialized 1 sandbox template (0 reused, 1 built).",
]);
expect(log).not.toHaveBeenCalledWith(expect.stringContaining("framework"));
expect([...events.bootstrapCommands]).toEqual(["echo default-bootstrap"]);
diff --git a/packages/eve/src/execution/sandbox/prewarm.ts b/packages/eve/src/execution/sandbox/prewarm.ts
index 864e464bd..bc0303dce 100644
--- a/packages/eve/src/execution/sandbox/prewarm.ts
+++ b/packages/eve/src/execution/sandbox/prewarm.ts
@@ -84,7 +84,7 @@ export async function prewarmSandboxes(input: PrewarmSandboxesInput): Promise<vo
return await backend.prewarm(prewarmInput);
});
- input.log?.(`Eve: initializing ${formatSandboxTemplateCount(targets.length)}...`);
+ input.log?.(`eve: initializing ${formatSandboxTemplateCount(targets.length)}...`);
const results = await Promise.all(
targets.map(async ({ backend, label, input: prewarmInput }) => {
@@ -92,7 +92,7 @@ export async function prewarmSandboxes(input: PrewarmSandboxesInput): Promise<vo
if (!shouldLogSandboxPrewarmProgress(message)) {
return;
}
- input.log?.(`Eve: sandbox template "${label}" (${backend.name}): ${message}`);
+ input.log?.(`eve: sandbox template "${label}" (${backend.name}): ${message}`);
};
let result: SandboxBackendPrewarmResult;
try {
@@ -114,7 +114,7 @@ export async function prewarmSandboxes(input: PrewarmSandboxesInput): Promise<vo
);
} catch (error) {
input.log?.(
- `Eve: failed to initialize sandbox template "${label}" on backend "${backend.name}": ${toErrorMessage(error)}`,
+ `eve: failed to initialize sandbox template "${label}" on backend "${backend.name}": ${toErrorMessage(error)}`,
);
throw error;
}
@@ -123,7 +123,7 @@ export async function prewarmSandboxes(input: PrewarmSandboxesInput): Promise<vo
);
const reusedCount = results.filter((result) => result.reused).length;
input.log?.(
- `Eve: initialized ${formatSandboxTemplateCount(targets.length)} (${reusedCount} reused, ${
+ `eve: initialized ${formatSandboxTemplateCount(targets.length)} (${reusedCount} reused, ${
targets.length - reusedCount
} built).`,
);
diff --git a/packages/eve/src/execution/session-callback-step.ts b/packages/eve/src/execution/session-callback-step.ts
index 34bb362e8..6b8496171 100644
--- a/packages/eve/src/execution/session-callback-step.ts
+++ b/packages/eve/src/execution/session-callback-step.ts
@@ -15,7 +15,7 @@ const log = createLogger("execution.session-callback");
* instead of being reported as a successful terminal step. Throwing is
* intentional: this function runs as a durable Workflow step, so rejection
* hands retry/failure policy back to the Workflow orchestrator rather than
- * letting Eve falsely mark the callback delivery as complete.
+ * letting eve falsely mark the callback delivery as complete.
*/
export async function fireSessionCallbackStep(input: {
readonly error?: unknown;
diff --git a/packages/eve/src/execution/tool-auth.ts b/packages/eve/src/execution/tool-auth.ts
index 19422a4c9..32fc2e6bc 100644
--- a/packages/eve/src/execution/tool-auth.ts
+++ b/packages/eve/src/execution/tool-auth.ts
@@ -85,7 +85,7 @@ export function createAuthorizedToolExecute(input: {
// The resolved bearer was rejected (a downstream 401 mapped to
// requireAuth, or getToken re-reporting Required). Drop it from
- // every cache layer — Eve's per-step cache and the strategy's own
+ // every cache layer — eve's per-step cache and the strategy's own
// (e.g. the @vercel/connect token cache) — so the
// re-authorization re-resolves a genuinely fresh token instead of
// re-reading the rejected one. Mirrors the MCP client.
diff --git a/packages/eve/src/execution/workflow-runtime.test.ts b/packages/eve/src/execution/workflow-runtime.test.ts
index d47072b42..0b44cb644 100644
--- a/packages/eve/src/execution/workflow-runtime.test.ts
+++ b/packages/eve/src/execution/workflow-runtime.test.ts
@@ -38,7 +38,7 @@ afterEach(() => {
});
describe("workflowEntryReference", () => {
- it("uses the installed Eve package identity for the runtime workflow id", () => {
+ it("uses the installed eve package identity for the runtime workflow id", () => {
const packageInfo = resolveInstalledPackageInfo();
// The runtime references intentionally omit the `@<pkg.version>`
diff --git a/packages/eve/src/harness/attachment-staging.ts b/packages/eve/src/harness/attachment-staging.ts
index b68346f43..44858d7d1 100644
--- a/packages/eve/src/harness/attachment-staging.ts
+++ b/packages/eve/src/harness/attachment-staging.ts
@@ -141,7 +141,7 @@ export async function hydrateSandboxAttachments(
const sandboxAccess = loadContext().get(SandboxKey);
if (sandboxAccess === undefined) {
throw new Error(
- "Cannot hydrate sandbox-ref FilePart: no SandboxKey is bound on the active Eve context. " +
+ "Cannot hydrate sandbox-ref FilePart: no SandboxKey is bound on the active eve context. " +
"Hydration must run inside a step scope with the framework sandbox provider installed.",
);
}
diff --git a/packages/eve/src/harness/code-mode-lifecycle.test.ts b/packages/eve/src/harness/code-mode-lifecycle.test.ts
index 5f4354126..d999aa5a1 100644
--- a/packages/eve/src/harness/code-mode-lifecycle.test.ts
+++ b/packages/eve/src/harness/code-mode-lifecycle.test.ts
@@ -30,7 +30,7 @@ function createTools(): HarnessToolMap {
}
describe("createCodeModeLifecycle", () => {
- it("emits nested tool calls and results as Eve action events", async () => {
+ it("emits nested tool calls and results as eve action events", async () => {
const events: HandleMessageStreamEvent[] = [];
const lifecycle = createCodeModeLifecycle({
emit: async (event) => {
@@ -374,7 +374,7 @@ describe("createCodeModeLifecycle", () => {
});
// The bridge handler runs every callback under the re-entered invocation
- // context — the guarantee the package provides on Eve's behalf.
+ // context — the guarantee the package provides on eve's behalf.
const result = await contextStorage.run(invocationSession, async () => {
// 1. execute_sql runs under the invocation context.
const executeSql = hostTools.execute_sql as {
diff --git a/packages/eve/src/harness/code-mode-lifecycle.ts b/packages/eve/src/harness/code-mode-lifecycle.ts
index fcc8fe4f4..6696dd796 100644
--- a/packages/eve/src/harness/code-mode-lifecycle.ts
+++ b/packages/eve/src/harness/code-mode-lifecycle.ts
@@ -19,7 +19,7 @@ type EmitCodeModeLifecycleEvent = (event: HandleMessageStreamEvent) => Promise<v
/**
* Builds code-mode lifecycle hooks that project nested host tool calls onto
- * Eve's existing action event stream.
+ * eve's existing action event stream.
*/
export function createCodeModeLifecycle(input: {
readonly emit: EmitCodeModeLifecycleEvent;
diff --git a/packages/eve/src/harness/code-mode.test.ts b/packages/eve/src/harness/code-mode.test.ts
index 8dbeca584..21127c672 100644
--- a/packages/eve/src/harness/code-mode.test.ts
+++ b/packages/eve/src/harness/code-mode.test.ts
@@ -188,7 +188,7 @@ describe("applySandboxToolSet", () => {
// `message` callback Node binds to the invocation that first created the
// worker. experimental-ai-sdk-code-mode >= 1.0.11 re-enters the originating
// invocation's AsyncLocalStorage context before dispatching host callbacks,
- // so Eve no longer re-pins context in the wrapper. The wrapper must stay
+ // so eve no longer re-pins context in the wrapper. The wrapper must stay
// transparent: it observes whatever context the caller provides, never a
// context captured at build time. The cross-invocation worker guarantee is
// covered by the package's own regression test.
diff --git a/packages/eve/src/harness/emission.ts b/packages/eve/src/harness/emission.ts
index 06bb5ea77..fa2b8d201 100644
--- a/packages/eve/src/harness/emission.ts
+++ b/packages/eve/src/harness/emission.ts
@@ -285,7 +285,7 @@ export async function emitTurnEpilogue(
// ---------------------------------------------------------------------------
/**
- * Maps an AI SDK finish reason string to the Eve-owned
+ * Maps an AI SDK finish reason string to the eve-owned
* {@link AssistantStepFinishReason} union. Unknown values become `"other"`.
*/
export function normalizeAssistantStepFinishReason(
diff --git a/packages/eve/src/harness/runtime-actions.ts b/packages/eve/src/harness/runtime-actions.ts
index b448e503a..833bd9032 100644
--- a/packages/eve/src/harness/runtime-actions.ts
+++ b/packages/eve/src/harness/runtime-actions.ts
@@ -395,7 +395,7 @@ export async function resolvePendingRuntimeActions(input: {
}
/**
- * Projects one AI SDK tool call into the Eve runtime-action contract.
+ * Projects one AI SDK tool call into the eve runtime-action contract.
*/
export function createRuntimeActionRequestFromToolCall(input: {
readonly toolCall: TypedToolCall<ToolSet>;
diff --git a/packages/eve/src/harness/tool-loop.test.ts b/packages/eve/src/harness/tool-loop.test.ts
index 5b4459cb9..666137995 100644
--- a/packages/eve/src/harness/tool-loop.test.ts
+++ b/packages/eve/src/harness/tool-loop.test.ts
@@ -1593,7 +1593,7 @@ describe("createToolLoopHarness", () => {
it("skips AI-SDK-marked invalid tool calls so a malformed JSON payload does not crash the harness", async () => {
// Simulates the AI SDK fallback path: when the model emits unparsable
// JSON for a tool call, `parseToolCall` returns a DynamicToolCall with
- // `invalid: true, dynamic: true, input: <raw string>`. Eve must not
+ // `invalid: true, dynamic: true, input: <raw string>`. eve must not
// project this into a RuntimeActionRequest (parseJsonObject would
// throw on a string) and must not surface the call via
// actions.requested — the AI SDK feeds the error back to the model
@@ -3800,7 +3800,7 @@ describe("createToolLoopHarness", () => {
{
content: [
{
- input: { query: "Eve release note current" },
+ input: { query: "eve release note current" },
providerExecuted: true,
toolCallId,
toolName: "web_search",
@@ -3857,7 +3857,7 @@ describe("createToolLoopHarness", () => {
setupMockAgent({
content: [
{
- input: { query: "Eve release note current" },
+ input: { query: "eve release note current" },
providerExecuted: true,
toolCallId,
toolName: "web_search",
@@ -3875,7 +3875,7 @@ describe("createToolLoopHarness", () => {
finishReason: "stop",
fullStreamParts: [
{
- input: { query: "Eve release note current" },
+ input: { query: "eve release note current" },
providerExecuted: true,
toolCallId,
toolName: "web_search",
@@ -3896,7 +3896,7 @@ describe("createToolLoopHarness", () => {
{
content: [
{
- input: { query: "Eve release note current" },
+ input: { query: "eve release note current" },
providerExecuted: true,
toolCallId,
toolName: "web_search",
@@ -3917,7 +3917,7 @@ describe("createToolLoopHarness", () => {
text: "Search result captured.",
toolCalls: [
{
- input: { query: "Eve release note current" },
+ input: { query: "eve release note current" },
providerExecuted: true,
toolCallId,
toolName: "web_search",
@@ -3926,7 +3926,7 @@ describe("createToolLoopHarness", () => {
],
toolResults: [
{
- input: { query: "Eve release note current" },
+ input: { query: "eve release note current" },
output: webSearchOutput,
providerExecuted: true,
toolCallId,
@@ -3957,7 +3957,7 @@ describe("createToolLoopHarness", () => {
actions: [
{
callId: toolCallId,
- input: { query: "Eve release note current" },
+ input: { query: "eve release note current" },
kind: "tool-call",
toolName: "web_search",
},
@@ -4001,7 +4001,7 @@ describe("createToolLoopHarness", () => {
setupMockAgent({
content: [
{
- input: { query: "Eve release note current" },
+ input: { query: "eve release note current" },
providerExecuted: true,
toolCallId,
toolName: "web_search",
@@ -4011,7 +4011,7 @@ describe("createToolLoopHarness", () => {
finishReason: "stop",
fullStreamParts: [
{
- input: { query: "Eve release note current" },
+ input: { query: "eve release note current" },
providerExecuted: true,
toolCallId,
toolName: "web_search",
@@ -4019,7 +4019,7 @@ describe("createToolLoopHarness", () => {
},
{
error: new Error("Search failed"),
- input: { query: "Eve release note current" },
+ input: { query: "eve release note current" },
providerExecuted: true,
toolCallId,
toolName: "web_search",
@@ -4032,7 +4032,7 @@ describe("createToolLoopHarness", () => {
{
content: [
{
- input: { query: "Eve release note current" },
+ input: { query: "eve release note current" },
providerExecuted: true,
toolCallId,
toolName: "web_search",
@@ -4046,7 +4046,7 @@ describe("createToolLoopHarness", () => {
text: "",
toolCalls: [
{
- input: { query: "Eve release note current" },
+ input: { query: "eve release note current" },
providerExecuted: true,
toolCallId,
toolName: "web_search",
diff --git a/packages/eve/src/harness/tool-loop.ts b/packages/eve/src/harness/tool-loop.ts
index 1d45ae06a..ea56402ea 100644
--- a/packages/eve/src/harness/tool-loop.ts
+++ b/packages/eve/src/harness/tool-loop.ts
@@ -1909,7 +1909,7 @@ async function continuePendingCodeModeInterrupt(input: {
* Parks the turn on a code-mode host interrupt. Stores the interrupt on the
* single pending slot, then runs the kind-specific side effect: connection-auth
* surfaces the authorization challenges and parks on pending authorization;
- * approval surfaces the nested tool's approval request through Eve's existing
+ * approval surfaces the nested tool's approval request through eve's existing
* input-request UX.
*/
function replaceCodeModeToolResult(
@@ -1985,7 +1985,7 @@ async function parkOnCodeModeInterrupt(input: {
return { next: null, session: parkedSession };
}
- // Approval: surface the nested tool's approval request as an Eve input
+ // Approval: surface the nested tool's approval request as an eve input
// request so the existing approval UX drives the resume.
if (isCodeModeApprovalInterrupt(interrupt)) {
const approvalMessages = toCodeModeApprovalMessages(interrupt);
diff --git a/packages/eve/src/internal/application/cache-metadata.ts b/packages/eve/src/internal/application/cache-metadata.ts
index 3e93dbb0d..595201165 100644
--- a/packages/eve/src/internal/application/cache-metadata.ts
+++ b/packages/eve/src/internal/application/cache-metadata.ts
@@ -6,7 +6,7 @@ import { resolveInstalledPackageInfo } from "#internal/application/package.js";
const EVE_CACHE_METADATA_FILE = "eve-cache.json";
/**
- * Clears one Eve-owned cache directory when its recorded Eve version is missing
+ * Clears one eve-owned cache directory when its recorded eve version is missing
* or differs from the currently installed package version.
*/
export async function prepareEveVersionedCacheDirectory(directoryPath: string): Promise<void> {
@@ -24,7 +24,7 @@ export async function prepareEveVersionedCacheDirectory(directoryPath: string):
}
/**
- * Writes the current installed Eve version into one Eve-owned cache directory.
+ * Writes the current installed eve version into one eve-owned cache directory.
*/
export async function writeEveVersionedCacheMetadata(directoryPath: string): Promise<void> {
await mkdir(directoryPath, {
diff --git a/packages/eve/src/internal/application/compiled-artifacts.ts b/packages/eve/src/internal/application/compiled-artifacts.ts
index 4d8f5c0bb..5a8cba6dd 100644
--- a/packages/eve/src/internal/application/compiled-artifacts.ts
+++ b/packages/eve/src/internal/application/compiled-artifacts.ts
@@ -117,7 +117,7 @@ async function createCompiledArtifactsBootstrapSource(input: {
).trim();
return [
- "// Generated by Eve. Do not edit by hand.",
+ "// Generated by eve. Do not edit by hand.",
`import { installBundledCompiledArtifacts } from ${stringifyEsmImportSpecifier(input.installModulePath)};`,
"",
moduleMapSource,
@@ -156,7 +156,7 @@ function createInstrumentationPluginSource(input: {
registerConfigPath: string;
}): string {
return [
- "// Generated by Eve. Do not edit by hand.",
+ "// Generated by eve. Do not edit by hand.",
`import * as instrumentationModule from ${stringifyEsmImportSpecifier(input.instrumentationPath)};`,
`import { registerInstrumentationConfig } from ${stringifyEsmImportSpecifier(input.registerConfigPath)};`,
"",
diff --git a/packages/eve/src/internal/application/package.ts b/packages/eve/src/internal/application/package.ts
index 566b6ad06..b7fb34c01 100644
--- a/packages/eve/src/internal/application/package.ts
+++ b/packages/eve/src/internal/application/package.ts
@@ -109,7 +109,7 @@ function findNearestPackageRoot(startDirectory: string): string {
}
/**
- * Resolves the installed Eve package root.
+ * Resolves the installed eve package root.
*/
export function resolvePackageRoot(): string {
// Canonicalize the current module path so workspace symlinks such as
@@ -130,7 +130,7 @@ function rewriteSourceFilePathForBuild(relativeSourcePath: string): string {
}
/**
- * Resolves one package-owned source file from the currently executing Eve installation.
+ * Resolves one package-owned source file from the currently executing eve installation.
*
* Source checkouts use `src/...` paths so local tests exercise live source files.
* Installed or built package executions use `dist/src/...` so published builds do
@@ -147,7 +147,7 @@ export function resolvePackageSourceFilePath(relativeSourcePath: string): string
}
/**
- * Resolves one package-owned source directory from the currently executing Eve installation.
+ * Resolves one package-owned source directory from the currently executing eve installation.
*/
export function resolvePackageSourceDirectoryPath(relativeSourcePath: string): string {
const packageBuildRoot = resolvePackageBuildRoot();
@@ -210,7 +210,7 @@ function tryReadInstalledPackageInfo(
}
/**
- * Resolves the installed Eve package identity from package.json.
+ * Resolves the installed eve package identity from package.json.
*/
export function resolveInstalledPackageInfo(): InstalledPackageInfo {
if (cachedPackageInfo) {
@@ -252,11 +252,11 @@ export function resolveInstalledPackageInfo(): InstalledPackageInfo {
}
/**
- * Resolves a Workflow runtime module from Eve's narrowed Workflow dependencies.
+ * Resolves a Workflow runtime module from eve's narrowed Workflow dependencies.
*
- * Older Workflow builder output still uses `workflow/*` specifiers. Eve maps
+ * Older Workflow builder output still uses `workflow/*` specifiers. eve maps
* those historical specifiers to the smaller `@workflow/*` packages it actually
- * needs, plus an Eve-owned builtins module for response body step helpers.
+ * needs, plus an eve-owned builtins module for response body step helpers.
*/
export function resolveWorkflowModulePath(specifier: string): string {
if (specifier === "workflow") {
diff --git a/packages/eve/src/internal/application/paths.test.ts b/packages/eve/src/internal/application/paths.test.ts
index 179d9439d..be0370fac 100644
--- a/packages/eve/src/internal/application/paths.test.ts
+++ b/packages/eve/src/internal/application/paths.test.ts
@@ -7,7 +7,7 @@ import { resolvePackageRoot } from "#internal/application/package.js";
import { resolveWorkflowBuildDirectory } from "#internal/application/paths.js";
describe("resolveWorkflowBuildDirectory", () => {
- it("keys the workflow build cache by app root only (stable across Eve versions)", () => {
+ it("keys the workflow build cache by app root only (stable across eve versions)", () => {
const appRoot = "/tmp/eve-app";
const expectedCacheKey = createHash("sha256").update(appRoot).digest("hex").slice(0, 12);
diff --git a/packages/eve/src/internal/application/paths.ts b/packages/eve/src/internal/application/paths.ts
index 2aee17a97..fc55d89f7 100644
--- a/packages/eve/src/internal/application/paths.ts
+++ b/packages/eve/src/internal/application/paths.ts
@@ -81,9 +81,9 @@ export function resolveWorkflowBuildDirectory(appRoot: string): string {
/*
* Defensive cleanup: removes legacy sibling cache directories whose recorded
- * eveVersion does not match the currently installed Eve. Earlier versions
+ * eveVersion does not match the currently installed eve. Earlier versions
* keyed the cache directory by `appRoot + workflowId` (which embedded the
- * Eve version), so an upgrade left one or more orphaned directories on
+ * eve version), so an upgrade left one or more orphaned directories on
* disk. Without this sweep those directories can still be picked up by
* downstream build steps and bake stale step IDs (e.g.
* `step//[email protected]//...`) into a freshly built dev bundle.
diff --git a/packages/eve/src/internal/attachments/url-refs.ts b/packages/eve/src/internal/attachments/url-refs.ts
index 69d82ea32..3e39c4c1e 100644
--- a/packages/eve/src/internal/attachments/url-refs.ts
+++ b/packages/eve/src/internal/attachments/url-refs.ts
@@ -28,7 +28,7 @@ export function deserializeUrlFilePart(data: string): URL {
/**
* Framework-internal `FilePart.data` ref schemes (`eve-url:`, `eve-sandbox:`,
- * `eve-attachment:`). Eve produces these during its own serialization and
+ * `eve-attachment:`). eve produces these during its own serialization and
* staging; an inbound channel payload must never carry one. The staging
* pipeline trusts the scheme prefix and reconstitutes such a string into a
* privileged sandbox/attachment read, so a caller-supplied ref is an
diff --git a/packages/eve/src/internal/authored-definition/connection.test.ts b/packages/eve/src/internal/authored-definition/connection.test.ts
index 16a30c97a..abb28f624 100644
--- a/packages/eve/src/internal/authored-definition/connection.test.ts
+++ b/packages/eve/src/internal/authored-definition/connection.test.ts
@@ -2,7 +2,7 @@ import { describe, expect, it } from "vitest";
import { normalizeMcpClientConnectionDefinition } from "#internal/authored-definition/connection.js";
-const MSG = "Expected the connection export to match the public Eve shape.";
+const MSG = "Expected the connection export to match the public eve shape.";
function validInput(overrides: Record<string, unknown> = {}) {
return {
diff --git a/packages/eve/src/internal/authored-definition/connection.ts b/packages/eve/src/internal/authored-definition/connection.ts
index 2f54775ad..579e24e84 100644
--- a/packages/eve/src/internal/authored-definition/connection.ts
+++ b/packages/eve/src/internal/authored-definition/connection.ts
@@ -31,7 +31,7 @@ const KNOWN_AUTHORIZATION_KEYS = [
"principalType",
"startAuthorization",
// Optional metadata marker that auth-provider helpers may attach so
- // downstream tooling (eg. the Eve compiler / Vercel dashboard) can
+ // downstream tooling (eg. the eve compiler / Vercel dashboard) can
// detect Vercel Connect-backed connections without opening the
// closure state of `getToken`. The runtime never reads it; it
// survives `normalizeAuthorizationSpec` so consumers can pick it
diff --git a/packages/eve/src/internal/authored-definition/openapi-connection.test.ts b/packages/eve/src/internal/authored-definition/openapi-connection.test.ts
index 804319b58..ac2cc694a 100644
--- a/packages/eve/src/internal/authored-definition/openapi-connection.test.ts
+++ b/packages/eve/src/internal/authored-definition/openapi-connection.test.ts
@@ -2,7 +2,7 @@ import { describe, expect, it } from "vitest";
import { normalizeOpenApiConnectionDefinition } from "#internal/authored-definition/connection.js";
-const MSG = "Expected the connection export to match the public Eve shape.";
+const MSG = "Expected the connection export to match the public eve shape.";
function validInput(overrides: Record<string, unknown> = {}) {
return {
diff --git a/packages/eve/src/internal/authored-definition/schema-backed.test.ts b/packages/eve/src/internal/authored-definition/schema-backed.test.ts
index 9e779fad7..64dc436a4 100644
--- a/packages/eve/src/internal/authored-definition/schema-backed.test.ts
+++ b/packages/eve/src/internal/authored-definition/schema-backed.test.ts
@@ -10,7 +10,7 @@ import {
import { once } from "#public/tools/approval/approval-helpers.js";
import { normalizeToolDefinition } from "#internal/authored-definition/schema-backed.js";
-const FAILURE_MESSAGE = "Expected the tool export to match the public Eve shape.";
+const FAILURE_MESSAGE = "Expected the tool export to match the public eve shape.";
describe("normalizeToolDefinition", () => {
it("returns a tool entry for a real defineTool default export", () => {
diff --git a/packages/eve/src/internal/authored-module-bundle.ts b/packages/eve/src/internal/authored-module-bundle.ts
index 8dc33787c..27247f1cc 100644
--- a/packages/eve/src/internal/authored-module-bundle.ts
+++ b/packages/eve/src/internal/authored-module-bundle.ts
@@ -20,7 +20,7 @@ export function createAuthoredModuleBundleError(modulePath: string, error: unkno
)
) {
hints.push(
- "If this comes from an asset import, Eve only supports assets that Rolldown can emit for a Node ESM bundle; otherwise load the file through fs/import.meta.url or externalize the package.",
+ "If this comes from an asset import, eve only supports assets that Rolldown can emit for a Node ESM bundle; otherwise load the file through fs/import.meta.url or externalize the package.",
);
}
diff --git a/packages/eve/src/internal/authored-module-loader.ts b/packages/eve/src/internal/authored-module-loader.ts
index 09cfe2e4b..42efbe06a 100644
--- a/packages/eve/src/internal/authored-module-loader.ts
+++ b/packages/eve/src/internal/authored-module-loader.ts
@@ -69,7 +69,7 @@ function getChannelModuleCache(): Map<string, unknown> | undefined {
* same `node_modules/.cache/.../<hash>.mjs` file: one call's
* `writeFile` can truncate the bundle while another's `import()` is
* still resolving it, surfacing as intermittent
- * "Expected … to match the public Eve shape" failures during
+ * "Expected … to match the public eve shape" failures during
* compilation.
*
* The map only holds in-flight promises; once a load settles the entry
diff --git a/packages/eve/src/internal/bundler/nitro-rolldown.ts b/packages/eve/src/internal/bundler/nitro-rolldown.ts
index 4a1b9a52e..dbe3f1385 100644
--- a/packages/eve/src/internal/bundler/nitro-rolldown.ts
+++ b/packages/eve/src/internal/bundler/nitro-rolldown.ts
@@ -37,7 +37,7 @@ let rolldownPromise: Promise<RolldownModule> | undefined;
let rolldownParseAstPromise: Promise<RolldownParseAstModule> | undefined;
/**
- * Loads Rolldown from Nitro's dependency tree so Eve does not carry a second
+ * Loads Rolldown from Nitro's dependency tree so eve does not carry a second
* native bundler package in its own install footprint.
*/
function loadNitroRolldown(): Promise<RolldownModule> {
diff --git a/packages/eve/src/internal/classify-model-routing.ts b/packages/eve/src/internal/classify-model-routing.ts
index 0fd1ddb43..a6f269559 100644
--- a/packages/eve/src/internal/classify-model-routing.ts
+++ b/packages/eve/src/internal/classify-model-routing.ts
@@ -60,7 +60,7 @@ function gatewayTarget(modelId: string): string {
/**
* Reads the upstream provider slug from a `providerOptions.gateway.byok` block
- * (the convention Eve scaffolds for forwarding a provider key to the gateway).
+ * (the convention eve scaffolds for forwarding a provider key to the gateway).
* Returns the first provider key, or undefined when no byok block is present.
*/
function readByokProvider(providerOptions?: Record<string, JsonObject>): string | undefined {
diff --git a/packages/eve/src/internal/helpers/markdown.test.ts b/packages/eve/src/internal/helpers/markdown.test.ts
index a06f644d4..7a7d866c9 100644
--- a/packages/eve/src/internal/helpers/markdown.test.ts
+++ b/packages/eve/src/internal/helpers/markdown.test.ts
@@ -56,7 +56,7 @@ Research complex weather questions before replying.`;
it("silently ignores authored name fields in skill markdown frontmatter", () => {
// SKILL.md files in the broader Agent Skills ecosystem typically declare
- // `name`; Eve derives identity from the file path, so we accept and drop
+ // `name`; eve derives identity from the file path, so we accept and drop
// the field rather than rejecting otherwise-valid skill markdown.
const markdown = `---
name: get-weather
@@ -98,7 +98,7 @@ description: Use the weather tool before answering forecast questions.
category: routing
---
When the user asks about weather, call the weather tool before answering.`),
- ).toThrow("Expected authored skill markdown to match the public Eve shape.");
+ ).toThrow("Expected authored skill markdown to match the public eve shape.");
});
it("derives flat skill metadata from plain markdown when no frontmatter is present", () => {
@@ -161,7 +161,7 @@ What's the temp in NYC?`;
description: nope
---
body`),
- ).toThrow("Expected authored schedule markdown to match the public Eve shape.");
+ ).toThrow("Expected authored schedule markdown to match the public eve shape.");
});
it("rejects run frontmatter in schedule markdown", () => {
@@ -183,7 +183,7 @@ cron: "*/5 * * * *"
name: not-allowed
---
body`),
- ).toThrow("Expected authored schedule markdown to match the public Eve shape.");
+ ).toThrow("Expected authored schedule markdown to match the public eve shape.");
});
it("rejects skill markdown frontmatter without a closing delimiter", () => {
diff --git a/packages/eve/src/internal/helpers/markdown.ts b/packages/eve/src/internal/helpers/markdown.ts
index efd20ecb8..2b29ec025 100644
--- a/packages/eve/src/internal/helpers/markdown.ts
+++ b/packages/eve/src/internal/helpers/markdown.ts
@@ -16,7 +16,7 @@ const CLOSED_FRONTMATTER_PATTERN = /^---\r?\n[\s\S]*?\r?\n---(?:\r?\n|$)/;
* gray-matter ships a built-in `javascript` frontmatter engine that runs
* `eval()` on the frontmatter body, so a document whose opening fence is
* `---javascript` (or `---js`) would execute arbitrary code the instant it is
- * parsed — before any of Eve's validators run. Authored markdown (skills,
+ * parsed — before any of eve's validators run. Authored markdown (skills,
* schedules, instructions) is treated as data, so we disable the code-capable
* engines and pin the default language to YAML; a JavaScript frontmatter fence
* now throws instead of evaluating.
@@ -98,7 +98,7 @@ function parseMarkdownDocument(source: string): ParsedMarkdownDocument {
export function lowerInstructionsMarkdown(markdown: string): InstructionsDefinition {
return normalizeInstructionsDefinition(
{ markdown },
- "Expected authored instructions markdown to match the public Eve shape.",
+ "Expected authored instructions markdown to match the public eve shape.",
);
}
@@ -157,7 +157,7 @@ export function lowerScheduleMarkdown(source: string): ScheduleDefinition {
return defineSchedule(
normalizeScheduleDefinition(
rawDefinition,
- "Expected authored schedule markdown to match the public Eve shape.",
+ "Expected authored schedule markdown to match the public eve shape.",
),
);
}
@@ -194,7 +194,7 @@ export function lowerSkillMarkdown(
return defineSkill(
normalizeSkillDefinition(
rawDefinition,
- "Expected authored skill markdown to match the public Eve shape.",
+ "Expected authored skill markdown to match the public eve shape.",
),
);
}
@@ -228,8 +228,8 @@ function applyOptionalSkillFrontmatter(
/**
* Removes frontmatter keys that the broader Agent Skills format permits but
- * Eve deliberately does not consume. Skill identity is path-derived, so an
- * authored `name` is meaningless to Eve; we drop it silently rather than
+ * eve deliberately does not consume. Skill identity is path-derived, so an
+ * authored `name` is meaningless to eve; we drop it silently rather than
* letting it surface as an unknown-key error during normalization.
*/
const IGNORED_SKILL_FRONTMATTER_KEYS = ["name"];
diff --git a/packages/eve/src/internal/instrumentation.test.ts b/packages/eve/src/internal/instrumentation.test.ts
index cfc52d4b3..a0ebb9de2 100644
--- a/packages/eve/src/internal/instrumentation.test.ts
+++ b/packages/eve/src/internal/instrumentation.test.ts
@@ -100,7 +100,7 @@ describe("resolveInstrumentationProjection", () => {
expect(log.warn).toHaveBeenCalledTimes(2);
});
- it("warns and returns undefined for a record outside the Eve JSON contract", () => {
+ it("warns and returns undefined for a record outside the eve JSON contract", () => {
const log = fakeLogger();
expect(
diff --git a/packages/eve/src/internal/instrumentation.ts b/packages/eve/src/internal/instrumentation.ts
index c364949d8..db087c543 100644
--- a/packages/eve/src/internal/instrumentation.ts
+++ b/packages/eve/src/internal/instrumentation.ts
@@ -47,7 +47,7 @@ export function normalizeInstrumentationChannelKind(
* Returns the JSON object the projector produced. Returns `undefined`
* without warning for a no-op `undefined`, or with a warning when it threw,
* returned a `Promise`, returned an incorrect shape, or included values
- * outside Eve's JSON contract. Every rejection path is warning-only so
+ * outside eve's JSON contract. Every rejection path is warning-only so
* instrumentation can never break the turn. Per-value shaping (for example
* reserved-key filtering) is left to the caller, since the channel and
* harness expose different value shapes.
diff --git a/packages/eve/src/internal/nitro/host/build-application.scenario.test.ts b/packages/eve/src/internal/nitro/host/build-application.scenario.test.ts
index 79a4b7f76..a69c7c764 100644
--- a/packages/eve/src/internal/nitro/host/build-application.scenario.test.ts
+++ b/packages/eve/src/internal/nitro/host/build-application.scenario.test.ts
@@ -336,7 +336,7 @@ describe("buildApplication", () => {
expect((summary.agent as { name: string }).name).toBe("scenario-test-agent");
});
- it("normalizes Eve function output behind a non-Next host service", async () => {
+ it("normalizes eve function output behind a non-Next host service", async () => {
vi.stubEnv("VERCEL", "1");
const appRoot = await createScratchDirectory("eve-build-application-vercel-nuxt-");
const flowOutputDir = join(appRoot, ".eve", "nitro-output", "flow");
diff --git a/packages/eve/src/internal/nitro/host/build-application.ts b/packages/eve/src/internal/nitro/host/build-application.ts
index e3352a4b7..9b422e972 100644
--- a/packages/eve/src/internal/nitro/host/build-application.ts
+++ b/packages/eve/src/internal/nitro/host/build-application.ts
@@ -56,11 +56,11 @@ function normalizeServicePrefix(service: Record<string, unknown>): string {
}
/**
- * Resolve the route prefix an Eve service is mounted under when it is
+ * Resolve the route prefix an eve service is mounted under when it is
* co-deployed behind a host web service (Next.js, Nuxt, SvelteKit etc.).
*
* Any service whose framework is not `eve` is treated as a host that proxies
- * Eve's transport routes behind a prefix. A standalone Eve deployment (no host
+ * eve's transport routes behind a prefix. A standalone eve deployment (no host
* service) returns `undefined` so its output stays routable at the root.
*/
function resolveCoDeployedEveServicePrefix(input: {
@@ -225,7 +225,7 @@ async function buildVercelNitroSurface(
}
/**
- * Builds the production Nitro output for an Eve application.
+ * Builds the production Nitro output for an eve application.
*/
export async function buildApplication(rootDir: string): Promise<string> {
const preparedHost = await prepareApplicationHost(rootDir);
diff --git a/packages/eve/src/internal/nitro/host/channel-routes.ts b/packages/eve/src/internal/nitro/host/channel-routes.ts
index af93c9463..eb37fffb1 100644
--- a/packages/eve/src/internal/nitro/host/channel-routes.ts
+++ b/packages/eve/src/internal/nitro/host/channel-routes.ts
@@ -28,7 +28,7 @@ interface ChannelRouteNitro {
}
/**
- * One Nitro route registration for an Eve channel.
+ * One Nitro route registration for an eve channel.
*/
export interface NitroChannelRouteRegistration {
readonly method: ChannelRouteMethod;
@@ -90,7 +90,7 @@ export function computeChannelRouteRegistrations(
}
/**
- * Registers virtual Nitro handlers for the provided Eve channel routes.
+ * Registers virtual Nitro handlers for the provided eve channel routes.
*/
export function registerChannelVirtualHandlers(
nitro: Pick<ChannelRouteNitro, "options">,
@@ -109,7 +109,7 @@ export function registerChannelVirtualHandlers(
}
/**
- * Replaces the currently-mounted Eve channel virtual handlers when the route
+ * Replaces the currently-mounted eve channel virtual handlers when the route
* set changes.
*/
export function syncChannelVirtualHandlers(
diff --git a/packages/eve/src/internal/nitro/host/configure-nitro-routes.ts b/packages/eve/src/internal/nitro/host/configure-nitro-routes.ts
index c86e7fc67..68f8fcb95 100644
--- a/packages/eve/src/internal/nitro/host/configure-nitro-routes.ts
+++ b/packages/eve/src/internal/nitro/host/configure-nitro-routes.ts
@@ -79,7 +79,7 @@ function createRelativeImportSpecifier(fromDirectoryPath: string, targetPath: st
}
/**
- * Describes a workflow queue entrypoint Eve will register as an in-process
+ * Describes a workflow queue entrypoint eve will register as an in-process
* direct handler on the runtime world's queue.
*
* Direct handlers let the local workflow queue dispatch step / workflow
@@ -168,7 +168,7 @@ function buildWorkflowFileHandlerSource(input: {
runtimeImportSpecifier?: string;
}): string {
const lines: string[] = [
- "// Generated by Eve. Do not edit by hand.",
+ "// Generated by eve. Do not edit by hand.",
`import { POST } from ${JSON.stringify(input.bundlePath)};`,
];
@@ -255,7 +255,7 @@ function addFrameworkVirtualHandler(
}
/**
- * Wires Eve's package-owned app, channel, workflow inspection, and Workflow
+ * Wires eve's package-owned app, channel, workflow inspection, and Workflow
* SDK endpoints into one Nitro host instance.
*/
export async function configureNitroRoutes(
diff --git a/packages/eve/src/internal/nitro/host/create-application-nitro.scenario.test.ts b/packages/eve/src/internal/nitro/host/create-application-nitro.scenario.test.ts
index 44bf8d64c..22d3da254 100644
--- a/packages/eve/src/internal/nitro/host/create-application-nitro.scenario.test.ts
+++ b/packages/eve/src/internal/nitro/host/create-application-nitro.scenario.test.ts
@@ -287,7 +287,7 @@ describe("createApplicationNitro", () => {
});
});
- it("sets the Eve framework version on Vercel app-surface build output config", async () => {
+ it("sets the eve framework version on Vercel app-surface build output config", async () => {
vi.stubEnv("VERCEL", "1");
const nitroStub = createNitroStub();
createNitroMock.mockResolvedValueOnce(nitroStub.nitro);
@@ -354,7 +354,7 @@ describe("createApplicationNitro", () => {
});
});
- it("clears Nitro build cache output from a different Eve version", async () => {
+ it("clears Nitro build cache output from a different eve version", async () => {
const tempRoot = await mkdtemp(join(tmpdir(), "eve-nitro-version-cache-"));
try {
diff --git a/packages/eve/src/internal/nitro/host/create-application-nitro.ts b/packages/eve/src/internal/nitro/host/create-application-nitro.ts
index 7d1c51932..dc4c14ee2 100644
--- a/packages/eve/src/internal/nitro/host/create-application-nitro.ts
+++ b/packages/eve/src/internal/nitro/host/create-application-nitro.ts
@@ -56,7 +56,7 @@ const WORKFLOW_TRANSFORM_PATCHED = Symbol("eve.workflow-transform-patched");
const WORKFLOW_CACHE_PATH_FRAGMENT = "/.eve/workflow-cache/";
/**
- * Packages Eve itself pulls into hosted application output that must stay
+ * Packages eve itself pulls into hosted application output that must stay
* external so Nitro/rolldown does not try to inline platform-specific
* `.node` binaries (which would fail with a UTF-8 decode error).
*
@@ -196,7 +196,7 @@ function createDevelopmentWatchOptions(appRoot: string): { ignored: string[] } |
}
return {
- // Eve's authored-source watcher owns app code rebuilds. If Nitro/Rollup
+ // eve's authored-source watcher owns app code rebuilds. If Nitro/Rollup
// also watches those files it can reload the worker while a workflow
// stream is waiting on a tool result, which surfaces as ECONNRESET.
ignored: [appRoot, join(appRoot, "**")],
@@ -577,7 +577,7 @@ function addInstrumentationModuleSideEffectsPlugin(
}
/**
- * Extends the Workflow Nitro transform exclusion list to include Eve's
+ * Extends the Workflow Nitro transform exclusion list to include eve's
* package-owned workflow cache directory.
*
* Without this patch, the Workflow transform can re-process the already-built
@@ -631,7 +631,7 @@ function patchWorkflowTransformExcludePath(nitro: Nitro, workflowBuildDir: strin
/**
* Creates one configured Nitro instance for either production build or dev
- * hosting of an Eve application.
+ * hosting of an eve application.
*
* `surface` narrows the mounted routes for isolated production builds.
* `outputDir` lets callers stage those isolated builds into separate Nitro
@@ -745,7 +745,7 @@ export async function createApplicationNitro(
}
// Resolve bare `workflow/*` specifiers during Nitro's Rollup bundling so
- // pre-built workflow modules (whose imports target Eve's installed copies)
+ // pre-built workflow modules (whose imports target eve's installed copies)
// resolve correctly in production builds where Node resolution from the
// workflow cache directory is not available.
if (includesWorkflowSurface(surface)) {
diff --git a/packages/eve/src/internal/nitro/host/cron-handler-route.test.ts b/packages/eve/src/internal/nitro/host/cron-handler-route.test.ts
index 0215df585..3539279e5 100644
--- a/packages/eve/src/internal/nitro/host/cron-handler-route.test.ts
+++ b/packages/eve/src/internal/nitro/host/cron-handler-route.test.ts
@@ -11,7 +11,7 @@ import {
const BASE64URL_PATTERN = /^[A-Za-z0-9_-]{43}$/;
describe("createEveCronHandlerRoute", () => {
- it("returns a route under the Eve protocol prefix with a random base64url suffix", () => {
+ it("returns a route under the eve protocol prefix with a random base64url suffix", () => {
const route = createEveCronHandlerRoute();
expect(route.startsWith(`${EVE_ROUTE_PREFIX}/cron/`)).toBe(true);
diff --git a/packages/eve/src/internal/nitro/host/cron-handler-route.ts b/packages/eve/src/internal/nitro/host/cron-handler-route.ts
index 6415be0cb..310a96e8a 100644
--- a/packages/eve/src/internal/nitro/host/cron-handler-route.ts
+++ b/packages/eve/src/internal/nitro/host/cron-handler-route.ts
@@ -5,7 +5,7 @@ import type { Nitro } from "nitro/types";
import { EVE_ROUTE_PREFIX } from "#protocol/routes.js";
/**
- * Builds an unguessable route path for Eve's Vercel cron handler.
+ * Builds an unguessable route path for eve's Vercel cron handler.
*
* Vercel cron jobs hit a single configurable path (default `/_vercel/cron`)
* for every scheduled tick, identifying the schedule via the
@@ -13,7 +13,7 @@ import { EVE_ROUTE_PREFIX } from "#protocol/routes.js";
* relies on the user setting a `CRON_SECRET` env var to authenticate
* incoming requests.
*
- * Eve sidesteps the manual env var by giving each build a unique random
+ * eve sidesteps the manual env var by giving each build a unique random
* handler path under the framework's protocol prefix — the path itself is
* the secret. Vercel's cron infra reads the path from the deploy's
* `config.crons[]` so the platform always knows where to POST, and the same
@@ -31,7 +31,7 @@ export function createEveCronHandlerRoute(): string {
}
/**
- * Applies Eve's unguessable cron handler route to a Nitro instance built
+ * Applies eve's unguessable cron handler route to a Nitro instance built
* with the Vercel preset.
*
* The Vercel preset reads `nitro.options.vercel.cronHandlerRoute` at two
diff --git a/packages/eve/src/internal/nitro/host/nitro-bundler-config.ts b/packages/eve/src/internal/nitro/host/nitro-bundler-config.ts
index 511a644a3..3bb1e90e2 100644
--- a/packages/eve/src/internal/nitro/host/nitro-bundler-config.ts
+++ b/packages/eve/src/internal/nitro/host/nitro-bundler-config.ts
@@ -68,7 +68,7 @@ function onNitroBundlerLog(
}
/**
- * Creates Eve-owned Nitro bundler overrides that must apply to both Rollup
+ * Creates eve-owned Nitro bundler overrides that must apply to both Rollup
* and Rolldown hosted builds.
*/
export function createNitroBundlerConfig(plugins: readonly object[]): Record<string, unknown> {
diff --git a/packages/eve/src/internal/nitro/host/optional-engine-dependency-plugin.ts b/packages/eve/src/internal/nitro/host/optional-engine-dependency-plugin.ts
index c1e4bf803..b5d528742 100644
--- a/packages/eve/src/internal/nitro/host/optional-engine-dependency-plugin.ts
+++ b/packages/eve/src/internal/nitro/host/optional-engine-dependency-plugin.ts
@@ -1,8 +1,8 @@
/**
- * Optional sandbox engine packages Eve's runtime references through
+ * Optional sandbox engine packages eve's runtime references through
* lazy dynamic imports. Bundlers follow literal dynamic imports like
* static imports — so without intervention mere *resolvability* (for
- * example Eve's own workspace devDependencies) would pull them into
+ * example eve's own workspace devDependencies) would pull them into
* every hosted build. The source of truth for whether an application
* opted in is its compiled sandbox config: the backend names captured
* into the manifest at compile time.
diff --git a/packages/eve/src/internal/nitro/host/schedule-task-routes.test.ts b/packages/eve/src/internal/nitro/host/schedule-task-routes.test.ts
index 529386d0f..4ec6b337b 100644
--- a/packages/eve/src/internal/nitro/host/schedule-task-routes.test.ts
+++ b/packages/eve/src/internal/nitro/host/schedule-task-routes.test.ts
@@ -51,11 +51,11 @@ describe("schedule task routes", () => {
expect(nitro.options.experimental.tasks).toBe(true);
expect(nitro.options.tasks).toEqual({
"eve.schedule.c2NoZWR1bGVzL2RhaWx5LWRpZ2VzdC5tanM": {
- description: 'Run Eve schedule "daily-digest" from "schedules/daily-digest.mjs".',
+ description: 'Run eve schedule "daily-digest" from "schedules/daily-digest.mjs".',
handler: "#eve-schedule-task/eve.schedule.c2NoZWR1bGVzL2RhaWx5LWRpZ2VzdC5tanM",
},
"eve.schedule.c2NoZWR1bGVzL3dlZWtseS1jbGVhbnVwLm1qcw": {
- description: 'Run Eve schedule "weekly-cleanup" from "schedules/weekly-cleanup.mjs".',
+ description: 'Run eve schedule "weekly-cleanup" from "schedules/weekly-cleanup.mjs".',
handler: "#eve-schedule-task/eve.schedule.c2NoZWR1bGVzL3dlZWtseS1jbGVhbnVwLm1qcw",
},
});
@@ -99,7 +99,7 @@ describe("schedule task routes", () => {
expect(nitro.options.virtual).toEqual({});
});
- it("removes only Eve-owned task entries, virtual modules, and cron mappings", () => {
+ it("removes only eve-owned task entries, virtual modules, and cron mappings", () => {
const nitro = createNitroStub({
scheduledTasks: {
"0 8 * * *": ["eve.schedule.example", "user-task"],
diff --git a/packages/eve/src/internal/nitro/host/schedule-task-routes.ts b/packages/eve/src/internal/nitro/host/schedule-task-routes.ts
index 24d235e3d..4af9fe93a 100644
--- a/packages/eve/src/internal/nitro/host/schedule-task-routes.ts
+++ b/packages/eve/src/internal/nitro/host/schedule-task-routes.ts
@@ -9,7 +9,7 @@ import type { NitroArtifactsConfigInput } from "#internal/nitro/host/artifacts-c
/**
* Virtual id prefix used for the synthetic Nitro task module emitted for each
- * Eve authored schedule. Each registered task points at its own virtual id so
+ * eve authored schedule. Each registered task points at its own virtual id so
* Rollup can resolve the generated `defineTask({...})` source without writing
* a physical handler file.
*/
@@ -79,7 +79,7 @@ export function registerScheduleTaskHandlers(
}
/**
- * Replaces the currently-registered Eve schedule task handlers when the
+ * Replaces the currently-registered eve schedule task handlers when the
* compiled authored schedule set changes.
*
* Returns `true` when the registration set changed (and the caller should
@@ -102,7 +102,7 @@ export function syncScheduleTaskHandlers(
}
/**
- * Removes every Eve-owned schedule task entry, virtual handler module, and
+ * Removes every eve-owned schedule task entry, virtual handler module, and
* cron entry from the Nitro options. Used by the dev watcher before
* re-registering the latest compiled set.
*/
diff --git a/packages/eve/src/internal/nitro/host/start-development-server.test.ts b/packages/eve/src/internal/nitro/host/start-development-server.test.ts
index bade3cbb8..9e8cfa9cf 100644
--- a/packages/eve/src/internal/nitro/host/start-development-server.test.ts
+++ b/packages/eve/src/internal/nitro/host/start-development-server.test.ts
@@ -257,7 +257,7 @@ describe("startDevelopmentServer", () => {
expect(process.env.EVE_DEVELOPMENT_SANDBOX_RUN_ID).toBeUndefined();
});
- it("uses Eve's default port when no port is requested", async () => {
+ it("uses eve's default port when no port is requested", async () => {
const { startDevelopmentServer } = await import("./start-development-server.js");
Object.assign(mocks.nitro.options.devServer, {
port: 3000,
@@ -339,7 +339,7 @@ describe("startDevelopmentServer", () => {
await expect(startDevelopmentServer("/tmp/eve-test")).rejects.toThrow(
[
- `A dev server is already running for this Eve agent (pid ${process.pid}).`,
+ `A dev server is already running for this eve agent (pid ${process.pid}).`,
`To stop it, run: ${
process.platform === "win32" ? "taskkill /PID" : "kill"
} ${process.pid}`,
diff --git a/packages/eve/src/internal/nitro/host/start-development-server.ts b/packages/eve/src/internal/nitro/host/start-development-server.ts
index 3cf05a2b8..e44d99c58 100644
--- a/packages/eve/src/internal/nitro/host/start-development-server.ts
+++ b/packages/eve/src/internal/nitro/host/start-development-server.ts
@@ -164,7 +164,7 @@ async function writeDevelopmentProcessId(appRoot: string): Promise<() => Promise
if (activeProcessId !== undefined) {
throw new Error(
[
- `A dev server is already running for this Eve agent (pid ${activeProcessId}).`,
+ `A dev server is already running for this eve agent (pid ${activeProcessId}).`,
`To stop it, run: ${formatKillCommand(activeProcessId)}`,
].join("\n"),
);
@@ -333,7 +333,7 @@ async function listenForDevelopmentServer(input: {
}
/**
- * Starts the development Nitro server for an Eve application.
+ * Starts the development Nitro server for an eve application.
*
* Authored schedules are never registered with Nitro's cron scheduler in
* dev mode. To fire one authored schedule on demand, `POST` the dev-only
diff --git a/packages/eve/src/internal/nitro/host/start-production-server.test.ts b/packages/eve/src/internal/nitro/host/start-production-server.test.ts
index 9e7c5866c..d6ff76ca6 100644
--- a/packages/eve/src/internal/nitro/host/start-production-server.test.ts
+++ b/packages/eve/src/internal/nitro/host/start-production-server.test.ts
@@ -79,7 +79,7 @@ describe("startProductionServer", () => {
mocks.existsSync.mockReturnValueOnce(false);
await expect(startProductionServer("/tmp/app")).rejects.toThrow(
- 'Missing Eve build output at /tmp/app/.output/server/index.mjs. Run "eve build" before "eve start".',
+ 'Missing eve build output at /tmp/app/.output/server/index.mjs. Run "eve build" before "eve start".',
);
expect(mocks.spawn).not.toHaveBeenCalled();
diff --git a/packages/eve/src/internal/nitro/host/start-production-server.ts b/packages/eve/src/internal/nitro/host/start-production-server.ts
index 6a0fbec1a..3c847b2fd 100644
--- a/packages/eve/src/internal/nitro/host/start-production-server.ts
+++ b/packages/eve/src/internal/nitro/host/start-production-server.ts
@@ -219,7 +219,7 @@ function once(child: ChildProcess, event: "exit"): Promise<void> {
}
/**
- * Starts a built Nitro server for an Eve application.
+ * Starts a built Nitro server for an eve application.
*/
export async function startProductionServer(
rootDir: string,
@@ -233,7 +233,7 @@ export async function startProductionServer(
if (!existsSync(serverEntry)) {
throw new Error(
- `Missing Eve build output at ${serverEntry}. Run "eve build" before "eve start".`,
+ `Missing eve build output at ${serverEntry}. Run "eve build" before "eve start".`,
);
}
@@ -323,7 +323,7 @@ export async function startProductionServer(
await terminate(child);
if (isRecord(error) && error.name === "AbortError") {
- throw new Error("Timed out waiting for built Eve server to respond.", { cause: error });
+ throw new Error("Timed out waiting for built eve server to respond.", { cause: error });
}
throw error;
diff --git a/packages/eve/src/internal/nitro/routes/agent-info/load-agent-info-data.ts b/packages/eve/src/internal/nitro/routes/agent-info/load-agent-info-data.ts
index f3fcd669f..4f92aaa19 100644
--- a/packages/eve/src/internal/nitro/routes/agent-info/load-agent-info-data.ts
+++ b/packages/eve/src/internal/nitro/routes/agent-info/load-agent-info-data.ts
@@ -88,7 +88,7 @@ export function resolveAgentInfoCompiledArtifactsSource(
return createDiskRuntimeCompiledArtifactsSource(input.appRoot);
}
- throw new Error("Eve agent info runtime data requires bundled artifacts or an app root.");
+ throw new Error("eve agent info runtime data requires bundled artifacts or an app root.");
}
async function loadAgentInfoDataFromArtifacts(
diff --git a/packages/eve/src/internal/nitro/routes/channel-dispatch.ts b/packages/eve/src/internal/nitro/routes/channel-dispatch.ts
index 844c1e23c..0d1f100fa 100644
--- a/packages/eve/src/internal/nitro/routes/channel-dispatch.ts
+++ b/packages/eve/src/internal/nitro/routes/channel-dispatch.ts
@@ -69,7 +69,7 @@ export async function dispatchChannelRequest(
response = await matchedChannel.fetch(event.req, ctx);
}
} catch (error) {
- // Without this a handler throw is only Nitro's default 5xx, with no Eve log.
+ // Without this a handler throw is only Nitro's default 5xx, with no eve log.
const errorId = logError(log, "channel handler threw", error, {
routeKey,
channel: matchedChannel.name,
diff --git a/packages/eve/src/internal/nitro/routes/health.ts b/packages/eve/src/internal/nitro/routes/health.ts
index 09409223e..787119d2e 100644
--- a/packages/eve/src/internal/nitro/routes/health.ts
+++ b/packages/eve/src/internal/nitro/routes/health.ts
@@ -2,7 +2,7 @@ import type { H3Event } from "nitro";
import { workflowEntryReference } from "#execution/workflow-runtime.js";
/**
- * Nitro route for Eve's health endpoint.
+ * Nitro route for eve's health endpoint.
*
* The health endpoint is intentionally always-public so platform load
* balancers and uptime monitors can probe it without credentials.
diff --git a/packages/eve/src/internal/nitro/routes/info.ts b/packages/eve/src/internal/nitro/routes/info.ts
index 4e65b21d9..b6bbd8ceb 100644
--- a/packages/eve/src/internal/nitro/routes/info.ts
+++ b/packages/eve/src/internal/nitro/routes/info.ts
@@ -36,7 +36,7 @@ function hasEnvValue(value: string | undefined): boolean {
/**
* Builds the package-owned JSON inspection response for the current agent.
*
- * The route keeps the same default auth chain as the Eve channel:
+ * The route keeps the same default auth chain as the eve channel:
* local development requests are accepted by hostname, while deployed
* Vercel targets require a valid OIDC bearer.
*/
diff --git a/packages/eve/src/internal/nitro/routes/runtime-artifacts.ts b/packages/eve/src/internal/nitro/routes/runtime-artifacts.ts
index 8e0a8138b..7b41e1afb 100644
--- a/packages/eve/src/internal/nitro/routes/runtime-artifacts.ts
+++ b/packages/eve/src/internal/nitro/routes/runtime-artifacts.ts
@@ -30,7 +30,7 @@ export function resolveNitroCompiledArtifactsSource(
if (isDevelopment && appRoot !== undefined) {
if (config.moduleMapLoaderPath === undefined) {
throw new Error(
- 'Eve Nitro development routes require "moduleMapLoaderPath" in the artifacts config.',
+ 'eve Nitro development routes require "moduleMapLoaderPath" in the artifacts config.',
);
}
@@ -52,6 +52,6 @@ export function resolveNitroCompiledArtifactsSource(
}
throw new Error(
- "Eve Nitro route requires bundled artifacts or an Eve Nitro runtime configuration app root.",
+ "eve Nitro route requires bundled artifacts or an eve Nitro runtime configuration app root.",
);
}
diff --git a/packages/eve/src/internal/nitro/routes/schedule-task.ts b/packages/eve/src/internal/nitro/routes/schedule-task.ts
index 429dc2842..a0958d235 100644
--- a/packages/eve/src/internal/nitro/routes/schedule-task.ts
+++ b/packages/eve/src/internal/nitro/routes/schedule-task.ts
@@ -7,7 +7,7 @@ import type { NitroArtifactsConfig } from "#internal/nitro/routes/runtime-artifa
import { resolveNitroCompiledArtifactsSource } from "#internal/nitro/routes/runtime-artifacts.js";
/**
- * Dispatches one Eve authored schedule via the execution engine.
+ * Dispatches one eve authored schedule via the execution engine.
*
* Fire-and-forget: the workflow runtime owns terminal completion and
* its own failure observability. The task return value reports which
diff --git a/packages/eve/src/internal/package-name.ts b/packages/eve/src/internal/package-name.ts
index 905c2b65c..dbdb34cf2 100644
--- a/packages/eve/src/internal/package-name.ts
+++ b/packages/eve/src/internal/package-name.ts
@@ -1,5 +1,5 @@
/**
- * The published npm package name for the Eve framework.
+ * The published npm package name for the eve framework.
*
* This module is intentionally free of side effects and heavy imports so that
* any layer can reference the package identity without pulling in filesystem
diff --git a/packages/eve/src/internal/structural-tests/runtime-boundary.test.ts b/packages/eve/src/internal/structural-tests/runtime-boundary.test.ts
index 0661452b1..234094263 100644
--- a/packages/eve/src/internal/structural-tests/runtime-boundary.test.ts
+++ b/packages/eve/src/internal/structural-tests/runtime-boundary.test.ts
@@ -234,7 +234,7 @@ function formatReachabilityFailure({
const sections = [
"Channel and harness production code must stay workflow-agnostic.",
"A channel or harness file can transitively reach vendored Workflow primitives.",
- "Move the workflow primitive call behind a runtime/execution-owned helper, then have the channel or harness depend on that Eve-owned boundary instead.",
+ "Move the workflow primitive call behind a runtime/execution-owned helper, then have the channel or harness depend on that eve-owned boundary instead.",
];
if (violations.length > 0) {
diff --git a/packages/eve/src/internal/testing/active-session-context.ts b/packages/eve/src/internal/testing/active-session-context.ts
index 4f508b6e2..576bd6de4 100644
--- a/packages/eve/src/internal/testing/active-session-context.ts
+++ b/packages/eve/src/internal/testing/active-session-context.ts
@@ -72,7 +72,7 @@ function buildSession(init: ActiveSessionInit): Session {
}
/**
- * Runs `fn` with an Eve {@link ContextContainer} bound to the active
+ * Runs `fn` with an eve {@link ContextContainer} bound to the active
* async scope.
*/
export async function runWithActiveSessionContext<T>(
diff --git a/packages/eve/src/internal/testing/app-harness.ts b/packages/eve/src/internal/testing/app-harness.ts
index 485776cb5..7958c600d 100644
--- a/packages/eve/src/internal/testing/app-harness.ts
+++ b/packages/eve/src/internal/testing/app-harness.ts
@@ -21,7 +21,7 @@ import {
import type { MockSandbox } from "#internal/testing/mocks/mock-sandbox.js";
/**
- * Declarative, in-memory Eve app stand-in used by integration tests.
+ * Declarative, in-memory eve app stand-in used by integration tests.
*/
/**
diff --git a/packages/eve/src/internal/testing/memory-agent-source.ts b/packages/eve/src/internal/testing/memory-agent-source.ts
index cd4bcf168..b310d3d3a 100644
--- a/packages/eve/src/internal/testing/memory-agent-source.ts
+++ b/packages/eve/src/internal/testing/memory-agent-source.ts
@@ -3,7 +3,7 @@ import { posix } from "node:path";
import { createMemoryProjectSource, type ProjectSource } from "#discover/project-source.js";
/**
- * Declarative description of an in-memory Eve project used by integration
+ * Declarative description of an in-memory eve project used by integration
* tests that exercise the `discover/` and `compile/` pipelines.
*
* The shape mirrors the authored grammar — tests author paths relative to
diff --git a/packages/eve/src/internal/testing/scenario-app.ts b/packages/eve/src/internal/testing/scenario-app.ts
index 2c6ed0c13..0e018db09 100644
--- a/packages/eve/src/internal/testing/scenario-app.ts
+++ b/packages/eve/src/internal/testing/scenario-app.ts
@@ -29,7 +29,7 @@ const SCENARIO_AI_PACKAGE_VERSION = resolvePackageVersion("ai");
* dev server, or `compileAgent` against real files) materialize a descriptor
* into a fresh temporary directory via {@link materializeScenarioApp}. The
* descriptor captures every file the test needs; the helper wires up the
- * package manifest, the Eve tarball dependency, and (when requested) an
+ * package manifest, the eve tarball dependency, and (when requested) an
* installed `node_modules/` tree.
*
* Descriptors are the single source of truth for fixture content — the
@@ -280,7 +280,7 @@ const EVE_SCENARIO_EVE_TARBALL_PATH_ENV = "EVE_SCENARIO_EVE_TARBALL_PATH";
let cachedScenarioEveTarballPromise: Promise<string> | null = null;
/**
- * Returns the on-disk path to the Eve tarball used by scenario apps.
+ * Returns the on-disk path to the eve tarball used by scenario apps.
*
* When the scenario vitest config's `globalSetup`
* (`test/setup/pack-scenario-tarball.ts`) has run, the tarball is packed
@@ -354,7 +354,7 @@ async function resolveScenarioEveTarballFileName(): Promise<string> {
let cachedScenarioWorkerCacheDirectoryPromise: Promise<string> | null = null;
/**
- * Returns a per-worker cache directory used to store the Eve tarball and the
+ * Returns a per-worker cache directory used to store the eve tarball and the
* installed dependency templates. The directory is created on demand and
* scoped by `VITEST_WORKER_ID` so concurrent workers cannot corrupt each
* other's caches.
diff --git a/packages/eve/src/internal/vercel-agent-summary.ts b/packages/eve/src/internal/vercel-agent-summary.ts
index 74dc28f06..060a5c3e3 100644
--- a/packages/eve/src/internal/vercel-agent-summary.ts
+++ b/packages/eve/src/internal/vercel-agent-summary.ts
@@ -1,8 +1,8 @@
/**
- * Public, versioned summary of an Eve agent emitted by `eve`
+ * Public, versioned summary of an eve agent emitted by `eve`
* during `eve build`.
*
- * This schema is the stable contract between Eve and Vercel platform
+ * This schema is the stable contract between eve and Vercel platform
* surfaces (eg. the dashboard's project overview card). It is intentionally
* smaller and more conservative than the internal {@link CompiledAgentManifest}
* — only fields safe to render in product UI live here, and the schema is
@@ -40,10 +40,10 @@ export const VERCEL_EVE_AGENT_SUMMARY_KIND = "vercel-eve-agent-summary" as const
export const VERCEL_EVE_AGENT_SUMMARY_VERSION = 3;
/**
- * Output path (relative to the agent's `appRoot`) where Eve writes the
+ * Output path (relative to the agent's `appRoot`) where eve writes the
* summary file at build time.
*
- * Lives under `.eve/` — the existing Eve-internal cache namespace that
+ * Lives under `.eve/` — the existing eve-internal cache namespace that
* already holds `nitro/`, `nitro-output/`, `sandbox-cache/`, etc. (see
* `packages/eve/src/internal/application/paths.ts`). Intentionally
* outside `.vercel/output/` so the file is not part of the Build Output
@@ -54,7 +54,7 @@ export const VERCEL_EVE_AGENT_SUMMARY_VERSION = 3;
export const VERCEL_EVE_AGENT_SUMMARY_OUTPUT_PATH = ".eve/agent-summary.json";
/**
- * Display category Eve exposes to the dashboard for one channel chip. Built
+ * Display category eve exposes to the dashboard for one channel chip. Built
* from the channel's reported {@link CompiledChannelDefinition.adapterKind}.
*/
export type VercelEveChannelType = "slack" | "http" | "webhook" | "unknown";
@@ -192,7 +192,7 @@ export interface VercelEveDiagnosticsSummary {
}
/**
- * Versioned public summary of one Eve agent, emitted into the Vercel Build
+ * Versioned public summary of one eve agent, emitted into the Vercel Build
* Output during `eve build` and ingested by Vercel as deployment metadata.
*/
export interface VercelEveAgentSummary {
diff --git a/packages/eve/src/internal/workflow-bundle/builder.scenario.test.ts b/packages/eve/src/internal/workflow-bundle/builder.scenario.test.ts
index f4d2ccc89..44541bc65 100644
--- a/packages/eve/src/internal/workflow-bundle/builder.scenario.test.ts
+++ b/packages/eve/src/internal/workflow-bundle/builder.scenario.test.ts
@@ -162,7 +162,7 @@ describe("WorkflowBundleBuilder", () => {
}
});
- it("clears workflow cache output from a different Eve version", async () => {
+ it("clears workflow cache output from a different eve version", async () => {
const tempRoot = await mkdtemp(join(tmpdir(), "eve-workflow-bundle-version-cache-"));
const outDir = join(tempRoot, "workflow-build");
const stepFilePath = join(tempRoot, "steps", "ping.ts");
diff --git a/packages/eve/src/internal/workflow-bundle/builder.ts b/packages/eve/src/internal/workflow-bundle/builder.ts
index b4e3bd681..06e3fb8f7 100644
--- a/packages/eve/src/internal/workflow-bundle/builder.ts
+++ b/packages/eve/src/internal/workflow-bundle/builder.ts
@@ -112,7 +112,7 @@ export class WorkflowBundleBuilder {
const workflowsOutfile = join(this.#outDir, "workflows.mjs");
const { manifest: workflowsManifest } = await this.createWorkflowsBundle({
discoveredEntries,
- // Eve owns dev rebuilds through `dev-authored-source-watcher`.
+ // eve owns dev rebuilds through `dev-authored-source-watcher`.
keepInterimBundleContext: false,
outfile: workflowsOutfile,
bundleFinalOutput: false,
diff --git a/packages/eve/src/internal/workflow-bundle/nitro-step-entry.scenario.test.ts b/packages/eve/src/internal/workflow-bundle/nitro-step-entry.scenario.test.ts
index 9010b1618..a921a1287 100644
--- a/packages/eve/src/internal/workflow-bundle/nitro-step-entry.scenario.test.ts
+++ b/packages/eve/src/internal/workflow-bundle/nitro-step-entry.scenario.test.ts
@@ -26,7 +26,7 @@ describe("writeNitroStepEntrypoint", () => {
await expect(readFile(outfile, "utf8")).resolves.toBe(
[
- "// Generated by Eve. Do not edit by hand.",
+ "// Generated by eve. Do not edit by hand.",
'import "file:///G:/projects/eve/node_modules/eve/dist/builtins.js";',
"export const __steps_registered = true;",
"",
diff --git a/packages/eve/src/internal/workflow-bundle/nitro-step-entry.ts b/packages/eve/src/internal/workflow-bundle/nitro-step-entry.ts
index bb9bb96f0..3f9a3ba03 100644
--- a/packages/eve/src/internal/workflow-bundle/nitro-step-entry.ts
+++ b/packages/eve/src/internal/workflow-bundle/nitro-step-entry.ts
@@ -52,7 +52,7 @@ export async function writeNitroStepEntrypoint(input: {
stepFiles,
});
const lines = [
- "// Generated by Eve. Do not edit by hand.",
+ "// Generated by eve. Do not edit by hand.",
...importLines,
"export const __steps_registered = true;",
"",
diff --git a/packages/eve/src/internal/workflow-bundle/vercel-workflow-output.ts b/packages/eve/src/internal/workflow-bundle/vercel-workflow-output.ts
index 8dfbf1c43..597e90101 100644
--- a/packages/eve/src/internal/workflow-bundle/vercel-workflow-output.ts
+++ b/packages/eve/src/internal/workflow-bundle/vercel-workflow-output.ts
@@ -117,18 +117,18 @@ export async function copyNitroFunctionDirectory(input: {
}
/**
- * Keeps only Eve-owned Vercel function output and rewrites Eve route function
- * symlinks to a shared Eve-owned server function.
+ * Keeps only eve-owned Vercel function output and rewrites eve route function
+ * symlinks to a shared eve-owned server function.
*
* Nitro emits generic app routes such as `index.func -> ./__server.func` for
- * Eve's standalone landing page. In a multi-service Next.js deployment those
+ * eve's standalone landing page. In a multi-service Next.js deployment those
* root aliases collide with Next's own functions. The Next integration only
- * proxies Eve's `/eve/v1/**` transport routes, so Vercel output should expose
- * those route functions and workflow trigger functions, not Eve's root page.
+ * proxies eve's `/eve/v1/**` transport routes, so Vercel output should expose
+ * those route functions and workflow trigger functions, not eve's root page.
*
* Nitro also dedupes every route function through `__server.func`. Preserve
- * that model by copying the shared target once into the Eve-owned tree and
- * repointing Eve route aliases at it before pruning the root target.
+ * that model by copying the shared target once into the eve-owned tree and
+ * repointing eve route aliases at it before pruning the root target.
*/
export async function normalizeEveVercelFunctionOutput(
outputDir: string,
diff --git a/packages/eve/src/internal/workflow-bundle/workflow-core-shim.ts b/packages/eve/src/internal/workflow-bundle/workflow-core-shim.ts
index 407f560cc..9171c39f7 100644
--- a/packages/eve/src/internal/workflow-bundle/workflow-core-shim.ts
+++ b/packages/eve/src/internal/workflow-bundle/workflow-core-shim.ts
@@ -104,7 +104,7 @@ export function defineHook<T = unknown>(): {
* Sleeps from inside workflow-body code.
*/
export function sleep(): never {
- throw new Error("`sleep()` is not available in Eve workflow body bundles");
+ throw new Error("`sleep()` is not available in eve workflow body bundles");
}
/**
@@ -125,11 +125,11 @@ export function getStepMetadata(): never {
* Options accepted by {@link experimental_setAttributes}.
*
* Mirrors `ExperimentalSetAttributesOptions` from `@workflow/core` so the
- * Eve workflow-body bundle does not have to pull the real type in.
+ * eve workflow-body bundle does not have to pull the real type in.
*/
export interface ExperimentalSetAttributesOptions {
/**
- * Permit attribute keys that start with the reserved `$` prefix. Eve
+ * Permit attribute keys that start with the reserved `$` prefix. eve
* framework code passes `true` so it can write the `$eve.*` namespace;
* authored agent code never calls this shim directly.
*/
@@ -137,7 +137,7 @@ export interface ExperimentalSetAttributesOptions {
}
/**
- * Workflow-body implementation of `experimental_setAttributes` for the Eve
+ * Workflow-body implementation of `experimental_setAttributes` for the eve
* bundle. Mirrors the dispatch path of `@workflow/core`'s workflow-body
* export (`dist/workflow/set-attributes.js`):
*
@@ -145,7 +145,7 @@ export interface ExperimentalSetAttributesOptions {
* runtime expects (`undefined` -> `null` to clear a key).
* 2. Resolve the workflow runtime's step dispatcher from
* `globalThis[Symbol.for("WORKFLOW_USE_STEP")]` (the same global symbol
- * Eve already relies on to materialize `"use step"` proxies).
+ * eve already relies on to materialize `"use step"` proxies).
* 3. Invoke the builtin `__builtin_set_attributes` step with the changes,
* which the runtime records on the active workflow run.
*
diff --git a/packages/eve/src/internal/workflow/builtins.ts b/packages/eve/src/internal/workflow/builtins.ts
index 6c00e0c12..48458d972 100644
--- a/packages/eve/src/internal/workflow/builtins.ts
+++ b/packages/eve/src/internal/workflow/builtins.ts
@@ -1,8 +1,8 @@
/**
- * Built-in Workflow response body steps used by Eve-owned workflow bundles.
+ * Built-in Workflow response body steps used by eve-owned workflow bundles.
*
* These mirror Workflow's tiny `workflow/internal/builtins` module without
- * requiring Eve to depend on Workflow's umbrella package.
+ * requiring eve to depend on Workflow's umbrella package.
*/
export async function __builtin_response_array_buffer(
this: Request | Response,
@@ -40,7 +40,7 @@ function formatUnknownError(error: unknown): string {
* dispatches into the workflow runtime with the step id
* `"__builtin_set_attributes"`; the runtime walks the deployment's step
* registry to resolve it, so the step has to live inside an
- * Eve-vendored builtins module that the registry visits. The Eve bundler
+ * eve-vendored builtins module that the registry visits. The eve bundler
* already pulls this file in via `resolveWorkflowModulePath("workflow/internal/builtins")`,
* so adding the function here is sufficient to register it.
*
diff --git a/packages/eve/src/protocol/message.ts b/packages/eve/src/protocol/message.ts
index 17215bc7d..f695a3279 100644
--- a/packages/eve/src/protocol/message.ts
+++ b/packages/eve/src/protocol/message.ts
@@ -13,7 +13,7 @@ export const EVE_MESSAGE_STREAM_FORMAT = "ndjson";
export const EVE_MESSAGE_STREAM_VERSION = "16";
/**
- * Eve-owned finish reason for one completed assistant step.
+ * eve-owned finish reason for one completed assistant step.
*
* `tool-calls` is the only non-terminal assistant step in the current
* tool-loop harness. All other values indicate the assistant step ended the
@@ -73,7 +73,7 @@ export interface SubagentSessionInvocationMetadata {
* Runtime identity metadata attached to the `session.started` event.
*
* The server populates this at run time so remote eval processes and
- * reporters receive authoritative metadata about the Eve instance
+ * reporters receive authoritative metadata about the eve instance
* serving the run.
*/
export interface RuntimeIdentity {
diff --git a/packages/eve/src/protocol/routes.ts b/packages/eve/src/protocol/routes.ts
index e1b3faf1e..4554f387b 100644
--- a/packages/eve/src/protocol/routes.ts
+++ b/packages/eve/src/protocol/routes.ts
@@ -1,5 +1,5 @@
/**
- * Stable framework-owned route prefix reserved for Eve's runtime transport
+ * Stable framework-owned route prefix reserved for eve's runtime transport
* surfaces.
*/
export const EVE_ROUTE_PREFIX = "/eve/v1";
@@ -12,7 +12,7 @@ export const EVE_HEALTH_ROUTE_PATH = `${EVE_ROUTE_PREFIX}/health`;
/**
* Stable framework-owned route exposing the JSON inspection payload for
* the current agent. Nitro registers this route with the application
- * surface, and the handler uses the same default auth chain as the Eve
+ * surface, and the handler uses the same default auth chain as the eve
* channel: local development accepts loopback requests, while deployed
* Vercel targets require OIDC.
*/
@@ -83,7 +83,7 @@ export function createEveDevDispatchSchedulePath(scheduleId: string): string {
* via `resumeHook(token, payload)`.
*
* The route is unauthenticated by design: an OAuth IdP follows this URL
- * via a 3xx redirect from the user's browser with no Eve credentials
+ * via a 3xx redirect from the user's browser with no eve credentials
* attached. The token is the unguessable capability that authorizes the
* resume; anyone who has it can deliver the callback payload, which is
* exactly what the IdP needs to do.
diff --git a/packages/eve/src/public/agents/auth.ts b/packages/eve/src/public/agents/auth.ts
index b56cf5f11..d18bc0a19 100644
--- a/packages/eve/src/public/agents/auth.ts
+++ b/packages/eve/src/public/agents/auth.ts
@@ -13,7 +13,7 @@ export type OutboundAuthFn = () => Promise<{
}>;
/**
- * Eve-owned mirror of the `@vercel/oidc` token lookup options forwarded to
+ * eve-owned mirror of the `@vercel/oidc` token lookup options forwarded to
* {@link vercelOidc}.
*/
export interface VercelOidcOptions {
diff --git a/packages/eve/src/public/channels/auth.test.ts b/packages/eve/src/public/channels/auth.test.ts
index 571ffb5c2..d29f8e531 100644
--- a/packages/eve/src/public/channels/auth.test.ts
+++ b/packages/eve/src/public/channels/auth.test.ts
@@ -709,7 +709,7 @@ describe("verifyVercelOidc", () => {
owner: "stranger",
owner_id: "team_stranger",
project: "stranger-agent",
- // Different project ID than the deployed Eve app.
+ // Different project ID than the deployed eve app.
project_id: "prj_other",
sub: "owner:stranger:project:stranger-agent:environment:production",
});
diff --git a/packages/eve/src/public/channels/auth.ts b/packages/eve/src/public/channels/auth.ts
index f3ca2637b..396eb131b 100644
--- a/packages/eve/src/public/channels/auth.ts
+++ b/packages/eve/src/public/channels/auth.ts
@@ -701,7 +701,7 @@ export interface VerifyVercelOidcOptions {
* - Tokens with an `external_sub` claim authenticate as
* `principalType: "user"` when they match the current `VERCEL_PROJECT_ID`
* (if set) and `VERCEL_TARGET_ENV` / `VERCEL_ENV` (if set). `external_sub`
- * becomes the Eve subject, `external_iss` or `connector_id` the Eve issuer
+ * becomes the eve subject, `external_iss` or `connector_id` the eve issuer
* when present, and string-valued OIDC profile claims (`name`, `picture`,
* `email`) are exposed as auth attributes.
* - Tokens from other Vercel projects are accepted **only** when their `sub`
diff --git a/packages/eve/src/public/channels/discord/api.ts b/packages/eve/src/public/channels/discord/api.ts
index 1f4a515f1..3ec334e46 100644
--- a/packages/eve/src/public/channels/discord/api.ts
+++ b/packages/eve/src/public/channels/discord/api.ts
@@ -1,6 +1,6 @@
/**
* Minimal Discord REST API wrapper. The channel talks directly to Discord's
- * JSON HTTP API rather than exposing a third-party SDK through Eve.
+ * JSON HTTP API rather than exposing a third-party SDK through eve.
*/
import { parseJsonObject, type JsonObject } from "#shared/json.js";
@@ -210,7 +210,7 @@ export async function createDiscordFollowupMessage(
}
/**
- * JSON body for the Discord message endpoints Eve calls. When
+ * JSON body for the Discord message endpoints eve calls. When
* `allowed_mentions` is omitted, channel write helpers default it to
* {@link DISCORD_NO_MENTIONS} (no pings); set it explicitly to allow mentions.
*/
diff --git a/packages/eve/src/public/channels/discord/discordChannel.ts b/packages/eve/src/public/channels/discord/discordChannel.ts
index 3ab7c1ef2..3c4ccf632 100644
--- a/packages/eve/src/public/channels/discord/discordChannel.ts
+++ b/packages/eve/src/public/channels/discord/discordChannel.ts
@@ -90,7 +90,7 @@ export interface DiscordChannelState {
/** Discord channel credentials. */
export interface DiscordChannelCredentials extends DiscordCredentials {
- /** Custom inbound webhook verifier. When supplied, Eve skips the `DISCORD_PUBLIC_KEY` fallback and delegates verification to it. */
+ /** Custom inbound webhook verifier. When supplied, eve skips the `DISCORD_PUBLIC_KEY` fallback and delegates verification to it. */
readonly webhookVerifier?: DiscordWebhookVerifier;
}
@@ -167,7 +167,7 @@ export interface DiscordHandle {
readonly applicationId: string | undefined;
/** Discord channel id. */
readonly channelId: string;
- /** Current Eve conversation id, usually the Discord anchor message id. */
+ /** Current eve conversation id, usually the Discord anchor message id. */
readonly conversationId: string;
/** Discord guild id when known. */
readonly guildId: string | undefined;
diff --git a/packages/eve/src/public/channels/discord/hitl.ts b/packages/eve/src/public/channels/discord/hitl.ts
index 0fbee79e0..2458f2166 100644
--- a/packages/eve/src/public/channels/discord/hitl.ts
+++ b/packages/eve/src/public/channels/discord/hitl.ts
@@ -1,7 +1,7 @@
/**
* Discord HITL component rendering + decode helpers.
*
- * Discord components carry a `custom_id` with a 100-character cap. Eve
+ * Discord components carry a `custom_id` with a 100-character cap. eve
* encodes only the request id and, for buttons, the selected option id.
*/
@@ -165,8 +165,8 @@ export function isDiscordFreeformComponent(customId: string): boolean {
}
/**
- * Decodes an Eve HITL component interaction into input responses. Empty array
- * if the custom id is not an Eve HITL id; otherwise one response from the
+ * Decodes an eve HITL component interaction into input responses. Empty array
+ * if the custom id is not an eve HITL id; otherwise one response from the
* encoded option id (buttons) or the first selected value (selects).
*/
export function deriveComponentInputResponses(
@@ -188,7 +188,7 @@ export function deriveComponentInputResponses(
}
/**
- * Decodes an Eve freeform modal submission into a single text input response.
+ * Decodes an eve freeform modal submission into a single text input response.
* Empty array unless the custom id matches the freeform prefix and the freeform
* text field is present.
*/
diff --git a/packages/eve/src/public/channels/discord/verify.ts b/packages/eve/src/public/channels/discord/verify.ts
index 7abdb231d..8702c8b69 100644
--- a/packages/eve/src/public/channels/discord/verify.ts
+++ b/packages/eve/src/public/channels/discord/verify.ts
@@ -20,7 +20,7 @@ export type DiscordPublicKey = string | (() => string | Promise<string>);
/**
* Caller-supplied inbound webhook verifier. Replaces Ed25519 verification
* when an integration authenticates forwarded webhooks before they reach
- * Eve. Receives the request and raw body.
+ * eve. Receives the request and raw body.
*
* Return a falsy value to reject the request. Return a string to accept it
* and use that string as the (possibly rewritten) body. Return any other
diff --git a/packages/eve/src/public/channels/eve.ts b/packages/eve/src/public/channels/eve.ts
index 3616ad71c..226fc6dcc 100644
--- a/packages/eve/src/public/channels/eve.ts
+++ b/packages/eve/src/public/channels/eve.ts
@@ -35,7 +35,7 @@ import { parseJsonObject, type JsonObject } from "#shared/json.js";
const log = createLogger("eve.channel");
/**
- * Event-handler channel context exposed by `eveChannel({ events })`. The default Eve HTTP channel
+ * Event-handler channel context exposed by `eveChannel({ events })`. The default eve HTTP channel
* has no platform-specific state, so handlers receive session continuation operations plus the `SessionContext` third arg from {@link ChannelEvents}.
*/
export type EveEventContext = ChannelSessionOps;
@@ -43,7 +43,7 @@ export type EveEventContext = ChannelSessionOps;
/** Runtime stream-event handlers supported by `eveChannel({ events })`. */
export type EveChannelEvents = ChannelEvents<EveEventContext>;
-/** Low-level Eve HTTP handle exposed to `eveChannel({ onMessage })`. */
+/** Low-level eve HTTP handle exposed to `eveChannel({ onMessage })`. */
export interface EveHandle {
/** Route-auth result for the request; `onMessage` chooses session auth by returning `{ auth }`. */
readonly caller: SessionAuthContext | null;
@@ -94,7 +94,7 @@ export interface EveChannelInput {
*/
readonly uploadPolicy?: UploadPolicyInput;
/**
- * Pre-dispatch hook for inbound Eve HTTP messages. Runs after route auth and body
+ * Pre-dispatch hook for inbound eve HTTP messages. Runs after route auth and body
* parsing, before runtime dispatch.
*/
readonly onMessage?: (
@@ -102,7 +102,7 @@ export interface EveChannelInput {
message: string | UserContent,
) => EveMessageResultOrPromise;
/**
- * Runtime stream-event handlers for the default Eve HTTP channel. Handlers receive
+ * Runtime stream-event handlers for the default eve HTTP channel. Handlers receive
* the event data, {@link EveEventContext}, and `SessionContext` (the same shape as custom channels).
*/
readonly events?: EveChannelEvents;
@@ -116,7 +116,7 @@ export interface EveChannelInput {
export interface EveChannel extends Channel {}
/**
- * Builds the default Eve HTTP channel: a {@link defineChannel} instance serving the
+ * Builds the default eve HTTP channel: a {@link defineChannel} instance serving the
* built-in `/eve/v1` routes (POST creates a session, POST delivers a follow-up, GET
* streams a session's NDJSON event feed). Every route runs {@link EveChannelInput.auth}
* via {@link routeAuth} before dispatching. Default-export the result as your
diff --git a/packages/eve/src/public/channels/github/api.ts b/packages/eve/src/public/channels/github/api.ts
index 638e73f3d..dadf8b9ef 100644
--- a/packages/eve/src/public/channels/github/api.ts
+++ b/packages/eve/src/public/channels/github/api.ts
@@ -1,7 +1,7 @@
/**
* Minimal GitHub REST/GraphQL wrapper used by the GitHub channel.
*
- * Eve exposes channel-owned helper types and functions instead of leaking a
+ * eve exposes channel-owned helper types and functions instead of leaking a
* third-party SDK through public channel APIs.
*/
diff --git a/packages/eve/src/public/channels/github/defaults.ts b/packages/eve/src/public/channels/github/defaults.ts
index 0c3eec377..76d4072da 100644
--- a/packages/eve/src/public/channels/github/defaults.ts
+++ b/packages/eve/src/public/channels/github/defaults.ts
@@ -20,7 +20,7 @@ import type { SessionContext } from "#public/definitions/callback-context.js";
const log = createLogger("github.defaults");
/**
- * Projects a GitHub webhook actor into an Eve {@link SessionAuthContext}. Sets `principalId` to
+ * Projects a GitHub webhook actor into an eve {@link SessionAuthContext}. Sets `principalId` to
* `github:<sender.id>`, `principalType` to `"service"` for bot senders and `"user"` otherwise, and
* copies conversation and repository metadata into `attributes`. Reuse it when composing a custom
* `onComment` hook.
diff --git a/packages/eve/src/public/channels/github/inbound.ts b/packages/eve/src/public/channels/github/inbound.ts
index 13a04d6c0..4d0be717a 100644
--- a/packages/eve/src/public/channels/github/inbound.ts
+++ b/packages/eve/src/public/channels/github/inbound.ts
@@ -242,7 +242,7 @@ export function extractGitHubCommentTrigger(input: {
return { kind: "mention", message, token: mention[0] };
}
-/** Parses GitHub webhook headers and body into an Eve-owned event shape. */
+/** Parses GitHub webhook headers and body into an eve-owned event shape. */
export function parseGitHubWebhookEvent(input: {
readonly body: string;
readonly contentType?: string;
diff --git a/packages/eve/src/public/channels/index.ts b/packages/eve/src/public/channels/index.ts
index 31f04cfe6..e3a1ded98 100644
--- a/packages/eve/src/public/channels/index.ts
+++ b/packages/eve/src/public/channels/index.ts
@@ -49,7 +49,7 @@ export type InstrumentationChannelMetadata = Readonly<Record<string, unknown>>;
* Channel metadata projections keyed by channel kind.
*
* Built-in channel packages ship declaration-merged entries (e.g. Slack
- * ships `"channel:slack"`). The Eve compiler generates entries for
+ * ships `"channel:slack"`). The eve compiler generates entries for
* authored channels at build time.
*/
export interface ChannelMetadataMap {
@@ -76,7 +76,7 @@ export type InstrumentationChannelKind = keyof ChannelMetadataMap;
/**
* Channel values keyed by path-derived channel kind.
*
- * Entries are generated by the Eve compiler for authored channels.
+ * Entries are generated by the eve compiler for authored channels.
* Built-in channel entries are declared inline above.
* Used by {@link isChannel} to resolve a channel value to its kind string.
*/
diff --git a/packages/eve/src/public/channels/linear/auth.ts b/packages/eve/src/public/channels/linear/auth.ts
index 28ebffa15..b29f5b1a1 100644
--- a/packages/eve/src/public/channels/linear/auth.ts
+++ b/packages/eve/src/public/channels/linear/auth.ts
@@ -1,7 +1,7 @@
/**
* Linear channel credential resolvers.
*
- * Eve keeps Linear access tokens out of model-visible context. Channel helpers
+ * eve keeps Linear access tokens out of model-visible context. Channel helpers
* resolve them only when verifying inbound webhooks or calling Linear's
* GraphQL API to emit Agent Activities.
*/
diff --git a/packages/eve/src/public/channels/linear/hitl.ts b/packages/eve/src/public/channels/linear/hitl.ts
index ce02714d5..0650f6f37 100644
--- a/packages/eve/src/public/channels/linear/hitl.ts
+++ b/packages/eve/src/public/channels/linear/hitl.ts
@@ -2,7 +2,7 @@ import { resolveTextToResponses } from "#channel/resolve-text.js";
import type { LinearAgentActivityRecord } from "#public/channels/linear/api.js";
import type { InputOption, InputRequest, InputResponse } from "#runtime/input/types.js";
-/** Hidden marker embedded in Eve-created Linear elicitation bodies. */
+/** Hidden marker embedded in eve-created Linear elicitation bodies. */
export const LINEAR_HITL_MARKER_PREFIX = "<!-- eve-input:";
export const LINEAR_HITL_MARKER_SUFFIX = " -->";
@@ -18,14 +18,14 @@ interface LinearStoredInputRequest {
requestId: string;
}
-/** Renders Eve input requests as one Linear elicitation body. */
+/** Renders eve input requests as one Linear elicitation body. */
export function renderLinearInputRequests(requests: readonly InputRequest[]): string {
const marker = encodeLinearHitlMarker(requests.map(storableRequest));
const rendered = requests.map(renderLinearInputRequest).join("\n\n");
return `${rendered}\n\n${marker}`;
}
-/** Resolves a Linear user prompt against the latest Eve-created elicitation marker. */
+/** Resolves a Linear user prompt against the latest eve-created elicitation marker. */
export function resolveLinearPromptInputResponses(input: {
readonly activities: readonly LinearAgentActivityRecord[];
readonly body: string;
@@ -35,7 +35,7 @@ export function resolveLinearPromptInputResponses(input: {
return resolveTextToResponses(input.body, marker.requests.map(toInputRequest));
}
-/** Strips Eve's hidden HITL marker from a body before user-facing assertions/logging. */
+/** Strips eve's hidden HITL marker from a body before user-facing assertions/logging. */
export function stripLinearHitlMarker(body: string): string {
const start = body.indexOf(LINEAR_HITL_MARKER_PREFIX);
if (start === -1) return body;
diff --git a/packages/eve/src/public/channels/linear/inbound.ts b/packages/eve/src/public/channels/linear/inbound.ts
index b4e03160b..2de103542 100644
--- a/packages/eve/src/public/channels/linear/inbound.ts
+++ b/packages/eve/src/public/channels/linear/inbound.ts
@@ -157,7 +157,7 @@ export function messageFromLinearAgentSessionEvent(event: LinearAgentSessionEven
return "Linear agent session started.";
}
-/** Formats Linear issue/session context as an Eve context block. */
+/** Formats Linear issue/session context as an eve context block. */
export function formatLinearContextBlock(event: LinearAgentSessionEvent): string {
const session = event.agentSession;
const issue = session.issue;
diff --git a/packages/eve/src/public/channels/linear/linearChannel.test.ts b/packages/eve/src/public/channels/linear/linearChannel.test.ts
index d6647b6a2..d72bdd1c9 100644
--- a/packages/eve/src/public/channels/linear/linearChannel.test.ts
+++ b/packages/eve/src/public/channels/linear/linearChannel.test.ts
@@ -180,7 +180,7 @@ describe("linearChannel inbound Agent Session events", () => {
});
});
- it("resolves prompted events into input responses when the latest elicitation has Eve metadata", async () => {
+ it("resolves prompted events into input responses when the latest elicitation has eve metadata", async () => {
const elicitation = renderLinearInputRequests([
makeRequest({
options: [
diff --git a/packages/eve/src/public/channels/linear/verify.ts b/packages/eve/src/public/channels/linear/verify.ts
index 248545fb8..cf09b6955 100644
--- a/packages/eve/src/public/channels/linear/verify.ts
+++ b/packages/eve/src/public/channels/linear/verify.ts
@@ -12,7 +12,7 @@ const log = createLogger("linear.verify");
/**
* Caller-supplied inbound webhook verifier. Use it as an alternative to
* Linear's HMAC secret, for example when a trusted proxy authenticates the
- * request before it reaches Eve.
+ * request before it reaches eve.
*
* - Throw / reject / return falsy: request rejected.
* - Return a string: request accepted and that string replaces the raw body.
diff --git a/packages/eve/src/public/channels/slack/api.test.ts b/packages/eve/src/public/channels/slack/api.test.ts
index a7eeceeee..cd970f2cd 100644
--- a/packages/eve/src/public/channels/slack/api.test.ts
+++ b/packages/eve/src/public/channels/slack/api.test.ts
@@ -311,7 +311,7 @@ describe("SlackThread.refresh", () => {
vi.unstubAllGlobals();
});
- it("hydrates recent messages with the Eve-owned Slack thread shape", async () => {
+ it("hydrates recent messages with the eve-owned Slack thread shape", async () => {
const { thread } = buildSlackBinding({
botToken: "xoxb-test",
channelId: "C01",
diff --git a/packages/eve/src/public/channels/slack/constants.ts b/packages/eve/src/public/channels/slack/constants.ts
index f9436204a..e7c271246 100644
--- a/packages/eve/src/public/channels/slack/constants.ts
+++ b/packages/eve/src/public/channels/slack/constants.ts
@@ -1,7 +1,7 @@
/**
* Default route that `slackChannel({})` mounts on. The scaffold's slack
* setup (`vercel connect attach --trigger-path ...`) must point at this
- * exact path or Connect-forwarded Slack events 404 against the Eve
+ * exact path or Connect-forwarded Slack events 404 against the eve
* framework router.
*/
export const SLACK_CHANNEL_DEFAULT_ROUTE = "/eve/v1/slack";
diff --git a/packages/eve/src/public/channels/teams/api.ts b/packages/eve/src/public/channels/teams/api.ts
index e23ec0882..5affd1c8b 100644
--- a/packages/eve/src/public/channels/teams/api.ts
+++ b/packages/eve/src/public/channels/teams/api.ts
@@ -3,7 +3,7 @@
*
* The native Teams channel talks directly to the Bot Framework Activity
* protocol instead of exposing BotBuilder or Teams SDK objects through
- * Eve public APIs.
+ * eve public APIs.
*/
import { parseJsonObject, type JsonObject } from "#shared/json.js";
@@ -47,7 +47,7 @@ export interface TeamsApiOptions {
readonly fetch?: TeamsFetch;
/**
* Microsoft OAuth host for the client-credentials token flow. Defaults to
- * `https://login.microsoftonline.com`. Eve ignores it when
+ * `https://login.microsoftonline.com`. eve ignores it when
* `credentials.tokenProvider` is set.
*/
readonly loginBaseUrl?: string;
@@ -83,7 +83,7 @@ export interface TeamsMention {
readonly type: "mention";
}
-/** Bot Framework/Teams attachment shape supported by Eve-owned APIs. */
+/** Bot Framework/Teams attachment shape supported by eve-owned APIs. */
export interface TeamsAttachment {
readonly content?: JsonObject;
readonly contentType: string;
@@ -91,7 +91,7 @@ export interface TeamsAttachment {
readonly name?: string;
}
-/** JSON body supported by Teams message endpoints used by Eve. */
+/** JSON body supported by Teams message endpoints used by eve. */
export interface TeamsMessageBody {
readonly attachments?: readonly TeamsAttachment[];
readonly channelData?: JsonObject;
diff --git a/packages/eve/src/public/channels/teams/hitl.ts b/packages/eve/src/public/channels/teams/hitl.ts
index 600f3a767..8e831b6dc 100644
--- a/packages/eve/src/public/channels/teams/hitl.ts
+++ b/packages/eve/src/public/channels/teams/hitl.ts
@@ -1,5 +1,5 @@
/**
- * Teams Adaptive Card rendering and decode helpers for Eve HITL prompts.
+ * Teams Adaptive Card rendering and decode helpers for eve HITL prompts.
*/
import type { InputRequest, InputResponse } from "#runtime/input/types.js";
@@ -21,7 +21,7 @@ import { parseJsonObject } from "#shared/json.js";
/** Adaptive Card attachment content type used by Teams. */
export const TEAMS_ADAPTIVE_CARD_CONTENT_TYPE = "application/vnd.microsoft.card.adaptive";
-/** Hidden data property used by Eve HITL Adaptive Card actions. */
+/** Hidden data property used by eve HITL Adaptive Card actions. */
export const TEAMS_HITL_DATA_KEY = "eve_input";
/** ChoiceSet input id used for select-style HITL requests. */
@@ -104,13 +104,13 @@ export function renderAnsweredInputRequestMessage(input: {
};
}
-/** Returns true when a Teams activity carries an Eve HITL submit payload. */
+/** Returns true when a Teams activity carries an eve HITL submit payload. */
export function isTeamsInputResponseActivity(activity: TeamsActivity): boolean {
return deriveTeamsInputResponses(activity).length > 0;
}
/**
- * Decodes the Eve HITL submit payload from a Teams activity. Returns a single
+ * Decodes the eve HITL submit payload from a Teams activity. Returns a single
* `InputResponse` (option selection, freeform text, or a bare requestId
* acknowledgement), or an empty array when the activity has no recognizable
* HITL payload or requestId.
diff --git a/packages/eve/src/public/channels/teams/inbound.test.ts b/packages/eve/src/public/channels/teams/inbound.test.ts
index cff8ade37..e7f7d6319 100644
--- a/packages/eve/src/public/channels/teams/inbound.test.ts
+++ b/packages/eve/src/public/channels/teams/inbound.test.ts
@@ -21,7 +21,7 @@ describe("Teams inbound parsing", () => {
const activity = parseTeamsActivity(
messageActivity({
conversationType: "channel",
- text: "<at>Eve Bot</at> <b>status</b><br>please",
+ text: "<at>eve Bot</at> <b>status</b><br>please",
}),
);
expect(activity).toMatchObject({
@@ -76,14 +76,14 @@ function messageActivity(input: {
conversation: { conversationType: input.conversationType, id: "CONV" },
entities: [
{
- mentioned: { id: "BOT", name: "Eve Bot" },
- text: "<at>Eve Bot</at>",
+ mentioned: { id: "BOT", name: "eve Bot" },
+ text: "<at>eve Bot</at>",
type: "mention",
},
],
from: { id: "USER", name: "Ada" },
id: "ACTIVITY_1",
- recipient: { id: "BOT", name: "Eve Bot" },
+ recipient: { id: "BOT", name: "eve Bot" },
serviceUrl: "https://smba.example.test/teams",
text: input.text ?? "hello",
textFormat: "xml",
diff --git a/packages/eve/src/public/channels/teams/limits.ts b/packages/eve/src/public/channels/teams/limits.ts
index d3733b7c7..bd10917c3 100644
--- a/packages/eve/src/public/channels/teams/limits.ts
+++ b/packages/eve/src/public/channels/teams/limits.ts
@@ -1,10 +1,10 @@
-/** Maximum Teams Adaptive Card text block length used by Eve renderers. */
+/** Maximum Teams Adaptive Card text block length used by eve renderers. */
export const TEAMS_ADAPTIVE_CARD_TEXT_MAX_LENGTH = 4000;
-/** Maximum Teams Adaptive Card button title length used by Eve renderers. */
+/** Maximum Teams Adaptive Card button title length used by eve renderers. */
export const TEAMS_ADAPTIVE_CARD_ACTION_TITLE_MAX_LENGTH = 80;
-/** Maximum Teams Adaptive Card choice title length used by Eve renderers. */
+/** Maximum Teams Adaptive Card choice title length used by eve renderers. */
export const TEAMS_ADAPTIVE_CARD_CHOICE_TITLE_MAX_LENGTH = 100;
/** Maximum number of direct Adaptive Card actions rendered for one request. */
diff --git a/packages/eve/src/public/channels/teams/teamsChannel.test.ts b/packages/eve/src/public/channels/teams/teamsChannel.test.ts
index da272a6dc..69c1f5ee9 100644
--- a/packages/eve/src/public/channels/teams/teamsChannel.test.ts
+++ b/packages/eve/src/public/channels/teams/teamsChannel.test.ts
@@ -181,12 +181,12 @@ function messageActivity(input: { readonly conversationType: string }): Record<s
...baseActivity(input),
entities: [
{
- mentioned: { id: "BOT", name: "Eve Bot" },
- text: "<at>Eve Bot</at>",
+ mentioned: { id: "BOT", name: "eve Bot" },
+ text: "<at>eve Bot</at>",
type: "mention",
},
],
- text: input.conversationType === "personal" ? "hello" : "<at>Eve Bot</at> hello",
+ text: input.conversationType === "personal" ? "hello" : "<at>eve Bot</at> hello",
textFormat: "xml",
type: "message",
};
@@ -202,7 +202,7 @@ function baseActivity(input: { readonly conversationType: string }): Record<stri
conversation: { conversationType: input.conversationType, id: "CONV" },
from: { id: "USER", name: "Ada" },
id: "ACTIVITY_1",
- recipient: { id: "BOT", name: "Eve Bot" },
+ recipient: { id: "BOT", name: "eve Bot" },
serviceUrl: "https://smba.example.test/teams",
};
}
diff --git a/packages/eve/src/public/channels/teams/verify.ts b/packages/eve/src/public/channels/teams/verify.ts
index aca1f3734..e64917b09 100644
--- a/packages/eve/src/public/channels/teams/verify.ts
+++ b/packages/eve/src/public/channels/teams/verify.ts
@@ -1,7 +1,7 @@
/**
* Microsoft Teams inbound Bot Framework request verification.
*
- * Teams sends bot activities through the Bot Connector service. Eve verifies
+ * Teams sends bot activities through the Bot Connector service. eve verifies
* the bearer JWT against Bot Connector OpenID keys and the bot's Microsoft
* app id before dispatching any activity to the runtime.
*/
@@ -22,7 +22,7 @@ const BOT_CONNECTOR_ISSUER = "https://api.botframework.com";
/**
* Caller-supplied inbound webhook verifier. Replaces Bot Connector JWT
* verification when a trusted integration authenticates forwarded requests
- * before they reach Eve.
+ * before they reach eve.
*
* Return a falsy value to reject the request (verification throws), a string
* to accept and use that string as the verified body, or any other truthy
diff --git a/packages/eve/src/public/channels/telegram/api.ts b/packages/eve/src/public/channels/telegram/api.ts
index 664b08443..531cb38ad 100644
--- a/packages/eve/src/public/channels/telegram/api.ts
+++ b/packages/eve/src/public/channels/telegram/api.ts
@@ -2,7 +2,7 @@
* Minimal Telegram Bot API wrapper for the Telegram channel.
*
* The channel talks directly to Telegram's JSON HTTP API instead of
- * exposing a third-party SDK through Eve public surfaces.
+ * exposing a third-party SDK through eve public surfaces.
*/
import { parseJsonObject, type JsonObject } from "#shared/json.js";
diff --git a/packages/eve/src/public/channels/telegram/hitl.ts b/packages/eve/src/public/channels/telegram/hitl.ts
index c25212250..a2eb37154 100644
--- a/packages/eve/src/public/channels/telegram/hitl.ts
+++ b/packages/eve/src/public/channels/telegram/hitl.ts
@@ -2,13 +2,13 @@
* Telegram HITL inline keyboard rendering and compact callback decode helpers.
*
* Telegram limits `InlineKeyboardButton.callback_data` to 64 bytes, so
- * Eve stores compact callback ids in durable channel state and remaps
+ * eve stores compact callback ids in durable channel state and remaps
* them back to full input responses inside the channel deliver hook.
*/
import type { InputRequest, InputResponse } from "#runtime/input/types.js";
-/** Prefix used in Telegram callback_data values generated by Eve. */
+/** Prefix used in Telegram callback_data values generated by eve. */
export const TELEGRAM_HITL_CALLBACK_PREFIX = "eve:";
/** Synthetic request id prefix sent through `send()` for callback queries. */
@@ -122,7 +122,7 @@ export function isTelegramSyntheticResponse(response: InputResponse): boolean {
);
}
-/** Remaps compact Telegram callback/reply ids into real Eve input responses. */
+/** Remaps compact Telegram callback/reply ids into real eve input responses. */
export function resolveTelegramInputResponses(
state: TelegramHitlState,
responses: readonly InputResponse[],
diff --git a/packages/eve/src/public/channels/telegram/verify.ts b/packages/eve/src/public/channels/telegram/verify.ts
index 6356f5a3b..bb07b1812 100644
--- a/packages/eve/src/public/channels/telegram/verify.ts
+++ b/packages/eve/src/public/channels/telegram/verify.ts
@@ -19,7 +19,7 @@ export type TelegramWebhookSecretToken = string | (() => string | Promise<string
/**
* Caller-supplied inbound webhook verifier. Use it instead of
* Telegram's secret-token header when an integration authenticates
- * forwarded webhooks before they reach Eve.
+ * forwarded webhooks before they reach eve.
*
* The return value selects how the channel handles the request: return a
* falsy value to reject the request, a string to accept it and use that
diff --git a/packages/eve/src/public/channels/twilio/api.ts b/packages/eve/src/public/channels/twilio/api.ts
index cf221fe25..1a8b48198 100644
--- a/packages/eve/src/public/channels/twilio/api.ts
+++ b/packages/eve/src/public/channels/twilio/api.ts
@@ -3,7 +3,7 @@
*
* Requests use Twilio's normal `application/x-www-form-urlencoded`
* body encoding and HTTP Basic auth. No Twilio SDK dependency is
- * required or exposed through Eve public APIs.
+ * required or exposed through eve public APIs.
*/
import { resolveTwilioAuthToken, type TwilioAuthToken } from "#public/channels/twilio/verify.js";
diff --git a/packages/eve/src/public/context/index.ts b/packages/eve/src/public/context/index.ts
index 13d237483..9e0c10674 100644
--- a/packages/eve/src/public/context/index.ts
+++ b/packages/eve/src/public/context/index.ts
@@ -2,7 +2,7 @@
* Runtime context helpers for authored code.
*
* These APIs work only inside active authored runtime execution such as
- * tools and other Eve-invoked callbacks.
+ * tools and other eve-invoked callbacks.
*
* @example
* ```ts
diff --git a/packages/eve/src/public/definitions/defineChannel.test.ts b/packages/eve/src/public/definitions/defineChannel.test.ts
index 081a87d5e..c72c72179 100644
--- a/packages/eve/src/public/definitions/defineChannel.test.ts
+++ b/packages/eve/src/public/definitions/defineChannel.test.ts
@@ -48,7 +48,7 @@ describe("defineChannel", () => {
expect(adapter.fetchFile).toBeUndefined();
});
- it("declares websocket routes with an Eve-owned route discriminator", () => {
+ it("declares websocket routes with an eve-owned route discriminator", () => {
const channel = defineChannel({
routes: [
WS("/ws", () => ({
diff --git a/packages/eve/src/public/definitions/defineChannel.ts b/packages/eve/src/public/definitions/defineChannel.ts
index d5424012e..7d4a5d76d 100644
--- a/packages/eve/src/public/definitions/defineChannel.ts
+++ b/packages/eve/src/public/definitions/defineChannel.ts
@@ -116,7 +116,7 @@ export interface ChannelDefinition<
/**
* Builds the per-step channel context handed to `events` and `deliver`.
* Receives the live {@link SessionHandle}, so a factory can close over it to
- * register late-bound callbacks. Eve writes state mutations made inside the
+ * register late-bound callbacks. eve writes state mutations made inside the
* returned context back through `adapter.state`.
*
* Return the channel-owned context (thread handles, API clients, etc.). The
@@ -143,7 +143,7 @@ export interface ChannelDefinition<
* Channel-owned metadata exposed to instrumentation callbacks. This is the
* channel's public observability surface, not a dump of durable adapter state,
* so keep it small. Return an object of JSON primitives, arrays, and plain
- * objects: Eve omits `undefined` properties and drops projections containing
+ * objects: eve omits `undefined` properties and drops projections containing
* values such as `Date` or `Map`.
*/
readonly metadata?: (state: NonNullable<TState>) => TMetadata;
diff --git a/packages/eve/src/public/definitions/hook.ts b/packages/eve/src/public/definitions/hook.ts
index 14c765cf2..ebac88150 100644
--- a/packages/eve/src/public/definitions/hook.ts
+++ b/packages/eve/src/public/definitions/hook.ts
@@ -46,7 +46,7 @@ export type StreamEventHooks = {
* Public hook definition authored in `agent/hooks/*.ts`.
*
* Hook files declare stream-event subscribers (under `events:`) that
- * fire after Eve has accepted and durably recorded each event.
+ * fire after eve has accepted and durably recorded each event.
* Handlers are observe-only: they cannot inject model context. To
* contribute runtime model messages, use `defineDynamic` +
* `defineInstructions` in `agent/instructions/`.
diff --git a/packages/eve/src/public/definitions/remote-agent.ts b/packages/eve/src/public/definitions/remote-agent.ts
index 6878bfd26..d928d3f1a 100644
--- a/packages/eve/src/public/definitions/remote-agent.ts
+++ b/packages/eve/src/public/definitions/remote-agent.ts
@@ -5,7 +5,7 @@ import { EVE_CREATE_SESSION_ROUTE_PATH } from "#protocol/routes.js";
import type { JsonObject } from "#shared/json.js";
/**
- * Public definition for a remote Eve agent. The compiler lowers it to a
+ * Public definition for a remote eve agent. The compiler lowers it to a
* subagent tool.
*/
export interface RemoteAgentDefinition {
@@ -24,18 +24,18 @@ export interface RemoteAgentDefinition {
*/
readonly outputSchema?: StandardJSONSchemaV1<unknown, unknown> | JsonObject;
/**
- * Route Eve appends to `url` for the create-session request. Defaults to the
+ * Route eve appends to `url` for the create-session request. Defaults to the
* framework create-session route (`/eve/v1/session`).
*/
readonly path: string;
/**
- * Base URL of the remote Eve deployment to call.
+ * Base URL of the remote eve deployment to call.
*/
readonly url: string;
}
/**
- * Authored input that {@link defineRemoteAgent} accepts. Eve derives identity
+ * Authored input that {@link defineRemoteAgent} accepts. eve derives identity
* from the file path under `agent/subagents/`; authored definitions do not
* carry a `name` field.
*/
@@ -44,7 +44,7 @@ export type RemoteAgentDefinitionInput = Omit<RemoteAgentDefinition, "kind" | "p
};
/**
- * Defines a remote Eve agent that the parent can call as a subagent tool. The
+ * Defines a remote eve agent that the parent can call as a subagent tool. The
* compiler lowers it at compile time from the file path under `agent/subagents/`.
*
* Stamps `kind: "remote"` and, when `path` is omitted, defaults it to the
diff --git a/packages/eve/src/public/definitions/sandbox.ts b/packages/eve/src/public/definitions/sandbox.ts
index 0398e141c..66897acea 100644
--- a/packages/eve/src/public/definitions/sandbox.ts
+++ b/packages/eve/src/public/definitions/sandbox.ts
@@ -29,7 +29,7 @@ export type {
/**
* The shape passed to {@link defineSandbox}: a discriminated union over
* whether a `bootstrap` hook is present. `backend` is optional here (it is
- * required on the shared base): when omitted, Eve substitutes
+ * required on the shared base): when omitted, eve substitutes
* `defaultBackend()` at runtime. `BO`/`SO` type the options for the
* bootstrap-use and session-use functions respectively.
*/
diff --git a/packages/eve/src/public/definitions/source.ts b/packages/eve/src/public/definitions/source.ts
index c6f231ce5..6daa32ac3 100644
--- a/packages/eve/src/public/definitions/source.ts
+++ b/packages/eve/src/public/definitions/source.ts
@@ -1,9 +1,9 @@
/**
- * Supported runtime contract for one module-authored Eve definition.
+ * Supported runtime contract for one module-authored eve definition.
*
* Module-backed authored sources may export the public definition directly or
* export a zero-argument factory that returns the definition synchronously or
- * asynchronously when Eve loads the module in Node.js at runtime.
+ * asynchronously when eve loads the module in Node.js at runtime.
*/
export type ModuleDefinitionExport<TDefinition> =
| TDefinition
diff --git a/packages/eve/src/public/definitions/state.test.ts b/packages/eve/src/public/definitions/state.test.ts
index 7c727b391..3ee39aa4e 100644
--- a/packages/eve/src/public/definitions/state.test.ts
+++ b/packages/eve/src/public/definitions/state.test.ts
@@ -11,7 +11,7 @@ describe("defineState", () => {
it("get() throws outside ALS", () => {
const counter = defineState("test.get.throws", () => ({ count: 0 }));
- expect(() => counter.get()).toThrow(/No active Eve context/);
+ expect(() => counter.get()).toThrow(/No active eve context/);
});
it("rejects names using the reserved eve. prefix", () => {
@@ -43,7 +43,7 @@ describe("defineState", () => {
it("update() throws outside ALS", () => {
const counter = defineState("test.update.throws", () => ({ count: 0 }));
- expect(() => counter.update((s) => ({ count: s.count + 1 }))).toThrow(/No active Eve context/);
+ expect(() => counter.update((s) => ({ count: s.count + 1 }))).toThrow(/No active eve context/);
});
it("separate handles with different names are independent", () => {
diff --git a/packages/eve/src/public/definitions/state.ts b/packages/eve/src/public/definitions/state.ts
index afa89094f..a0a5db9d7 100644
--- a/packages/eve/src/public/definitions/state.ts
+++ b/packages/eve/src/public/definitions/state.ts
@@ -5,7 +5,7 @@ import { loadContext } from "#context/container.js";
* Typed handle returned by {@link defineState}. Reads and updates a
* named context slot.
*
- * All operations require an active Eve context (ALS scope) and throw
+ * All operations require an active eve context (ALS scope) and throw
* when called outside one.
*/
export interface StateHandle<T> {
@@ -24,7 +24,7 @@ const RESERVED_STATE_NAME_PREFIX = "eve.";
* The name must not start with the reserved `"eve."` prefix (reserved
* for framework context keys); doing so throws.
*
- * All operations require an active Eve context. Calling `get()` or
+ * All operations require an active eve context. Calling `get()` or
* `update()` outside of tools, hooks, or other framework-managed code
* throws.
*
@@ -43,7 +43,7 @@ const RESERVED_STATE_NAME_PREFIX = "eve.";
export function defineState<T>(name: string, initial: () => T): StateHandle<T> {
if (name.startsWith(RESERVED_STATE_NAME_PREFIX)) {
throw new Error(
- `defineState() name "${name}" uses the reserved "${RESERVED_STATE_NAME_PREFIX}" prefix, which Eve reserves for its own framework context keys (e.g. "eve.channel", "eve.bundle"). Colliding with one silently corrupts context serialization. Use your own namespace, e.g. "my-agent.${name.slice(RESERVED_STATE_NAME_PREFIX.length)}".`,
+ `defineState() name "${name}" uses the reserved "${RESERVED_STATE_NAME_PREFIX}" prefix, which eve reserves for its own framework context keys (e.g. "eve.channel", "eve.bundle"). Colliding with one silently corrupts context serialization. Use your own namespace, e.g. "my-agent.${name.slice(RESERVED_STATE_NAME_PREFIX.length)}".`,
);
}
diff --git a/packages/eve/src/public/instrumentation/index.ts b/packages/eve/src/public/instrumentation/index.ts
index 27b8a1b52..db4a16f50 100644
--- a/packages/eve/src/public/instrumentation/index.ts
+++ b/packages/eve/src/public/instrumentation/index.ts
@@ -89,7 +89,7 @@ export interface InstrumentationModelInput {
}
/**
- * Input passed to `events["step.started"]`. Eve runs the callback after
+ * Input passed to `events["step.started"]`. eve runs the callback after
* building the final model input for this attempt and before constructing
* the AI SDK model call.
*/
@@ -102,7 +102,7 @@ export interface InstrumentationStepStartedEventInput {
}
/**
- * Result of a `step.started` callback. Eve merges `runtimeContext` into the
+ * Result of a `step.started` callback. eve merges `runtimeContext` into the
* AI SDK telemetry span; child spans inherit the values. Keys beginning with
* `eve.` and non-JSON-serializable values are dropped. Return `undefined` to
* contribute no context.
@@ -164,7 +164,7 @@ export interface InstrumentationDefinition {
}
/**
- * Export the result as the default export of `agent/instrumentation.ts`. Eve
+ * Export the result as the default export of `agent/instrumentation.ts`. eve
* reads these settings at server startup and applies them to every AI SDK
* model call. The `setup` callback runs later with the resolved agent name,
* not during `defineInstrumentation` itself.
diff --git a/packages/eve/src/public/next/index.integration.test.ts b/packages/eve/src/public/next/index.integration.test.ts
index ae332821b..a505b1aa0 100644
--- a/packages/eve/src/public/next/index.integration.test.ts
+++ b/packages/eve/src/public/next/index.integration.test.ts
@@ -95,7 +95,7 @@ describe("withEve Vercel config", () => {
).rejects.toThrow();
});
- it("uses an already configured root Eve service prefix", async () => {
+ it("uses an already configured root eve service prefix", async () => {
const appRoot = await createTempAppRoot();
process.chdir(appRoot);
vi.stubEnv("NODE_ENV", "production");
@@ -136,7 +136,7 @@ describe("withEve Vercel config", () => {
});
});
- it("uses an already configured Build Output Eve service prefix", async () => {
+ it("uses an already configured Build Output eve service prefix", async () => {
const appRoot = await createTempAppRoot();
process.chdir(appRoot);
vi.stubEnv("NODE_ENV", "production");
@@ -195,7 +195,7 @@ describe("withEve Vercel config", () => {
});
});
- it("accepts a custom Eve service build command", async () => {
+ it("accepts a custom eve service build command", async () => {
const appRoot = await createTempAppRoot();
process.chdir(appRoot);
await mkdir(join(appRoot, ".vercel"), { recursive: true });
@@ -223,7 +223,7 @@ describe("withEve Vercel config", () => {
});
});
- it("does not start a local Eve build while Next.js is building", async () => {
+ it("does not start a local eve build while Next.js is building", async () => {
const appRoot = await createTempAppRoot();
process.chdir(appRoot);
vi.stubEnv("NODE_ENV", "production");
diff --git a/packages/eve/src/public/next/index.test.ts b/packages/eve/src/public/next/index.test.ts
index a5f462bfd..50345adda 100644
--- a/packages/eve/src/public/next/index.test.ts
+++ b/packages/eve/src/public/next/index.test.ts
@@ -28,7 +28,7 @@ describe("withEve", () => {
vi.unstubAllEnvs();
});
- it("emits Eve rewrites through beforeFiles when no user rewrites exist", async () => {
+ it("emits eve rewrites through beforeFiles when no user rewrites exist", async () => {
vi.stubEnv("NODE_ENV", "production");
vi.stubEnv("VERCEL", "1");
vi.stubEnv("VERCEL_URL", "preview.example.com");
@@ -69,7 +69,7 @@ describe("withEve", () => {
expect(eveRewrite).not.toHaveProperty("basePath");
});
- it("adds production Vercel rewrites to the private Eve service namespace", async () => {
+ it("adds production Vercel rewrites to the private eve service namespace", async () => {
vi.stubEnv("NODE_ENV", "production");
vi.stubEnv("VERCEL", "1");
vi.stubEnv("VERCEL_URL", "preview.example.com");
@@ -83,7 +83,7 @@ describe("withEve", () => {
});
});
- it("only rewrites Eve-prefixed non-index routes", async () => {
+ it("only rewrites eve-prefixed non-index routes", async () => {
vi.stubEnv("NODE_ENV", "production");
vi.stubEnv("VERCEL", "1");
vi.stubEnv("VERCEL_URL", "preview.example.com");
@@ -97,7 +97,7 @@ describe("withEve", () => {
expect(beforeFiles.every((rewrite) => rewrite.source.startsWith("/eve/v1/"))).toBe(true);
});
- it("rewrites authored channel routes under the Eve protocol prefix", async () => {
+ it("rewrites authored channel routes under the eve protocol prefix", async () => {
vi.stubEnv("NODE_ENV", "production");
vi.stubEnv("VERCEL", "1");
vi.stubEnv("VERCEL_URL", "preview.example.com");
@@ -188,7 +188,7 @@ describe("withEve", () => {
});
});
- it("prepends Eve rewrites to beforeFiles when user rewrites use sections", async () => {
+ it("prepends eve rewrites to beforeFiles when user rewrites use sections", async () => {
vi.stubEnv("NODE_ENV", "production");
vi.stubEnv("VERCEL", "1");
vi.stubEnv("VERCEL_URL", "preview.example.com");
diff --git a/packages/eve/src/public/next/index.ts b/packages/eve/src/public/next/index.ts
index 917bf3ff5..b08d22f97 100644
--- a/packages/eve/src/public/next/index.ts
+++ b/packages/eve/src/public/next/index.ts
@@ -7,7 +7,7 @@ import { resolveEveDestinationPrefix } from "./server.js";
import { ensureEveVercelOutputConfig } from "./vercel-output-config.js";
/**
- * Default private route namespace for hosting Eve as a separate experimental
+ * Default private route namespace for hosting eve as a separate experimental
* Vercel service behind the Next.js app. {@link WithEveOptions.servicePrefix}
* defaults to this value.
*/
@@ -75,27 +75,27 @@ export type EveNextConfigInput<TConfig extends EveNextConfig = EveNextConfig> =
*/
export interface WithEveOptions {
/**
- * Maximum time in milliseconds to wait for the Eve development server to
+ * Maximum time in milliseconds to wait for the eve development server to
* start, including waiting for another Next.js process to start it. Defaults
* to 180000 (three minutes).
*/
readonly devServerTimeoutMs?: number;
/**
- * Path to the Eve application root, relative to `process.cwd()` unless
+ * Path to the eve application root, relative to `process.cwd()` unless
* absolute. Defaults to the Next.js app root.
*/
readonly eveRoot?: string;
/**
- * Build command for the generated Eve Vercel service. Defaults to `eve build`.
- * Use this when the Eve service needs project-specific prework before the
+ * Build command for the generated eve Vercel service. Defaults to `eve build`.
+ * Use this when the eve service needs project-specific prework before the
* framework build, without changing the Next.js service build command.
*/
readonly eveBuildCommand?: string;
/**
- * Private Vercel service prefix for the Eve deployment. Defaults to
+ * Private Vercel service prefix for the eve deployment. Defaults to
* {@link EVE_NEXT_SERVICE_PREFIX} (`/_eve_internal/eve`). `withEve` normalizes
* the prefix (adds a leading slash, strips trailing slashes) and rejects a
- * prefix that resolves to the root route. The prefix must match the Eve
+ * prefix that resolves to the root route. The prefix must match the eve
* service's mount in Vercel Build Output config.
*/
readonly servicePrefix?: string;
@@ -115,7 +115,7 @@ function resolveDevServerTimeout(timeoutMs: number | undefined): number | undefi
}
if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
- throw new Error("Eve Next.js development server timeout must be a positive number.");
+ throw new Error("eve Next.js development server timeout must be a positive number.");
}
return timeoutMs;
@@ -126,7 +126,7 @@ function normalizeRoutePrefix(prefix: string): string {
const normalized = prefixed.replace(/\/+$/, "");
if (normalized.length === 0) {
- throw new Error("Eve Next.js service prefix cannot resolve to the root route.");
+ throw new Error("eve Next.js service prefix cannot resolve to the root route.");
}
return normalized;
@@ -238,15 +238,15 @@ async function resolveNextConfig<TConfig extends EveNextConfig>(
}
/**
- * Wraps a Next.js config so same-origin Eve endpoints proxy to a separate Eve
+ * Wraps a Next.js config so same-origin eve endpoints proxy to a separate eve
* service.
*
- * In development, starts `eve dev --no-ui --port 0` for the Eve app and
- * rewrites Eve protocol endpoints to that local URL. In Vercel production,
- * rewrites to the resolved private Eve service prefix.
+ * In development, starts `eve dev --no-ui --port 0` for the eve app and
+ * rewrites eve protocol endpoints to that local URL. In Vercel production,
+ * rewrites to the resolved private eve service prefix.
* Outside Vercel production, serves an existing `.output/server/index.mjs` build
* on a stable local port when present; otherwise set `EVE_NEXT_PRODUCTION_ORIGIN`
- * to the origin serving the Eve service namespace.
+ * to the origin serving the eve service namespace.
*/
export function withEve<TConfig extends EveNextConfig>(
configOrFunction: EveNextConfigInput<TConfig>,
diff --git a/packages/eve/src/public/next/server.integration.test.ts b/packages/eve/src/public/next/server.integration.test.ts
index 0eb511e9b..e8ec83db1 100644
--- a/packages/eve/src/public/next/server.integration.test.ts
+++ b/packages/eve/src/public/next/server.integration.test.ts
@@ -88,7 +88,7 @@ async function readRegisteredOrigin(appRoot: string): Promise<string> {
await readFile(join(appRoot, ".eve", "next-dev-server.json"), "utf8"),
) as { readonly origin?: unknown };
if (typeof registry.origin !== "string") {
- throw new Error("Eve dev server registry did not record a string origin.");
+ throw new Error("eve dev server registry did not record a string origin.");
}
return registry.origin;
}
diff --git a/packages/eve/src/public/next/server.ts b/packages/eve/src/public/next/server.ts
index 5183f3f73..91cd25778 100644
--- a/packages/eve/src/public/next/server.ts
+++ b/packages/eve/src/public/next/server.ts
@@ -233,7 +233,7 @@ async function acquireEveDevServerLock(
if (Date.now() > deadline) {
throw new Error(
- `Timed out after ${timeoutMs}ms waiting for another Next.js process to start Eve.`,
+ `Timed out after ${timeoutMs}ms waiting for another Next.js process to start eve.`,
);
}
@@ -258,7 +258,7 @@ function isLoopbackHostname(hostname: string): boolean {
function parseLocalServerOrigin(urlText: string): string | undefined {
const url = URL.parse(urlText);
// Dev-server discovery reads mixed subprocess output. Build metadata and
- // dependency warnings can print unrelated URLs before Eve reports its listener,
+ // dependency warnings can print unrelated URLs before eve reports its listener,
// but withEve only owns the app-local loopback server it started.
if (
url === null ||
@@ -304,7 +304,7 @@ function startServerProcess(input: {
child.kill();
reject(
new Error(
- `Timed out after ${input.timeoutMs ?? DEFAULT_SERVER_READY_TIMEOUT_MS}ms waiting for Eve to print its server URL.`,
+ `Timed out after ${input.timeoutMs ?? DEFAULT_SERVER_READY_TIMEOUT_MS}ms waiting for eve to print its server URL.`,
),
);
}, input.timeoutMs ?? DEFAULT_SERVER_READY_TIMEOUT_MS);
@@ -322,7 +322,7 @@ function startServerProcess(input: {
cleanup();
reject(
new Error(
- `Eve server process exited before printing its server URL (code ${String(code)}, signal ${String(signal)}).`,
+ `eve server process exited before printing its server URL (code ${String(code)}, signal ${String(signal)}).`,
),
);
};
diff --git a/packages/eve/src/public/next/vercel-output-config.ts b/packages/eve/src/public/next/vercel-output-config.ts
index 694a9c6c9..6b92871d8 100644
--- a/packages/eve/src/public/next/vercel-output-config.ts
+++ b/packages/eve/src/public/next/vercel-output-config.ts
@@ -172,7 +172,7 @@ function assertRootServicesAreComplete(input: {
}
throw new Error(
- `${VERCEL_JSON_FILE_NAME} already defines experimentalServices, so withEve cannot add generated services through ${VERCEL_OUTPUT_CONFIG_FILE_NAME}. Add both the Next.js and Eve services to ${VERCEL_JSON_FILE_NAME}, or remove experimentalServices from ${VERCEL_JSON_FILE_NAME}.`,
+ `${VERCEL_JSON_FILE_NAME} already defines experimentalServices, so withEve cannot add generated services through ${VERCEL_OUTPUT_CONFIG_FILE_NAME}. Add both the Next.js and eve services to ${VERCEL_JSON_FILE_NAME}, or remove experimentalServices from ${VERCEL_JSON_FILE_NAME}.`,
);
}
diff --git a/packages/eve/src/public/nuxt/dev-server.ts b/packages/eve/src/public/nuxt/dev-server.ts
index 80404bbbe..e0d78cb4a 100644
--- a/packages/eve/src/public/nuxt/dev-server.ts
+++ b/packages/eve/src/public/nuxt/dev-server.ts
@@ -158,7 +158,7 @@ async function acquireEveDevServerLock(appRoot: string): Promise<() => Promise<v
await removeStaleEveDevServerLock(lockPath);
if (Date.now() > deadline) {
throw new Error(
- `Timed out after ${DEV_SERVER_REGISTRY_TIMEOUT_MS}ms waiting for another Nuxt process to start Eve.`,
+ `Timed out after ${DEV_SERVER_REGISTRY_TIMEOUT_MS}ms waiting for another Nuxt process to start eve.`,
);
}
await delay(DEV_SERVER_REGISTRY_POLL_MS);
@@ -186,7 +186,7 @@ function startServerProcess(input: {
child.kill();
reject(
new Error(
- `Timed out after ${DEFAULT_SERVER_READY_TIMEOUT_MS}ms waiting for Eve to print its server URL.`,
+ `Timed out after ${DEFAULT_SERVER_READY_TIMEOUT_MS}ms waiting for eve to print its server URL.`,
),
);
}, DEFAULT_SERVER_READY_TIMEOUT_MS);
@@ -204,7 +204,7 @@ function startServerProcess(input: {
cleanup();
reject(
new Error(
- `Eve server process exited before printing its server URL (code ${String(code)}, signal ${String(signal)}).`,
+ `eve server process exited before printing its server URL (code ${String(code)}, signal ${String(signal)}).`,
),
);
};
@@ -256,9 +256,9 @@ function startEveDevServer(appRoot: string): Promise<EveProcessHandle> {
}
/**
- * Resolve a shared Eve dev server for {@link appRoot}, reusing a healthy
+ * Resolve a shared eve dev server for {@link appRoot}, reusing a healthy
* registered server when one exists and otherwise spawning a new one behind a
- * cross-process lock so concurrent Nuxt processes don't each boot Eve.
+ * cross-process lock so concurrent Nuxt processes don't each boot eve.
*/
export async function resolveSharedEveDevServer(appRoot: string): Promise<EveProcessHandle> {
const registeredOrigin = await readUsableEveDevServerRegistry(appRoot);
diff --git a/packages/eve/src/public/nuxt/module.ts b/packages/eve/src/public/nuxt/module.ts
index fbd9f3abd..105b833b7 100644
--- a/packages/eve/src/public/nuxt/module.ts
+++ b/packages/eve/src/public/nuxt/module.ts
@@ -21,30 +21,30 @@ export { EVE_NUXT_SERVICE_PREFIX };
const DEFAULT_EVE_BUILD_COMMAND = "eve build";
/**
- * Options for the Eve Nuxt module.
+ * Options for the eve Nuxt module.
*/
export interface EveNuxtModuleOptions {
/**
- * Path to the Eve application root, resolved relative to the Nuxt project
+ * Path to the eve application root, resolved relative to the Nuxt project
* root unless absolute. Defaults to the Nuxt project root. The dev server is
- * spawned here and written as the Eve service entrypoint in `vercel.json`
+ * spawned here and written as the eve service entrypoint in `vercel.json`
* (relative to the Nuxt root).
*/
eveRoot?: string;
/**
- * Build command for the generated Eve Vercel service. Defaults to `"eve build"`.
+ * Build command for the generated eve Vercel service. Defaults to `"eve build"`.
*/
eveBuildCommand?: string;
/**
* Set to `false` to skip creating or updating `vercel.json`. By default the
* module ensures `vercel.json` contains `experimentalServices` for the Nuxt
- * app and Eve app.
+ * app and eve app.
*/
configureVercelJson?: boolean;
/**
- * Private Vercel service prefix Eve transport is proxied to. Defaults to
+ * Private Vercel service prefix eve transport is proxied to. Defaults to
* {@link EVE_NUXT_SERVICE_PREFIX}. When `configureVercelJson` is enabled, it
- * is written as the Eve service `routePrefix`, but an existing `routePrefix`
+ * is written as the eve service `routePrefix`, but an existing `routePrefix`
* in `vercel.json` takes precedence. Normalized to a leading-slash,
* no-trailing-slash route; cannot resolve to `/`.
*/
@@ -75,7 +75,7 @@ interface NitroVercelConfigHost {
}
/**
- * Resolve the destination Eve routes proxy to. In dev this is an explicit
+ * Resolve the destination eve routes proxy to. In dev this is an explicit
* `EVE_BASE_URL` or a shared dev server spawned on demand; in production it is
* the Vercel private service or a configured origin/port.
*
@@ -106,12 +106,12 @@ async function resolveEveProxyTarget(input: {
}
/**
- * Nuxt module that wires an Eve agent into a Nuxt app. Register under `modules`
+ * Nuxt module that wires an eve agent into a Nuxt app. Register under `modules`
* (configured via the `eve` config key). It auto-imports the `useEveAgent()`
- * composable, routes Eve transport requests (`/eve/v1/**`) to the Eve service
+ * composable, routes eve transport requests (`/eve/v1/**`) to the eve service
* (a shared dev server spawned on demand in dev, a Vercel sibling service or a
* configured origin/port in production), and unless `configureVercelJson` is
- * `false`, ensures `vercel.json` declares both the Nuxt and Eve services.
+ * `false`, ensures `vercel.json` declares both the Nuxt and eve services.
* Requires Nuxt >= 4.0.0. Configure via {@link EveNuxtModuleOptions}.
*/
export default defineNuxtModule<EveNuxtModuleOptions>({
@@ -133,9 +133,9 @@ export default defineNuxtModule<EveNuxtModuleOptions>({
// without an explicit import, matching Nuxt's composable conventions.
addImports({ name: "useEveAgent", from: "eve/vue" });
- // On Vercel the Eve app deploys as a sibling experimental service. A Nitro
+ // On Vercel the eve app deploys as a sibling experimental service. A Nitro
// runtime `proxy` rule can't reach it — the proxied request loops back into
- // the Nuxt function and 404s — so route Eve transport at the edge via a
+ // the Nuxt function and 404s — so route eve transport at the edge via a
// build-config rewrite, mirroring the Next.js integration.
if (!nuxt.options.dev && process.env.VERCEL) {
const rewrite = createEveVercelRewriteRoute(servicePrefix);
@@ -151,7 +151,7 @@ export default defineNuxtModule<EveNuxtModuleOptions>({
};
} else {
// Dev (and non-Vercel production, which proxies to an absolute origin):
- // booting the shared Eve dev server can take a while, so defer it out of
+ // booting the shared eve dev server can take a while, so defer it out of
// module setup. `modules:done` still runs before Nitro is configured, so
// the proxy route rule is registered in time while other modules' setup
// isn't blocked behind the spawn.
diff --git a/packages/eve/src/public/nuxt/routing.test.ts b/packages/eve/src/public/nuxt/routing.test.ts
index 1ce2fec90..7b3a9add8 100644
--- a/packages/eve/src/public/nuxt/routing.test.ts
+++ b/packages/eve/src/public/nuxt/routing.test.ts
@@ -94,7 +94,7 @@ describe("readLocalProductionPort", () => {
});
describe("createEveVercelRewriteRoute", () => {
- it("rewrites the Eve transport prefix onto the service prefix", () => {
+ it("rewrites the eve transport prefix onto the service prefix", () => {
expect(createEveVercelRewriteRoute(EVE_NUXT_SERVICE_PREFIX)).toEqual({
src: `^${EVE_PROTOCOL_PREFIX}/(.*)$`,
dest: `${EVE_NUXT_SERVICE_PREFIX}${EVE_PROTOCOL_PREFIX}/$1`,
diff --git a/packages/eve/src/public/nuxt/routing.ts b/packages/eve/src/public/nuxt/routing.ts
index cebdfd0d1..482d0b327 100644
--- a/packages/eve/src/public/nuxt/routing.ts
+++ b/packages/eve/src/public/nuxt/routing.ts
@@ -1,7 +1,7 @@
import { EVE_ROUTE_PREFIX } from "#protocol/routes.js";
/**
- * Private route namespace used when a Vercel deployment hosts Eve as a
+ * Private route namespace used when a Vercel deployment hosts eve as a
* separate experimental service behind the Nuxt app.
*/
export const EVE_NUXT_SERVICE_PREFIX = "/_eve_internal/eve";
@@ -19,7 +19,7 @@ export function normalizeRoutePrefix(prefix: string): string {
const prefixed = prefix.startsWith("/") ? prefix : `/${prefix}`;
const normalized = prefixed.replace(/\/+$/, "");
if (normalized.length === 0) {
- throw new Error("Eve Nuxt service prefix cannot resolve to the root route.");
+ throw new Error("eve Nuxt service prefix cannot resolve to the root route.");
}
return normalized;
}
@@ -39,7 +39,7 @@ export function normalizeOrigin(origin: string): string {
}
/**
- * Resolve the local production port the module proxies to when an Eve service
+ * Resolve the local production port the module proxies to when an eve service
* runs alongside a non-Vercel Nuxt deployment. Defaults to
* {@link DEFAULT_EVE_NUXT_PRODUCTION_PORT}.
*/
@@ -63,15 +63,15 @@ export interface EveVercelRewriteRoute {
readonly dest: string;
/**
* Re-run route matching against the rewritten `dest`. Required so the
- * rewritten Eve service path is routed to the sibling Eve service instead of
+ * rewritten eve service path is routed to the sibling eve service instead of
* being resolved inside the host service's own filesystem (which 404s).
*/
readonly check: true;
}
/**
- * Build the edge-level Vercel rewrite that forwards Eve transport requests
- * (`/eve/v1/**`) to the Eve service prefix (`/_eve_internal/eve/eve/v1/**`).
+ * Build the edge-level Vercel rewrite that forwards eve transport requests
+ * (`/eve/v1/**`) to the eve service prefix (`/_eve_internal/eve/eve/v1/**`).
*
* Mirrors the Next.js integration's `beforeFiles` rewrite. A Nitro runtime
* `proxy` route rule cannot reach a sibling Vercel service — the proxied
@@ -88,7 +88,7 @@ export function createEveVercelRewriteRoute(servicePrefix: string): EveVercelRew
}
/**
- * Resolve the proxy destination for Eve routes in production.
+ * Resolve the proxy destination for eve routes in production.
*
* On Vercel the destination is the private service prefix. Off Vercel it is an
* explicit origin override (`EVE_NUXT_PRODUCTION_ORIGIN`) or a local port.
diff --git a/packages/eve/src/public/nuxt/vercel-json.integration.test.ts b/packages/eve/src/public/nuxt/vercel-json.integration.test.ts
index f236679f3..95560d1bf 100644
--- a/packages/eve/src/public/nuxt/vercel-json.integration.test.ts
+++ b/packages/eve/src/public/nuxt/vercel-json.integration.test.ts
@@ -45,7 +45,7 @@ describe("ensureEveVercelJson", () => {
});
});
- it("resolves the Eve entrypoint relative to the Nuxt root", async () => {
+ it("resolves the eve entrypoint relative to the Nuxt root", async () => {
const nuxtRoot = await createTempRoot();
const appRoot = join(nuxtRoot, "agent");
@@ -80,7 +80,7 @@ describe("ensureEveVercelJson", () => {
});
});
- it("preserves an already-configured Eve service and reuses its prefix", async () => {
+ it("preserves an already-configured eve service and reuses its prefix", async () => {
const nuxtRoot = await createTempRoot();
const existing = {
$schema: "https://openapi.vercel.sh/vercel.json",
diff --git a/packages/eve/src/public/nuxt/vercel-json.ts b/packages/eve/src/public/nuxt/vercel-json.ts
index e3f37948c..6f448b137 100644
--- a/packages/eve/src/public/nuxt/vercel-json.ts
+++ b/packages/eve/src/public/nuxt/vercel-json.ts
@@ -64,10 +64,10 @@ function findServiceByFramework(
}
/**
- * Ensure `vercel.json` declares the Nuxt web service and the Eve agent
+ * Ensure `vercel.json` declares the Nuxt web service and the eve agent
* service so a Vercel deployment ships both from one project.
*
- * Existing services are preserved untouched; an already-configured Eve
+ * Existing services are preserved untouched; an already-configured eve
* service's `routePrefix` wins over {@link input.servicePrefix}. The file is
* only rewritten when the resulting config differs from what is on disk.
*/
diff --git a/packages/eve/src/public/sandbox/backends/just-bash.ts b/packages/eve/src/public/sandbox/backends/just-bash.ts
index 198585f40..3a93d9e4a 100644
--- a/packages/eve/src/public/sandbox/backends/just-bash.ts
+++ b/packages/eve/src/public/sandbox/backends/just-bash.ts
@@ -9,7 +9,7 @@ import type { JustBashSandboxCreateOptions } from "#public/sandbox/just-bash-san
* real binaries (`git`, `node`, package managers) and no network
* isolation.
*
- * The `just-bash` package is not bundled with Eve. When it is missing,
+ * The `just-bash` package is not bundled with eve. When it is missing,
* `eve dev` installs it into the application automatically (disable
* with `autoInstall: false`); production processes fail with an
* actionable install error instead. Configuring this backend pins it
diff --git a/packages/eve/src/public/sandbox/backends/microsandbox.ts b/packages/eve/src/public/sandbox/backends/microsandbox.ts
index 1eca279d8..2167060b5 100644
--- a/packages/eve/src/public/sandbox/backends/microsandbox.ts
+++ b/packages/eve/src/public/sandbox/backends/microsandbox.ts
@@ -13,7 +13,7 @@ import type {
* network policies and credential brokering.
*
* Supported hosts: macOS on Apple Silicon, or Linux (glibc) with KVM
- * enabled. The `microsandbox` package is not bundled with Eve. When it
+ * enabled. The `microsandbox` package is not bundled with eve. When it
* (or its VM runtime) is missing, `eve dev` installs both
* automatically (disable with `setup: { autoInstall: false }`);
* production processes fail with actionable errors instead.
diff --git a/packages/eve/src/public/sandbox/backends/vercel.ts b/packages/eve/src/public/sandbox/backends/vercel.ts
index fcc19e631..b797a9a52 100644
--- a/packages/eve/src/public/sandbox/backends/vercel.ts
+++ b/packages/eve/src/public/sandbox/backends/vercel.ts
@@ -23,7 +23,7 @@ import type {
* the author's snapshot, git revision, or tarball becomes the base
* layer of the template. Bootstrap, seed files, and framework setup
* still run on top, and every session derives from the resulting
- * Eve-owned snapshot. `source` is stripped from session creates so the
+ * eve-owned snapshot. `source` is stripped from session creates so the
* framework's snapshot always wins.
*
* `bootstrap({ use })` applies its options to the template via
diff --git a/packages/eve/src/public/sandbox/docker-sandbox.ts b/packages/eve/src/public/sandbox/docker-sandbox.ts
index 47d0d4666..c46684d8a 100644
--- a/packages/eve/src/public/sandbox/docker-sandbox.ts
+++ b/packages/eve/src/public/sandbox/docker-sandbox.ts
@@ -24,7 +24,7 @@ export type DockerSandboxNetworkPolicy = "allow-all" | "deny-all";
export interface DockerSandboxCreateOptions {
/**
* Base container image for templates and sessions. Defaults to
- * `ghcr.io/vercel/eve:latest` — Eve's published sandbox runtime image.
+ * `ghcr.io/vercel/eve:latest` — eve's published sandbox runtime image.
* Framework setup creates `/workspace` and verifies Bash. Install any
* authored runtime tools in sandbox bootstrap or provide them through a
* custom image.
diff --git a/packages/eve/src/public/sandbox/just-bash-sandbox.ts b/packages/eve/src/public/sandbox/just-bash-sandbox.ts
index 3635e5da4..85aa6db12 100644
--- a/packages/eve/src/public/sandbox/just-bash-sandbox.ts
+++ b/packages/eve/src/public/sandbox/just-bash-sandbox.ts
@@ -4,7 +4,7 @@
* The just-bash backend runs the workspace under the pure-JS `just-bash`
* interpreter with a virtual filesystem — no daemon or VM required, but
* no real binaries either. The `just-bash` package is not bundled with
- * Eve; it is loaded lazily from the application install.
+ * eve; it is loaded lazily from the application install.
*/
export interface JustBashSandboxCreateOptions {
/**
diff --git a/packages/eve/src/public/sandbox/microsandbox-sandbox.ts b/packages/eve/src/public/sandbox/microsandbox-sandbox.ts
index bc968c177..aaa913a53 100644
--- a/packages/eve/src/public/sandbox/microsandbox-sandbox.ts
+++ b/packages/eve/src/public/sandbox/microsandbox-sandbox.ts
@@ -5,13 +5,13 @@ import type { SandboxNetworkPolicy } from "#shared/sandbox-network-policy.js";
*
* The microsandbox backend runs sandboxes in lightweight local VMs via
* [microsandbox](https://www.npmjs.com/package/microsandbox). Options
- * are Eve-owned rather than a raw passthrough so the public surface can
+ * are eve-owned rather than a raw passthrough so the public surface can
* stay stable while the underlying runtime evolves. Supported hosts:
* macOS on Apple Silicon, or Linux (glibc) with KVM enabled.
*/
export interface MicrosandboxCreateOptions {
/**
- * OCI image used as the base runtime. Eve prepares this image with
+ * OCI image used as the base runtime. eve prepares this image with
* Bash, the framework workspace, and the sandbox user before authored
* bootstrap code runs. Install authored runtime tools such as Node,
* Python, or ripgrep in sandbox bootstrap or provide them through a
@@ -30,7 +30,7 @@ export interface MicrosandboxCreateOptions {
readonly pullPolicy?: "always" | "if-missing" | "never";
/**
* Installation behavior for the microsandbox npm package and its VM
- * runtime. By default Eve installs both automatically when missing —
+ * runtime. By default eve installs both automatically when missing —
* the npm package with the project's package manager (during
* `eve dev` only), the runtime via microsandbox's own installer.
*/
diff --git a/packages/eve/src/public/sandbox/vercel-sandbox.ts b/packages/eve/src/public/sandbox/vercel-sandbox.ts
index 8c5df77e3..d77c0789a 100644
--- a/packages/eve/src/public/sandbox/vercel-sandbox.ts
+++ b/packages/eve/src/public/sandbox/vercel-sandbox.ts
@@ -10,7 +10,7 @@ import type {
* Skipped on resume (`Sandbox.get`) since no create happens there.
*
* `networkPolicy` is deferred until after framework-owned base setup
- * for fresh templates and template-less sessions, so Eve can install
+ * for fresh templates and template-less sessions, so eve can install
* required packages before authored bootstrap code runs. Template-backed
* session creates receive it at creation time because the template
* already contains the prepared base runtime.
@@ -24,7 +24,7 @@ import type {
* base layer for the template. Framework setup, bootstrap, and seed
* files all run on top, and the resulting
* framework-owned snapshot is what every later session derives from,
- * so `source` is stripped from the session-create path. Eve does not
+ * so `source` is stripped from the session-create path. eve does not
* detect external snapshot changes; to pick up a rebuilt external
* snapshot, force a template rebuild (e.g. by changing the sandbox
* definition so its template key changes).
diff --git a/packages/eve/src/public/sveltekit/dev-server.ts b/packages/eve/src/public/sveltekit/dev-server.ts
index 3a5154707..3c8c2376c 100644
--- a/packages/eve/src/public/sveltekit/dev-server.ts
+++ b/packages/eve/src/public/sveltekit/dev-server.ts
@@ -158,7 +158,7 @@ async function acquireEveDevServerLock(appRoot: string): Promise<() => Promise<v
await removeStaleEveDevServerLock(lockPath);
if (Date.now() > deadline) {
throw new Error(
- `Timed out after ${DEV_SERVER_REGISTRY_TIMEOUT_MS}ms waiting for another SvelteKit process to start Eve.`,
+ `Timed out after ${DEV_SERVER_REGISTRY_TIMEOUT_MS}ms waiting for another SvelteKit process to start eve.`,
);
}
await delay(DEV_SERVER_REGISTRY_POLL_MS);
@@ -186,7 +186,7 @@ function startServerProcess(input: {
child.kill();
reject(
new Error(
- `Timed out after ${DEFAULT_SERVER_READY_TIMEOUT_MS}ms waiting for Eve to print its server URL.`,
+ `Timed out after ${DEFAULT_SERVER_READY_TIMEOUT_MS}ms waiting for eve to print its server URL.`,
),
);
}, DEFAULT_SERVER_READY_TIMEOUT_MS);
@@ -204,7 +204,7 @@ function startServerProcess(input: {
cleanup();
reject(
new Error(
- `Eve server process exited before printing its server URL (code ${String(code)}, signal ${String(signal)}).`,
+ `eve server process exited before printing its server URL (code ${String(code)}, signal ${String(signal)}).`,
),
);
};
@@ -256,9 +256,9 @@ function startEveDevServer(appRoot: string): Promise<EveProcessHandle> {
}
/**
- * Resolve a shared Eve dev server for {@link appRoot}, reusing a healthy
+ * Resolve a shared eve dev server for {@link appRoot}, reusing a healthy
* registered server when one exists and otherwise spawning a new one behind a
- * cross-process lock so concurrent SvelteKit processes don't each boot Eve.
+ * cross-process lock so concurrent SvelteKit processes don't each boot eve.
*/
export async function resolveSharedEveDevServer(appRoot: string): Promise<EveProcessHandle> {
const registeredOrigin = await readUsableEveDevServerRegistry(appRoot);
diff --git a/packages/eve/src/public/sveltekit/index.test.ts b/packages/eve/src/public/sveltekit/index.test.ts
index a7533741f..7c7f42fab 100644
--- a/packages/eve/src/public/sveltekit/index.test.ts
+++ b/packages/eve/src/public/sveltekit/index.test.ts
@@ -34,7 +34,7 @@ afterEach(() => {
});
describe("eveSvelteKit", () => {
- it("configures Vite dev server proxy to a shared Eve server", async () => {
+ it("configures Vite dev server proxy to a shared eve server", async () => {
const plugin = eveSvelteKit();
const result = (await getConfigHook(plugin)(
{
@@ -61,7 +61,7 @@ describe("eveSvelteKit", () => {
});
});
- it("configures Vite preview proxy and starts Eve for local production preview", async () => {
+ it("configures Vite preview proxy and starts eve for local production preview", async () => {
const plugin = eveSvelteKit();
const result = (await getConfigHook(plugin)(
{
diff --git a/packages/eve/src/public/sveltekit/index.ts b/packages/eve/src/public/sveltekit/index.ts
index 043401aec..4ed2464c5 100644
--- a/packages/eve/src/public/sveltekit/index.ts
+++ b/packages/eve/src/public/sveltekit/index.ts
@@ -13,16 +13,16 @@ export { EVE_SVELTEKIT_SERVICE_PREFIX };
const DEFAULT_EVE_BUILD_COMMAND = "eve build";
/**
- * Options for the Eve SvelteKit Vite plugin.
+ * Options for the eve SvelteKit Vite plugin.
*/
export interface EveSvelteKitPluginOptions {
/**
- * Path to the Eve application root, relative to the SvelteKit project root
+ * Path to the eve application root, relative to the SvelteKit project root
* unless absolute. Defaults to the SvelteKit project root.
*/
readonly eveRoot?: string;
/**
- * Build command for the generated Eve Vercel service.
+ * Build command for the generated eve Vercel service.
* Defaults to `"eve build"`.
*/
readonly eveBuildCommand?: string;
@@ -30,12 +30,12 @@ export interface EveSvelteKitPluginOptions {
* Set to `false` to skip creating or updating `vercel.json`.
*
* By default the plugin ensures `vercel.json` contains `experimentalServices`
- * for the SvelteKit app and Eve app.
+ * for the SvelteKit app and eve app.
*/
readonly configureVercelJson?: boolean;
/**
- * Private Vercel service prefix for the Eve deployment. Must match the
- * Eve service's `routePrefix` in `vercel.json`. Defaults to
+ * Private Vercel service prefix for the eve deployment. Must match the
+ * eve service's `routePrefix` in `vercel.json`. Defaults to
* {@link EVE_SVELTEKIT_SERVICE_PREFIX} (`"/_eve_internal/eve"`).
*/
readonly servicePrefix?: string;
@@ -71,15 +71,15 @@ async function resolveEveDevProxyTarget(appRoot: string): Promise<string> {
}
/**
- * Vite plugin for running an Eve agent alongside a SvelteKit app.
+ * Vite plugin for running an eve agent alongside a SvelteKit app.
*
- * In development and local preview, `eveSvelteKit` proxies Eve protocol
- * endpoints to a local Eve server. It resolves the server in order: the
- * `EVE_BASE_URL` env var if set, then a healthy shared Eve dev server already
+ * In development and local preview, `eveSvelteKit` proxies eve protocol
+ * endpoints to a local eve server. It resolves the server in order: the
+ * `EVE_BASE_URL` env var if set, then a healthy shared eve dev server already
* running for the app, then a freshly spawned `eve dev --no-ui --port 0`.
*
* During builds, unless `configureVercelJson` is `false`, it ensures
- * `vercel.json` deploys the SvelteKit app and Eve agent as sibling Vercel
+ * `vercel.json` deploys the SvelteKit app and eve agent as sibling Vercel
* services.
*/
export function eveSvelteKit(options: EveSvelteKitPluginOptions = {}): Plugin {
diff --git a/packages/eve/src/public/sveltekit/routing.test.ts b/packages/eve/src/public/sveltekit/routing.test.ts
index b1bca5fe5..3380062c5 100644
--- a/packages/eve/src/public/sveltekit/routing.test.ts
+++ b/packages/eve/src/public/sveltekit/routing.test.ts
@@ -62,7 +62,7 @@ describe("normalizeOrigin", () => {
});
describe("createEveVercelRewrite", () => {
- it("rewrites the Eve transport prefix onto the service prefix", () => {
+ it("rewrites the eve transport prefix onto the service prefix", () => {
expect(createEveVercelRewrite(EVE_SVELTEKIT_SERVICE_PREFIX)).toEqual({
source: `${EVE_PROTOCOL_PREFIX}/:path*`,
destination: `${EVE_SVELTEKIT_SERVICE_PREFIX}${EVE_PROTOCOL_PREFIX}/:path*`,
diff --git a/packages/eve/src/public/sveltekit/routing.ts b/packages/eve/src/public/sveltekit/routing.ts
index c0dd661cb..68174b465 100644
--- a/packages/eve/src/public/sveltekit/routing.ts
+++ b/packages/eve/src/public/sveltekit/routing.ts
@@ -1,7 +1,7 @@
import { EVE_ROUTE_PREFIX } from "#protocol/routes.js";
/**
- * Private route namespace for hosting Eve as a separate experimental Vercel
+ * Private route namespace for hosting eve as a separate experimental Vercel
* service behind the SvelteKit app.
*/
export const EVE_SVELTEKIT_SERVICE_PREFIX = "/_eve_internal/eve";
@@ -15,7 +15,7 @@ export function normalizeRoutePrefix(prefix: string): string {
const prefixed = prefix.startsWith("/") ? prefix : `/${prefix}`;
const normalized = prefixed.replace(/\/+$/, "");
if (normalized.length === 0) {
- throw new Error("Eve SvelteKit service prefix cannot resolve to the root route.");
+ throw new Error("eve SvelteKit service prefix cannot resolve to the root route.");
}
return normalized;
}
@@ -35,8 +35,8 @@ export function normalizeOrigin(origin: string): string {
}
/**
- * A Vercel rewrite that forwards Eve transport requests (`/eve/v1/**`) to the
- * private Eve service prefix (`/_eve_internal/eve/eve/v1/**`).
+ * A Vercel rewrite that forwards eve transport requests (`/eve/v1/**`) to the
+ * private eve service prefix (`/_eve_internal/eve/eve/v1/**`).
*/
export interface EveVercelRewrite {
readonly destination: string;
@@ -44,8 +44,8 @@ export interface EveVercelRewrite {
}
/**
- * Build the Vercel rewrite that forwards browser Eve transport requests to the
- * sibling Eve service.
+ * Build the Vercel rewrite that forwards browser eve transport requests to the
+ * sibling eve service.
*/
export function createEveVercelRewrite(servicePrefix: string): EveVercelRewrite {
return {
diff --git a/packages/eve/src/public/sveltekit/vercel-json.integration.test.ts b/packages/eve/src/public/sveltekit/vercel-json.integration.test.ts
index f6f46d7e4..bd6643683 100644
--- a/packages/eve/src/public/sveltekit/vercel-json.integration.test.ts
+++ b/packages/eve/src/public/sveltekit/vercel-json.integration.test.ts
@@ -51,7 +51,7 @@ describe("ensureEveVercelJson", () => {
});
});
- it("resolves the Eve entrypoint relative to the SvelteKit root", async () => {
+ it("resolves the eve entrypoint relative to the SvelteKit root", async () => {
const svelteKitRoot = await createTempRoot();
const appRoot = join(svelteKitRoot, "agent");
@@ -86,7 +86,7 @@ describe("ensureEveVercelJson", () => {
});
});
- it("preserves an already-configured Eve service and reuses its prefix", async () => {
+ it("preserves an already-configured eve service and reuses its prefix", async () => {
const svelteKitRoot = await createTempRoot();
const existing = {
$schema: "https://openapi.vercel.sh/vercel.json",
diff --git a/packages/eve/src/public/sveltekit/vercel-json.ts b/packages/eve/src/public/sveltekit/vercel-json.ts
index d88fcc4b4..e56527178 100644
--- a/packages/eve/src/public/sveltekit/vercel-json.ts
+++ b/packages/eve/src/public/sveltekit/vercel-json.ts
@@ -78,10 +78,10 @@ function hasRewrite(rewrites: readonly EveVercelRewrite[], rewrite: EveVercelRew
}
/**
- * Ensure `vercel.json` declares the SvelteKit web service and the Eve agent
+ * Ensure `vercel.json` declares the SvelteKit web service and the eve agent
* service so a Vercel deployment ships both from one project.
*
- * Existing services are preserved untouched; an already-configured Eve
+ * Existing services are preserved untouched; an already-configured eve
* service's `routePrefix` wins over {@link input.servicePrefix}. The file is
* only rewritten when the resulting config differs from what is on disk.
*/
diff --git a/packages/eve/src/public/tool-result-narrowing.test.ts b/packages/eve/src/public/tool-result-narrowing.test.ts
index 9b314ec6d..75bd55b55 100644
--- a/packages/eve/src/public/tool-result-narrowing.test.ts
+++ b/packages/eve/src/public/tool-result-narrowing.test.ts
@@ -159,7 +159,7 @@ describe("toolResultFrom", () => {
expect(warn).toHaveBeenCalledOnce();
expect(warn).toHaveBeenCalledWith(
expect.stringContaining(
- 'Eve could not assign a unique toolResultFrom identity for "tool:Run the shared action."',
+ 'eve could not assign a unique toolResultFrom identity for "tool:Run the shared action."',
),
);
expect(warn).toHaveBeenCalledWith(
@@ -256,7 +256,7 @@ describe("toolResultFrom", () => {
expect(warn).toHaveBeenCalledOnce();
expect(warn).toHaveBeenCalledWith(
expect.stringContaining(
- 'Eve could not assign a unique toolResultFrom identity for "connection:https://mcp.example.test"',
+ 'eve could not assign a unique toolResultFrom identity for "connection:https://mcp.example.test"',
),
);
expect(warn).toHaveBeenCalledWith(
diff --git a/packages/eve/src/public/tool-result-narrowing.ts b/packages/eve/src/public/tool-result-narrowing.ts
index 93242709e..af72d5422 100644
--- a/packages/eve/src/public/tool-result-narrowing.ts
+++ b/packages/eve/src/public/tool-result-narrowing.ts
@@ -101,10 +101,10 @@ export function registerDefinitionSource(key: string, entry: DefinitionSourceEnt
if (existing.kind !== "ambiguous") {
console.warn(
[
- `Eve could not assign a unique toolResultFrom identity for ${JSON.stringify(key)}.`,
+ `eve could not assign a unique toolResultFrom identity for ${JSON.stringify(key)}.`,
`Conflicting definitions: ${formatDefinitionSourceForWarning(existing)} and ${formatDefinitionSourceForWarning(entry)}.`,
"Multiple authored definitions share that fallback identity, so toolResultFrom will not match through it.",
- "Use the original definition object loaded by Eve so source-derived identity can be used instead.",
+ "Use the original definition object loaded by eve so source-derived identity can be used instead.",
].join(" "),
);
}
diff --git a/packages/eve/src/public/types/json.ts b/packages/eve/src/public/types/json.ts
index 79659cd52..9c74ad5dc 100644
--- a/packages/eve/src/public/types/json.ts
+++ b/packages/eve/src/public/types/json.ts
@@ -1,5 +1,5 @@
/**
- * Shared JSON primitive used by public Eve APIs that need to declare
+ * Shared JSON primitive used by public eve APIs that need to declare
* author-supplied values as JSON-serializable.
*
* The canonical use site is {@link AuthorizationDefinition}, whose
diff --git a/packages/eve/src/react/use-eve-agent.ts b/packages/eve/src/react/use-eve-agent.ts
index f8d3b1b48..fc102795a 100644
--- a/packages/eve/src/react/use-eve-agent.ts
+++ b/packages/eve/src/react/use-eve-agent.ts
@@ -16,7 +16,7 @@ import type { ClientAuth, HeadersValue, SendTurnPayload, SessionState } from "#c
export type { PrepareSend };
/**
- * Lifecycle status of an Eve agent session.
+ * Lifecycle status of an eve agent session.
*
* - `"ready"`: idle, accepting a new turn.
* - `"submitted"`: a turn was sent, no stream events received yet.
@@ -26,7 +26,7 @@ export type { PrepareSend };
export type UseEveAgentStatus = EveAgentStoreStatus;
/**
- * Snapshot of an Eve agent session: `data` (the reducer projection), `events`
+ * Snapshot of an eve agent session: `data` (the reducer projection), `events`
* (the authoritative server stream), `session` (resumable cursor), `status`,
* and `error`.
*/
@@ -45,7 +45,7 @@ export interface UseEveAgentHelpers<TData> extends UseEveAgentSnapshot<TData> {
}
/**
- * Configuration for creating or binding a React Eve agent session.
+ * Configuration for creating or binding a React eve agent session.
*
* Session configuration is read when the hook creates its internal store;
* remount the component to point at a different host, reducer, or session.
@@ -58,11 +58,11 @@ export interface UseEveAgentOptions<TData> extends EveAgentStoreCallbacks<TData>
readonly auth?: ClientAuth;
readonly headers?: HeadersValue;
/**
- * Base URL for Eve client requests.
+ * Base URL for eve client requests.
*
- * Defaults to same-origin Eve routes such as `/eve/v1/...`. Pass a same-origin
+ * Defaults to same-origin eve routes such as `/eve/v1/...`. Pass a same-origin
* prefix such as `/api` for an app-owned proxy, or an absolute origin to talk
- * to an Eve server directly.
+ * to an eve server directly.
*
* @default ""
*/
@@ -71,11 +71,11 @@ export interface UseEveAgentOptions<TData> extends EveAgentStoreCallbacks<TData>
readonly initialSession?: SessionState;
readonly maxReconnectAttempts?: number;
/**
- * Project submitted user messages before Eve confirms them with a
+ * Project submitted user messages before eve confirms them with a
* `message.received` stream event.
*
* Optimistic events are reducer-facing projection events only. They are not
- * exposed through `events`, which remains the authoritative Eve stream.
+ * exposed through `events`, which remains the authoritative eve stream.
*
* @default true
*/
@@ -93,7 +93,7 @@ export function useEveAgent<TData>(
): UseEveAgentHelpers<TData>;
/**
- * React hook that drives an Eve session and projects its event stream into UI data.
+ * React hook that drives an eve session and projects its event stream into UI data.
*
* Returns the current snapshot (`data`, `events`, `session`, `status`, `error`)
* plus the commands `send`, `stop`, and `reset`. With no reducer, `data` is the
diff --git a/packages/eve/src/runtime/agent/bootstrap-model.ts b/packages/eve/src/runtime/agent/bootstrap-model.ts
index fae6aa679..f21f58820 100644
--- a/packages/eve/src/runtime/agent/bootstrap-model.ts
+++ b/packages/eve/src/runtime/agent/bootstrap-model.ts
@@ -52,7 +52,7 @@ function createBootstrapModelResult(
prompt: BootstrapPrompt,
modelId: string,
): BootstrapGenerateResult {
- const lastUserMessage = getLastUserPromptText(prompt) ?? "Hello from Eve";
+ const lastUserMessage = getLastUserPromptText(prompt) ?? "Hello from eve";
const text = `Bootstrap reply: ${lastUserMessage}`;
return createBootstrapGenerateResult({
diff --git a/packages/eve/src/runtime/agent/bootstrap.ts b/packages/eve/src/runtime/agent/bootstrap.ts
index 5d4c91bcf..55709c9e0 100644
--- a/packages/eve/src/runtime/agent/bootstrap.ts
+++ b/packages/eve/src/runtime/agent/bootstrap.ts
@@ -38,7 +38,7 @@ export interface RuntimeTurnAgent {
* Static system prompt for the bootstrap runtime path.
*/
export const BOOTSTRAP_RUNTIME_SYSTEM_PROMPT =
- "You are the Eve bootstrap agent. Be concise, stay grounded in the current conversation, and do not assume tools are available unless the runtime provides them.";
+ "You are the eve bootstrap agent. Be concise, stay grounded in the current conversation, and do not assume tools are available unless the runtime provides them.";
/**
* Creates the runtime-owned turn-preparation shape from a resolved authored
diff --git a/packages/eve/src/runtime/agent/mock-model-adapter.ts b/packages/eve/src/runtime/agent/mock-model-adapter.ts
index f6e999281..30ae34b1d 100644
--- a/packages/eve/src/runtime/agent/mock-model-adapter.ts
+++ b/packages/eve/src/runtime/agent/mock-model-adapter.ts
@@ -294,7 +294,7 @@ function createFollowUpToolCallResult(input: {
}
function createAssistantMessage(prompt: BootstrapPrompt): string {
- const lastUserMessage = getLastUserPromptText(prompt) ?? "Hello from Eve";
+ const lastUserMessage = getLastUserPromptText(prompt) ?? "Hello from eve";
const systemLabels = getSystemPromptLabels(prompt);
const systemProbe = resolveSystemProbe(prompt);
const fixtureToken = resolveMockFixtureToken(prompt);
@@ -327,7 +327,7 @@ function formatToolResultReply(result: BootstrapToolResult, prompt: BootstrapPro
return `Used local weather tool for ${result.output.city}: ${result.output.condition}, ${result.output.temperatureF}F. ${result.output.summary}`;
}
- const lastUserMessage = getLastUserPromptText(prompt) ?? "Hello from Eve";
+ const lastUserMessage = getLastUserPromptText(prompt) ?? "Hello from eve";
return `Used ${result.toolName} for "${lastUserMessage}": ${formatToolOutput(result.output)}`;
}
diff --git a/packages/eve/src/runtime/agent/resolve-model.ts b/packages/eve/src/runtime/agent/resolve-model.ts
index a6590ea8b..ce3d33616 100644
--- a/packages/eve/src/runtime/agent/resolve-model.ts
+++ b/packages/eve/src/runtime/agent/resolve-model.ts
@@ -76,7 +76,7 @@ async function loadSourceBackedRuntimeModelReference(
);
const normalizedDefinition = normalizeAgentDefinition(
definition,
- `Expected the authored agent config export "${reference.source.exportName ?? "default"}" from "${reference.source.logicalPath}" to match the public Eve shape.`,
+ `Expected the authored agent config export "${reference.source.exportName ?? "default"}" from "${reference.source.logicalPath}" to match the public eve shape.`,
);
const model = normalizedDefinition.model;
diff --git a/packages/eve/src/runtime/attributes/emit.ts b/packages/eve/src/runtime/attributes/emit.ts
index 3a949a6c7..b5137a87b 100644
--- a/packages/eve/src/runtime/attributes/emit.ts
+++ b/packages/eve/src/runtime/attributes/emit.ts
@@ -94,7 +94,7 @@ export function truncateForTag(value: string, maxBytes = EVE_ATTRIBUTE_VALUE_MAX
}
/**
- * Writes a batch of Eve-owned attributes to the active workflow run.
+ * Writes a batch of eve-owned attributes to the active workflow run.
*
* Reserved-namespace contract:
* - All keys must use the `$eve.` prefix (the workflow runtime would
@@ -116,7 +116,7 @@ export function truncateForTag(value: string, maxBytes = EVE_ATTRIBUTE_VALUE_MAX
* Failure policy: tag writes are observability metadata, not load-bearing
* state. A failure inside the runtime (transient network, schema bug,
* missing world adapter) is logged once per process and then swallowed
- * so the Eve session it tagged is unaffected.
+ * so the eve session it tagged is unaffected.
*
* Must be called from inside a `"use workflow"` or `"use step"` body —
* the runtime throws a `FatalError` outside those contexts.
diff --git a/packages/eve/src/runtime/connections/callback-route.ts b/packages/eve/src/runtime/connections/callback-route.ts
index a0807cf0f..a268e72b4 100644
--- a/packages/eve/src/runtime/connections/callback-route.ts
+++ b/packages/eve/src/runtime/connections/callback-route.ts
@@ -16,7 +16,7 @@
*
* Owning this route in the framework - instead of routing the IdP at the
* workflow runtime's raw `/.well-known/workflow/v1/webhook/:token` -
- * keeps the public surface namespaced under Eve and lets the framework
+ * keeps the public surface namespaced under eve and lets the framework
* decide delivery policy (auth, throttling, logging) for connection
* callbacks without leaking generic workflow primitives to the public
* internet.
diff --git a/packages/eve/src/runtime/connections/mcp-client.ts b/packages/eve/src/runtime/connections/mcp-client.ts
index 3c35c472d..27db60b88 100644
--- a/packages/eve/src/runtime/connections/mcp-client.ts
+++ b/packages/eve/src/runtime/connections/mcp-client.ts
@@ -220,7 +220,7 @@ export class McpConnectionClient implements ConnectionClient {
/**
* Best-effort removal of the rejected bearer for this connection's
- * resolved principal, across both Eve's per-step cache and the
+ * resolved principal, across both eve's per-step cache and the
* strategy's own cache (e.g. `@vercel/connect`). Delegates to the
* shared {@link evictScopedToken} so MCP connections and authored
* tools invalidate identically. No-op outside a runtime scope or when
diff --git a/packages/eve/src/runtime/connections/principal.test.ts b/packages/eve/src/runtime/connections/principal.test.ts
index 22fdf7522..d483a8f4d 100644
--- a/packages/eve/src/runtime/connections/principal.test.ts
+++ b/packages/eve/src/runtime/connections/principal.test.ts
@@ -176,7 +176,7 @@ describe("resolveConnectionPrincipal", () => {
const err = error as ConnectionAuthorizationFailedError;
expect(err.reason).toBe("principal_required");
expect(err.retryable).toBe(false);
- expect(err.message).toMatch(/outside an Eve context/);
+ expect(err.message).toMatch(/outside an eve context/);
}
});
});
diff --git a/packages/eve/src/runtime/connections/principal.ts b/packages/eve/src/runtime/connections/principal.ts
index 6b6f66e1e..44e18b579 100644
--- a/packages/eve/src/runtime/connections/principal.ts
+++ b/packages/eve/src/runtime/connections/principal.ts
@@ -88,7 +88,7 @@ export function resolveConnectionPrincipal(
message:
ctx === undefined
? `Connection "${connectionName}" declares principalType "user" ` +
- `but was invoked outside an Eve context, so no user principal can be resolved.`
+ `but was invoked outside an eve context, so no user principal can be resolved.`
: `Connection "${connectionName}" declares principalType "user" ` +
`but the active session has no authenticated user principal.`,
reason: "principal_required",
diff --git a/packages/eve/src/runtime/connections/scoped-authorization.ts b/packages/eve/src/runtime/connections/scoped-authorization.ts
index 5f9951d85..83b5cf651 100644
--- a/packages/eve/src/runtime/connections/scoped-authorization.ts
+++ b/packages/eve/src/runtime/connections/scoped-authorization.ts
@@ -88,7 +88,7 @@ export async function resolveScopedToken(input: ScopedAuthorization): Promise<To
* Called when an already-resolved bearer is rejected (a downstream
* `401`, or an explicit `requireAuth()` after a failed call) so the
* re-authorization attempt does not re-read the stale token. Drops two
- * layers: Eve's per-step cache, and — via the strategy's optional
+ * layers: eve's per-step cache, and — via the strategy's optional
* {@link AuthorizationDefinition.evict} hook — any cache the strategy
* itself owns (e.g. the `@vercel/connect` in-process token cache). The
* single shared eviction path here means both authored tools and MCP
diff --git a/packages/eve/src/runtime/connections/types.ts b/packages/eve/src/runtime/connections/types.ts
index 79546782e..faef6f9f0 100644
--- a/packages/eve/src/runtime/connections/types.ts
+++ b/packages/eve/src/runtime/connections/types.ts
@@ -195,7 +195,7 @@ interface AuthorizationDefinitionBase {
* Optional metadata marker attached by `connect()` from
* `@vercel/connect/eve` so downstream tooling can detect Vercel
* Connect-backed connections at compile time without inspecting
- * `getToken`'s closure state. Examples: a future Eve compiler step
+ * `getToken`'s closure state. Examples: a future eve compiler step
* that surfaces connector identifiers in build output, or the Vercel
* dashboard rendering deep links to a connector's settings page.
*
@@ -225,13 +225,13 @@ interface AuthorizationDefinitionBase {
/**
* Optional best-effort invalidation of any token cache the strategy
- * owns *below* Eve's per-step cache, for the given `principal`.
+ * owns *below* eve's per-step cache, for the given `principal`.
*
- * Eve always drops its own per-step entry when a resolved bearer is
+ * eve always drops its own per-step entry when a resolved bearer is
* rejected (a downstream `401` mapped to `ctx.requireAuth()`, or the
* MCP server rejecting the token). But a strategy frequently sits on a
* second, longer-lived cache — most notably the `@vercel/connect`
- * in-process token cache — that Eve cannot see. Without this hook the
+ * in-process token cache — that eve cannot see. Without this hook the
* re-authorization re-reads the same revoked-but-unexpired credential
* from that lower layer and the tool keeps failing.
*
diff --git a/packages/eve/src/runtime/connections/validate-authorization.ts b/packages/eve/src/runtime/connections/validate-authorization.ts
index a1ceea716..4518dcb3d 100644
--- a/packages/eve/src/runtime/connections/validate-authorization.ts
+++ b/packages/eve/src/runtime/connections/validate-authorization.ts
@@ -115,7 +115,7 @@ export function normalizeAuthorizationSpec(
* parsed marker when present and well-formed, otherwise `undefined`.
*
* The marker is opaque to the runtime — it exists so downstream tooling
- * (eg. the Eve compiler / Vercel dashboard) can attribute the auth
+ * (eg. the eve compiler / Vercel dashboard) can attribute the auth
* back to a Vercel Connect connector without inspecting `getToken`'s
* closure state. Validation is lenient (a malformed marker is dropped,
* not thrown) so a misbehaving auth provider can't fail an otherwise-
diff --git a/packages/eve/src/runtime/framework-tools/final-output.ts b/packages/eve/src/runtime/framework-tools/final-output.ts
index 389c4b0f7..f7be8749b 100644
--- a/packages/eve/src/runtime/framework-tools/final-output.ts
+++ b/packages/eve/src/runtime/framework-tools/final-output.ts
@@ -16,7 +16,7 @@ const FINAL_OUTPUT_TOOL_DESCRIPTION =
*
* The tool has no `execute`: calling it is the terminal signal the harness
* intercepts to surface the structured result. Its input is provider-constrained
- * to the schema during generation, exactly like every other Eve tool input.
+ * to the schema during generation, exactly like every other eve tool input.
*/
export function buildFinalOutputTool(schema: JsonObject): Tool {
return {
diff --git a/packages/eve/src/runtime/governance/auth/http-basic.ts b/packages/eve/src/runtime/governance/auth/http-basic.ts
index 180c3da79..2d805dd7e 100644
--- a/packages/eve/src/runtime/governance/auth/http-basic.ts
+++ b/packages/eve/src/runtime/governance/auth/http-basic.ts
@@ -6,7 +6,7 @@ import type {
} from "#runtime/governance/auth/types.js";
/**
- * Verifies one HTTP Basic credential against a resolved Eve strategy.
+ * Verifies one HTTP Basic credential against a resolved eve strategy.
*/
export function authenticateHttpBasicStrategy(input: {
readonly authorization: string;
diff --git a/packages/eve/src/runtime/governance/auth/token-claims.ts b/packages/eve/src/runtime/governance/auth/token-claims.ts
index ab30589d7..cdb5263b3 100644
--- a/packages/eve/src/runtime/governance/auth/token-claims.ts
+++ b/packages/eve/src/runtime/governance/auth/token-claims.ts
@@ -9,7 +9,7 @@ import type {
const STANDARD_PROJECTED_CLAIM_KEYS = new Set(["aud", "exp", "iat", "iss", "jti", "nbf", "sub"]);
/**
- * Returns the normalized string-valued JWT claim projection used by Eve's
+ * Returns the normalized string-valued JWT claim projection used by eve's
* runtime auth layer.
*/
function normalizeJwtClaims(payload: JWTPayload): RouteAuthAttributes {
@@ -84,7 +84,7 @@ export function areTokenClaimMatchersSatisfied(
}
/**
- * Creates a normalized JWT-backed Eve principal from a verified payload.
+ * Creates a normalized JWT-backed eve principal from a verified payload.
*/
export function createJwtAuthenticatedCallerPrincipal(input: {
readonly authenticator: AuthenticatedCallerPrincipal["authenticator"];
diff --git a/packages/eve/src/runtime/governance/auth/types.ts b/packages/eve/src/runtime/governance/auth/types.ts
index d8931ac94..33e3f7f9c 100644
--- a/packages/eve/src/runtime/governance/auth/types.ts
+++ b/packages/eve/src/runtime/governance/auth/types.ts
@@ -11,7 +11,7 @@ import type {
export type RouteAuthAttributes = RuntimeSessionAuthAttributes;
/**
- * One authenticated caller normalized into Eve-owned runtime metadata.
+ * One authenticated caller normalized into eve-owned runtime metadata.
*/
export interface AuthenticatedCallerPrincipal {
readonly attributes: RouteAuthAttributes;
diff --git a/packages/eve/src/runtime/loaders/artifact-paths.ts b/packages/eve/src/runtime/loaders/artifact-paths.ts
index 50928a55a..93a6f92b3 100644
--- a/packages/eve/src/runtime/loaders/artifact-paths.ts
+++ b/packages/eve/src/runtime/loaders/artifact-paths.ts
@@ -13,7 +13,7 @@ export interface RuntimeCompilerArtifactPaths {
}
/**
- * Resolves the stable Eve artifact paths for one application root without
+ * Resolves the stable eve artifact paths for one application root without
* depending on Node path helpers.
*/
export function resolveRuntimeCompilerArtifactPaths(appRoot: string): RuntimeCompilerArtifactPaths {
diff --git a/packages/eve/src/runtime/loaders/compile-metadata.ts b/packages/eve/src/runtime/loaders/compile-metadata.ts
index 1c2346623..d4f5b02f5 100644
--- a/packages/eve/src/runtime/loaders/compile-metadata.ts
+++ b/packages/eve/src/runtime/loaders/compile-metadata.ts
@@ -112,7 +112,7 @@ function parseCompileMetadata(value: unknown, metadataPath: string): CompileMeta
if (!parsed.success) {
throw new LoadCompileMetadataError(
- `Expected "${metadataPath}" to contain valid Eve compile metadata. ${formatValidationError(parsed.error)}`,
+ `Expected "${metadataPath}" to contain valid eve compile metadata. ${formatValidationError(parsed.error)}`,
metadataPath,
);
}
diff --git a/packages/eve/src/runtime/loaders/manifest.ts b/packages/eve/src/runtime/loaders/manifest.ts
index 6cf0478d7..4a4d216bc 100644
--- a/packages/eve/src/runtime/loaders/manifest.ts
+++ b/packages/eve/src/runtime/loaders/manifest.ts
@@ -72,7 +72,7 @@ function parseCompiledManifest(value: unknown, manifestPath: string): CompiledAg
if (!parsed.success) {
throw new LoadCompiledManifestError(
- `Expected "${manifestPath}" to contain a valid compiled Eve agent manifest. ${formatValidationError(parsed.error)}`,
+ `Expected "${manifestPath}" to contain a valid compiled eve agent manifest. ${formatValidationError(parsed.error)}`,
manifestPath,
);
}
diff --git a/packages/eve/src/runtime/loaders/module-map.ts b/packages/eve/src/runtime/loaders/module-map.ts
index 9961796cf..8ce380707 100644
--- a/packages/eve/src/runtime/loaders/module-map.ts
+++ b/packages/eve/src/runtime/loaders/module-map.ts
@@ -76,7 +76,7 @@ function parseCompiledModuleMap(value: unknown, moduleMapPath: string): Compiled
if (!parsed.success) {
throw new LoadCompiledModuleMapError(
- `Expected "${moduleMapPath}" to export a valid compiled Eve module map. ${formatValidationError(parsed.error)}`,
+ `Expected "${moduleMapPath}" to export a valid compiled eve module map. ${formatValidationError(parsed.error)}`,
moduleMapPath,
);
}
diff --git a/packages/eve/src/runtime/prompt/compose.ts b/packages/eve/src/runtime/prompt/compose.ts
index 8ab835dc2..82bb4cd06 100644
--- a/packages/eve/src/runtime/prompt/compose.ts
+++ b/packages/eve/src/runtime/prompt/compose.ts
@@ -9,7 +9,7 @@ import type { WorkspaceRuntimeSpec } from "#runtime/workspace/types.js";
import { formatConnectionsSection } from "#runtime/prompt/connections.js";
const PARALLEL_ACTION_INSTRUCTION =
- "Tool execution\nA single tool or subagent call runs as one serial action. If you call multiple independent tools or subagents in one response, Eve treats that batch as parallel work. Only batch work that is independent and does not rely on another call in the same response.";
+ "Tool execution\nA single tool or subagent call runs as one serial action. If you call multiple independent tools or subagents in one response, eve treats that batch as parallel work. Only batch work that is independent and does not rely on another call in the same response.";
/**
* Input for composing the base authored instructions prompt for one
diff --git a/packages/eve/src/runtime/resolve-channel.ts b/packages/eve/src/runtime/resolve-channel.ts
index 885ba4f1e..8831edb70 100644
--- a/packages/eve/src/runtime/resolve-channel.ts
+++ b/packages/eve/src/runtime/resolve-channel.ts
@@ -43,7 +43,7 @@ export async function resolveChannelDefinition(
});
const channelDefinition = normalizeChannelDefinition(
resolvedExportValue,
- `Expected the channel export "${definition.exportName ?? "default"}" from "${definition.logicalPath}" to match the public Eve shape.`,
+ `Expected the channel export "${definition.exportName ?? "default"}" from "${definition.logicalPath}" to match the public eve shape.`,
);
const sourceRef = createResolvedModuleSourceRef({
diff --git a/packages/eve/src/runtime/sandbox/keys.ts b/packages/eve/src/runtime/sandbox/keys.ts
index 9acc10bac..c1a9e6573 100644
--- a/packages/eve/src/runtime/sandbox/keys.ts
+++ b/packages/eve/src/runtime/sandbox/keys.ts
@@ -81,7 +81,7 @@ export async function createRuntimeSandboxTemplateKey(input: {
}
/**
- * Resolves the Eve package version that participates in template keys.
+ * Resolves the eve package version that participates in template keys.
*
* Build-time prewarm and deployed runtime must derive the same key, but a
* bundled runtime cannot resolve the installed package.json and may fall back
diff --git a/packages/eve/src/runtime/schedules/register.ts b/packages/eve/src/runtime/schedules/register.ts
index 4403e3911..13edc720e 100644
--- a/packages/eve/src/runtime/schedules/register.ts
+++ b/packages/eve/src/runtime/schedules/register.ts
@@ -61,7 +61,7 @@ export function createScheduleRegistrations(
const registrations = schedules
.map((schedule) => ({
cron: schedule.cron,
- description: `Run Eve schedule "${schedule.name}" from "${schedule.logicalPath}".`,
+ description: `Run eve schedule "${schedule.name}" from "${schedule.logicalPath}".`,
logicalPath: schedule.logicalPath,
scheduleId: schedule.name,
sourceId: schedule.sourceId,
diff --git a/packages/eve/src/runtime/sessions/auth.ts b/packages/eve/src/runtime/sessions/auth.ts
index 4b86f6027..528b05a37 100644
--- a/packages/eve/src/runtime/sessions/auth.ts
+++ b/packages/eve/src/runtime/sessions/auth.ts
@@ -1,7 +1,7 @@
import { z } from "#compiled/zod/index.js";
/**
- * Runtime-owned authenticator kinds projected into Eve session auth metadata.
+ * Runtime-owned authenticator kinds projected into eve session auth metadata.
*/
export type RuntimeSessionAuthenticator = "http-basic" | "jwt-hmac" | "jwt-ecdsa" | "oidc";
diff --git a/packages/eve/src/runtime/sessions/runtime-session.ts b/packages/eve/src/runtime/sessions/runtime-session.ts
index c0f684cf1..344356cf4 100644
--- a/packages/eve/src/runtime/sessions/runtime-session.ts
+++ b/packages/eve/src/runtime/sessions/runtime-session.ts
@@ -4,7 +4,7 @@ import type { BundledCompiledArtifacts } from "#runtime/loaders/bundled-artifact
import type { CompiledRuntimeAgentBundle } from "#runtime/sessions/compiled-agent-cache.js";
/**
- * Process-scoped container for mutable runtime state owned by one Eve
+ * Process-scoped container for mutable runtime state owned by one eve
* deployment.
*
* Holds installed compiled artifacts and compiled-agent bundle caches.
@@ -50,7 +50,7 @@ export function createRuntimeSession(id: string = "test-session"): RuntimeSessio
/**
* Process-global storage for the current `RuntimeSession`.
*
- * Rooted on `globalThis` so Nitro-inlined Eve and disk-imported Eve share
+ * Rooted on `globalThis` so Nitro-inlined eve and disk-imported eve share
* the same process default while tests still get async-scoped overrides.
*/
const RUNTIME_SESSION_STORAGE_GLOBAL_KEY = Symbol.for("eve.runtime-session-storage");
diff --git a/packages/eve/src/runtime/types.ts b/packages/eve/src/runtime/types.ts
index fbaa74919..514c3b882 100644
--- a/packages/eve/src/runtime/types.ts
+++ b/packages/eve/src/runtime/types.ts
@@ -142,7 +142,7 @@ export type ResolvedSandboxDefinition = ResolvedModuleSourceRef & {
/**
* Runtime-owned authored tool definition resolved from a compiled module map.
- * A tool without `execute` is surfaced to the client and never executed by Eve.
+ * A tool without `execute` is surfaced to the client and never executed by eve.
*/
export type ResolvedToolDefinition = Readonly<
Optional<InternalToolDefinitionWithExecuteFn<unknown, unknown>, "execute">
diff --git a/packages/eve/src/runtime/workspace/types.ts b/packages/eve/src/runtime/workspace/types.ts
index a26275416..32f612919 100644
--- a/packages/eve/src/runtime/workspace/types.ts
+++ b/packages/eve/src/runtime/workspace/types.ts
@@ -1,5 +1,5 @@
/**
- * Stable root directory for every workspace Eve exposes to agents and
+ * Stable root directory for every workspace eve exposes to agents and
* sandbox backends.
*
* This is both the model-facing logical path and the live `bash` cwd
diff --git a/packages/eve/src/services/dev-client/request-headers.ts b/packages/eve/src/services/dev-client/request-headers.ts
index 141568690..15e88433f 100644
--- a/packages/eve/src/services/dev-client/request-headers.ts
+++ b/packages/eve/src/services/dev-client/request-headers.ts
@@ -85,7 +85,7 @@ export const VERCEL_TRUSTED_OIDC_IDP_TOKEN_HEADER = "x-vercel-trusted-oidc-idp-t
export const VERCEL_OIDC_TOKEN_HEADER = "x-vercel-oidc-token";
/**
- * Header values accepted by Eve's development client helpers.
+ * Header values accepted by eve's development client helpers.
*/
export type DevelopmentRequestHeaders =
| Headers
@@ -103,7 +103,7 @@ function isEveRouteUrl(url: URL): boolean {
/**
* Creates request headers for one service-issued development request and
- * opportunistically refreshes a linked local Vercel OIDC token for Eve-owned
+ * opportunistically refreshes a linked local Vercel OIDC token for eve-owned
* routes when no explicit authorization header is present.
*/
export async function createDevelopmentRequestHeadersAsync(input: {
@@ -149,7 +149,7 @@ function attachEveRouteOidcHeaders(headers: Headers, oidcToken: string): void {
}
/**
- * Resolves an OIDC token for an Eve-owned request, asking
+ * Resolves an OIDC token for an eve-owned request, asking
* `@vercel/oidc` for a freshly-issued token when the CLI is linked to a
* Vercel project. Falls back to the forwarded runtime header or the
* `VERCEL_OIDC_TOKEN` environment variable.
@@ -172,7 +172,7 @@ async function resolveEveRouteOidcToken(
}
/**
- * Returns `true` when an Eve-route request should attempt to attach a
+ * Returns `true` when an eve-route request should attempt to attach a
* Vercel OIDC token. Local dev servers do not need (and cannot validate)
* the token, so this returns `false` for them.
*/
diff --git a/packages/eve/src/services/dev-client/vercel-auth-error.ts b/packages/eve/src/services/dev-client/vercel-auth-error.ts
index 810edc90e..542996aa8 100644
--- a/packages/eve/src/services/dev-client/vercel-auth-error.ts
+++ b/packages/eve/src/services/dev-client/vercel-auth-error.ts
@@ -3,7 +3,7 @@
* "Authentication Required" challenge that fronts protected previews and
* production deployments.
*
- * When the Eve development client (`eve dev --url …`) targets a deployment
+ * When the eve development client (`eve dev --url …`) targets a deployment
* that has Deployment Protection enabled and no valid bypass header is
* attached, Vercel returns an HTML SSO challenge instead of routing the
* request to the function. The raw HTML body is unhelpful in a CLI
diff --git a/packages/eve/src/services/inspect-application.ts b/packages/eve/src/services/inspect-application.ts
index 593349ee9..8dc3d84b3 100644
--- a/packages/eve/src/services/inspect-application.ts
+++ b/packages/eve/src/services/inspect-application.ts
@@ -31,7 +31,7 @@ export interface ApplicationInspection {
/**
* Resolves application details, compile artifacts, and the active message
- * contract for one Eve application root.
+ * contract for one eve application root.
*/
export async function inspectApplication(appRoot: string): Promise<ApplicationInspection> {
const compiledState = await loadCompiledApplicationState(appRoot);
diff --git a/packages/eve/src/setup/boxes/add-channels.test.ts b/packages/eve/src/setup/boxes/add-channels.test.ts
index 32916a048..20c88c49c 100644
--- a/packages/eve/src/setup/boxes/add-channels.test.ts
+++ b/packages/eve/src/setup/boxes/add-channels.test.ts
@@ -299,10 +299,10 @@ describe("addChannels box", () => {
expect(prompter.log.warning).toHaveBeenCalledWith("Overwrote /tmp/project/app/page.tsx");
expect(prompter.log.warning).toHaveBeenCalledWith(
- 'Overrode package.json engines.node from "22.x" to "24.x" because the previous value was not confined to the Node.js major selected by Eve.',
+ 'Overrode package.json engines.node from "22.x" to "24.x" because the previous value was not confined to the Node.js major selected by eve.',
);
expect(prompter.log.warning).toHaveBeenCalledWith(
- "Found competing Next.js config at /tmp/project/next.config.mjs; merge any needed settings into next.config.ts and remove it before starting the preview, or Next.js may ignore the generated Eve rewrite.",
+ "Found competing Next.js config at /tmp/project/next.config.mjs; merge any needed settings into next.config.ts and remove it before starting the preview, or Next.js may ignore the generated eve rewrite.",
);
});
diff --git a/packages/eve/src/setup/boxes/add-channels.ts b/packages/eve/src/setup/boxes/add-channels.ts
index 9586b9f7f..6d0b6c98d 100644
--- a/packages/eve/src/setup/boxes/add-channels.ts
+++ b/packages/eve/src/setup/boxes/add-channels.ts
@@ -148,7 +148,7 @@ export interface AddChannelsOptions {
*/
headless?: boolean;
/**
- * Eve package metadata for the scaffolded web `package.json`. When omitted,
+ * eve package metadata for the scaffolded web `package.json`. When omitted,
* every package value comes from the build-stamped defaults.
*/
evePackage?: EvePackageContract;
@@ -231,7 +231,7 @@ function warnCompetingNextConfigFiles(
): void {
for (const filePath of files ?? []) {
log.warning(
- `Found competing Next.js config at ${filePath}; merge any needed settings into next.config.ts and remove it before starting the preview, or Next.js may ignore the generated Eve rewrite.`,
+ `Found competing Next.js config at ${filePath}; merge any needed settings into next.config.ts and remove it before starting the preview, or Next.js may ignore the generated eve rewrite.`,
);
}
}
diff --git a/packages/eve/src/setup/boxes/deploy-project.test.ts b/packages/eve/src/setup/boxes/deploy-project.test.ts
index cdc264938..64124979f 100644
--- a/packages/eve/src/setup/boxes/deploy-project.test.ts
+++ b/packages/eve/src/setup/boxes/deploy-project.test.ts
@@ -217,7 +217,7 @@ describe("deployProject box", () => {
const next = await runHeadless([box], pendingState(), silentSink);
expect(prompter.log.warning).toHaveBeenCalledWith(
- "Deployment succeeded, but Eve could not verify its production URL.",
+ "Deployment succeeded, but eve could not verify its production URL.",
);
expect(prompter.log.error).not.toHaveBeenCalled();
expect(next.project).toEqual({ kind: "linked", projectId: "prj_demo" });
diff --git a/packages/eve/src/setup/boxes/deploy-project.ts b/packages/eve/src/setup/boxes/deploy-project.ts
index 4ed8d2c9a..9fc923677 100644
--- a/packages/eve/src/setup/boxes/deploy-project.ts
+++ b/packages/eve/src/setup/boxes/deploy-project.ts
@@ -195,7 +195,7 @@ export function deployProject(
if (productionUrl !== undefined) {
log.info(`Production URL: ${productionUrl}`);
} else {
- log.warning("Deployment succeeded, but Eve could not verify its production URL.");
+ log.warning("Deployment succeeded, but eve could not verify its production URL.");
}
const deployedProject = projectResolutionFromDeployResult(project, {
deployed: true,
diff --git a/packages/eve/src/setup/boxes/resolve-target.test.ts b/packages/eve/src/setup/boxes/resolve-target.test.ts
index d0fdfe319..09dd9af92 100644
--- a/packages/eve/src/setup/boxes/resolve-target.test.ts
+++ b/packages/eve/src/setup/boxes/resolve-target.test.ts
@@ -82,7 +82,7 @@ describe("resolveTarget box", () => {
);
});
- it("resumes an existing Eve project when the composition opted in (headless re-runs)", async () => {
+ it("resumes an existing eve project when the composition opted in (headless re-runs)", async () => {
mockedPathExists.mockImplementation(async (path) => path === "/tmp/parent/demo-agent");
mockedIsEveProject.mockResolvedValue(true);
const box = resolveTarget({
@@ -99,7 +99,7 @@ describe("resolveTarget box", () => {
});
});
- it("still refuses an existing directory that is not an Eve project, even when resumable", async () => {
+ it("still refuses an existing directory that is not an eve project, even when resumable", async () => {
mockedPathExists.mockImplementation(async (path) => path === "/tmp/parent/demo-agent");
mockedIsEveProject.mockResolvedValue(false);
const box = resolveTarget({
diff --git a/packages/eve/src/setup/boxes/resolve-target.ts b/packages/eve/src/setup/boxes/resolve-target.ts
index 67c9ee881..0f3634d09 100644
--- a/packages/eve/src/setup/boxes/resolve-target.ts
+++ b/packages/eve/src/setup/boxes/resolve-target.ts
@@ -41,7 +41,7 @@ export interface ResolveTargetOptions {
/** Force scaffolding into the target directory instead of a `./<name>` child. */
inPlace?: boolean;
/**
- * Treat an existing `./<name>` that is already an Eve project as resumable
+ * Treat an existing `./<name>` that is already an eve project as resumable
* instead of refusing it. Composed on for headless runs so re-runs converge;
* interactive runs keep refusing so a human notices the collision.
*/
@@ -103,7 +103,7 @@ function deriveInPlaceProjectName(targetDirectory: string | undefined): string {
* place or into a new `./<name>` child. The current-vs-new question only fires
* when the target directory already looks like a project; otherwise creating a
* new directory is the announced default. A headless re-run resumes an
- * existing Eve project directory instead of refusing it (composed via
+ * existing eve project directory instead of refusing it (composed via
* `resumeExisting`), so re-runs converge.
*/
export function resolveTarget(
@@ -115,7 +115,7 @@ export function resolveTarget(
/**
* Throws if `./<name>` already exists under `parent`, unless the composition
- * opted into resuming an existing Eve project there (headless re-runs). Used
+ * opted into resuming an existing eve project there (headless re-runs). Used
* for the "create a new directory" branch, where clobbering an existing
* folder is unsafe.
*/
diff --git a/packages/eve/src/setup/boxes/scaffold.test.ts b/packages/eve/src/setup/boxes/scaffold.test.ts
index 8d6537788..7b98a9536 100644
--- a/packages/eve/src/setup/boxes/scaffold.test.ts
+++ b/packages/eve/src/setup/boxes/scaffold.test.ts
@@ -100,7 +100,7 @@ describe("scaffold box", () => {
);
});
- it("headless re-run on an existing Eve project skips scaffolding and continues", async () => {
+ it("headless re-run on an existing eve project skips scaffolding and continues", async () => {
const deps = fakeDeps({ isEveProject: vi.fn(async () => true) });
const prompter = createPrompter();
const box = scaffold({ prompter, evePackage: TEST_EVE_PACKAGE, headless: true, deps });
@@ -109,12 +109,12 @@ describe("scaffold box", () => {
expect(deps.scaffoldBaseProject).not.toHaveBeenCalled();
expect(prompter.log.message).toHaveBeenCalledWith(
- "Existing Eve project detected; continuing setup...",
+ "Existing eve project detected; continuing setup...",
);
expect(next.projectPath).toEqual({ kind: "resolved", inPlace: false, path: "/tmp/my-agent" });
});
- it("interactive run scaffolds even when the directory is already an Eve project", async () => {
+ it("interactive run scaffolds even when the directory is already an eve project", async () => {
const deps = fakeDeps({ isEveProject: vi.fn(async () => true) });
const box = scaffold({ prompter: createPrompter(), evePackage: TEST_EVE_PACKAGE, deps });
@@ -124,7 +124,7 @@ describe("scaffold box", () => {
expect(deps.scaffoldBaseProject).toHaveBeenCalledTimes(1);
});
- it("headless overwriteExisting re-scaffolds an existing Eve project and warns per overwrite", async () => {
+ it("headless overwriteExisting re-scaffolds an existing eve project and warns per overwrite", async () => {
const deps = fakeDeps({ isEveProject: vi.fn(async () => true) });
const prompter = createPrompter();
const box = scaffold({
diff --git a/packages/eve/src/setup/boxes/scaffold.ts b/packages/eve/src/setup/boxes/scaffold.ts
index 433a768a7..6118f5bc7 100644
--- a/packages/eve/src/setup/boxes/scaffold.ts
+++ b/packages/eve/src/setup/boxes/scaffold.ts
@@ -20,10 +20,10 @@ export interface ScaffoldOptions {
evePackage?: EvePackageContract;
/** Parent directory the project folder is created inside. Defaults to cwd. */
targetDirectory?: string;
- /** Allow the in-place scaffold to replace Eve scaffold files that already exist. */
+ /** Allow the in-place scaffold to replace eve scaffold files that already exist. */
overwriteExisting?: boolean;
/**
- * Headless mode: a headless re-run over an existing Eve project skips
+ * Headless mode: a headless re-run over an existing eve project skips
* scaffolding (idempotent re-entry); an interactive run always scaffolds and
* lets `scaffoldBaseProject` own the in-place conflict rules. The box prompts
* for nothing, so this dispatch comes from the composition site.
@@ -33,7 +33,7 @@ export interface ScaffoldOptions {
}
/**
- * Whether the run is headless. A headless re-run over an existing Eve project
+ * Whether the run is headless. A headless re-run over an existing eve project
* skips scaffolding (idempotent re-entry); an interactive run always scaffolds.
*/
export interface ScaffoldInput {
@@ -43,7 +43,7 @@ export interface ScaffoldInput {
/**
* THE SCAFFOLD BOX: writes the base agent template into the path resolved by
* the target box. It prompts for nothing; the gather only records which mode
- * ran, because a headless re-run on an already-scaffolded Eve project skips the
+ * ran, because a headless re-run on an already-scaffolded eve project skips the
* write and continues setup instead of failing.
*/
export function scaffold(options: ScaffoldOptions): SetupBox<SetupState, ScaffoldInput, string> {
@@ -54,7 +54,7 @@ export function scaffold(options: ScaffoldOptions): SetupBox<SetupState, Scaffol
async gather(): Promise<ScaffoldInput> {
// No questions: the only difference between modes is whether a re-run over
- // an existing Eve project skips the write, a composition-time fact.
+ // an existing eve project skips the write, a composition-time fact.
return { headless: options.headless ?? false };
},
@@ -65,7 +65,7 @@ export function scaffold(options: ScaffoldOptions): SetupBox<SetupState, Scaffol
: state.agentName;
const projectPath = requireProjectPath(state);
if (input.headless && !options.overwriteExisting && (await deps.isEveProject(projectPath))) {
- prompter.log.message("Existing Eve project detected; continuing setup...");
+ prompter.log.message("Existing eve project detected; continuing setup...");
return projectPath;
}
diff --git a/packages/eve/src/setup/boxes/select-channels.test.ts b/packages/eve/src/setup/boxes/select-channels.test.ts
index 2c3a9e369..79a4c5c80 100644
--- a/packages/eve/src/setup/boxes/select-channels.test.ts
+++ b/packages/eve/src/setup/boxes/select-channels.test.ts
@@ -232,7 +232,7 @@ describe("selectChannels box", () => {
it("runs validateSelection on the preset path before recording the selection", async () => {
const validateSelection = vi.fn(async () => {
- throw new Error("existing Eve session channel");
+ throw new Error("existing eve session channel");
});
const box = selectChannels({
asker: headlessAsker(),
@@ -242,7 +242,7 @@ describe("selectChannels box", () => {
});
await expect(runInteractive([box], createDefaultSetupState(), silentSink)).rejects.toThrow(
- "existing Eve session channel",
+ "existing eve session channel",
);
expect(validateSelection).toHaveBeenCalledWith(["web"]);
});
diff --git a/packages/eve/src/setup/build.ts b/packages/eve/src/setup/build.ts
index af32ec912..653380ed9 100644
--- a/packages/eve/src/setup/build.ts
+++ b/packages/eve/src/setup/build.ts
@@ -32,7 +32,7 @@ const FILE_TRANSFORMS: Record<string, ReadonlyArray<readonly [string, string]>>
"app/_components/agent-chat.tsx": [
['const AGENT_NAME = "eve-agent";', 'const AGENT_NAME = "__EVE_INIT_APP_NAME__";'],
],
- "app/layout.tsx": [[' title: "Eve Next.js Starter",', ' title: "__EVE_INIT_APP_NAME__",']],
+ "app/layout.tsx": [[' title: "eve Next.js Starter",', ' title: "__EVE_INIT_APP_NAME__",']],
"next.config.ts": [
[
"export default withEve(nextConfig);",
diff --git a/packages/eve/src/setup/channel-add-conflicts.ts b/packages/eve/src/setup/channel-add-conflicts.ts
index a7cc0bcf9..0b7d79d72 100644
--- a/packages/eve/src/setup/channel-add-conflicts.ts
+++ b/packages/eve/src/setup/channel-add-conflicts.ts
@@ -90,7 +90,7 @@ export function assertCanAddSelectedChannels(
);
if (conflictingOwner !== undefined) {
throw new Error(
- `Cannot scaffold Web Chat because agent/${conflictingOwner} already defines POST ${EVE_CREATE_SESSION_ROUTE_PATH}. Web Chat scaffolds the same Eve session routes.`,
+ `Cannot scaffold Web Chat because agent/${conflictingOwner} already defines POST ${EVE_CREATE_SESSION_ROUTE_PATH}. Web Chat scaffolds the same eve session routes.`,
);
}
}
diff --git a/packages/eve/src/setup/cli/rail-log.ts b/packages/eve/src/setup/cli/rail-log.ts
index d4e98c9f8..dfc164de1 100644
--- a/packages/eve/src/setup/cli/rail-log.ts
+++ b/packages/eve/src/setup/cli/rail-log.ts
@@ -89,7 +89,7 @@ export interface RailLog extends ChannelSetupLog {
settle(): void;
}
-/** Options for the shared live rail log used by both Eve onboarding entry points. */
+/** Options for the shared live rail log used by both eve onboarding entry points. */
export interface RailLogOptions {
colors: PromptColors;
output: PromptOutput;
diff --git a/packages/eve/src/setup/flows/model.test.ts b/packages/eve/src/setup/flows/model.test.ts
index 89d6b9e9a..b2393b66d 100644
--- a/packages/eve/src/setup/flows/model.test.ts
+++ b/packages/eve/src/setup/flows/model.test.ts
@@ -174,7 +174,7 @@ describe("runModelFlow", () => {
it("disables only Change model for a gateway-routed SDK model call, keeping the provider row", async () => {
const { prompter, menuPaints } = scriptedPrompter({ menu: ["esc"] });
const deps = flowDeps({
- // `gateway("…")` instance: gateway-routed, but not a string literal Eve can rewrite.
+ // `gateway("…")` instance: gateway-routed, but not a string literal eve can rewrite.
readCurrentModel: vi.fn(async () => ({
id: "anthropic/claude-sonnet-4.6",
routing: { kind: "gateway", target: "anthropic" } as const,
diff --git a/packages/eve/src/setup/flows/model.ts b/packages/eve/src/setup/flows/model.ts
index ebac52fb4..d79d81520 100644
--- a/packages/eve/src/setup/flows/model.ts
+++ b/packages/eve/src/setup/flows/model.ts
@@ -59,7 +59,7 @@ export interface ModelFlowDeps {
* How the agent's model is backed right now, as far as the local directory
* shows: a linked Vercel project, a gateway credential in an env file, or
* nothing detectable. An external provider (own ANTHROPIC_API_KEY etc.)
- * leaves no marker Eve owns, so it reads as `unset`.
+ * leaves no marker eve owns, so it reads as `unset`.
*/
export type ModelProviderStatus =
| { kind: "unset" }
@@ -121,7 +121,7 @@ function providerStatusHint(
/**
* The two-row configure menu. The two rows answer independent questions.
*
- * The model row keys off `editable`: Eve can rewrite `model` only when it is a
+ * The model row keys off `editable`: eve can rewrite `model` only when it is a
* string literal, so an SDK model call (`gateway(...)` / `anthropic(...)`) is
* disabled regardless of how it routes. The provider row keys off routing: an
* external endpoint disables it (gateway credentials don't apply); a gateway
@@ -443,7 +443,7 @@ export async function changeAgentModel(input: {
* Returns a rejection message when `slug` is malformed or absent from the
* model catalog, or null when it is safe to apply.
*
- * UX note: `/model` only reports success after Eve confirms the id. A real
+ * UX note: `/model` only reports success after eve confirms the id. A real
* turn still needs Gateway/provider access, so treating an offline catalog as
* success would give a false "model changed" result.
*/
diff --git a/packages/eve/src/setup/headless.test.ts b/packages/eve/src/setup/headless.test.ts
index 599e0d430..d31522dd0 100644
--- a/packages/eve/src/setup/headless.test.ts
+++ b/packages/eve/src/setup/headless.test.ts
@@ -30,11 +30,11 @@ describe("createHeadlessPrompter", () => {
test("routes log output to the sink", () => {
const lines: string[] = [];
const prompter = createHeadlessPrompter((text) => lines.push(text));
- prompter.intro("Create a new Eve agent", "subtitle");
+ prompter.intro("Create a new eve agent", "subtitle");
prompter.log.success("scaffolded");
prompter.log.error("boom");
prompter.outro("done");
- expect(lines).toEqual(["Create a new Eve agent: subtitle", "scaffolded", "boom", "done"]);
+ expect(lines).toEqual(["Create a new eve agent: subtitle", "scaffolded", "boom", "done"]);
});
});
diff --git a/packages/eve/src/setup/index.ts b/packages/eve/src/setup/index.ts
index ac4411c43..b10f4f2f0 100644
--- a/packages/eve/src/setup/index.ts
+++ b/packages/eve/src/setup/index.ts
@@ -1,5 +1,5 @@
// Public setup primitives remain available for programmatic onboarding flows,
-// even though Eve currently exposes no setup wizard command.
+// even though eve currently exposes no setup wizard command.
export { type OutputSink, type SetupBox, WizardCancelledError } from "./step.js";
export { InteractionRequired } from "./ask.js";
export {
diff --git a/packages/eve/src/setup/node-engine.test.ts b/packages/eve/src/setup/node-engine.test.ts
index 3bccb5ab9..facf6e21d 100644
--- a/packages/eve/src/setup/node-engine.test.ts
+++ b/packages/eve/src/setup/node-engine.test.ts
@@ -7,7 +7,7 @@ import {
} from "./node-engine.js";
describe("reconcileNodeEngine", () => {
- // Each row is the authored `engines.node` value reconciled against Eve's
+ // Each row is the authored `engines.node` value reconciled against eve's
// ">=24" requirement (pinned major "24.x") and the result it must produce.
it.each<[unknown, NodeEngineReconciliation]>([
// Confined to the scaffolded major → kept as authored.
diff --git a/packages/eve/src/setup/node-engine.ts b/packages/eve/src/setup/node-engine.ts
index 565381c6f..1fd1bb079 100644
--- a/packages/eve/src/setup/node-engine.ts
+++ b/packages/eve/src/setup/node-engine.ts
@@ -2,7 +2,7 @@ import semver from "#compiled/semver/index.js";
const { Range, intersects, minVersion, subset, validRange } = semver;
-/** An authored Node.js engine value replaced by Eve's selected scaffold major. */
+/** An authored Node.js engine value replaced by eve's selected scaffold major. */
export interface NodeEngineOverride {
previous: unknown;
next: string;
@@ -42,21 +42,21 @@ function nextAllowedMajor(requiredRange: string, currentMajor: number): number |
/**
* The single-major `engines.node` value a generated project should declare,
- * derived from Eve's required range — e.g. `">=24"` → `"24.x"`. A scaffolded
+ * derived from eve's required range — e.g. `">=24"` → `"24.x"`. A scaffolded
* app is a deployment artifact, not a library: Vercel reads `engines.node` to
* pick the build's Node and resolves an open range to the newest *supported*
* major, so `">=24"` would float onto a future major as Vercel widens its set,
* whereas `"24.x"` stays on major 24 while still taking minor/patch updates.
- * Eve's own package keeps the open range; only generated apps pin.
+ * eve's own package keeps the open range; only generated apps pin.
*/
export function pinnedNodeEngineMajor(requiredRange: string): string {
const normalized = validRange(requiredRange);
if (normalized === null) {
- throw new Error(`Eve declares an invalid Node.js engine range: "${requiredRange}".`);
+ throw new Error(`eve declares an invalid Node.js engine range: "${requiredRange}".`);
}
const floor = minVersion(normalized);
if (floor === null) {
- throw new Error(`Eve declares an empty Node.js engine range: "${requiredRange}".`);
+ throw new Error(`eve declares an empty Node.js engine range: "${requiredRange}".`);
}
let candidateMajor: number | undefined = floor.major;
@@ -69,13 +69,13 @@ export function pinnedNodeEngineMajor(requiredRange: string): string {
}
throw new Error(
- `Eve's Node.js engine range "${requiredRange}" cannot be represented by a major pin without widening it.`,
+ `eve's Node.js engine range "${requiredRange}" cannot be represented by a major pin without widening it.`,
);
}
/**
* Reconciles an authored `engines.node` value with the single Node.js major
- * selected for scaffolded Eve projects. Existing ranges are preserved only
+ * selected for scaffolded eve projects. Existing ranges are preserved only
* when every version they permit remains inside that selected major.
*/
export function reconcileNodeEngine(
@@ -100,10 +100,10 @@ function formatPackageJsonValue(value: unknown): string {
return JSON.stringify(value) ?? String(value);
}
-/** Formats the warning shown when Eve replaces an incompatible Node.js engine value. */
+/** Formats the warning shown when eve replaces an incompatible Node.js engine value. */
export function formatNodeEngineOverrideWarning(override: NodeEngineOverride): string {
return (
`Overrode package.json engines.node from ${formatPackageJsonValue(override.previous)} ` +
- `to "${override.next}" because the previous value was not confined to the Node.js major selected by Eve.`
+ `to "${override.next}" because the previous value was not confined to the Node.js major selected by eve.`
);
}
diff --git a/packages/eve/src/setup/onboarding.ts b/packages/eve/src/setup/onboarding.ts
index 74b5ef745..5e1569667 100644
--- a/packages/eve/src/setup/onboarding.ts
+++ b/packages/eve/src/setup/onboarding.ts
@@ -57,7 +57,7 @@ export interface OnboardingBoxesOptions {
targetDirectory?: string;
/** Scaffold into cwd or targetDirectory instead of creating a child directory. */
inPlace?: boolean;
- /** Allow the in-place scaffold to replace Eve scaffold files that already exist. */
+ /** Allow the in-place scaffold to replace eve scaffold files that already exist. */
overwriteExisting?: boolean;
/** Skip the post-channel Vercel deployment entirely. */
presetNoDeploy?: boolean;
@@ -67,7 +67,7 @@ export interface OnboardingBoxesOptions {
* setup remains an interactive/onboarding handoff, not a headless flow.
*/
headless?: boolean;
- /** Eve package metadata baked into the scaffolded `package.json`. */
+ /** eve package metadata baked into the scaffolded `package.json`. */
evePackage?: EvePackageContract;
}
@@ -134,7 +134,7 @@ export function composeOnboardingBoxes(options: OnboardingBoxesOptions): AnySetu
presetName: options.presetName,
targetDirectory: options.targetDirectory,
inPlace: options.inPlace,
- // Only headless re-runs converge onto an existing Eve project directory;
+ // Only headless re-runs converge onto an existing eve project directory;
// interactive runs keep refusing so a human notices the collision.
resumeExisting: options.headless,
}),
diff --git a/packages/eve/src/setup/primitives/open-url.ts b/packages/eve/src/setup/primitives/open-url.ts
index 2a38a341b..7452db961 100644
--- a/packages/eve/src/setup/primitives/open-url.ts
+++ b/packages/eve/src/setup/primitives/open-url.ts
@@ -27,7 +27,7 @@ export function parseWebUrl(candidate: string): string | undefined {
/**
* Opens a URL in the user's default browser, best-effort and fire-and-forget.
- * Used where Eve owns the hand-off (e.g. pointing the user at their Slack
+ * Used where eve owns the hand-off (e.g. pointing the user at their Slack
* workspace after a deploy) rather than relying on a child CLI to open it. A
* missing or failing opener is never fatal: callers still print the URL for the
* user to open by hand.
diff --git a/packages/eve/src/setup/primitives/pm/pnpm.ts b/packages/eve/src/setup/primitives/pm/pnpm.ts
index e84b19a9d..607e320e4 100644
--- a/packages/eve/src/setup/primitives/pm/pnpm.ts
+++ b/packages/eve/src/setup/primitives/pm/pnpm.ts
@@ -15,7 +15,7 @@ export const PNPM_WORKSPACE_CONTENT = [
" - eve",
"allowBuilds:",
" sharp: false",
- "# Compatibility for Eve releases with an incomplete runtime manifest.",
+ "# Compatibility for eve releases with an incomplete runtime manifest.",
"packageExtensions:",
' "eve@>=0.6.0-beta.13 <=0.7.0":',
" dependencies:",
diff --git a/packages/eve/src/setup/primitives/pm/run.ts b/packages/eve/src/setup/primitives/pm/run.ts
index dd8b26161..0a8678ac2 100644
--- a/packages/eve/src/setup/primitives/pm/run.ts
+++ b/packages/eve/src/setup/primitives/pm/run.ts
@@ -213,7 +213,7 @@ export async function runPackageManagerInstall(
return spawnPackageManager(kind, projectRoot, strategy.installArguments(installOptions), options);
}
-/** The argv that runs the locally installed Eve binary's `dev` command. */
+/** The argv that runs the locally installed eve binary's `dev` command. */
export function eveDevArguments(kind: PackageManagerKind): readonly string[] {
return getPackageManagerStrategy(kind).devArguments();
}
diff --git a/packages/eve/src/setup/primitives/pm/types.ts b/packages/eve/src/setup/primitives/pm/types.ts
index 99e7e5e8b..565355c54 100644
--- a/packages/eve/src/setup/primitives/pm/types.ts
+++ b/packages/eve/src/setup/primitives/pm/types.ts
@@ -33,7 +33,7 @@ export interface PackageManagerStrategy {
readonly scaffoldFiles: Readonly<Record<string, string>>;
/** Adds or reconciles manager-owned configuration in an existing project. */
applyProjectConfiguration(projectRoot: string): Promise<PackageManagerConfigurationResult>;
- /** Arguments that run the project-local Eve development command. */
+ /** Arguments that run the project-local eve development command. */
devArguments(): readonly string[];
/** Arguments that install project dependencies. */
installArguments(options: PackageManagerInstallOptions): readonly string[];
diff --git a/packages/eve/src/setup/scaffold/connections/catalog.ts b/packages/eve/src/setup/scaffold/connections/catalog.ts
index b77e94021..f9ec660cd 100644
--- a/packages/eve/src/setup/scaffold/connections/catalog.ts
+++ b/packages/eve/src/setup/scaffold/connections/catalog.ts
@@ -1,5 +1,5 @@
/**
- * Build-time catalog of known Eve connections. Each entry drives both the
+ * Build-time catalog of known eve connections. Each entry drives both the
* `eve connections add` picker and the per-entry scaffold template.
*
* Connection *identity* (slug, label, transport, description) is owned by
diff --git a/packages/eve/src/setup/scaffold/create/add-to-project.ts b/packages/eve/src/setup/scaffold/create/add-to-project.ts
index d399613a5..b2fe68355 100644
--- a/packages/eve/src/setup/scaffold/create/add-to-project.ts
+++ b/packages/eve/src/setup/scaffold/create/add-to-project.ts
@@ -62,8 +62,8 @@ function hasDeclaredDependency(packageJson: unknown, dependencyName: string): bo
}
/**
- * Adds an Eve agent to an existing package: writes the `agent/` files, adds
- * missing runtime dependencies, reconciles `engines.node` with Eve's
+ * Adds an eve agent to an existing package: writes the `agent/` files, adds
+ * missing runtime dependencies, reconciles `engines.node` with eve's
* requirement, and applies the selected package manager's project
* configuration. Other host configuration (tsconfig, scripts, ignore files)
* remains untouched. All conflicts are gathered and reported before anything
@@ -75,7 +75,7 @@ export async function addAgentToProject(
const packageJsonPath = join(options.projectRoot, "package.json");
if (!(await pathExists(packageJsonPath))) {
throw new Error(
- `Cannot add an Eve agent to "${options.projectRoot}" because it has no package.json. ` +
+ `Cannot add an eve agent to "${options.projectRoot}" because it has no package.json. ` +
"Run `eve init <name>` to create a new project instead.",
);
}
@@ -92,7 +92,7 @@ export async function addAgentToProject(
}
if (conflicts.length > 0) {
throw new Error(
- `Cannot add an Eve agent to "${options.projectRoot}" because it already has: ` +
+ `Cannot add an eve agent to "${options.projectRoot}" because it already has: ` +
`${conflicts.join(", ")}. Move them aside first.`,
);
}
diff --git a/packages/eve/src/setup/scaffold/create/project.ts b/packages/eve/src/setup/scaffold/create/project.ts
index 207c816a2..71f84c51b 100644
--- a/packages/eve/src/setup/scaffold/create/project.ts
+++ b/packages/eve/src/setup/scaffold/create/project.ts
@@ -19,15 +19,15 @@ export const DEFAULT_ZOD_PACKAGE_VERSION = "__ZOD_VERSION__";
const DEFAULT_TSGO_PACKAGE_VERSION = "__TSGO_VERSION__";
/**
- * The Eve package metadata that generated projects consume together. Keeping
+ * The eve package metadata that generated projects consume together. Keeping
* the dependency version and Node.js requirement in one value prevents a
- * scaffold from installing one Eve release while declaring another release's
+ * scaffold from installing one eve release while declaring another release's
* runtime contract.
*/
export interface EvePackageContract {
- /** Eve dependency version or npm specifier written to the generated package. */
+ /** eve dependency version or npm specifier written to the generated package. */
version: string;
- /** The matching Eve release's authored `package.json` `engines.node` value. */
+ /** The matching eve release's authored `package.json` `engines.node` value. */
nodeEngine: string;
}
@@ -36,7 +36,7 @@ export const DEFAULT_EVE_PACKAGE_CONTRACT: EvePackageContract = {
nodeEngine: "__NODE_ENGINE__",
};
-/** Resolves a stamped or explicitly supplied Eve package contract. */
+/** Resolves a stamped or explicitly supplied eve package contract. */
export function resolveEvePackageContract(
contract: EvePackageContract = DEFAULT_EVE_PACKAGE_CONTRACT,
): EvePackageContract {
@@ -235,9 +235,9 @@ dist
.nitro
dist
`,
- "AGENTS.md": `# Eve Agent App
+ "AGENTS.md": `# eve Agent App
-This project uses the Eve framework. Before writing code, always read the relevant guide in \`node_modules/eve/docs/\`.
+This project uses the eve framework. Before writing code, always read the relevant guide in \`node_modules/eve/docs/\`.
`,
"CLAUDE.md": `@AGENTS.md
`,
diff --git a/packages/eve/src/setup/scaffold/create/web-template.ts b/packages/eve/src/setup/scaffold/create/web-template.ts
index 6e06a8c2c..3de8f1ca2 100644
--- a/packages/eve/src/setup/scaffold/create/web-template.ts
+++ b/packages/eve/src/setup/scaffold/create/web-template.ts
@@ -3,7 +3,7 @@
export const WEB_APP_TEMPLATE_FILES = {
"agent/channels/eve.ts":
- 'import { eveChannel } from "eve/channels/eve";\nimport { localDev, placeholderAuth, vercelOidc } from "eve/channels/auth";\n\nexport default eveChannel({\n auth: [\n // Open on localhost for `eve dev` and the REPL; ignored in production.\n localDev(),\n // Lets the Eve TUI and your Vercel deployments reach the deployed agent.\n vercelOidc(),\n // This placeholder will not allow browser requests in production.\n // Replace it with your app\'s auth provider, like Auth.js or Clerk,\n // or use none() for a public demo.\n placeholderAuth(),\n ],\n});\n',
+ 'import { eveChannel } from "eve/channels/eve";\nimport { localDev, placeholderAuth, vercelOidc } from "eve/channels/auth";\n\nexport default eveChannel({\n auth: [\n // Open on localhost for `eve dev` and the REPL; ignored in production.\n localDev(),\n // Lets the eve TUI and your Vercel deployments reach the deployed agent.\n vercelOidc(),\n // This placeholder will not allow browser requests in production.\n // Replace it with your app\'s auth provider, like Auth.js or Clerk,\n // or use none() for a public demo.\n placeholderAuth(),\n ],\n});\n',
"app/_components/agent-chat.tsx":
'"use client";\n\nimport { useEveAgent } from "eve/react";\nimport { AlertCircleIcon } from "lucide-react";\nimport {\n Conversation,\n ConversationContent,\n ConversationScrollButton,\n} from "@/components/ai-elements/conversation";\nimport {\n PromptInput,\n type PromptInputMessage,\n PromptInputSubmit,\n PromptInputTextarea,\n} from "@/components/ai-elements/prompt-input";\nimport { cn } from "@/lib/utils";\nimport { AgentMessage } from "./agent-message";\n\nconst AGENT_NAME = "__EVE_INIT_APP_NAME__";\nconst BETA_TERMS_HREF = "https://vercel.com/docs/release-phases/public-beta-agreement";\n\ntype AgentStatus = ReturnType<typeof useEveAgent>["status"];\n\nexport function AgentChat() {\n const agent = useEveAgent();\n const isBusy = agent.status === "submitted" || agent.status === "streaming";\n const isEmpty = agent.data.messages.length === 0;\n\n const handleSubmit = async (message: PromptInputMessage) => {\n const text = message.text.trim();\n if (!text || isBusy) return;\n\n await agent.send({ message: text });\n };\n\n const composer = (\n <PromptInput onSubmit={handleSubmit}>\n <PromptInputTextarea placeholder="Send a message…" />\n <PromptInputSubmit onStop={agent.stop} status={agent.status} />\n </PromptInput>\n );\n\n return (\n <main className="flex h-dvh flex-col overflow-hidden bg-background text-foreground">\n {isEmpty ? null : (\n <header className="flex h-14 shrink-0 items-center justify-center gap-3 pl-4 pr-2">\n <span className="flex min-w-0 items-center gap-2">\n <span className="truncate text-muted-foreground text-sm">{AGENT_NAME}</span>\n <StatusDot status={agent.status} />\n </span>\n <a\n className="rounded-full border border-amber-500/30 px-2 py-0.5 font-medium text-amber-700 text-xs transition-colors hover:bg-amber-500/10 dark:text-amber-300"\n href={BETA_TERMS_HREF}\n rel="noreferrer"\n target="_blank"\n >\n Public preview\n </a>\n </header>\n )}\n\n {agent.error ? (\n <div className="mx-auto w-full max-w-3xl shrink-0 px-4 pt-2 sm:px-6">\n <div className="flex items-start gap-3 rounded-lg border border-destructive/30 bg-destructive/5 px-3 py-2.5 text-sm">\n <AlertCircleIcon className="mt-0.5 size-4 shrink-0 text-destructive" />\n <div>\n <p className="font-medium">Request failed</p>\n <p className="mt-0.5 text-muted-foreground">{agent.error.message}</p>\n </div>\n </div>\n </div>\n ) : null}\n\n {isEmpty ? null : (\n <Conversation className="min-h-0 flex-1">\n <ConversationContent className="mx-auto w-full max-w-3xl gap-6 px-4 py-6 sm:px-6">\n {agent.data.messages.map((message, index) => (\n <AgentMessage\n canRespond={!isBusy}\n isStreaming={\n agent.status === "streaming" && index === agent.data.messages.length - 1\n }\n key={message.id}\n message={message}\n onInputResponses={(inputResponses) => agent.send({ inputResponses })}\n />\n ))}\n </ConversationContent>\n <ConversationScrollButton />\n </Conversation>\n )}\n\n <div\n className={cn(\n "mx-auto w-full px-4 sm:px-6",\n isEmpty\n ? "flex max-w-xl flex-1 flex-col items-center justify-center gap-8 pb-[10vh]"\n : "max-w-3xl shrink-0 pb-6",\n )}\n >\n {isEmpty ? (\n <div className="flex flex-col items-center gap-3 text-center">\n <h1 className="font-medium text-5xl tracking-tighter">{AGENT_NAME}</h1>\n <a\n className="rounded-full border border-amber-500/30 px-2 py-0.5 font-medium text-amber-700 text-xs transition-colors hover:bg-amber-500/10 dark:text-amber-300"\n href={BETA_TERMS_HREF}\n rel="noreferrer"\n target="_blank"\n >\n Public preview\n </a>\n </div>\n ) : null}\n <div className="w-full">{composer}</div>\n </div>\n </main>\n );\n}\n\nfunction StatusDot({ status }: { readonly status: AgentStatus }) {\n const isLive = status === "submitted" || status === "streaming";\n const tone =\n status === "error"\n ? "bg-destructive"\n : isLive\n ? "bg-emerald-500"\n : status === "ready"\n ? "bg-muted-foreground"\n : "bg-muted-foreground/50";\n\n return (\n <span className="relative flex size-1">\n {isLive ? (\n <span\n className={cn(\n "absolute inline-flex size-full animate-ping rounded-full opacity-75",\n tone,\n )}\n />\n ) : null}\n <span className={cn("relative inline-flex size-1 rounded-full transition-colors", tone)} />\n </span>\n );\n}\n',
"app/_components/agent-message.tsx":
@@ -11,7 +11,7 @@ export const WEB_APP_TEMPLATE_FILES = {
"app/globals.css":
'@import "tailwindcss";\n@source "../node_modules/streamdown/dist/*.js";\n\n@theme inline {\n --color-background: var(--background);\n --color-foreground: var(--foreground);\n --color-card: var(--card);\n --color-card-foreground: var(--card-foreground);\n --color-popover: var(--popover);\n --color-popover-foreground: var(--popover-foreground);\n --color-primary: var(--primary);\n --color-primary-foreground: var(--primary-foreground);\n --color-secondary: var(--secondary);\n --color-secondary-foreground: var(--secondary-foreground);\n --color-muted: var(--muted);\n --color-muted-foreground: var(--muted-foreground);\n --color-accent: var(--accent);\n --color-accent-foreground: var(--accent-foreground);\n --color-destructive: var(--destructive);\n --color-border: var(--border);\n --color-input: var(--input);\n --color-ring: var(--ring);\n --radius-sm: calc(var(--radius) - 4px);\n --radius-md: calc(var(--radius) - 2px);\n --radius-lg: var(--radius);\n --radius-xl: calc(var(--radius) + 4px);\n --font-sans: "Geist", "Geist Fallback", ui-sans-serif, system-ui, sans-serif;\n --font-mono: "Geist Mono", "Geist Mono Fallback", ui-monospace, monospace;\n}\n\n:root {\n color-scheme: light;\n /* Soft neutral page with white elevated surfaces so cards/composer pop. */\n --background: oklch(0.971 0 0);\n --foreground: oklch(0.16 0 0);\n --card: oklch(1 0 0);\n --card-foreground: oklch(0.16 0 0);\n --popover: oklch(1 0 0);\n --popover-foreground: oklch(0.16 0 0);\n --primary: oklch(0.19 0 0);\n --primary-foreground: oklch(0.985 0 0);\n --secondary: oklch(0.94 0 0);\n --secondary-foreground: oklch(0.19 0 0);\n --muted: oklch(0.94 0 0);\n --muted-foreground: oklch(0.6 0 0);\n --accent: oklch(0.94 0 0);\n --accent-foreground: oklch(0.19 0 0);\n --destructive: oklch(0.577 0.245 27.325);\n --border: oklch(0.916 0 0);\n --input: oklch(0.916 0 0);\n --ring: oklch(0.708 0 0);\n --radius: 0.625rem;\n}\n\n@media (prefers-color-scheme: dark) {\n :root {\n color-scheme: dark;\n --background: oklch(0.145 0 0);\n --foreground: oklch(0.985 0 0);\n --card: oklch(0.205 0 0);\n --card-foreground: oklch(0.985 0 0);\n --popover: oklch(0.205 0 0);\n --popover-foreground: oklch(0.985 0 0);\n --primary: oklch(0.922 0 0);\n --primary-foreground: oklch(0.205 0 0);\n --secondary: oklch(0.269 0 0);\n --secondary-foreground: oklch(0.985 0 0);\n --muted: oklch(0.269 0 0);\n --muted-foreground: oklch(0.708 0 0);\n --accent: oklch(0.269 0 0);\n --accent-foreground: oklch(0.985 0 0);\n --destructive: oklch(0.704 0.191 22.216);\n --border: oklch(1 0 0 / 10%);\n --input: oklch(1 0 0 / 15%);\n --ring: oklch(0.556 0 0);\n }\n}\n\n* {\n border-color: var(--border);\n}\n\nhtml {\n height: 100%;\n}\n\nbody {\n min-height: 100%;\n margin: 0;\n background: var(--background);\n font-family: var(--font-sans);\n}\n\nbutton,\ninput,\ntextarea {\n font: inherit;\n}\n',
"app/layout.tsx":
- 'import type { Metadata } from "next";\nimport { Geist, Geist_Mono } from "next/font/google";\nimport type { ReactNode } from "react";\nimport { TooltipProvider } from "@/components/ui/tooltip";\nimport { cn } from "@/lib/utils";\nimport "./globals.css";\n\nconst sans = Geist({\n variable: "--font-sans",\n subsets: ["latin"],\n weight: "variable",\n display: "swap",\n});\n\nconst mono = Geist_Mono({\n variable: "--font-mono",\n subsets: ["latin"],\n weight: "variable",\n display: "swap",\n});\n\nexport const metadata: Metadata = {\n title: "__EVE_INIT_APP_NAME__",\n description: "A Next.js starter for Eve agents with AI Elements.",\n};\n\nexport default function RootLayout({ children }: { readonly children: ReactNode }) {\n return (\n <html className={cn(sans.variable, mono.variable)} lang="en">\n <body>\n <TooltipProvider>{children}</TooltipProvider>\n </body>\n </html>\n );\n}\n',
+ 'import type { Metadata } from "next";\nimport { Geist, Geist_Mono } from "next/font/google";\nimport type { ReactNode } from "react";\nimport { TooltipProvider } from "@/components/ui/tooltip";\nimport { cn } from "@/lib/utils";\nimport "./globals.css";\n\nconst sans = Geist({\n variable: "--font-sans",\n subsets: ["latin"],\n weight: "variable",\n display: "swap",\n});\n\nconst mono = Geist_Mono({\n variable: "--font-mono",\n subsets: ["latin"],\n weight: "variable",\n display: "swap",\n});\n\nexport const metadata: Metadata = {\n title: "__EVE_INIT_APP_NAME__",\n description: "A Next.js starter for eve agents with AI Elements.",\n};\n\nexport default function RootLayout({ children }: { readonly children: ReactNode }) {\n return (\n <html className={cn(sans.variable, mono.variable)} lang="en">\n <body>\n <TooltipProvider>{children}</TooltipProvider>\n </body>\n </html>\n );\n}\n',
"app/page.tsx":
'import { AgentChat } from "@/app/_components/agent-chat";\n\nexport default function Page() {\n return <AgentChat />;\n}\n',
"components/ai-elements/chain-of-thought.tsx":
diff --git a/packages/eve/src/setup/scaffold/index.integration.test.ts b/packages/eve/src/setup/scaffold/index.integration.test.ts
index 56beecdbf..c244d7efd 100644
--- a/packages/eve/src/setup/scaffold/index.integration.test.ts
+++ b/packages/eve/src/setup/scaffold/index.integration.test.ts
@@ -456,7 +456,7 @@ describe("ensureChannel", () => {
expect(result.filesWritten).toContain(pnpmWorkspacePath);
});
- test("adds the Eve release age exclusion to an existing pnpm workspace exclusion list", async () => {
+ test("adds the eve release age exclusion to an existing pnpm workspace exclusion list", async () => {
const projectRoot = await createTempDir();
const pnpmWorkspacePath = join(projectRoot, "pnpm-workspace.yaml");
await writeFile(
@@ -560,7 +560,7 @@ describe("listAuthoredChannels", () => {
});
describe("scaffoldBaseProject", () => {
- test("writes a base Eve project with explicit versions", async () => {
+ test("writes a base eve project with explicit versions", async () => {
const targetDirectory = await createTempDir();
const projectRoot = await scaffoldBaseProject({
projectName: "demo-agent",
diff --git a/packages/eve/src/setup/scaffold/update/package-json.ts b/packages/eve/src/setup/scaffold/update/package-json.ts
index e62b44431..027d7c8c1 100644
--- a/packages/eve/src/setup/scaffold/update/package-json.ts
+++ b/packages/eve/src/setup/scaffold/update/package-json.ts
@@ -7,7 +7,7 @@ export interface PackageJsonPatch {
devDependencies?: Record<string, string>;
scripts?: Record<string, string>;
/**
- * Eve's required Node.js range (e.g. `">=24"`). When the target's
+ * eve's required Node.js range (e.g. `">=24"`). When the target's
* `engines.node` is absent or is not confined to the scaffolded major, it is
* set to that pinned major (e.g. `"24.x"`). Existing ranges within the same
* major are left untouched.
diff --git a/packages/eve/src/setup/slack-connect-lifecycle.ts b/packages/eve/src/setup/slack-connect-lifecycle.ts
index ed81f8b53..50dc671fe 100644
--- a/packages/eve/src/setup/slack-connect-lifecycle.ts
+++ b/packages/eve/src/setup/slack-connect-lifecycle.ts
@@ -117,7 +117,7 @@ export async function findSlackConnector(
}
/**
- * Outcome of pointing a connector's trigger destination at this project's Eve
+ * Outcome of pointing a connector's trigger destination at this project's eve
* route. Detach and attach are reported separately because attach must not run
* while an old trigger destination may still exist. A `detach-failed` connector
* is left in a known-stale state the caller surfaces with manual recovery steps.
@@ -128,7 +128,7 @@ export type SlackConnectorAttachmentResult =
| { state: "attach-failed" };
/**
- * Replaces the connector's default trigger destination with the Eve route:
+ * Replaces the connector's default trigger destination with the eve route:
* detach the existing destination first, then attach this project. Either
* subprocess failing short-circuits so a half-configured connector is reported
* rather than silently left pointing at the wrong place.
@@ -279,7 +279,7 @@ export async function cleanupCreatedAttempt(
}
context.log.warning(
- "Vercel returned no connector UID for the abandoned Slack Connect request, so Eve cannot prove that request was cancelled. No connector was removed; do not retry until the browser request is no longer usable.",
+ "Vercel returned no connector UID for the abandoned Slack Connect request, so eve cannot prove that request was cancelled. No connector was removed; do not retry until the browser request is no longer usable.",
);
const inventory = await listSlackConnectors(context.deps, context.projectRoot, context.onOutput);
if (inventory.state === "failed") return { state: "failed", connectorUids: [] };
diff --git a/packages/eve/src/setup/slackbot.test.ts b/packages/eve/src/setup/slackbot.test.ts
index 71aecbbb7..e30ff59dd 100644
--- a/packages/eve/src/setup/slackbot.test.ts
+++ b/packages/eve/src/setup/slackbot.test.ts
@@ -452,7 +452,7 @@ describe("provisionSlackbot", () => {
expect(mockedRunVercel).toHaveBeenCalledTimes(1);
});
- it("resolves the UID from create JSON, then attaches the Eve trigger route", async () => {
+ it("resolves the UID from create JSON, then attaches the eve trigger route", async () => {
mockHappyPathProvision();
await expect(provisionSlackbot(createTestLog(), "/tmp/eve-agent", "my-agent")).resolves.toEqual(
@@ -927,7 +927,7 @@ describe("provisionSlackbot", () => {
await expect(provisioning).rejects.toMatchObject({ name: "AbortError" });
expect(log.warning).toHaveBeenCalledWith(
- "Vercel returned no connector UID for the abandoned Slack Connect request, so Eve cannot prove that request was cancelled. No connector was removed; do not retry until the browser request is no longer usable.",
+ "Vercel returned no connector UID for the abandoned Slack Connect request, so eve cannot prove that request was cancelled. No connector was removed; do not retry until the browser request is no longer usable.",
);
});
@@ -1220,7 +1220,7 @@ describe("provisionSlackbot", () => {
expect.anything(),
);
expect(log.warning).toHaveBeenCalledWith(
- "The existing Slack connector `slack/my-agent` is not connected to a Slack workspace. Eve did not remove it because this run did not create it. If its original browser request is still open, complete it; otherwise run `vercel connect remove slack/my-agent --disconnect-all --yes` before trying again.",
+ "The existing Slack connector `slack/my-agent` is not connected to a Slack workspace. eve did not remove it because this run did not create it. If its original browser request is still open, complete it; otherwise run `vercel connect remove slack/my-agent --disconnect-all --yes` before trying again.",
);
});
@@ -1271,7 +1271,7 @@ describe("provisionSlackbot", () => {
controller.abort();
workspace.resolve({ ok: true, stdout: createSlackConnectorJson("slack/my-agent") });
- // The wait was interrupted, not concluded: the abort propagates and Eve never
+ // The wait was interrupted, not concluded: the abort propagates and eve never
// claims the connector is disconnected (it never finished checking).
await expect(provisioning).rejects.toMatchObject({ name: "AbortError" });
expect(log.warning).not.toHaveBeenCalledWith(
diff --git a/packages/eve/src/setup/slackbot.ts b/packages/eve/src/setup/slackbot.ts
index 9c7042c2f..6472c733f 100644
--- a/packages/eve/src/setup/slackbot.ts
+++ b/packages/eve/src/setup/slackbot.ts
@@ -180,7 +180,7 @@ function cleanupFailureResult(
* Runs one provisioning attempt end to end. A new connector completes when the
* CLI's browser verifier succeeds (or connector details prove the workspace
* connection first). A reused connector must expose workspace metadata before
- * Eve attaches this project's trigger route.
+ * eve attaches this project's trigger route.
* `onCreated` fires the instant a fresh connector exists so an aborted attempt
* can remove exactly what it made. The `phase` seam lets each caller route
* progress through its own transient status surface.
@@ -227,7 +227,7 @@ async function runAttempt(input: {
if (created.state === "failed") return { state: "create-failed" };
if (created.state === "unresolved") {
log.warning(
- "Vercel did not return an exact Slack connector UID for this request, so Eve cannot attach or remove it safely.",
+ "Vercel did not return an exact Slack connector UID for this request, so eve cannot attach or remove it safely.",
);
return { state: "unresolved" };
}
@@ -308,7 +308,7 @@ async function raceAttemptAgainstChoice(input: {
}
/**
- * Creates or reuses a Slack connector and points its event destination at Eve.
+ * Creates or reuses a Slack connector and points its event destination at eve.
* A successful `connect create` is the completion boundary for a new browser
* flow. Existing connectors are verified through their team-scoped detail
* payload before attachment.
@@ -345,13 +345,13 @@ export async function provisionSlackbot(
options.signal?.throwIfAborted();
if (existing.state === "failed") {
log.warning(
- `Could not inspect existing Slack connectors, so Eve did not create another one. ${existing.message}`,
+ `Could not inspect existing Slack connectors, so eve did not create another one. ${existing.message}`,
);
return { state: "connector-lookup-failed" };
}
if (projectId === undefined && existing.connectorUids.size > 0) {
log.warning(
- "Could not verify which Slack connectors belong to this Vercel project, so Eve did not create another one. Restore `.vercel/project.json`, then try again.",
+ "Could not verify which Slack connectors belong to this Vercel project, so eve did not create another one. Restore `.vercel/project.json`, then try again.",
);
return { state: "connector-lookup-failed" };
}
@@ -454,7 +454,7 @@ export async function provisionSlackbot(
});
const notInstalled = (): ProvisionSlackbotResult => {
log.warning(
- `The existing Slack connector \`${attempt.ref.uid}\` is not connected to a Slack workspace. Eve did not remove it because this run did not create it. If its original browser request is still open, complete it; otherwise run \`vercel connect remove ${attempt.ref.uid} --disconnect-all --yes\` before trying again.`,
+ `The existing Slack connector \`${attempt.ref.uid}\` is not connected to a Slack workspace. eve did not remove it because this run did not create it. If its original browser request is still open, complete it; otherwise run \`vercel connect remove ${attempt.ref.uid} --disconnect-all --yes\` before trying again.`,
);
return {
state: "existing-not-installed",
@@ -537,7 +537,7 @@ export async function provisionSlackbot(
// the browser. A user action aborts the attempt and removes its connector.
const prompt = awaitChoice({
status: "Waiting for Slack setup to finish...",
- context: "Complete setup in the browser, then wait while Eve verifies the connection",
+ context: "Complete setup in the browser, then wait while eve verifies the connection",
actions: [
{ value: "retry", label: "Did your browser not open? Try again" },
{ value: "cancel", label: "Cancel" },
@@ -591,7 +591,7 @@ export async function provisionSlackbot(
options.signal?.throwIfAborted();
if (inventory.state === "failed") {
log.warning(
- `Could not inspect existing Slack connectors, so Eve did not create another one. ${inventory.message}`,
+ `Could not inspect existing Slack connectors, so eve did not create another one. ${inventory.message}`,
);
return { state: "finished", result: { state: "connector-lookup-failed" } };
}
diff --git a/packages/eve/src/setup/validate-gateway-key.ts b/packages/eve/src/setup/validate-gateway-key.ts
index fd2df156c..a7c856ee3 100644
--- a/packages/eve/src/setup/validate-gateway-key.ts
+++ b/packages/eve/src/setup/validate-gateway-key.ts
@@ -36,7 +36,7 @@ export type GatewayKeyValidation =
| { kind: "inconclusive"; message: string };
/**
- * Confirms an `AI_GATEWAY_API_KEY` authenticates before Eve saves it, by making
+ * Confirms an `AI_GATEWAY_API_KEY` authenticates before eve saves it, by making
* one account-scoped request to the gateway (`getCredits`). That endpoint
* rejects a bad key with a 401; the model catalog (`getAvailableModels`) is
* public and would accept any key, so it cannot validate.
diff --git a/packages/eve/src/shared/agent-definition.ts b/packages/eve/src/shared/agent-definition.ts
index 6d93171b8..805f7b766 100644
--- a/packages/eve/src/shared/agent-definition.ts
+++ b/packages/eve/src/shared/agent-definition.ts
@@ -4,7 +4,7 @@ import type { JsonObject } from "#shared/json.js";
import type { ModuleSourceRef } from "#shared/source-ref.js";
/**
- * Optional overrides that Eve forwards to the AI SDK model runtime call for
+ * Optional overrides that eve forwards to the AI SDK model runtime call for
* this model.
*/
export interface AgentModelOptionsDefinition {
@@ -43,7 +43,7 @@ export type InternalAgentModelDefinition = {
/**
* The model handle you assign to an agent's `model` field. This is the AI SDK
* `LanguageModel` value (for example, the result of a provider or gateway
- * model call), not an Eve-authored definition object.
+ * model call), not an eve-authored definition object.
*/
export type PublicAgentModelDefinition = LanguageModel;
@@ -51,21 +51,21 @@ export interface InternalAgentCompactionDefinition {
/**
* Optional model used only for generating compaction summaries.
*
- * When omitted, Eve uses the active turn model for the summary call.
+ * When omitted, eve uses the active turn model for the summary call.
*/
model?: InternalAgentModelDefinition;
/**
* Fraction of the primary model context window that triggers compaction.
*
- * Eve defaults to `0.9` when this is omitted.
+ * eve defaults to `0.9` when this is omitted.
*/
thresholdPercent?: number;
}
/**
* Configures conversation compaction: when the model context window fills past
- * `thresholdPercent`, Eve summarizes earlier turns to reclaim space. Every
- * field is optional; omit the block to use Eve's defaults.
+ * `thresholdPercent`, eve summarizes earlier turns to reclaim space. Every
+ * field is optional; omit the block to use eve's defaults.
*/
export interface PublicAgentCompactionDefinition {
/**
@@ -73,20 +73,20 @@ export interface PublicAgentCompactionDefinition {
* in tokens.
*
* Same escape hatch as the agent-level `modelContextWindowTokens`. When set,
- * Eve uses this value verbatim and skips the AI Gateway lookup for the
+ * eve uses this value verbatim and skips the AI Gateway lookup for the
* compaction summary model.
*/
readonly modelContextWindowTokens?: number;
/**
* Optional model used only for generating compaction summaries.
*
- * When omitted, Eve uses the active turn model for the summary call.
+ * When omitted, eve uses the active turn model for the summary call.
*/
readonly model?: PublicAgentModelDefinition;
/**
* Fraction of the primary model context window that triggers compaction.
*
- * Eve defaults to `0.9` when this is omitted.
+ * eve defaults to `0.9` when this is omitted.
*/
readonly thresholdPercent?: number;
}
@@ -105,7 +105,7 @@ export interface AgentExperimentalDefinition {
* instead of exposing them directly to the model. The model writes
* JavaScript that calls the tools inside the sandbox.
*
- * When unset, Eve falls back to the `EVE_EXPERIMENTAL_CODE_MODE`
+ * When unset, eve falls back to the `EVE_EXPERIMENTAL_CODE_MODE`
* environment variable (`"1"` enables it) for backwards compatibility.
*/
readonly codeMode?: boolean;
@@ -119,8 +119,8 @@ export interface AgentExperimentalDefinition {
*/
export interface AgentBuildDefinition {
/**
- * Additional imported package names that Eve should keep external and trace
- * into hosted build output. Eve also keeps matching imports external while
+ * Additional imported package names that eve should keep external and trace
+ * into hosted build output. eve also keeps matching imports external while
* compiling authored TypeScript modules such as tools, channels, and
* schedules.
*
@@ -174,10 +174,10 @@ export type PublicAgentDefinition = {
/**
* Optional override for the primary model's context window size, in tokens.
*
- * Escape hatch for cases where Eve cannot resolve the model's metadata via
+ * Escape hatch for cases where eve cannot resolve the model's metadata via
* the AI Gateway model catalog (e.g. a custom or unlisted model id). When
- * set, Eve uses this value verbatim and skips the AI Gateway lookup. Prefer
- * leaving this unset so Eve can stay in sync with provider metadata.
+ * set, eve uses this value verbatim and skips the AI Gateway lookup. Prefer
+ * leaving this unset so eve can stay in sync with provider metadata.
*/
readonly modelContextWindowTokens?: number;
readonly modelOptions?: AgentModelOptionsDefinition;
diff --git a/packages/eve/src/shared/code-mode.ts b/packages/eve/src/shared/code-mode.ts
index 1092a35ec..d078d8cd9 100644
--- a/packages/eve/src/shared/code-mode.ts
+++ b/packages/eve/src/shared/code-mode.ts
@@ -1,10 +1,10 @@
import type * as CodeModeModule from "#compiled/experimental-ai-sdk-code-mode/index.js";
-/** Internal AI SDK tool name used for Eve's code-mode wrapper. */
+/** Internal AI SDK tool name used for eve's code-mode wrapper. */
export const CODE_MODE_TOOL_NAME = "code_mode";
/**
- * Model-facing tool name for Eve's `Workflow` orchestration wrapper — a
+ * Model-facing tool name for eve's `Workflow` orchestration wrapper — a
* code-mode sandbox restricted to subagent and remote-agent calls. Reserved so
* authored tools cannot collide with it.
*/
@@ -44,7 +44,7 @@ export function isCodeModeEnvEnabled(
/**
* Resolves the effective code-mode setting for one agent. The authored
- * `experimental.codeMode` flag wins; when omitted, Eve falls back to the
+ * `experimental.codeMode` flag wins; when omitted, eve falls back to the
* {@link isCodeModeEnvEnabled} environment backstop.
*/
export function resolveCodeModeEnabled(
diff --git a/packages/eve/src/shared/json-schema.ts b/packages/eve/src/shared/json-schema.ts
index bc6c103b3..aef6b9d32 100644
--- a/packages/eve/src/shared/json-schema.ts
+++ b/packages/eve/src/shared/json-schema.ts
@@ -8,7 +8,7 @@ type JsonSchemaDirection = "input" | "output";
/**
* Normalizes one Standard Schema or JSON Schema definition into plain JSON
- * Schema data that can cross Eve runtime and client boundaries.
+ * Schema data that can cross eve runtime and client boundaries.
*/
export function normalizeJsonSchemaDefinition(
value: StandardJSONSchemaV1 | Record<string, unknown> | unknown,
diff --git a/packages/eve/src/shared/model-endpoint-status.ts b/packages/eve/src/shared/model-endpoint-status.ts
index 9444e071c..78275c5de 100644
--- a/packages/eve/src/shared/model-endpoint-status.ts
+++ b/packages/eve/src/shared/model-endpoint-status.ts
@@ -4,10 +4,10 @@
* dev TUI status bar, or any other consumer of `/eve/v1/info`) shows and gates
* on three states:
*
- * - `external`: a direct provider endpoint, not the gateway. Eve makes no
+ * - `external`: a direct provider endpoint, not the gateway. eve makes no
* connectedness claim, since the provider key lives in the agent's own code
* rather than the gateway's credentials, and model selection is disabled
- * because Eve cannot rewrite the authored source.
+ * because eve cannot rewrite the authored source.
* - `gateway` + `connected: true`: routed through the Vercel AI Gateway with a
* resolvable credential (`api-key` from `AI_GATEWAY_API_KEY`, else `oidc`).
* - `gateway` + `connected: false`: routed through the gateway with neither a
diff --git a/packages/eve/src/shared/sandbox-backend.ts b/packages/eve/src/shared/sandbox-backend.ts
index b0105384f..ef146073d 100644
--- a/packages/eve/src/shared/sandbox-backend.ts
+++ b/packages/eve/src/shared/sandbox-backend.ts
@@ -41,7 +41,7 @@ export interface SandboxSeedFile {
* Diagnostic tags attached to provider-owned sandbox resources.
*
* Built-in backends may forward these into their hosting platform's
- * native tagging system. Eve supplies stable tags such as the active
+ * native tagging system. eve supplies stable tags such as the active
* agent, channel, and session id so sandboxes can be found and
* attributed in provider dashboards.
*/
@@ -66,7 +66,7 @@ export interface SandboxBackendRuntimeContext {
*/
export interface SandboxBackendCreateInput {
/**
- * Reusable template key to open this session from. `null` means Eve
+ * Reusable template key to open this session from. `null` means eve
* intentionally skipped template prewarm because the sandbox has no
* `bootstrap()` and no seed files, so the backend should create a
* fresh session from its default base runtime.
@@ -123,7 +123,7 @@ export interface SandboxBackendPrewarmResult {
*
* A `SandboxBackend` is a value an author attaches to a
* {@link SandboxDefinition} to choose which underlying runtime hosts the
- * sandbox. Eve ships built-in backends (`docker()`,
+ * sandbox. eve ships built-in backends (`docker()`,
* `justbash()`, `microsandbox()`,
* `vercel()`, and the availability-aware
* `defaultSandbox()`), but the interface is public so authors can write
@@ -152,7 +152,7 @@ export interface SandboxBackend<BO = Record<string, never>, SO = Record<string,
*/
create(input: SandboxBackendCreateInput): Promise<SandboxBackendHandle<SO>>;
/**
- * Build-time prewarm hook. Eve invokes this for every authored
+ * Build-time prewarm hook. eve invokes this for every authored
* sandbox in the compiled graph before serving traffic so the backend
* can capture reusable template state. Idempotent against existing state
* keyed by `templateKey`.
diff --git a/packages/eve/src/shared/sandbox-definition.ts b/packages/eve/src/shared/sandbox-definition.ts
index 996225f8c..81eb45651 100644
--- a/packages/eve/src/shared/sandbox-definition.ts
+++ b/packages/eve/src/shared/sandbox-definition.ts
@@ -44,7 +44,7 @@ export interface SandboxSessionContext<O = Record<string, never>> {
}
/**
- * Resolves a build-time revalidation key for a bootstrap snapshot. Eve
+ * Resolves a build-time revalidation key for a bootstrap snapshot. eve
* evaluates it during compile/build and freezes the result into compiled
* artifacts. Supply one only for external inputs that affect bootstrap
* output; authored source and managed seeds are tracked automatically.
@@ -83,7 +83,7 @@ interface SandboxDefinitionBase<BO = Record<string, never>, SO = Record<string,
* });
* ```
*
- * When this field is omitted, Eve substitutes `defaultSandbox()` at
+ * When this field is omitted, eve substitutes `defaultSandbox()` at
* runtime, which picks the best available backend: `vercel()`
* on hosted Vercel (where `process.env.VERCEL` is set), then Docker,
* microsandbox, or just-bash
@@ -108,7 +108,7 @@ export interface SandboxDefinitionWithBootstrap<
bootstrap(input: SandboxBootstrapContext<BO>): Promise<void> | void;
/**
* Optional build-time revalidation key for the reusable sandbox
- * snapshot produced by {@link bootstrap}. Eve evaluates this
+ * snapshot produced by {@link bootstrap}. eve evaluates this
* function during compile/build, stores the resolved string in
* compiled artifacts, and uses that frozen value for both prewarm and
* runtime session create. Authored sandbox source and
diff --git a/packages/eve/src/shared/sandbox-network-policy.ts b/packages/eve/src/shared/sandbox-network-policy.ts
index f45af456e..0ab401f33 100644
--- a/packages/eve/src/shared/sandbox-network-policy.ts
+++ b/packages/eve/src/shared/sandbox-network-policy.ts
@@ -3,7 +3,7 @@ import type { NetworkPolicy } from "#compiled/@vercel/sandbox/index.js";
/**
* Firewall network policy applied to a live sandbox session.
*
- * Eve-owned alias of the backend network-policy shape. Use it to restrict
+ * eve-owned alias of the backend network-policy shape. Use it to restrict
* egress (`"deny-all"`, an allow-list) or to broker credentials onto
* outgoing requests. A per-domain `transform` injects headers at the
* firewall so secrets never enter the sandbox process:
diff --git a/packages/eve/src/shared/sandbox-session.ts b/packages/eve/src/shared/sandbox-session.ts
index 19f819f73..bd5a71c97 100644
--- a/packages/eve/src/shared/sandbox-session.ts
+++ b/packages/eve/src/shared/sandbox-session.ts
@@ -77,13 +77,13 @@ export interface SandboxRemovePathOptions {
}
/**
- * Public Eve-owned sandbox session exposed to authored lifecycle hooks.
+ * Public eve-owned sandbox session exposed to authored lifecycle hooks.
*
* The eight I/O methods (`run`, `spawn`, `readFile`, `readBinaryFile`,
* `readTextFile`, `writeFile`, `writeBinaryFile`, `writeTextFile`) are
* pulled directly from the AI SDK {@link AiSdkSandbox} type, so authored
* code that targets either surface uses identical signatures. `id` and
- * `resolvePath` are Eve-specific extensions that the runtime relies on
+ * `resolvePath` are eve-specific extensions that the runtime relies on
* for caching and `/workspace` path anchoring.
*
* Relative paths resolve from `/workspace`, the live working directory
diff --git a/packages/eve/src/shared/skill-package.ts b/packages/eve/src/shared/skill-package.ts
index ca28b553a..172b93e61 100644
--- a/packages/eve/src/shared/skill-package.ts
+++ b/packages/eve/src/shared/skill-package.ts
@@ -22,7 +22,7 @@ export interface MaterializableSkillPackage {
}
/**
- * Normalizes one named skill package into the concrete files Eve writes to
+ * Normalizes one named skill package into the concrete files eve writes to
* workspace resources or the live sandbox.
*/
export function normalizeSkillPackage(input: NamedSkillDefinition): MaterializableSkillPackage {
@@ -125,7 +125,7 @@ export function assertSafeSkillPackageName(name: string): void {
function assertSafeSkillPackageFilePath(relativePath: string): void {
if (relativePath === "SKILL.md") {
- throw new Error('Skill package files must not include "SKILL.md"; Eve generates it.');
+ throw new Error('Skill package files must not include "SKILL.md"; eve generates it.');
}
if (
diff --git a/packages/eve/src/shared/tool-definition.ts b/packages/eve/src/shared/tool-definition.ts
index 907c26bf2..d6fa8a810 100644
--- a/packages/eve/src/shared/tool-definition.ts
+++ b/packages/eve/src/shared/tool-definition.ts
@@ -70,7 +70,7 @@ export interface PublicToolDefinitionWithExecuteFn<
}
/**
- * Eve-owned shape for the model-facing tool result produced by
+ * eve-owned shape for the model-facing tool result produced by
* `toModelOutput`. Structurally compatible with the AI SDK's
* `ToolResultOutput` so the harness can forward it without conversion.
*/
diff --git a/packages/eve/src/svelte/use-eve-agent.ts b/packages/eve/src/svelte/use-eve-agent.ts
index 4f2c1e7cb..c454e05bb 100644
--- a/packages/eve/src/svelte/use-eve-agent.ts
+++ b/packages/eve/src/svelte/use-eve-agent.ts
@@ -23,7 +23,7 @@ export type { PrepareSend };
export type UseEveAgentStatus = EveAgentStoreStatus;
/**
- * Immutable point-in-time view of an Eve agent session: projected `data`, the
+ * Immutable point-in-time view of an eve agent session: projected `data`, the
* last `error`, the raw `events` stream, the `session` cursor, and `status`.
* `useEveAgent` passes this snapshot to the `onFinish` callback.
*/
@@ -33,7 +33,7 @@ export type UseEveAgentSnapshot<TData> = EveAgentStoreSnapshot<TData>;
* Reactive return value from `useEveAgent`.
*
* The state properties are Svelte 5 rune-friendly getters. Read them from a
- * template, `$derived`, or `$effect` and Svelte will update when Eve streams
+ * template, `$derived`, or `$effect` and Svelte will update when eve streams
* new events.
*/
export interface UseEveAgentReturn<TData> {
@@ -56,7 +56,7 @@ export interface UseEveAgentReturn<TData> {
}
/**
- * Configuration for a Svelte Eve agent session.
+ * Configuration for a Svelte eve agent session.
*
* Read once when `useEveAgent` creates its store; create a new binding to
* change host, reducer, or session. To rotate credentials or headers without
@@ -75,9 +75,9 @@ export interface UseEveAgentOptions<TData> extends EveAgentStoreCallbacks<TData>
*/
readonly headers?: HeadersValue;
/**
- * Base URL for Eve client requests. Empty targets same-origin Eve routes
+ * Base URL for eve client requests. Empty targets same-origin eve routes
* such as `/eve/v1/...`; a same-origin prefix like `/api` routes through an
- * app-owned proxy; an absolute origin hits an Eve server directly.
+ * app-owned proxy; an absolute origin hits an eve server directly.
*
* @default ""
*/
@@ -93,10 +93,10 @@ export interface UseEveAgentOptions<TData> extends EveAgentStoreCallbacks<TData>
*/
readonly maxReconnectAttempts?: number;
/**
- * Project submitted user messages before Eve confirms them with a
+ * Project submitted user messages before eve confirms them with a
* `message.received` stream event. Optimistic events are reducer-facing
* projection only and never appear in `events`, which stays the
- * authoritative Eve stream.
+ * authoritative eve stream.
*
* @default true
*/
@@ -183,7 +183,7 @@ export function useEveAgent<TData>(
): UseEveAgentReturn<TData>;
/**
- * Svelte 5 binding that drives an Eve session and projects its events into
+ * Svelte 5 binding that drives an eve session and projects its events into
* rune-friendly reactive data.
*
* Without a `reducer`, projects to {@link EveMessageData} via
diff --git a/packages/eve/src/vue/use-eve-agent.ts b/packages/eve/src/vue/use-eve-agent.ts
index c50939ba2..22645ea52 100644
--- a/packages/eve/src/vue/use-eve-agent.ts
+++ b/packages/eve/src/vue/use-eve-agent.ts
@@ -23,7 +23,7 @@ export type { PrepareSend };
export type UseEveAgentStatus = EveAgentStoreStatus;
/**
- * Point-in-time projected state for an Eve agent session (`data`, `error`,
+ * Point-in-time projected state for an eve agent session (`data`, `error`,
* `events`, `session`, `status`).
*
* `useEveAgent` passes this shape to callbacks such as `onFinish`, but exposes
@@ -54,7 +54,7 @@ export interface UseEveAgentReturn<TData> {
}
/**
- * Configuration for creating or binding a Vue Eve agent session.
+ * Configuration for creating or binding a Vue eve agent session.
*
* Session configuration is read once when the composable creates its internal
* store; to change the host, reducer, or session, remount the component. For
@@ -71,11 +71,11 @@ export interface UseEveAgentOptions<TData> extends EveAgentStoreCallbacks<TData>
/** Custom headers; a function value is resolved per request. */
readonly headers?: HeadersValue;
/**
- * Base URL used for Eve client requests.
+ * Base URL used for eve client requests.
*
- * By default, requests target same-origin Eve routes such as `/eve/v1/...`.
+ * By default, requests target same-origin eve routes such as `/eve/v1/...`.
* Pass a same-origin prefix such as `/api` to use an app-owned proxy, or an
- * absolute origin to talk to an Eve server directly.
+ * absolute origin to talk to an eve server directly.
*
* @default ""
*/
@@ -87,11 +87,11 @@ export interface UseEveAgentOptions<TData> extends EveAgentStoreCallbacks<TData>
/** Maximum SSE reconnection attempts per turn. @default 3 */
readonly maxReconnectAttempts?: number;
/**
- * Project submitted user messages before Eve confirms them with a
+ * Project submitted user messages before eve confirms them with a
* `message.received` stream event.
*
* Optimistic events are reducer-facing projection events only. They are not
- * exposed through `events`, which remains the authoritative Eve stream.
+ * exposed through `events`, which remains the authoritative eve stream.
*
* @default true
*/
@@ -119,7 +119,7 @@ export function useEveAgent<TData>(
): UseEveAgentReturn<TData>;
/**
- * Vue composable that drives one Eve session and projects its event stream into
+ * Vue composable that drives one eve session and projects its event stream into
* reactive UI state.
*
* Without a `reducer`, events project into `EveMessageData` via
diff --git a/packages/eve/test/bin-bootstrap.test.ts b/packages/eve/test/bin-bootstrap.test.ts
index 3e70e81e1..6c87e776c 100644
--- a/packages/eve/test/bin-bootstrap.test.ts
+++ b/packages/eve/test/bin-bootstrap.test.ts
@@ -35,7 +35,7 @@ describe("eve CLI bootstrap", () => {
runCommand,
}),
).rejects.toThrow(
- "Eve requires Node.js >=24. You are running v23.11.0. " +
+ "eve requires Node.js >=24. You are running v23.11.0. " +
"Please install a compatible Node.js version and try again.",
);
@@ -81,7 +81,7 @@ describe("eve CLI bootstrap", () => {
nodeEngineRequirement: ">=24 <26",
nodeVersion: "v26.0.0",
}),
- ).rejects.toThrow("Eve requires Node.js >=24 <26. You are running v26.0.0.");
+ ).rejects.toThrow("eve requires Node.js >=24 <26. You are running v26.0.0.");
expect(exists).not.toHaveBeenCalled();
expect(importModule).not.toHaveBeenCalled();
@@ -258,7 +258,7 @@ describe("eve CLI bootstrap", () => {
runCommand,
}),
).rejects.toThrow(
- `Eve package at ${bootstrapOptions.packageRoot} does not include the sources required to rebuild the CLI.`,
+ `eve package at ${bootstrapOptions.packageRoot} does not include the sources required to rebuild the CLI.`,
);
expect(runCommand).not.toHaveBeenCalled();
diff --git a/packages/eve/test/dev-client-harness/send-message.ts b/packages/eve/test/dev-client-harness/send-message.ts
index ba4756639..6a7712b36 100644
--- a/packages/eve/test/dev-client-harness/send-message.ts
+++ b/packages/eve/test/dev-client-harness/send-message.ts
@@ -128,8 +128,8 @@ async function readDevelopmentTurnEvents(input: {
}
/**
- * Sends one message to the configured Eve server and collects its streamed
- * events, forwarding any caller-supplied Eve route headers across the message
+ * Sends one message to the configured eve server and collects its streamed
+ * events, forwarding any caller-supplied eve route headers across the message
* and stream requests for the current turn.
*/
export async function sendDevelopmentMessage(input: {
diff --git a/packages/eve/test/dev-client-harness/url.ts b/packages/eve/test/dev-client-harness/url.ts
index 4aec0bab5..ddcc0f152 100644
--- a/packages/eve/test/dev-client-harness/url.ts
+++ b/packages/eve/test/dev-client-harness/url.ts
@@ -12,7 +12,7 @@ function createDevelopmentServerBaseUrl(serverUrl: string): URL {
}
/**
- * Resolves one Eve route against the configured development server URL.
+ * Resolves one eve route against the configured development server URL.
*
* Test-only helper.
*/
diff --git a/packages/eve/test/dev-request-headers.test.ts b/packages/eve/test/dev-request-headers.test.ts
index 60de3415c..1ef2810e0 100644
--- a/packages/eve/test/dev-request-headers.test.ts
+++ b/packages/eve/test/dev-request-headers.test.ts
@@ -24,7 +24,7 @@ afterEach(() => {
});
describe("createDevelopmentRequestHeadersAsync", () => {
- it("adds the Vercel protection bypass header for preview-scoped Eve routes", async () => {
+ it("adds the Vercel protection bypass header for preview-scoped eve routes", async () => {
vi.stubEnv("VERCEL_AUTOMATION_BYPASS_SECRET", "secret_123");
vi.mocked(getVercelOidcToken).mockRejectedValue(new Error("not linked"));
@@ -39,7 +39,7 @@ describe("createDevelopmentRequestHeadersAsync", () => {
expect(headers.get(VERCEL_PROTECTION_BYPASS_HEADER)).toBe("secret_123");
});
- it("skips the bypass header for non-Eve routes", async () => {
+ it("skips the bypass header for non-eve routes", async () => {
vi.stubEnv("VERCEL_AUTOMATION_BYPASS_SECRET", "secret_123");
const headers = await createDevelopmentRequestHeadersAsync({
@@ -140,7 +140,7 @@ describe("createDevelopmentRequestHeadersAsync", () => {
expect(headers.has("authorization")).toBe(false);
});
- it("does not call getVercelOidcToken when the target Eve route is on localhost", async () => {
+ it("does not call getVercelOidcToken when the target eve route is on localhost", async () => {
vi.mocked(getVercelOidcToken).mockResolvedValue("oidc_token_456");
const headers = await createDevelopmentRequestHeadersAsync({
diff --git a/packages/eve/test/helpers/vercel-deployment-fixture.ts b/packages/eve/test/helpers/vercel-deployment-fixture.ts
index 73573365a..b29cbdf37 100644
--- a/packages/eve/test/helpers/vercel-deployment-fixture.ts
+++ b/packages/eve/test/helpers/vercel-deployment-fixture.ts
@@ -15,7 +15,7 @@ const DEFAULT_DEPLOYMENT_READY_ATTEMPTS = 30;
const DEFAULT_DEPLOYMENT_READY_WAIT_MS = 2_000;
/**
- * One deployed test app prepared from a fixture copy and an Eve tarball.
+ * One deployed test app prepared from a fixture copy and an eve tarball.
*/
export interface TarballVercelDeploymentFixture {
readonly appRoot: string;
@@ -38,7 +38,7 @@ export interface CreateTarballVercelDeploymentFixtureInput {
/**
* Materializes the descriptor into a fresh temporary directory, wires the
- * app to depend on the locally packed Eve tarball, deploys it to Vercel,
+ * app to depend on the locally packed eve tarball, deploys it to Vercel,
* and returns the deployment URL.
*/
export async function createTarballVercelDeploymentFixture(
diff --git a/packages/eve/test/runtime-prompt-compose.test.ts b/packages/eve/test/runtime-prompt-compose.test.ts
index ede0d04ff..044a1a008 100644
--- a/packages/eve/test/runtime-prompt-compose.test.ts
+++ b/packages/eve/test/runtime-prompt-compose.test.ts
@@ -24,7 +24,7 @@ describe("composeRuntimeBasePrompt", () => {
).toEqual([
[
"Tool execution",
- "A single tool or subagent call runs as one serial action. If you call multiple independent tools or subagents in one response, Eve treats that batch as parallel work. Only batch work that is independent and does not rely on another call in the same response.",
+ "A single tool or subagent call runs as one serial action. If you call multiple independent tools or subagents in one response, eve treats that batch as parallel work. Only batch work that is independent and does not rely on another call in the same response.",
].join("\n"),
]);
});
@@ -89,7 +89,7 @@ describe("composeRuntimeBasePrompt", () => {
].join("\n"),
[
"Tool execution",
- "A single tool or subagent call runs as one serial action. If you call multiple independent tools or subagents in one response, Eve treats that batch as parallel work. Only batch work that is independent and does not rely on another call in the same response.",
+ "A single tool or subagent call runs as one serial action. If you call multiple independent tools or subagents in one response, eve treats that batch as parallel work. Only batch work that is independent and does not rely on another call in the same response.",
].join("\n"),
]);
});
diff --git a/packages/eve/test/runtime-schedule-registration.test.ts b/packages/eve/test/runtime-schedule-registration.test.ts
index 34d4cdfd1..298aecdfe 100644
--- a/packages/eve/test/runtime-schedule-registration.test.ts
+++ b/packages/eve/test/runtime-schedule-registration.test.ts
@@ -30,7 +30,7 @@ describe("schedule registration", () => {
).toEqual([
{
cron: "0 0 * * 0",
- description: 'Run Eve schedule "cleanup" from "schedules/cleanup.md".',
+ description: 'Run eve schedule "cleanup" from "schedules/cleanup.md".',
logicalPath: "schedules/cleanup.md",
scheduleId: "cleanup",
sourceId: "schedules/cleanup.md",
@@ -38,7 +38,7 @@ describe("schedule registration", () => {
},
{
cron: "0 8 * * *",
- description: 'Run Eve schedule "daily-digest" from "schedules/daily-digest.mjs".',
+ description: 'Run eve schedule "daily-digest" from "schedules/daily-digest.mjs".',
logicalPath: "schedules/daily-digest.mjs",
scheduleId: "daily-digest",
sourceId: "schedules/daily-digest.mjs",
diff --git a/packages/eve/test/scenarios/bin-build-output.scenario.test.ts b/packages/eve/test/scenarios/bin-build-output.scenario.test.ts
index 60b5085b0..f15107cea 100644
--- a/packages/eve/test/scenarios/bin-build-output.scenario.test.ts
+++ b/packages/eve/test/scenarios/bin-build-output.scenario.test.ts
@@ -275,7 +275,7 @@ describe("eve build process output", () => {
expect(result.signal).toBeNull();
expect(result.stdout).toBe("");
expect(result.stderr).toContain(
- 'Expected the tool export "default" from "tools/bad.ts" to match the public Eve shape.',
+ 'Expected the tool export "default" from "tools/bad.ts" to match the public eve shape.',
);
expect(result.stderr).not.toContain("Diagnostics artifact:");
}, 120_000);
diff --git a/packages/eve/test/scenarios/cli.scenario.test.ts b/packages/eve/test/scenarios/cli.scenario.test.ts
index 5391ae846..541070a1e 100644
--- a/packages/eve/test/scenarios/cli.scenario.test.ts
+++ b/packages/eve/test/scenarios/cli.scenario.test.ts
@@ -241,7 +241,7 @@ describe("runCli", () => {
await runCli(["info"], logger);
expect(logger.log).toHaveBeenCalled();
- expect(getLogOutput(logger)).toContain("Eve Info");
+ expect(getLogOutput(logger)).toContain("eve Info");
expect(getLogOutput(logger)).toContain("Application");
expect(getLogOutput(logger)).toContain("Workflow ID");
expect(getLogOutput(logger)).toContain(`POST ${EVE_CREATE_SESSION_ROUTE_PATH}`);
@@ -249,7 +249,7 @@ describe("runCli", () => {
expect(getLogOutput(logger)).toContain(`GET ${EVE_MESSAGE_STREAM_ROUTE_PATTERN}`);
});
- it("prints compiled discovery metadata when run inside an Eve app", async () => {
+ it("prints compiled discovery metadata when run inside an eve app", async () => {
const fixtureApp = await scenarioApp(WEATHER_AGENT_DESCRIPTOR);
const resolvedFixtureRoot = await realpath(fixtureApp.appRoot);
const previousCwd = process.cwd();
@@ -381,7 +381,7 @@ describe("runCli", () => {
try {
await expect(runCli(["start"], logger)).rejects.toThrow(
- `Missing Eve build output at ${join(
+ `Missing eve build output at ${join(
resolvedWorkspaceRoot,
".output",
"server",
diff --git a/packages/eve/test/scenarios/compile-agent.scenario.test.ts b/packages/eve/test/scenarios/compile-agent.scenario.test.ts
index de87d8543..1708337dc 100644
--- a/packages/eve/test/scenarios/compile-agent.scenario.test.ts
+++ b/packages/eve/test/scenarios/compile-agent.scenario.test.ts
@@ -287,7 +287,7 @@ describe("compiler artifacts", () => {
expect(moduleMapText).toContain('"agent.mjs": module_0');
expect(channelInstrumentationTypesText).toBe(
[
- "// Generated by Eve. Do not edit by hand.",
+ "// Generated by eve. Do not edit by hand.",
'import type { InferChannelMetadata } from "eve/channels";',
"",
'declare module "eve/channels" {',
@@ -955,7 +955,7 @@ describe("compileAgent", () => {
startPath: appRoot,
}),
).rejects.toThrow(
- 'Expected the agent config export "default" from "agent.mjs" to match the public Eve shape.',
+ 'Expected the agent config export "default" from "agent.mjs" to match the public eve shape.',
);
});
diff --git a/packages/eve/test/scenarios/eve-init.scenario.test.ts b/packages/eve/test/scenarios/eve-init.scenario.test.ts
index c7ff5cd10..133ae0dca 100644
--- a/packages/eve/test/scenarios/eve-init.scenario.test.ts
+++ b/packages/eve/test/scenarios/eve-init.scenario.test.ts
@@ -88,9 +88,9 @@ async function createFakePnpmEnvironment(scratch: string): Promise<{
...withoutCodingAgentMarkers(baseEnv),
EVE_INIT_PNPM_LOG: logPath,
GIT_AUTHOR_EMAIL: "[email protected]",
- GIT_AUTHOR_NAME: "Eve Init",
+ GIT_AUTHOR_NAME: "eve Init",
GIT_COMMITTER_EMAIL: "[email protected]",
- GIT_COMMITTER_NAME: "Eve Init",
+ GIT_COMMITTER_NAME: "eve Init",
npm_execpath: fakePnpmPath,
};
@@ -134,9 +134,9 @@ async function createFakeNpmEnvironment(scratch: string): Promise<{
...withoutCodingAgentMarkers(baseEnv),
EVE_INIT_NPM_LOG: logPath,
GIT_AUTHOR_EMAIL: "[email protected]",
- GIT_AUTHOR_NAME: "Eve Init",
+ GIT_AUTHOR_NAME: "eve Init",
GIT_COMMITTER_EMAIL: "[email protected]",
- GIT_COMMITTER_NAME: "Eve Init",
+ GIT_COMMITTER_NAME: "eve Init",
npm_config_user_agent: "npm/11.0.0 node/v24.0.0 darwin arm64",
npm_execpath: fakeNpmPath,
};
@@ -200,7 +200,7 @@ describe("eve init smoke", () => {
await expect(pathExists(join(projectDir, ".git"))).resolves.toBe(true);
await expect(
runFile("git", ["log", "-1", "--pretty=%s"], { cwd: projectDir }),
- ).resolves.toMatchObject({ stdout: "Initial commit from Eve\n" });
+ ).resolves.toMatchObject({ stdout: "Initial commit from eve\n" });
await expect(
runFile("git", ["ls-files", "--error-unmatch", "pnpm-lock.yaml"], { cwd: projectDir }),
).resolves.toMatchObject({ stdout: "pnpm-lock.yaml\n" });
diff --git a/packages/eve/test/scenarios/vercel-build-prewarm.scenario.test.ts b/packages/eve/test/scenarios/vercel-build-prewarm.scenario.test.ts
index 0742fe69f..87d0581b0 100644
--- a/packages/eve/test/scenarios/vercel-build-prewarm.scenario.test.ts
+++ b/packages/eve/test/scenarios/vercel-build-prewarm.scenario.test.ts
@@ -47,8 +47,8 @@ describe("Vercel build-time sandbox prewarm", () => {
);
expect([...events.commands].sort()).toEqual(["echo child-bootstrap", "echo root-bootstrap"]);
expect(log.mock.calls.map(([message]) => message)).toEqual([
- "Eve: initializing 2 sandbox templates...",
- "Eve: initialized 2 sandbox templates (0 reused, 2 built).",
+ "eve: initializing 2 sandbox templates...",
+ "eve: initialized 2 sandbox templates (0 reused, 2 built).",
]);
});
diff --git a/packages/eve/test/setup/clear-workflow-cache.ts b/packages/eve/test/setup/clear-workflow-cache.ts
index da4e13a0d..7dcc3ccda 100644
--- a/packages/eve/test/setup/clear-workflow-cache.ts
+++ b/packages/eve/test/setup/clear-workflow-cache.ts
@@ -3,7 +3,7 @@ import { join } from "node:path";
import { fileURLToPath } from "node:url";
/**
- * Clears workflow and Eve scratch state before the integration suite so
+ * Clears workflow and eve scratch state before the integration suite so
* stale bundled step modules cannot replay against fresh test code.
*/
export default async function clearWorkflowCache(): Promise<void> {
diff --git a/packages/eve/test/setup/pack-scenario-tarball.ts b/packages/eve/test/setup/pack-scenario-tarball.ts
index a9ffdee7e..53784d267 100644
--- a/packages/eve/test/setup/pack-scenario-tarball.ts
+++ b/packages/eve/test/setup/pack-scenario-tarball.ts
@@ -11,7 +11,7 @@ const SCENARIO_CACHE_ROOT = join(tmpdir(), "eve-scenario-cache");
const SHARED_TARBALLS_ROOT = join(SCENARIO_CACHE_ROOT, "shared-tarballs");
/**
- * Vitest `globalSetup` that packs the Eve package exactly once before any
+ * Vitest `globalSetup` that packs the eve package exactly once before any
* scenario worker boots. The resulting tarball path is exposed to workers
* through `process.env.EVE_SCENARIO_EVE_TARBALL_PATH` so
* `materializeScenarioApp()` can reuse it instead of racing to run
diff --git a/packages/eve/test/tui-client/lib/stream.ts b/packages/eve/test/tui-client/lib/stream.ts
index 780df9dee..29960484c 100644
--- a/packages/eve/test/tui-client/lib/stream.ts
+++ b/packages/eve/test/tui-client/lib/stream.ts
@@ -14,7 +14,7 @@ const state: PrintState = {
/**
* Renders one stream event to stdout in a way that's pleasant to watch
- * live. Mirrors the visual language of the Eve CLI REPL:
+ * live. Mirrors the visual language of the eve CLI REPL:
*
* - Reasoning streams as blue inline text.
* - Assistant replies stream as default terminal text after a muted
diff --git a/packages/eve/test/tui-client/lib/theme.ts b/packages/eve/test/tui-client/lib/theme.ts
index 554e06504..1bfaa83fa 100644
--- a/packages/eve/test/tui-client/lib/theme.ts
+++ b/packages/eve/test/tui-client/lib/theme.ts
@@ -1,7 +1,7 @@
import pc from "picocolors";
/**
- * Smoke-test color palette. Mirrors the Eve CLI REPL's theme (see
+ * Smoke-test color palette. Mirrors the eve CLI REPL's theme (see
* `packages/eve/src/cli/ui/output.ts`) so the visual language is
* consistent: reasoning in blue, secondary output in dim gray,
* failures in red, assistant replies in default terminal text.
diff --git a/packages/eve/test/tui-client/target/local-environment.ts b/packages/eve/test/tui-client/target/local-environment.ts
index 33b2c8ba1..90a6a3552 100644
--- a/packages/eve/test/tui-client/target/local-environment.ts
+++ b/packages/eve/test/tui-client/target/local-environment.ts
@@ -25,7 +25,7 @@ interface PendingLocalTargetRecord {
readonly target: Promise<TestTarget>;
}
-/** Creates an environment that starts local Eve app servers on demand. */
+/** Creates an environment that starts local eve app servers on demand. */
export function createLocalTestEnvironment(
options: CreateLocalTestEnvironmentOptions = {},
): LocalTestEnvironment {
diff --git a/packages/eve/test/tui-client/target/types.ts b/packages/eve/test/tui-client/target/types.ts
index 097e4230d..5202594da 100644
--- a/packages/eve/test/tui-client/target/types.ts
+++ b/packages/eve/test/tui-client/target/types.ts
@@ -1,6 +1,6 @@
import type { AgentServerHandle, AgentServerMode } from "../lib/server.ts";
-/** Starts one local Eve app server for a smoke-test target. */
+/** Starts one local eve app server for a smoke-test target. */
export type StartTestAgentServer = (input: {
readonly appName: string;
readonly mode?: AgentServerMode;
diff --git a/packages/eve/test/tui-client/tui-connection-auth-states.ts b/packages/eve/test/tui-client/tui-connection-auth-states.ts
index df0a4406e..f53af28f5 100644
--- a/packages/eve/test/tui-client/tui-connection-auth-states.ts
+++ b/packages/eve/test/tui-client/tui-connection-auth-states.ts
@@ -7,7 +7,7 @@ import { theme } from "./lib/theme.ts";
/**
* Drives the full `authorization.*` lifecycle through the
- * runner + renderer without spinning up a real Eve server. The other
+ * runner + renderer without spinning up a real eve server. The other
* smoke (`tui-connection-auth.ts`) covers the realistic `_required`
* path through a live runtime, but the live runtime cannot easily
* emit `_completed` in this repo (interactive auth
diff --git a/packages/eve/test/tui-client/tui-connection-auth-user.ts b/packages/eve/test/tui-client/tui-connection-auth-user.ts
index f5cbe8c75..6b5a3080a 100644
--- a/packages/eve/test/tui-client/tui-connection-auth-user.ts
+++ b/packages/eve/test/tui-client/tui-connection-auth-user.ts
@@ -17,7 +17,7 @@ import { theme } from "./lib/theme.ts";
/**
* End-to-end proof that a user-principal MCP connection drives a
- * real OAuth 2.1 + PKCE flow through Eve's
+ * real OAuth 2.1 + PKCE flow through eve's
* `requestAuthorization` / `getAuthorizationResult` API, with an
* actual token exchange against an external IdP and an authenticated
* MCP request after the resume.
diff --git a/packages/eve/test/tui-client/tui-log-modes.ts b/packages/eve/test/tui-client/tui-log-modes.ts
index c0f45b88e..3161e2318 100644
--- a/packages/eve/test/tui-client/tui-log-modes.ts
+++ b/packages/eve/test/tui-client/tui-log-modes.ts
@@ -53,7 +53,7 @@ async function snapshotForMode(mode: "all" | "stderr" | "sandbox" | "none"): Pro
// them immediately.
process.stdout.write(`${STDOUT_MARK}\n`);
process.stderr.write(`${STDERR_MARK}\n`);
- process.stdout.write(`Eve: sandbox ${SANDBOX_MARK}\n`);
+ process.stdout.write(`eve: sandbox ${SANDBOX_MARK}\n`);
const snapshot = screen.snapshot();
input.type("/exit");
diff --git a/packages/eve/vitest.vercel.config.ts b/packages/eve/vitest.vercel.config.ts
index c19e13e65..2d0a7b430 100644
--- a/packages/eve/vitest.vercel.config.ts
+++ b/packages/eve/vitest.vercel.config.ts
@@ -4,7 +4,7 @@ import { defineConfig } from "vitest/config";
* Tier 3 — Vercel deployment tests.
*
* Tests that deploy to real infrastructure (Vercel) and exercise the public
- * shape of Eve from outside the repository. These are the slowest and most
+ * shape of eve from outside the repository. These are the slowest and most
* externally dependent tests in the suite. They run sequentially and are
* expected to be gated by credentials provided from CI secrets.
*/
diff --git a/scripts/guard-invariants.mjs b/scripts/guard-invariants.mjs
index 64811cfb1..17d0f5ffb 100644
--- a/scripts/guard-invariants.mjs
+++ b/scripts/guard-invariants.mjs
@@ -624,7 +624,7 @@ const REMOVED_CLI_REFERENCES = [
replacement: "`eve init <name>`",
},
{ pattern: /\bcreate-eve\b/i, replacement: "`eve init`" },
- { pattern: /\beve\s+setup\b/i, replacement: "the dedicated current Eve command" },
+ { pattern: /\beve\s+setup\b/i, replacement: "the dedicated current eve command" },
];
/**
@@ -657,7 +657,7 @@ async function checkRule31RemovedCliReferences() {
rule: 31,
file: posix,
line: index + 1,
- message: `references a removed Eve CLI entry point. Replace it with ${removed.replacement}. Historical mentions belong only in changelogs or changesets.`,
+ message: `references a removed eve CLI entry point. Replace it with ${removed.replacement}. Historical mentions belong only in changelogs or changesets.`,
});
});
}