eve 0.22.1 → 0.22.3

package/docs/guides/frontend/nextjs.mdx

@@ -34,12 +34,12 @@ export default withEve(nextConfig, {
 
 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.                                                                            |
+| 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 route namespace for legacy manual Vercel service configs and non-Vercel production proxying. Generated Vercel configs use service routes instead. |
+| `devServerTimeoutMs` | `number` | `180000`               | Maximum time to wait for the eve development server to become available.                                                                                  |
 
 For slow cold starts, increase the development timeout:
 
@@ -75,7 +75,7 @@ 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`:
+- **Vercel.** The web app and the eve runtime deploy as a single project. `withEve()` writes Build Output `services` for eve and `routes` that send `/eve/v1/**` to that service before filesystem routing; the Next.js app itself remains the default app. When the agent needs its own build step, set `eveBuildCommand`:
 
   ```ts
   export default withEve(nextConfig, {

package/docs/guides/instrumentation.md

@@ -66,7 +66,7 @@ Use it when the values depend on the current session, turn, step, channel, or mo
 
 ```ts
 import { defineInstrumentation, isChannel } from "eve/instrumentation";
-import supportChannel from "./channels/support.js";
+import supportChannel from "./channels/support";
 
 export default defineInstrumentation({
   events: {

package/docs/guides/state.md

@@ -27,8 +27,8 @@ export const budget = defineState("my-agent.budget", () => ({ count: 0, cap: 25
 ```ts title="agent/tools/spend.ts"
 import { defineTool } from "eve/tools";
 import { z } from "zod";
-import { budget } from "../lib/budget.js";
-import { runQuery } from "../lib/warehouse.js";
+import { budget } from "../lib/budget";
+import { runQuery } from "../lib/warehouse";
 
 export default defineTool({
   description: "Run a query, counting it against the session budget.",
@@ -50,7 +50,7 @@ State is durable by default and does not reset between turns. If you want a clea
 
 ```ts title="agent/hooks/reset-budget.ts"
 import { defineHook } from "eve/hooks";
-import { budget } from "../lib/budget.js";
+import { budget } from "../lib/budget";
 
 export default defineHook({
   events: {

package/docs/instructions.mdx

@@ -21,7 +21,7 @@ A static prompt belongs in markdown (`agent/instructions.md`). Switch to a TypeS
 
 ```ts title="agent/instructions.ts"
 import { defineInstructions } from "eve/instructions";
-import { buildInstructionsPrompt } from "./lib/prompts.js";
+import { buildInstructionsPrompt } from "./lib/prompts";
 
 export default defineInstructions({
   markdown: buildInstructionsPrompt(),

package/docs/meta.json

@@ -12,6 +12,7 @@
     "sandbox",
     "subagents",
     "schedules",
+    "extensions",
     "evals",
     "---",
     "guides",

package/docs/patterns/dynamic-scheduling.md

@@ -30,8 +30,8 @@ This is the only authored schedule. It looks up due application-managed rows and
 
 ```ts title="agent/schedules/dynamic.ts"
 import { defineSchedule } from "eve/schedules";
-import slack from "../channels/slack.js";
-import { scheduleStore } from "../lib/schedule-store.js";
+import slack from "../channels/slack";
+import { scheduleStore } from "../lib/schedule-store";
 
 export default defineSchedule({
   cron: "* * * * *",
@@ -119,8 +119,8 @@ Create a one-time schedule with `everyMinutes: null`, or a recurring one with an
 ```ts title="agent/tools/create_schedule.ts"
 import { defineTool } from "eve/tools";
 import { z } from "zod";
-import { scheduleStore } from "../lib/schedule-store.js";
-import { requireScheduleOwner } from "../lib/tenant.js";
+import { scheduleStore } from "../lib/schedule-store";
+import { requireScheduleOwner } from "../lib/tenant";
 
 export default defineTool({
   description: "Create a one-time or repeating scheduled agent run for this tenant.",
@@ -142,8 +142,8 @@ export default defineTool({
 ```ts title="agent/tools/list_schedules.ts"
 import { defineTool } from "eve/tools";
 import { z } from "zod";
-import { scheduleStore } from "../lib/schedule-store.js";
-import { requireScheduleOwner } from "../lib/tenant.js";
+import { scheduleStore } from "../lib/schedule-store";
+import { requireScheduleOwner } from "../lib/tenant";
 
 export default defineTool({
   description: "List this tenant's dynamic schedules and their latest status.",
@@ -157,8 +157,8 @@ export default defineTool({
 ```ts title="agent/tools/update_schedule.ts"
 import { defineTool } from "eve/tools";
 import { z } from "zod";
-import { scheduleStore } from "../lib/schedule-store.js";
-import { requireScheduleOwner } from "../lib/tenant.js";
+import { scheduleStore } from "../lib/schedule-store";
+import { requireScheduleOwner } from "../lib/tenant";
 
 export default defineTool({
   description: "Change, pause, or resume one of this tenant's schedules.",
@@ -183,8 +183,8 @@ export default defineTool({
 import { defineTool } from "eve/tools";
 import { always } from "eve/tools/approval";
 import { z } from "zod";
-import { scheduleStore } from "../lib/schedule-store.js";
-import { requireScheduleOwner } from "../lib/tenant.js";
+import { scheduleStore } from "../lib/schedule-store";
+import { requireScheduleOwner } from "../lib/tenant";
 
 export default defineTool({
   description: "Permanently delete one of this tenant's schedules.",
@@ -232,7 +232,7 @@ export interface ScheduleStore {
   release(job: ClaimedSchedule, failure: { error: unknown; retryAt: Date }): Promise<void>;
 }
 
-export { scheduleStore } from "../../lib/schedule-store.js";
+export { scheduleStore } from "../../lib/schedule-store";
 ```
 
 Implement that adapter with whichever durable store already belongs to your application. It must preserve a few semantics:

package/docs/patterns/multi-tenant-approvals.md

@@ -22,7 +22,7 @@ The current caller and initiating caller are both available on the session. This
 
 ```ts title="agent/lib/tenant-approval.ts"
 import type { ApprovalContext, ApprovalStatus } from "eve/tools";
-import { approvalPolicies } from "./approval-policies.js";
+import { approvalPolicies } from "./approval-policies";
 
 type Surface = "connection" | "tool";
 
@@ -77,8 +77,8 @@ Approval runs before `execute`. The executor must still derive and enforce tenan
 ```ts title="agent/tools/transfer_funds.ts"
 import { defineTool } from "eve/tools";
 import { z } from "zod";
-import { transferFunds } from "../../lib/payments.js";
-import { decideTenantApproval } from "../lib/tenant-approval.js";
+import { transferFunds } from "../../lib/payments";
+import { decideTenantApproval } from "../lib/tenant-approval";
 
 export default defineTool({
   description: "Transfer funds from the current tenant's account.",
@@ -111,7 +111,7 @@ The same callback gates every generated operation. The qualified operation name
 
 ```ts title="agent/connections/billing.ts"
 import { defineOpenAPIConnection } from "eve/connections";
-import { decideTenantApproval } from "../lib/tenant-approval.js";
+import { decideTenantApproval } from "../lib/tenant-approval";
 
 export default defineOpenAPIConnection({
   spec: "https://billing.example.com/openapi.json",
@@ -135,7 +135,7 @@ The allow-list limits what the model can discover. Approval independently decide
 
 ```ts title="agent/connections/support.ts"
 import { defineMcpClientConnection } from "eve/connections";
-import { decideTenantApproval } from "../lib/tenant-approval.js";
+import { decideTenantApproval } from "../lib/tenant-approval";
 
 export default defineMcpClientConnection({
   url: "https://support.example.com/mcp",
@@ -176,7 +176,7 @@ export interface ApprovalPolicyProvider {
   decide(request: ApprovalPolicyRequest): Promise<ApprovalPolicyDecision>;
 }
 
-export { approvalPolicies } from "../../lib/approval-policies.js";
+export { approvalPolicies } from "../../lib/approval-policies";
 ```
 
 Your provider decides the policy model. A common implementation checks active tenant membership, finds an exact resource rule before a connection-wide fallback, evaluates role and input thresholds, and defaults to deny. Keep those choices in application code rather than encoding a database design into the agent.

package/docs/patterns/multi-tenant-auth.md

@@ -44,7 +44,7 @@ the caller before eve starts a run, then stamp the tenant onto the session:
 ```ts title="agent/channels/eve.ts"
 import { eveChannel } from "eve/channels/eve";
 import { localDev, type AuthFn } from "eve/channels/auth";
-import { verifyAgentCaller } from "../../lib/app-auth.js";
+import { verifyAgentCaller } from "../../lib/app-auth";
 
 function tenantAppAuth(): AuthFn<Request> {
   return async (request) => {
@@ -92,7 +92,7 @@ cache by that user, and pass the projected principal into `getToken`:
 
 ```ts title="agent/lib/tenant-connection-auth.ts"
 import type { ConnectionPrincipal, NonInteractiveAuthorizationDefinition } from "eve/connections";
-import { tenantCredentials, type TenantService } from "./tenant-credentials.js";
+import { tenantCredentials, type TenantService } from "./tenant-credentials";
 
 function requireTenantPrincipal(principal: ConnectionPrincipal): {
   tenantId: string;
@@ -136,8 +136,8 @@ Derive the tenant inside `execute`, fetch its credential from your application p
 ```ts title="agent/tools/list_invoices.ts"
 import { defineTool } from "eve/tools";
 import { z } from "zod";
-import { tenantCredentials } from "../lib/tenant-credentials.js";
-import { requireTenantCaller } from "../lib/tenant.js";
+import { tenantCredentials } from "../lib/tenant-credentials";
+import { requireTenantCaller } from "../lib/tenant";
 
 export default defineTool({
   description: "List recent invoices from the current tenant's billing account.",
@@ -167,9 +167,9 @@ receive the token at call time without exposing it to the model:
 
 ```ts title="agent/connections/billing.ts"
 import { defineOpenAPIConnection } from "eve/connections";
-import { tenantCredentials } from "../lib/tenant-credentials.js";
-import { tenantBearerAuth } from "../lib/tenant-connection-auth.js";
-import { requireTenantCaller } from "../lib/tenant.js";
+import { tenantCredentials } from "../lib/tenant-credentials";
+import { tenantBearerAuth } from "../lib/tenant-connection-auth";
+import { requireTenantCaller } from "../lib/tenant";
 
 export default defineOpenAPIConnection({
   spec: "https://billing.example.com/openapi.json",
@@ -193,9 +193,9 @@ MCP connections accept the same callbacks:
 
 ```ts title="agent/connections/support.ts"
 import { defineMcpClientConnection } from "eve/connections";
-import { tenantCredentials } from "../lib/tenant-credentials.js";
-import { tenantBearerAuth } from "../lib/tenant-connection-auth.js";
-import { requireTenantCaller } from "../lib/tenant.js";
+import { tenantCredentials } from "../lib/tenant-credentials";
+import { tenantBearerAuth } from "../lib/tenant-connection-auth";
+import { requireTenantCaller } from "../lib/tenant";
 
 export default defineMcpClientConnection({
   url: "https://support.example.com/mcp",
@@ -220,8 +220,8 @@ tenant API key from `headers` instead:
 
 ```ts title="agent/connections/support.ts"
 import { defineMcpClientConnection } from "eve/connections";
-import { tenantCredentials } from "../lib/tenant-credentials.js";
-import { requireTenantCaller } from "../lib/tenant.js";
+import { tenantCredentials } from "../lib/tenant-credentials";
+import { requireTenantCaller } from "../lib/tenant";
 
 export default defineMcpClientConnection({
   url: "https://support.example.com/mcp",
@@ -274,7 +274,7 @@ export interface TenantCredentialProvider {
   ): Promise<TenantApiKeyCredential>;
 }
 
-export { tenantCredentials } from "../../lib/tenant-credentials.js";
+export { tenantCredentials } from "../../lib/tenant-credentials";
 ```
 
 Implement the provider with the secret system your application already trusts:

package/docs/patterns/multi-tenant-memory.md

@@ -53,8 +53,8 @@ Resolve on `turn.started` so later turns in the same session see memories writte
 
 ```ts title="agent/instructions/memory.ts"
 import { defineDynamic, defineInstructions } from "eve/instructions";
-import { memoryStore } from "../lib/memory-store.js";
-import { requireTenantCaller } from "../lib/tenant.js";
+import { memoryStore } from "../lib/memory-store";
+import { requireTenantCaller } from "../lib/tenant";
 
 export default defineDynamic({
   events: {
@@ -88,8 +88,8 @@ The model chooses the memory key and value. The executor chooses the tenant and
 ```ts title="agent/tools/remember.ts"
 import { defineTool } from "eve/tools";
 import { z } from "zod";
-import { memoryStore } from "../lib/memory-store.js";
-import { requireTenantCaller } from "../lib/tenant.js";
+import { memoryStore } from "../lib/memory-store";
+import { requireTenantCaller } from "../lib/tenant";
 
 export default defineTool({
   description: "Remember one stable fact or preference for the current user.",
@@ -110,8 +110,8 @@ export default defineTool({
 ```ts title="agent/tools/list_memories.ts"
 import { defineTool } from "eve/tools";
 import { z } from "zod";
-import { memoryStore } from "../lib/memory-store.js";
-import { requireTenantCaller } from "../lib/tenant.js";
+import { memoryStore } from "../lib/memory-store";
+import { requireTenantCaller } from "../lib/tenant";
 
 export default defineTool({
   description: "List long-term memories saved for the current user.",
@@ -126,8 +126,8 @@ export default defineTool({
 import { defineTool } from "eve/tools";
 import { always } from "eve/tools/approval";
 import { z } from "zod";
-import { memoryStore } from "../lib/memory-store.js";
-import { requireTenantCaller } from "../lib/tenant.js";
+import { memoryStore } from "../lib/memory-store";
+import { requireTenantCaller } from "../lib/tenant";
 
 export default defineTool({
   description: "Delete one long-term memory belonging to the current user.",
@@ -165,7 +165,7 @@ export interface MemoryStore {
 }
 
 // Implement this with your application's PostgreSQL, KV, or vector-store client.
-export { memoryStore } from "../../lib/memory-store.js";
+export { memoryStore } from "../../lib/memory-store";
 ```
 
 Whatever backend you choose, preserve these invariants:

package/docs/schedules.mdx

@@ -61,7 +61,7 @@ Use a handler when the schedule needs to deliver to a channel, branch on conditi
 ```ts title="agent/schedules/critical-alerts.ts"
 import { defineSchedule } from "eve/schedules";
 
-import slack from "../channels/slack.js";
+import slack from "../channels/slack";
 
 export default defineSchedule({
   cron: "* * * * *",

package/docs/subagents.mdx

@@ -111,6 +111,8 @@ Do not rely on subagent delegation by itself as an approval boundary. Put sensit
 
 Each delegated subagent spins up its own child session and stream. The parent stream carries the control-plane events `subagent.called` and `subagent.completed`, plus interactive `input.requested`, `authorization.required`, and `authorization.completed` events proxied from descendants so the root channel can prompt the user. To follow the child's other progress, read `subagent.called.data.childSessionId` and subscribe at `GET /eve/v1/session/:childSessionId/stream`.
 
+Subagent model calls automatically retry classified transient provider failures, including overload errors delivered after a stream starts. eve makes at most three fresh model-call attempts, repeating only the current uncommitted call so completed earlier steps, tool results, and sandbox work remain available to the child. Other recoverable task errors fall back to Workflow's durable step retry from the last committed session snapshot. Exhausting the transient model-call attempts or the dedicated empty-response reissue returns one failed task result instead of stacking both retry budgets; terminal errors fail immediately.
+
 ## When to split
 
 Split out a subagent when the task needs a different prompt or specialist role, a narrower tool surface, or its own runtime context. Don't reach for one when a [skill](./skills) would do. If the agent can keep its identity and needs only an optional procedure, a skill is the lighter choice.

package/docs/tutorial/guard-the-spend.mdx

@@ -23,8 +23,8 @@ export function estimateScanGb(sql: string): number {
 ```ts title="agent/tools/run_sql.ts"
 import { defineTool } from "eve/tools";
 import { z } from "zod";
-import { runReadOnlySql } from "../lib/sample-db.js";
-import { estimateScanGb } from "../lib/cost.js";
+import { runReadOnlySql } from "../lib/sample-db";
+import { estimateScanGb } from "../lib/cost";
 
 const THRESHOLD_GB = 50;
 

package/docs/tutorial/query-sample-data.mdx

@@ -47,7 +47,7 @@ export async function runReadOnlySql(sql: string) {
 ```ts title="agent/tools/run_sql.ts"
 import { defineTool } from "eve/tools";
 import { z } from "zod";
-import { runReadOnlySql } from "../lib/sample-db.js";
+import { runReadOnlySql } from "../lib/sample-db";
 
 export default defineTool({
   description:

package/docs/tutorial/remember-definitions.mdx

@@ -26,7 +26,7 @@ export const glossary = defineState<Glossary>("analytics.glossary", () => ({
 ```ts title="agent/tools/define_metric.ts"
 import { defineTool } from "eve/tools";
 import { z } from "zod";
-import { glossary } from "../lib/glossary.js";
+import { glossary } from "../lib/glossary";
 
 export default defineTool({
   description: "Record the team's definition of a metric so it persists across turns.",
@@ -41,7 +41,7 @@ export default defineTool({
 ```ts title="agent/tools/recall_metrics.ts"
 import { defineTool } from "eve/tools";
 import { z } from "zod";
-import { glossary } from "../lib/glossary.js";
+import { glossary } from "../lib/glossary";
 
 export default defineTool({
   description: "Read the team's recorded metric definitions.",

package/docs/tutorial/ship-it.mdx

@@ -98,7 +98,7 @@ Now point the channel at it. Replace the contents of `agent/channels/eve.ts`, wh
 ```ts title="agent/channels/eve.ts"
 import { eveChannel } from "eve/channels/eve";
 import { localDev, vercelOidc, type AuthFn } from "eve/channels/auth";
-import { authenticate } from "../lib/auth.js";
+import { authenticate } from "../lib/auth";
 
 const appAuth: AuthFn<Request> = async (request) => {
   const user = await authenticate(request); // your cookie/session/provider

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eve",
-  "version": "0.22.1",
+  "version": "0.22.3",
   "private": false,
   "description": "Filesystem-first framework for durable backend AI agents that run anywhere.",
   "keywords": [
@@ -186,6 +186,11 @@
       "import": "./dist/src/public/context/index.js",
       "default": "./dist/src/public/context/index.js"
     },
+    "./extension": {
+      "types": "./dist/src/public/extension/index.d.ts",
+      "import": "./dist/src/public/extension/index.js",
+      "default": "./dist/src/public/extension/index.js"
+    },
     "./instrumentation": {
       "types": "./dist/src/public/instrumentation/index.d.ts",
       "import": "./dist/src/public/instrumentation/index.js",
@@ -293,11 +298,13 @@
     "@vercel/oidc": "3.5.0",
     "@vercel/sandbox": "2.3.0",
     "@vercel/sdk": "1.28.1",
-    "@workflow/core": "5.0.0-beta.26",
-    "@workflow/errors": "5.0.0-beta.8",
+    "@workflow/core": "5.0.0-beta.28",
+    "@workflow/errors": "5.0.0-beta.10",
     "@workflow/serde": "5.0.0-beta.2",
-    "@workflow/world": "5.0.0-beta.14",
-    "@workflow/world-local": "5.0.0-beta.22",
+    "@workflow/utils": "5.0.0-beta.6",
+    "@workflow/world": "5.0.0-beta.16",
+    "@workflow/world-local": "5.0.0-beta.24",
+    "@workflow/world-vercel": "5.0.0-beta.24",
     "ai": "^7.0.0",
     "autoevals": "0.0.132",
     "chat": "4.31.0",