chore: update deps and agent docs (#4366)

Author: pi0

.agents/architecture.md

@@ -121,7 +121,8 @@ Route file conventions:
 
 ## Presets (`src/presets/`)
 
-31 presets. Structure per preset:
+Several deployment-target presets (+ internal `_nitro`/`_static`); see `.agents/presets.md`. Structure per preset:
+
 ```
 presets/<name>/
 ├── preset.ts        # defineNitroPreset()

.agents/presets.md

@@ -1,9 +1,10 @@
 # Nitro Presets Reference
 
-## All Presets (31)
+## All Presets
 
 ### Core
 - `_nitro/` — Internal presets (dev, prerender, worker modes)
+- `_static/` — Internal static / prerender-only output
 - `standard/` — Framework-agnostic standard server
 - `node/` — Node.js (server, middleware, cluster)
 - `bun/` — Bun runtime
@@ -14,18 +15,20 @@
 - `azure/` — Azure Static Web Apps
 - `cloudflare/` — Cloudflare Pages/Workers
 - `deno/` — Deno Deploy
-- `firebase/` — Firebase Hosting
-- `netlify/` — Netlify Functions/Edge
-- `vercel/` — Vercel Functions/Edge
 - `digitalocean/` — DigitalOcean App Platform
+- `edgeone/` — Tencent EdgeOne
+- `firebase/` — Firebase Hosting
+- `genezio/` — Genezio
 - `heroku/` — Heroku
 - `koyeb/` — Koyeb
-- `zeabur/` — Zeabur
+- `netlify/` — Netlify Functions/Edge
 - `render.com/` — Render
 - `stormkit/` — Stormkit
-- `genezio/` — Genezio
+- `vercel/` — Vercel Functions/Edge
 - `winterjs/` — WinterJS
+- `zeabur/` — Zeabur
 - `zephyr/` — Zephyr
+- `zerops/` — Zerops
 - `alwaysdata/`
 - `cleavr/`
 - `flightcontrol/`

AGENTS.md

@@ -10,11 +10,13 @@ Nitro is a framework-agnostic and deployment-agnostic server framework powered b
 
 ## Key Scripts
 
-- `pnpm build --stub` — Fast stub build for development.
-- `pnpm lint` — Lint and format code.
-- `pnpm fmt` — Automatically fix lint and formatting issues.
-- `pnpm test` — Run all tests.
-- `pnpm typecheck` — Run type tests.
+- `pnpm build --stub` — Fast stub build (`obuild --stub`) for development.
+- `pnpm build` — Full build (`pnpm gen-presets && obuild`).
+- `pnpm lint` — Check lint and formatting (`oxlint` + `oxfmt --check`).
+- `pnpm fmt` — Auto-fix lint and formatting (`automd` + `oxlint --fix` + `oxfmt`).
+- `pnpm test` — Full pipeline: `lint && build && typecheck && test:rollup && test:rolldown` (runs vitest against both the rollup and rolldown builders).
+- `pnpm test:rollup` / `pnpm test:rolldown` — Run vitest against a single builder (`NITRO_BUILDER`).
+- `pnpm typecheck` — Type-check with the TypeScript native-preview compiler (`tsgo --noEmit --skipLibCheck`).
 
 **Always run** `pnpm fmt` and `pnpm typecheck` after making changes.
 
@@ -30,10 +32,10 @@ Nitro is a framework-agnostic and deployment-agnostic server framework powered b
 
 Project source is centralized under `src/`:
 
-- `src/build` — Build logic (Vite | Rolldown | Rollup config, virtual templates, plugins).
+- `src/build` — Build logic (Vite | Rolldown | Rollup config, virtual templates in `src/build/virtual/`, plugins in `src/build/plugins/`).
 - `src/cli` — `nitro` CLI subcommands (each file in `src/cli/commands` is a command).
 - `src/config/` — Config defaults (`src/config/defaults.ts`) and resolvers/normalizers (`src/config/resolvers`).
-- `src/dev` and `src/runner` — Development server logic.
+- `src/dev` — Development server logic (`app.ts`, `server.ts`, `vfs.ts`).
 - `src/prerender` — Prerender logic.
 - `src/presets` — Deployment presets and runtime entry.
 - `src/types` — Shared types.
@@ -96,11 +98,11 @@ Each preset in `src/presets/` defines deployment target behavior:
 ### Making Changes
 
 1. Make changes in `src/`.
-2. Run `pnpm build --stub` if you changed build logic.
+2. Run `pnpm stub` if you changed build logic.
 3. Test with `pnpm test`.
 4. Run `pnpm fmt`.
 5. Run `pnpm typecheck`.
-6. Run `pnpm vitest run`.
+6. Run `pnpm test:rollup` and/or `pnpm test:rolldown` to run vitest against a specific builder.
 
 ## Contribution Principles
 
@@ -115,7 +117,7 @@ Each preset in `src/presets/` defines deployment target behavior:
 ## Common Gotchas
 
 - **Don't use Node.js-specific APIs in `src/runtime/`** — Code runs in multiple runtimes (Node, workers, edge).
-- **Virtual modules must be registered** in `src/build/virtual.ts`.
+- **Virtual modules must be registered** in `src/build/virtual/_all.ts` (one template per file under `src/build/virtual/`).
 - **CLI commands** are in `src/cli/commands/` — Each file exports a command definition.
 - **Runtime size matters** — Check bundle impact with `pnpm build`.
 - **Use `pathe` not `node:path`** — Ensures cross-platform compatibility.
@@ -160,7 +162,7 @@ Each preset in `src/presets/` defines deployment target behavior:
 For deeper context, see `.agents/`:
 
 - [`.agents/architecture.md`](.agents/architecture.md) — Full architecture: core instance, build system, config resolution, virtual modules, runtime internals, dev server, routing, key libraries.
-- [`.agents/presets.md`](.agents/presets.md) — All 31 presets, preset structure, how to create presets, resolution logic.
+- [`.agents/presets.md`](.agents/presets.md) — All presets (multiple deployment targets + internal `_nitro`/`_static`), preset structure, how to create presets, resolution logic.
 - [`.agents/testing.md`](.agents/testing.md) — Test structure, how tests work, adding regression tests, running tests.
 - [`.agents/vite.md`](.agents/vite.md) — Vite build system: plugin architecture (6 sub-plugins), environments API, dev server integration, production build stages, bundler config, HMR, runtime worker.
 - [`.agents/docs.md`](.agents/docs.md) — Documentation conventions: structure, preset naming (underscore), H3 v2 API patterns, import paths, common mistakes.

package.json

@@ -88,7 +88,7 @@
     "@azure/functions": "^3.5.1",
     "@azure/static-web-apps-cli": "^2.0.9",
     "@cloudflare/workers-types": "^4.20260615.1",
-    "@cloudflare/workers-utils": "^0.23.0",
+    "@cloudflare/workers-utils": "^0.24.0",
     "@deno/types": "^0.0.1",
     "@hiogawa/vite-plugin-fullstack": "^0.0.11",
     "@netlify/edge-functions": "^3.0.8",
@@ -105,7 +105,7 @@
     "@types/estree": "^1.0.9",
     "@types/etag": "^1.8.4",
     "@types/http-proxy": "^1.17.17",
-    "@types/node": "^25.9.3",
+    "@types/node": "^26.0.0",
     "@types/node-fetch": "^2.6.13",
     "@types/semver": "^7.7.1",
     "@types/xml2js": "^0.4.14",
@@ -141,9 +141,9 @@
     "miniflare": "^4.20260611.0",
     "mlly": "^1.8.2",
     "nypm": "^0.6.7",
-    "obuild": "^0.4.36",
+    "obuild": "^0.4.37",
     "oxc-parser": "link:shims/oxc-parser",
-    "oxfmt": "^0.54.0",
+    "oxfmt": "^0.55.0",
     "oxlint": "^1.69.0",
     "pathe": "^2.0.3",
     "perfect-debounce": "^2.1.0",
@@ -175,7 +175,7 @@
     "xml2js": "^0.6.2",
     "youch": "^4.1.1",
     "youch-core": "^0.3.3",
-    "zephyr-agent": "^0.2.0"
+    "zephyr-agent": "^1.1.2"
   },
   "peerDependencies": {
     "@vercel/queue": "^0.3.1",