@vesk/vesk-cli 0.2.15 → 0.2.16

package/dist/cli.js

@@ -1525,6 +1525,38 @@ var init_context = __esm({
   }
 });
 
+// ../runtime/src/server-events.ts
+function getStore() {
+  const g2 = globalThis;
+  if (!g2.__vesk_server_ctx || typeof g2.__vesk_server_ctx !== "object") {
+    g2.__vesk_server_ctx = {};
+  }
+  return g2.__vesk_server_ctx;
+}
+function server_locals() {
+  return getStore();
+}
+function get_server_context(key) {
+  return getStore()[key];
+}
+function set_server_context(key, value) {
+  getStore()[key] = value;
+}
+function clear_server_context() {
+  const store = getStore();
+  for (const key of Object.keys(store)) delete store[key];
+}
+var serverLocals, getServerContext, setServerContext, clearServerContext;
+var init_server_events = __esm({
+  "../runtime/src/server-events.ts"() {
+    "use strict";
+    serverLocals = server_locals;
+    getServerContext = get_server_context;
+    setServerContext = set_server_context;
+    clearServerContext = clear_server_context;
+  }
+});
+
 // ../runtime/src/resource.ts
 function setSsrSink(sink) {
   ssrSink = sink;
@@ -1708,7 +1740,7 @@ async function runFetcher(handle2, timeout) {
   }
 }
 function sleep(ms) {
-  return new Promise((resolve38) => setTimeout(resolve38, ms));
+  return new Promise((resolve39) => setTimeout(resolve39, ms));
 }
 function streamText(res, into, onChunk) {
   const decoder = new TextDecoder();
@@ -2117,10 +2149,10 @@ function createHydrateWalker(container, markerList) {
 }
 function hydrateViewport(container, componentFn, props, rootMargin = 500) {
   if (document.readyState !== "complete") {
-    return new Promise((resolve38) => {
+    return new Promise((resolve39) => {
       const onLoad = () => {
         window.removeEventListener("load", onLoad);
-        resolve38(hydrateViewport(container, componentFn, props, rootMargin));
+        resolve39(hydrateViewport(container, componentFn, props, rootMargin));
       };
       window.addEventListener("load", onLoad);
     });
@@ -2147,7 +2179,7 @@ function hydrateViewport(container, componentFn, props, rootMargin = 500) {
   const viewportWalker = createHydrateWalker(container, viewportMarkers);
   componentFn(props || {}, /* @__PURE__ */ new Map(), viewportWalker);
   if (deferredMarkers.length > 0) {
-    return new Promise((resolve38) => {
+    return new Promise((resolve39) => {
       const observer = new IntersectionObserver((entries) => {
         const toHydrate = [];
         for (const entry of entries) {
@@ -2170,7 +2202,7 @@ function hydrateViewport(container, componentFn, props, rootMargin = 500) {
         }
         if (observer._observed === 0) {
           observer.disconnect();
-          resolve38();
+          resolve39();
         }
       }, { rootMargin: `${rootMargin}px` });
       observer._observed = deferredMarkers.length;
@@ -3033,12 +3065,12 @@ function ensureChunk(chunkUrl) {
   if (typeof document === "undefined" || typeof document.createElement !== "function") {
     return Promise.resolve();
   }
-  return new Promise((resolve38, reject) => {
+  return new Promise((resolve39, reject) => {
     const s = document.createElement("script");
     s.src = chunkUrl;
     s.onload = () => {
       failedChunks.delete(chunkUrl);
-      resolve38();
+      resolve39();
     };
     s.onerror = () => {
       loadedChunks.delete(chunkUrl);
@@ -23828,7 +23860,9 @@ __export(index_server_exports, {
   buildRouteTree: () => buildRouteTree,
   clearActions: () => clearActions,
   clearIsrCache: () => clearIsrCache,
+  clearServerContext: () => clearServerContext,
   clearSsrData: () => clearSsrData,
+  clear_server_context: () => clear_server_context,
   componentIsr: () => componentIsr,
   configureLoadingIndicator: () => configureLoadingIndicator,
   cookies: () => cookies,
@@ -23854,6 +23888,8 @@ __export(index_server_exports, {
   getActiveComponent: () => getActiveComponent,
   getLoadingError: () => getLoadingError,
   getLoadingProgress: () => getLoadingProgress,
+  getServerContext: () => getServerContext,
+  get_server_context: () => get_server_context,
   headers: () => headers,
   isFormAction: () => isFormAction,
   isLoadingActive: () => isLoadingActive,
@@ -23889,13 +23925,17 @@ __export(index_server_exports, {
   runHooks: () => runHooks,
   safe_scope: () => safe_scope,
   scope: () => scope,
+  serverLocals: () => serverLocals,
+  server_locals: () => server_locals,
   set: () => set,
   setActiveComponent: () => setActiveComponent,
+  setServerContext: () => setServerContext,
   setSignedCookie: () => setSignedCookie2,
   setSsrData: () => setSsrData,
   setSsrSink: () => setSsrSink,
   set_active_block: () => set_active_block,
   set_active_component: () => set_active_component,
+  set_server_context: () => set_server_context,
   signCookie: () => signCookie2,
   tick: () => tick,
   track: () => track,
@@ -23924,6 +23964,7 @@ var init_index_server = __esm({
     init_ripple_runtime();
     init_ripple_blocks();
     init_context();
+    init_server_events();
     init_resource();
     init_portal();
     init_router();
@@ -24861,7 +24902,7 @@ is not a problem with esbuild. You need to fix your environment instead.
         let latestResultPromise;
         let provideLatestResult;
         if (isContext)
-          requestCallbacks["on-end"] = (id, request2) => new Promise((resolve38) => {
+          requestCallbacks["on-end"] = (id, request2) => new Promise((resolve39) => {
             buildResponseToResult(request2, (err, result2, onEndErrors, onEndWarnings) => {
               const response = {
                 errors: onEndErrors,
@@ -24871,7 +24912,7 @@ is not a problem with esbuild. You need to fix your environment instead.
               latestResultPromise = void 0;
               provideLatestResult = void 0;
               sendResponse(id, response);
-              resolve38();
+              resolve39();
             });
           });
         sendRequest(refs, request, (error, response) => {
@@ -24888,10 +24929,10 @@ is not a problem with esbuild. You need to fix your environment instead.
           let didDispose = false;
           const result2 = {
             rebuild: () => {
-              if (!latestResultPromise) latestResultPromise = new Promise((resolve38, reject) => {
+              if (!latestResultPromise) latestResultPromise = new Promise((resolve39, reject) => {
                 let settlePromise;
                 provideLatestResult = (err, result22) => {
-                  if (!settlePromise) settlePromise = () => err ? reject(err) : resolve38(result22);
+                  if (!settlePromise) settlePromise = () => err ? reject(err) : resolve39(result22);
                 };
                 const triggerAnotherBuild = () => {
                   const request2 = {
@@ -24912,7 +24953,7 @@ is not a problem with esbuild. You need to fix your environment instead.
               });
               return latestResultPromise;
             },
-            watch: (options22 = {}) => new Promise((resolve38, reject) => {
+            watch: (options22 = {}) => new Promise((resolve39, reject) => {
               if (!streamIn.hasFS) throw new Error(`Cannot use the "watch" API in this environment`);
               const keys = {};
               const delay = getFlag(options22, keys, "delay", mustBeInteger);
@@ -24924,10 +24965,10 @@ is not a problem with esbuild. You need to fix your environment instead.
               if (delay) request2.delay = delay;
               sendRequest(refs, request2, (error2) => {
                 if (error2) reject(new Error(error2));
-                else resolve38(void 0);
+                else resolve39(void 0);
               });
             }),
-            serve: (options22 = {}) => new Promise((resolve38, reject) => {
+            serve: (options22 = {}) => new Promise((resolve39, reject) => {
               if (!streamIn.hasFS) throw new Error(`Cannot use the "serve" API in this environment`);
               const keys = {};
               const port2 = getFlag(options22, keys, "port", mustBeValidPortNumber);
@@ -24965,28 +25006,28 @@ is not a problem with esbuild. You need to fix your environment instead.
                     sendResponse(id, {});
                   };
                 }
-                resolve38(response2);
+                resolve39(response2);
               });
             }),
-            cancel: () => new Promise((resolve38) => {
-              if (didDispose) return resolve38();
+            cancel: () => new Promise((resolve39) => {
+              if (didDispose) return resolve39();
               const request2 = {
                 command: "cancel",
                 key: buildKey
               };
               sendRequest(refs, request2, () => {
-                resolve38();
+                resolve39();
               });
             }),
-            dispose: () => new Promise((resolve38) => {
-              if (didDispose) return resolve38();
+            dispose: () => new Promise((resolve39) => {
+              if (didDispose) return resolve39();
               didDispose = true;
               const request2 = {
                 command: "dispose",
                 key: buildKey
               };
               sendRequest(refs, request2, () => {
-                resolve38();
+                resolve39();
                 scheduleOnDisposeCallbacks();
                 refs.unref();
               });
@@ -25025,7 +25066,7 @@ is not a problem with esbuild. You need to fix your environment instead.
             onLoad: []
           };
           i++;
-          let resolve38 = (path3, options2 = {}) => {
+          let resolve39 = (path3, options2 = {}) => {
             if (!isSetupDone) throw new Error('Cannot call "resolve" before plugin setup has completed');
             if (typeof path3 !== "string") throw new Error(`The path to resolve must be a string`);
             let keys2 = /* @__PURE__ */ Object.create(null);
@@ -25069,7 +25110,7 @@ is not a problem with esbuild. You need to fix your environment instead.
           };
           let promise = setup({
             initialOptions,
-            resolve: resolve38,
+            resolve: resolve39,
             onStart(callback) {
               let registeredText = `This error came from the "onStart" callback registered here:`;
               let registeredNote = extractCallerV8(new Error(registeredText), streamIn, "onStart");
@@ -25762,46 +25803,46 @@ More information: The file containing the code for esbuild's JavaScript API (${_
         }
       };
       longLivedService = {
-        build: (options2) => new Promise((resolve38, reject) => {
+        build: (options2) => new Promise((resolve39, reject) => {
           service.buildOrContext({
             callName: "build",
             refs,
             options: options2,
             isTTY: isTTY(),
             defaultWD,
-            callback: (err, res) => err ? reject(err) : resolve38(res)
+            callback: (err, res) => err ? reject(err) : resolve39(res)
           });
         }),
-        context: (options2) => new Promise((resolve38, reject) => service.buildOrContext({
+        context: (options2) => new Promise((resolve39, reject) => service.buildOrContext({
           callName: "context",
           refs,
           options: options2,
           isTTY: isTTY(),
           defaultWD,
-          callback: (err, res) => err ? reject(err) : resolve38(res)
+          callback: (err, res) => err ? reject(err) : resolve39(res)
         })),
-        transform: (input, options2) => new Promise((resolve38, reject) => service.transform({
+        transform: (input, options2) => new Promise((resolve39, reject) => service.transform({
           callName: "transform",
           refs,
           input,
           options: options2 || {},
           isTTY: isTTY(),
           fs: fsAsync,
-          callback: (err, res) => err ? reject(err) : resolve38(res)
+          callback: (err, res) => err ? reject(err) : resolve39(res)
         })),
-        formatMessages: (messages, options2) => new Promise((resolve38, reject) => service.formatMessages({
+        formatMessages: (messages, options2) => new Promise((resolve39, reject) => service.formatMessages({
           callName: "formatMessages",
           refs,
           messages,
           options: options2,
-          callback: (err, res) => err ? reject(err) : resolve38(res)
+          callback: (err, res) => err ? reject(err) : resolve39(res)
         })),
-        analyzeMetafile: (metafile, options2) => new Promise((resolve38, reject) => service.analyzeMetafile({
+        analyzeMetafile: (metafile, options2) => new Promise((resolve39, reject) => service.analyzeMetafile({
           callName: "analyzeMetafile",
           refs,
           metafile: typeof metafile === "string" ? metafile : JSON.stringify(metafile),
           options: options2,
-          callback: (err, res) => err ? reject(err) : resolve38(res)
+          callback: (err, res) => err ? reject(err) : resolve39(res)
         }))
       };
       return longLivedService;
@@ -25879,13 +25920,13 @@ error: ${text}`);
         worker.postMessage(msg);
         let status = Atomics.wait(sharedBufferView, 0, 0);
         if (status !== "ok" && status !== "not-equal") throw new Error("Internal error: Atomics.wait() failed: " + status);
-        let { message: { id: id2, resolve: resolve38, reject, properties } } = worker_threads2.receiveMessageOnPort(mainPort);
+        let { message: { id: id2, resolve: resolve39, reject, properties } } = worker_threads2.receiveMessageOnPort(mainPort);
         if (id !== id2) throw new Error(`Internal error: Expected id ${id} but got id ${id2}`);
         if (reject) {
           applyProperties(reject, properties);
           throw reject;
         }
-        return resolve38;
+        return resolve39;
       };
       worker.unref();
       return {
@@ -28810,17 +28851,17 @@ var init_server_render = __esm({
 });
 
 // ../adapter/src/paths.ts
-import { resolve as resolve10, sep as sep2 } from "node:path";
-import { existsSync as existsSync9, statSync as statSync4, readFileSync as readFileSync10 } from "node:fs";
+import { resolve as resolve11, sep as sep2 } from "node:path";
+import { existsSync as existsSync10, statSync as statSync4, readFileSync as readFileSync10 } from "node:fs";
 function resolveWithin(baseDir, relPath) {
-  const base = resolve10(baseDir);
-  const target = resolve10(baseDir, relPath);
+  const base = resolve11(baseDir);
+  const target = resolve11(baseDir, relPath);
   const prefix = base + sep2;
   if (!target.startsWith(prefix)) return null;
   return target;
 }
 function installMdReadHook(publicDirs) {
-  const dirs = publicDirs.map((d) => resolve10(d));
+  const dirs = publicDirs.map((d) => resolve11(d));
   globalThis.__vsk_md_read_file = (p) => {
     for (const dir of dirs) {
       try {
@@ -28830,7 +28871,7 @@ function installMdReadHook(publicDirs) {
         if (!abs) continue;
         const lower = abs.toLowerCase();
         if (!lower.endsWith(".md") && !lower.endsWith(".markdown")) continue;
-        if (existsSync9(abs) && statSync4(abs).isFile()) return readFileSync10(abs, "utf8");
+        if (existsSync10(abs) && statSync4(abs).isFile()) return readFileSync10(abs, "utf8");
       } catch {
       }
     }
@@ -28864,12 +28905,12 @@ __export(plugins_exports, {
 });
 import {
   readFileSync as readFileSync13,
-  writeFileSync as writeFileSync4,
-  existsSync as existsSync12,
-  mkdirSync as mkdirSync2,
+  writeFileSync as writeFileSync5,
+  existsSync as existsSync13,
+  mkdirSync as mkdirSync3,
   statSync as statSync7
 } from "node:fs";
-import { resolve as resolve13, dirname as dirname8, join as join7, extname as extname4, basename } from "node:path";
+import { resolve as resolve14, dirname as dirname8, join as join8, extname as extname4, basename } from "node:path";
 import { createRequire as createRequire3 } from "node:module";
 import { spawn } from "node:child_process";
 function defaultState() {
@@ -28879,11 +28920,11 @@ function eqIgnoreCase(a, b) {
   return String(a || "").toLowerCase() === String(b || "").toLowerCase();
 }
 function stateFilePath(veskDir) {
-  return resolve13(veskDir, PLUGIN_STATE_FILENAME);
+  return resolve14(veskDir, PLUGIN_STATE_FILENAME);
 }
 function readPluginState(veskDir) {
   const file = stateFilePath(veskDir);
-  if (!existsSync12(file)) return defaultState();
+  if (!existsSync13(file)) return defaultState();
   let raw2;
   try {
     raw2 = JSON.parse(readFileSync13(file, "utf-8"));
@@ -28904,11 +28945,11 @@ function readPluginState(veskDir) {
 function writePluginState(veskDir, state) {
   const file = stateFilePath(veskDir);
   const dir = dirname8(file);
-  if (!existsSync12(dir)) mkdirSync2(dir, { recursive: true });
-  writeFileSync4(file, JSON.stringify(state, null, 2) + "\n", "utf-8");
+  if (!existsSync13(dir)) mkdirSync3(dir, { recursive: true });
+  writeFileSync5(file, JSON.stringify(state, null, 2) + "\n", "utf-8");
 }
 function resolvePackage(appDir, pkg) {
-  const require3 = createRequire3(resolve13(appDir, "package.json"));
+  const require3 = createRequire3(resolve14(appDir, "package.json"));
   let entryPath = null;
   let pkgJsonPath = null;
   let pkgJson = null;
@@ -28921,8 +28962,8 @@ function resolvePackage(appDir, pkg) {
       const seen = /* @__PURE__ */ new Set();
       while (cur && cur !== dirname8(cur) && !seen.has(cur)) {
         seen.add(cur);
-        const candidate = join7(cur, "package.json");
-        if (existsSync12(candidate)) {
+        const candidate = join8(cur, "package.json");
+        if (existsSync13(candidate)) {
           pkgJsonPath = candidate;
           break;
         }
@@ -28933,15 +28974,15 @@ function resolvePackage(appDir, pkg) {
     } catch {
     }
   }
-  if (pkgJsonPath && existsSync12(pkgJsonPath)) {
+  if (pkgJsonPath && existsSync13(pkgJsonPath)) {
     pkgJson = readJsonFile(pkgJsonPath);
     const main = pkgJson?.main || pkgJson?.module || "index.js";
-    entryPath = resolve13(dirname8(pkgJsonPath), main);
+    entryPath = resolve14(dirname8(pkgJsonPath), main);
   }
   let localPath = localDir(appDir, pkg);
   if (!localPath) {
     for (const sub of ["src/plugins", "plugins", "lib/plugins"]) {
-      const candidate = localDir(resolve13(appDir, sub), pkg);
+      const candidate = localDir(resolve14(appDir, sub), pkg);
       if (candidate) {
         localPath = candidate;
         break;
@@ -28949,30 +28990,30 @@ function resolvePackage(appDir, pkg) {
     }
   }
   if (localPath) {
-    const localJson = join7(localPath, "package.json");
+    const localJson = join8(localPath, "package.json");
     let json = null;
-    if (existsSync12(localJson)) {
+    if (existsSync13(localJson)) {
       json = readJsonFile(localJson);
     }
     return { installed: true, path: localPath, dir: localPath, packageJson: json ?? pkgJson };
   }
-  const installed2 = !!pkgJsonPath && existsSync12(pkgJsonPath);
+  const installed2 = !!pkgJsonPath && existsSync13(pkgJsonPath);
   return { installed: installed2, path: entryPath, dir: installed2 ? dirname8(pkgJsonPath) : null, packageJson: pkgJson };
 }
 function localDir(base, pkg) {
   if (pkg.startsWith("@")) {
     const parts = pkg.split("/");
-    const p2 = resolve13(base, parts[0], parts[1] ?? "");
-    if (existsSync12(p2)) return p2;
+    const p2 = resolve14(base, parts[0], parts[1] ?? "");
+    if (existsSync13(p2)) return p2;
     return null;
   }
-  const p = resolve13(base, pkg);
-  if (existsSync12(p)) return p;
+  const p = resolve14(base, pkg);
+  if (existsSync13(p)) return p;
   return null;
 }
 function readJsonFile(file) {
   try {
-    if (existsSync12(file)) return JSON.parse(readFileSync13(file, "utf-8"));
+    if (existsSync13(file)) return JSON.parse(readFileSync13(file, "utf-8"));
   } catch {
   }
   return null;
@@ -29012,7 +29053,7 @@ function repositoryToString(r) {
 function assemblePluginMeta(probe) {
   const pkgJson = probe.packageJson || {};
   const dir = probe.dir;
-  const meta = dir ? readJsonFile(resolve13(dir, "vesk.meta.json")) : null;
+  const meta = dir ? readJsonFile(resolve14(dir, "vesk.meta.json")) : null;
   const hasMeta = !!meta && Object.keys(meta).length > 0;
   const m = meta || {};
   const metaSource = hasMeta ? "vesk.meta.json" : probe.packageJson ? "package.json" : "none";
@@ -29251,11 +29292,11 @@ function findIconFile(dir, meta) {
   const explicit = str(meta?.icon);
   if (explicit) {
     const p = resolveWithin(dir, explicit);
-    if (p && existsSync12(p) && statSync7(p).isFile()) return p;
+    if (p && existsSync13(p) && statSync7(p).isFile()) return p;
   }
   for (const name of ["icon.png", "icon.ico"]) {
-    const p = resolve13(dir, name);
-    if (existsSync12(p) && statSync7(p).isFile()) return p;
+    const p = resolve14(dir, name);
+    if (existsSync13(p) && statSync7(p).isFile()) return p;
   }
   return null;
 }
@@ -29263,7 +29304,7 @@ function findPluginIcon(appDir, name) {
   const probe = resolvePackage(appDir, name);
   const dir = probe.dir;
   if (!dir) return null;
-  const meta = readJsonFile(resolve13(dir, "vesk.meta.json"));
+  const meta = readJsonFile(resolve14(dir, "vesk.meta.json"));
   const iconPath = findIconFile(dir, meta);
   if (!iconPath) return null;
   const ext = extname4(iconPath).toLowerCase();
@@ -29326,7 +29367,7 @@ function resolveDtsPath(probe, pkgJson) {
   for (const rel of candidates) {
     if (!rel) continue;
     const abs = resolveWithin(dir, rel);
-    if (abs && existsSync12(abs) && statSync7(abs).isFile()) return abs;
+    if (abs && existsSync13(abs) && statSync7(abs).isFile()) return abs;
   }
   return null;
 }
@@ -29783,19 +29824,19 @@ __export(static_exports, {
   generateSitemap: () => generateSitemap,
   generateSsgRoutes: () => generateSsgRoutes
 });
-import { mkdirSync as mkdirSync3, copyFileSync as copyFileSync2, readdirSync as readdirSync3, statSync as statSync8, existsSync as existsSync13, writeFileSync as writeFileSync5, readFileSync as readFileSync14 } from "node:fs";
-import { resolve as resolve14, join as join8 } from "node:path";
+import { mkdirSync as mkdirSync4, copyFileSync as copyFileSync2, readdirSync as readdirSync3, statSync as statSync8, existsSync as existsSync14, writeFileSync as writeFileSync6, readFileSync as readFileSync14 } from "node:fs";
+import { resolve as resolve15, join as join9 } from "node:path";
 function copyStaticAssets2(publicDir, outDir2) {
-  const targetDir = resolve14(outDir2, "static", "public");
-  mkdirSync3(targetDir, { recursive: true });
-  if (!existsSync13(publicDir))
+  const targetDir = resolve15(outDir2, "static", "public");
+  mkdirSync4(targetDir, { recursive: true });
+  if (!existsSync14(publicDir))
     return;
   function copyDir(src2, dest) {
-    mkdirSync3(dest, { recursive: true });
+    mkdirSync4(dest, { recursive: true });
     const entries = readdirSync3(src2);
     for (const entry of entries) {
-      const srcPath = join8(src2, entry);
-      const destPath = join8(dest, entry);
+      const srcPath = join9(src2, entry);
+      const destPath = join9(dest, entry);
       const st = statSync8(srcPath);
       if (st.isDirectory()) {
         copyDir(srcPath, destPath);
@@ -29808,8 +29849,8 @@ function copyStaticAssets2(publicDir, outDir2) {
 }
 async function generateSsgRoutes(routeTree, appDir, outDir2, plugins, headExtra, cssUrls) {
   const { ssg: ssg2 } = await Promise.resolve().then(() => (init_server_render(), server_render_exports));
-  const prerenderDir = resolve14(outDir2, "prerendered");
-  mkdirSync3(prerenderDir, { recursive: true });
+  const prerenderDir = resolve15(outDir2, "prerendered");
+  mkdirSync4(prerenderDir, { recursive: true });
   const ssgOptions = { plugins, headExtra, cssUrls };
   const results = [];
   async function evaluateExport(src2, exportName) {
@@ -29828,7 +29869,7 @@ async function generateSsgRoutes(routeTree, appDir, outDir2, plugins, headExtra,
   async function walk6(nodes) {
     for (const node of nodes) {
       if (node.page) {
-        const pagePath = resolve14(appDir, node.sourceDir, "page.vsk");
+        const pagePath = resolve15(appDir, node.sourceDir, "page.vsk");
         const src2 = readFileSync14(pagePath, "utf-8");
         const hasStaticProps = src2.includes("getStaticProps");
         const hasStaticPaths = src2.includes("getStaticPaths");
@@ -29846,8 +29887,8 @@ async function generateSsgRoutes(routeTree, appDir, outDir2, plugins, headExtra,
                   console.error(`vesk: SSG path escaped output dir \u2014 skipping ${pagePath} (path: ${urlPath})`);
                   continue;
                 }
-                mkdirSync3(resolve14(htmlPath, ".."), { recursive: true });
-                writeFileSync5(htmlPath, result2.html);
+                mkdirSync4(resolve15(htmlPath, ".."), { recursive: true });
+                writeFileSync6(htmlPath, result2.html);
                 results.push({ path: urlPath, html: htmlPath, static: result2.static, params });
               } catch (e) {
                 const message = e instanceof Error ? e.message : String(e);
@@ -29858,9 +29899,9 @@ async function generateSsgRoutes(routeTree, appDir, outDir2, plugins, headExtra,
         } else if (hasStaticProps) {
           try {
             const result2 = await ssg2(src2, null, void 0, ssgOptions);
-            const htmlPath = resolve14(prerenderDir, node.fullPath === "/" ? "index.html" : `${node.fullPath.slice(1)}.html`);
-            mkdirSync3(resolve14(htmlPath, ".."), { recursive: true });
-            writeFileSync5(htmlPath, result2.html);
+            const htmlPath = resolve15(prerenderDir, node.fullPath === "/" ? "index.html" : `${node.fullPath.slice(1)}.html`);
+            mkdirSync4(resolve15(htmlPath, ".."), { recursive: true });
+            writeFileSync6(htmlPath, result2.html);
             results.push({ path: node.fullPath, html: htmlPath, static: result2.static });
           } catch (e) {
             const message = e instanceof Error ? e.message : String(e);
@@ -29929,16 +29970,16 @@ var image_pipeline_exports = {};
 __export(image_pipeline_exports, {
   optimizeImages: () => optimizeImages
 });
-import { mkdirSync as mkdirSync4, writeFileSync as writeFileSync6, readFileSync as readFileSync15, existsSync as existsSync14, readdirSync as readdirSync4, statSync as statSync9 } from "node:fs";
-import { resolve as resolve15, extname as extname5, dirname as dirname9 } from "node:path";
+import { mkdirSync as mkdirSync5, writeFileSync as writeFileSync7, readFileSync as readFileSync15, existsSync as existsSync15, readdirSync as readdirSync4, statSync as statSync9 } from "node:fs";
+import { resolve as resolve16, extname as extname5, dirname as dirname9 } from "node:path";
 async function processImage(srcPath, outDir2, baseName) {
   const image = sharpFn ? sharpFn(srcPath) : null;
   if (!image) {
     const original = readFileSync15(srcPath);
     for (const w of OUTPUT_WIDTHS) {
-      const outputPath = resolve15(outDir2, `${baseName}-${w}w`);
-      mkdirSync4(dirname9(outputPath), { recursive: true });
-      writeFileSync6(outputPath, original);
+      const outputPath = resolve16(outDir2, `${baseName}-${w}w`);
+      mkdirSync5(dirname9(outputPath), { recursive: true });
+      writeFileSync7(outputPath, original);
     }
     return [];
   }
@@ -29950,12 +29991,12 @@ async function processImage(srcPath, outDir2, baseName) {
       continue;
     const resized = image.clone().resize({ width: w, withoutEnlargement: true });
     const base = `${baseName}-${w}w`;
-    const jpgPath = resolve15(outDir2, `${base}${extname5(srcPath)}`);
-    mkdirSync4(dirname9(jpgPath), { recursive: true });
+    const jpgPath = resolve16(outDir2, `${base}${extname5(srcPath)}`);
+    mkdirSync5(dirname9(jpgPath), { recursive: true });
     await resized.toFile(jpgPath);
     generated.push(jpgPath);
     for (const fmt of FORMATS) {
-      const fmtPath = resolve15(outDir2, `${base}.${fmt}`);
+      const fmtPath = resolve16(outDir2, `${base}.${fmt}`);
       await resized.toFormat(fmt, { quality: 80 }).toFile(fmtPath);
       generated.push(fmtPath);
     }
@@ -29972,7 +30013,7 @@ function collectImageRefs(appDir) {
       return;
     }
     for (const entry of entries) {
-      const full = resolve15(dir, entry);
+      const full = resolve16(dir, entry);
       const st = statSync9(full);
       if (st.isDirectory()) {
         if (entry.startsWith("."))
@@ -29992,8 +30033,8 @@ function collectImageRefs(appDir) {
   return refs;
 }
 async function optimizeImages(appDir, outDir2) {
-  const imageOutDir = resolve15(outDir2, "static", "images");
-  mkdirSync4(imageOutDir, { recursive: true });
+  const imageOutDir = resolve16(outDir2, "static", "images");
+  mkdirSync5(imageOutDir, { recursive: true });
   const refs = collectImageRefs(appDir);
   if (refs.length === 0) {
     console.error("vesk images: no <Image> refs found");
@@ -30002,14 +30043,14 @@ async function optimizeImages(appDir, outDir2) {
   const results = [];
   for (const ref2 of refs) {
     const possiblePaths = [
-      resolve15(appDir, ref2.src),
-      resolve15(appDir, "..", "public", ref2.src.replace(/^\//, "")),
-      resolve15(appDir, "..", "src", ref2.src.replace(/^\//, "")),
-      resolve15(outDir2, "static", "public", ref2.src.replace(/^\//, ""))
+      resolve16(appDir, ref2.src),
+      resolve16(appDir, "..", "public", ref2.src.replace(/^\//, "")),
+      resolve16(appDir, "..", "src", ref2.src.replace(/^\//, "")),
+      resolve16(outDir2, "static", "public", ref2.src.replace(/^\//, ""))
     ];
     let srcPath = null;
     for (const p of possiblePaths) {
-      if (existsSync14(p)) {
+      if (existsSync15(p)) {
         srcPath = p;
         break;
       }
@@ -30056,8 +30097,8 @@ var seo_audit_exports = {};
 __export(seo_audit_exports, {
   runSeoAudit: () => runSeoAudit
 });
-import { readFileSync as readFileSync16, existsSync as existsSync15, readdirSync as readdirSync5, statSync as statSync10 } from "node:fs";
-import { resolve as resolve16 } from "node:path";
+import { readFileSync as readFileSync16, existsSync as existsSync16, readdirSync as readdirSync5, statSync as statSync10 } from "node:fs";
+import { resolve as resolve17 } from "node:path";
 function walkFiles(dir) {
   const results = [];
   let entries;
@@ -30067,7 +30108,7 @@ function walkFiles(dir) {
     return results;
   }
   for (const entry of entries) {
-    const full = resolve16(dir, entry);
+    const full = resolve17(dir, entry);
     const st = statSync10(full);
     if (st.isDirectory()) {
       if (!entry.startsWith("."))
@@ -30082,10 +30123,10 @@ function collectCombinedSource(appDir) {
   const pages = files.filter((f) => f.endsWith("/page.vsk") || f.endsWith("\\page.vsk"));
   const combined = [];
   for (const pagePath of pages) {
-    const dir = resolve16(pagePath, "..");
-    const layoutPath = resolve16(dir, "layout.vsk");
+    const dir = resolve17(pagePath, "..");
+    const layoutPath = resolve17(dir, "layout.vsk");
     const pageSrc = readFileSync16(pagePath, "utf-8");
-    const layoutSrc = existsSync15(layoutPath) ? readFileSync16(layoutPath, "utf-8") : "";
+    const layoutSrc = existsSync16(layoutPath) ? readFileSync16(layoutPath, "utf-8") : "";
     const combinedSrc = layoutSrc ? layoutSrc + "\n" + pageSrc : pageSrc;
     combined.push({
       path: pagePath,
@@ -30260,8 +30301,8 @@ var init_platform = __esm({
 });
 
 // ../adapter/src/platform-handler.ts
-import { existsSync as existsSync16 } from "node:fs";
-import { resolve as resolve17, dirname as dirname10 } from "node:path";
+import { existsSync as existsSync17 } from "node:fs";
+import { resolve as resolve18, dirname as dirname10 } from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 function routeName2(segments) {
   const parts = segments.filter(Boolean).map((s) => {
@@ -30278,12 +30319,13 @@ function toId(s) {
   return s.replace(/[^a-zA-Z0-9_]/g, "_").replace(/^_/, "");
 }
 function findCompilerSrc2() {
-  const monorepo = resolve17(__dirname5, "..", "..", "..", "packages", "compiler", "dist");
-  if (existsSync16(monorepo)) return monorepo;
+  const monorepo = resolve18(__dirname5, "..", "..", "..", "packages", "compiler", "dist");
+  if (existsSync17(monorepo)) return monorepo;
   throw new Error('@vesk/compiler/dist not found \u2014 run "npm run build" first');
 }
 function generatePlatformHandlerSource(input) {
   const { ssrRoutes, apiRoutes, prerenderedPaths, hasMiddleware } = input;
+  const hasEvents = !!input.hasEvents;
   let imports = "";
   const routeEntries = [];
   for (const r of ssrRoutes) {
@@ -30306,15 +30348,21 @@ function generatePlatformHandlerSource(input) {
   }
   const mwImport = hasMiddleware ? "import { execute as __executeMw } from './server/middleware.js';" : "";
   const hasMwLiteral = hasMiddleware ? "true" : "false";
+  const eventsImport = hasEvents ? "import { executeStart as __eventsStart, executeRequest as __eventsRequest } from './server/events.js';" : "";
   const prerenderedList = prerenderedPaths.length > 0 ? `const __prerendered = new Set(${JSON.stringify(prerenderedPaths)});
 ` : "const __prerendered = new Set();\n";
   const isrCache = "const __isrCache = new Map();";
+  const serverStoreLine = hasEvents ? "const __serverStore = globalThis.__vesk_server_ctx || {};" : "";
+  const eventsStartLine = hasEvents ? "  await __eventsStart({ server: null });" : "";
+  const eventsRequestLine = hasEvents ? "  await __eventsRequest(mwCtx);" : "";
+  const localsSeed = hasEvents ? "Object.assign({}, __serverStore)" : "{}";
   const compilerSrc = findCompilerSrc2();
-  const parseCookiesImport = hasMiddleware ? `import { parseCookies } from ${JSON.stringify(resolve17(compilerSrc, "server-cookies.js"))};` : "";
+  const parseCookiesImport = hasMiddleware ? `import { parseCookies } from ${JSON.stringify(resolve18(compilerSrc, "server-cookies.js"))};` : "";
   return `
 ${imports}
 ${parseCookiesImport}
 ${mwImport}
+${eventsImport}
 ${prerenderedList}
 ${isrCache}
 const __routes = [${routeEntries.join(",\n")}];
@@ -30343,23 +30391,28 @@ export async function handleRequest(request) {
   const url = new URL(request.url);
   const pathname = url.pathname;
   const isDataRequest = request.headers.get('x-vesk-data') === '1';
+${serverStoreLine}
 
   if (__prerendered.has(pathname) && !isDataRequest) {
     return new Response(null, { status: 308, headers: { Location: '/_vesk/static/public' + (pathname.endsWith('/') ? pathname + 'index.html' : pathname + '.html') } });
   }
 
-  let mwCtx = { params: {}, url, locals: {}, cookies: {}, request, resolveUrl(u) { return new URL(u, request.url).href; }, set() {}, get() { return undefined; } };
+${eventsStartLine}
+  let mwCtx = { params: {}, url, locals: ${localsSeed}, cookies: {}, request, resolveUrl(u) { return new URL(u, request.url).href; }, set() {}, get() { return undefined; } };
   if (${hasMwLiteral}) {
     mwCtx = {
       request,
       params: {},
       url,
-      locals: {},
+      locals: ${localsSeed},
       cookies: typeof parseCookies !== 'undefined' ? parseCookies(request.headers.get('cookie') || '') : {},
       resolveUrl(u) { return new URL(u, request.url).href; },
       set(key, value) { this.locals[key] = value; },
       get(key) { return this.locals[key]; },
     };
+  }
+${eventsRequestLine}
+  if (${hasMwLiteral}) {
     const mwResult = await __executeMw(mwCtx);
     if (mwResult.response) return mwResult.response;
     if (mwResult.rewriteUrl) url.pathname = mwResult.rewriteUrl;
@@ -30497,72 +30550,72 @@ var init_platform_handler = __esm({
 
 // ../adapter/src/platform-output.ts
 import {
-  mkdirSync as mkdirSync5,
+  mkdirSync as mkdirSync6,
   copyFileSync as copyFileSync3,
   readdirSync as readdirSync6,
   statSync as statSync11,
-  existsSync as existsSync17,
-  writeFileSync as writeFileSync7,
+  existsSync as existsSync18,
+  writeFileSync as writeFileSync8,
   rmSync as rmSync2,
   readFileSync as readFileSync17
 } from "node:fs";
-import { resolve as resolve18, join as join9, extname as extname6, dirname as dirname11 } from "node:path";
+import { resolve as resolve19, join as join10, extname as extname6, dirname as dirname11 } from "node:path";
 function ensureCleanDir(dir) {
   rmSync2(dir, { recursive: true, force: true });
-  mkdirSync5(dir, { recursive: true });
+  mkdirSync6(dir, { recursive: true });
 }
 function copyDirContents(srcDir, destDir) {
-  if (!existsSync17(srcDir)) return;
-  mkdirSync5(destDir, { recursive: true });
+  if (!existsSync18(srcDir)) return;
+  mkdirSync6(destDir, { recursive: true });
   for (const entry of readdirSync6(srcDir)) {
-    const srcPath = join9(srcDir, entry);
-    const destPath = join9(destDir, entry);
+    const srcPath = join10(srcDir, entry);
+    const destPath = join10(destDir, entry);
     if (statSync11(srcPath).isDirectory()) {
       copyDirContents(srcPath, destPath);
     } else {
-      mkdirSync5(dirname11(destPath), { recursive: true });
+      mkdirSync6(dirname11(destPath), { recursive: true });
       copyFileSync3(srcPath, destPath);
     }
   }
 }
 function writeFile(path, content) {
-  mkdirSync5(dirname11(path), { recursive: true });
-  writeFileSync7(path, content, "utf-8");
+  mkdirSync6(dirname11(path), { recursive: true });
+  writeFileSync8(path, content, "utf-8");
 }
 function writePlatformStatic(buildStaticDir, platformStaticDir) {
-  mkdirSync5(platformStaticDir, { recursive: true });
-  const publicDir = resolve18(buildStaticDir, "public");
-  if (existsSync17(publicDir)) {
+  mkdirSync6(platformStaticDir, { recursive: true });
+  const publicDir = resolve19(buildStaticDir, "public");
+  if (existsSync18(publicDir)) {
     copyDirContents(publicDir, platformStaticDir);
   }
-  const assetsDir = resolve18(platformStaticDir, "_vesk", "static");
+  const assetsDir = resolve19(platformStaticDir, "_vesk", "static");
   copyDirContents(buildStaticDir, assetsDir);
-  const runtimeAlias = resolve18(platformStaticDir, "_vesk", "runtime.js");
-  const clientPath = resolve18(buildStaticDir, "client.js");
-  if (existsSync17(clientPath)) {
-    mkdirSync5(dirname11(runtimeAlias), { recursive: true });
+  const runtimeAlias = resolve19(platformStaticDir, "_vesk", "runtime.js");
+  const clientPath = resolve19(buildStaticDir, "client.js");
+  if (existsSync18(clientPath)) {
+    mkdirSync6(dirname11(runtimeAlias), { recursive: true });
     copyFileSync3(clientPath, runtimeAlias);
   }
 }
 function writePrerenderedStatic(prerenderedRoutes, platformStaticDir) {
   for (const route of prerenderedRoutes) {
-    if (!existsSync17(route.html)) continue;
+    if (!existsSync18(route.html)) continue;
     const content = readFileSync17(route.html);
     const htmlRel = route.path === "/" ? "index.html" : `${route.path.replace(/^\//, "")}.html`;
-    const target = resolve18(platformStaticDir, "_vesk", "static", "public", htmlRel);
+    const target = resolve19(platformStaticDir, "_vesk", "static", "public", htmlRel);
     writeFile(target, content);
     if (route.path !== "/" && route.path.endsWith("/")) {
-      const dirIndex = resolve18(platformStaticDir, "_vesk", "static", "public", `${route.path.replace(/^\//, "")}index.html`);
+      const dirIndex = resolve19(platformStaticDir, "_vesk", "static", "public", `${route.path.replace(/^\//, "")}index.html`);
       writeFile(dirIndex, content);
     }
   }
 }
 function listStaticDir(dir) {
   const out = [];
-  if (!existsSync17(dir)) return out;
+  if (!existsSync18(dir)) return out;
   function walk6(d, prefix) {
     for (const entry of readdirSync6(d)) {
-      const full = join9(d, entry);
+      const full = join10(d, entry);
       const rel = prefix ? `${prefix}/${entry}` : entry;
       if (statSync11(full).isDirectory()) {
         walk6(full, rel);
@@ -30614,8 +30667,8 @@ var platform_deploy_exports = {};
 __export(platform_deploy_exports, {
   emitPlatformOutput: () => emitPlatformOutput
 });
-import { writeFileSync as writeFileSync8, mkdirSync as mkdirSync6, rmSync as rmSync3, symlinkSync } from "node:fs";
-import { resolve as resolve19, dirname as dirname12, relative as relative3 } from "node:path";
+import { writeFileSync as writeFileSync9, mkdirSync as mkdirSync7, rmSync as rmSync3, symlinkSync } from "node:fs";
+import { resolve as resolve20, dirname as dirname12, relative as relative3 } from "node:path";
 async function emitPlatformOutput(platform, ctx2) {
   if (platform === "node") return null;
   const prerenderedPaths = ctx2.prerenderedRoutes.map((r) => r.path);
@@ -30623,16 +30676,17 @@ async function emitPlatformOutput(platform, ctx2) {
     ssrRoutes: ctx2.ssrRoutes,
     apiRoutes: ctx2.apiRoutes,
     prerenderedPaths,
-    hasMiddleware: ctx2.hasMiddleware
+    hasMiddleware: ctx2.hasMiddleware,
+    hasEvents: ctx2.hasEvents
   });
   const shell = shellFor(platform);
-  const projectRoot = resolve19(ctx2.outDir, "..");
-  const outRoot = resolve19(projectRoot, shell.root);
+  const projectRoot = resolve20(ctx2.outDir, "..");
+  const outRoot = resolve20(projectRoot, shell.root);
   ensureCleanDir(outRoot);
-  const staticDir2 = shell.staticSubdir === "" ? outRoot : resolve19(outRoot, shell.staticSubdir || "static");
-  writePlatformStatic(resolve19(ctx2.outDir, "static"), staticDir2);
+  const staticDir2 = shell.staticSubdir === "" ? outRoot : resolve20(outRoot, shell.staticSubdir || "static");
+  writePlatformStatic(resolve20(ctx2.outDir, "static"), staticDir2);
   writePrerenderedStatic(ctx2.prerenderedRoutes, staticDir2);
-  const entry = resolve19(ctx2.outDir, ".platform-entry.mjs");
+  const entry = resolve20(ctx2.outDir, ".platform-entry.mjs");
   let source = handler;
   if (shell.imports) source = `${shell.imports}
 ${source}`;
@@ -30647,27 +30701,27 @@ ${inlineStaticSource(staticDir2)}`;
   source += `
 ${shell.bootstrap}
 `;
-  writeFileSync8(entry, source, "utf-8");
+  writeFileSync9(entry, source, "utf-8");
   let handlerRel;
   if (shell.functionFile) {
-    const funcDir = resolve19(outRoot, shell.functionFile.dir);
-    mkdirSync6(funcDir, { recursive: true });
+    const funcDir = resolve20(outRoot, shell.functionFile.dir);
+    mkdirSync7(funcDir, { recursive: true });
     if (shell.functionConfig) {
-      writeFileSync8(resolve19(funcDir, ".vc-config.json"), JSON.stringify(shell.functionConfig, null, 2), "utf-8");
+      writeFileSync9(resolve20(funcDir, ".vc-config.json"), JSON.stringify(shell.functionConfig, null, 2), "utf-8");
     }
     handlerRel = `${shell.functionFile.dir}/${shell.functionFile.file}`;
-    await bundlePlatformHandler({ entry, outfile: resolve19(funcDir, shell.functionFile.file), nodeBuiltins: shell.nodeBuiltins });
+    await bundlePlatformHandler({ entry, outfile: resolve20(funcDir, shell.functionFile.file), nodeBuiltins: shell.nodeBuiltins });
   } else {
     handlerRel = shell.outfile || "index.js";
-    await bundlePlatformHandler({ entry, outfile: resolve19(outRoot, handlerRel), nodeBuiltins: shell.nodeBuiltins });
+    await bundlePlatformHandler({ entry, outfile: resolve20(outRoot, handlerRel), nodeBuiltins: shell.nodeBuiltins });
   }
   for (const file of shell.extraFiles || []) {
-    writeFileSync8(resolve19(outRoot, file.path), file.content, "utf-8");
+    writeFileSync9(resolve20(outRoot, file.path), file.content, "utf-8");
   }
   if (platform === "vercel") {
-    writeFileSync8(resolve19(outRoot, "config.json"), vercelConfigJson(prerenderedPaths), "utf-8");
+    writeFileSync9(resolve20(outRoot, "config.json"), vercelConfigJson(prerenderedPaths), "utf-8");
   }
-  writeFileSync8(resolve19(outRoot, "manifest.json"), JSON.stringify({
+  writeFileSync9(resolve20(outRoot, "manifest.json"), JSON.stringify({
     platform,
     runtime: shell.nodeBuiltins ? "node" : "edge",
     static: shell.staticMode,
@@ -30677,9 +30731,9 @@ ${shell.bootstrap}
     prerendered: prerenderedPaths
   }, null, 2), "utf-8");
   if (platform === "vercel") {
-    const vercelDir = resolve19(projectRoot, ".vercel");
-    mkdirSync6(vercelDir, { recursive: true });
-    const linkPath = resolve19(vercelDir, "output");
+    const vercelDir = resolve20(projectRoot, ".vercel");
+    mkdirSync7(vercelDir, { recursive: true });
+    const linkPath = resolve20(vercelDir, "output");
     rmSync3(linkPath, { recursive: true, force: true });
     symlinkSync(relative3(dirname12(linkPath), outRoot), linkPath, "dir");
   }
@@ -34994,7 +35048,7 @@ __export(typecheck_exports, {
   typecheckProject: () => typecheckProject
 });
 import { readFileSync as readFileSync34, readdirSync as readdirSync14, statSync as statSync22 } from "node:fs";
-import { join as join20, dirname as dirname22, normalize, relative as relative7, resolve as resolve36, sep as sep7 } from "node:path";
+import { join as join22, dirname as dirname22, normalize, relative as relative7, resolve as resolve37, sep as sep7 } from "node:path";
 import * as ts8 from "typescript";
 function walkProjectFiles(projectRoot) {
   const code = [];
@@ -35007,7 +35061,7 @@ function walkProjectFiles(projectRoot) {
       return;
     }
     for (const e of entries) {
-      const p = join20(dir, e);
+      const p = join22(dir, e);
       let st;
       try {
         st = statSync22(p);
@@ -35035,8 +35089,8 @@ function walkProjectFiles(projectRoot) {
   return { code, js };
 }
 function isUnder(dir, file) {
-  const base = resolve36(dir);
-  const abs = resolve36(file);
+  const base = resolve37(dir);
+  const abs = resolve37(file);
   return abs === base || abs.startsWith(base + sep7);
 }
 function structureWarning(rel, message) {
@@ -35062,8 +35116,8 @@ function checkStructureFile(appDir, file) {
   return null;
 }
 function createTypecheckHost(projectRoot, appDir, vskFiles) {
-  const ambientPath = join20(appDir, "__vesk_ambient.d.ts");
-  const overridePath = join20(appDir, "__vesk_runtime_override.d.ts");
+  const ambientPath = join22(appDir, "__vesk_ambient.d.ts");
+  const overridePath = join22(appDir, "__vesk_runtime_override.d.ts");
   const cached = /* @__PURE__ */ new Map();
   const scriptKindFor = (file) => file.endsWith(".vsk") ? ts8.ScriptKind.TSX : ts8.ScriptKind.TS;
   const host2 = {
@@ -35133,7 +35187,7 @@ function createTypecheckHost(projectRoot, appDir, vskFiles) {
     directoryExists: (dir) => ts8.sys.directoryExists(dir),
     getDirectories: (dir) => {
       try {
-        return readdirSync14(dir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => join20(dir, d.name));
+        return readdirSync14(dir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => join22(dir, d.name));
       } catch {
         return [];
       }
@@ -35144,7 +35198,7 @@ function createTypecheckHost(projectRoot, appDir, vskFiles) {
     resolveModuleNameLiterals(moduleLiterals, containingFile, redirectedReference, options2) {
       return moduleLiterals.map(({ text }) => {
         if (text.endsWith(".vsk")) {
-          const abs = normalize(join20(dirname22(containingFile), text));
+          const abs = normalize(join22(dirname22(containingFile), text));
           return {
             resolvedModule: {
               resolvedFileName: abs + ".d.ts",
@@ -35155,7 +35209,7 @@ function createTypecheckHost(projectRoot, appDir, vskFiles) {
           };
         }
         if (text.endsWith(".css")) {
-          const abs = normalize(join20(dirname22(containingFile), text));
+          const abs = normalize(join22(dirname22(containingFile), text));
           return {
             resolvedModule: {
               resolvedFileName: abs + ".d.ts",
@@ -35173,7 +35227,7 @@ function createTypecheckHost(projectRoot, appDir, vskFiles) {
   return host2;
 }
 function typecheckProject(projectRoot, opts = {}) {
-  const appDir = opts.appDir ?? join20(projectRoot, "app");
+  const appDir = opts.appDir ?? join22(projectRoot, "app");
   const vskFiles = /* @__PURE__ */ new Map();
   const parseErrors = [];
   const warnings = [];
@@ -35212,8 +35266,8 @@ function typecheckProject(projectRoot, opts = {}) {
     }
     rootNames.push(f);
   }
-  const ambientPath = join20(appDir, "__vesk_ambient.d.ts");
-  const overridePath = join20(appDir, "__vesk_runtime_override.d.ts");
+  const ambientPath = join22(appDir, "__vesk_ambient.d.ts");
+  const overridePath = join22(appDir, "__vesk_runtime_override.d.ts");
   rootNames.push(ambientPath);
   rootNames.push(overridePath);
   const options2 = {
@@ -35777,8 +35831,8 @@ declare module '@vesk/runtime' {
 });
 
 // src/index.ts
-import { readFileSync as readFileSync35, writeFileSync as writeFileSync18, mkdirSync as mkdirSync15, existsSync as existsSync36 } from "fs";
-import { resolve as resolve37, join as join21, dirname as dirname23 } from "path";
+import { readFileSync as readFileSync35, writeFileSync as writeFileSync19, mkdirSync as mkdirSync16, existsSync as existsSync38 } from "fs";
+import { resolve as resolve38, join as join23, dirname as dirname23 } from "path";
 import { fileURLToPath as fileURLToPath9 } from "url";
 
 // ../compiler/dist/config.js
@@ -35886,9 +35940,9 @@ function validateConfig(config) {
     if (typeof plugin.name !== "string" || !plugin.name) {
       throw new Error("[vesk] A plugin is missing a `name` property. Use a Vesk-native plugin factory (e.g. tailwindcss({...}) from @vesk/plugin-tailwind) that returns a plugin object with the correct shape.");
     }
-    const hasKnownHook = typeof plugin.onCSS === "function" || typeof plugin.onFileWatch === "function" || typeof plugin.onTransformJS === "function" || typeof plugin.onBuildStart === "function" || typeof plugin.onBuildEnd === "function" || typeof plugin.onRequest === "function" || typeof plugin.onHead === "function" || typeof plugin.onHtml === "function" || plugin.provides && typeof plugin.provides === "object" && Object.keys(plugin.provides).length > 0;
+    const hasKnownHook = typeof plugin.onCSS === "function" || typeof plugin.onFileWatch === "function" || typeof plugin.onTransformJS === "function" || typeof plugin.onBuildStart === "function" || typeof plugin.onBuildEnd === "function" || typeof plugin.onRequest === "function" || typeof plugin.onStart === "function" || typeof plugin.onStop === "function" || typeof plugin.onHead === "function" || typeof plugin.onHtml === "function" || plugin.provides && typeof plugin.provides === "object" && Object.keys(plugin.provides).length > 0;
     if (!hasKnownHook) {
-      throw new Error(`[vesk] Plugin "${plugin.name}" implements none of the recognized hooks (onCSS, onFileWatch, onTransformJS, onBuildStart, onBuildEnd, onRequest, onHead, onHtml) or provides \u2014 it will never be called. Check the plugin package version, or see /docu/cli/plugin-api.md for the current hook contract.`);
+      throw new Error(`[vesk] Plugin "${plugin.name}" implements none of the recognized hooks (onCSS, onFileWatch, onTransformJS, onBuildStart, onBuildEnd, onRequest, onStart, onStop, onHead, onHtml) or provides \u2014 it will never be called. Check the plugin package version, or see /docu/cli/plugin-api.md for the current hook contract.`);
     }
   }
   return config;
@@ -36276,8 +36330,8 @@ function setRuntimeModule2(mod) {
 }
 
 // ../adapter/dist/index.js
-import { mkdirSync as mkdirSync7, writeFileSync as writeFileSync9, existsSync as existsSync18, readFileSync as readFileSync18 } from "node:fs";
-import { resolve as resolve20, dirname as dirname13, relative as relative4, basename as basename2 } from "node:path";
+import { mkdirSync as mkdirSync8, writeFileSync as writeFileSync10, existsSync as existsSync19, readFileSync as readFileSync18 } from "node:fs";
+import { resolve as resolve21, dirname as dirname13, relative as relative4, basename as basename2 } from "node:path";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 
 // ../adapter/src/runtime-bundle.ts
@@ -36393,7 +36447,17 @@ async function bundleRuntime(appDir, outDir2) {
     "export const getAction = __veskRuntime.getAction;",
     "export const clearActions = __veskRuntime.clearActions;",
     "export const validateActionInput = __veskRuntime.validateActionInput;",
-    "export const issuesToFieldMap = __veskRuntime.issuesToFieldMap;"
+    "export const issuesToFieldMap = __veskRuntime.issuesToFieldMap;",
+    "",
+    "// Server-wide context store (server events)",
+    "export const serverLocals = __veskRuntime.serverLocals;",
+    "export const getServerContext = __veskRuntime.getServerContext;",
+    "export const setServerContext = __veskRuntime.setServerContext;",
+    "export const clearServerContext = __veskRuntime.clearServerContext;",
+    "export const server_locals = __veskRuntime.server_locals;",
+    "export const get_server_context = __veskRuntime.get_server_context;",
+    "export const set_server_context = __veskRuntime.set_server_context;",
+    "export const clear_server_context = __veskRuntime.clear_server_context;"
   ].join("\n");
   writeFileSync(entryFile, entryContent, "utf-8");
   try {
@@ -37314,13 +37378,117 @@ ${extracted.body}
   return code;
 }
 
+// ../adapter/src/events.ts
+init_esbuild_fallback();
+import { writeFileSync as writeFileSync2, unlinkSync as unlinkSync2, mkdirSync } from "node:fs";
+import { resolve as resolve9 } from "node:path";
+
+// ../compiler/src/events.ts
+import { existsSync as existsSync8 } from "fs";
+import { join as join5 } from "path";
+var EVENTS_FILE_NAMES = ["_events.ts", "_events.js"];
+function collectEventsFile(appDir) {
+  for (const name of EVENTS_FILE_NAMES) {
+    const candidate = join5(appDir, name);
+    if (existsSync8(candidate)) return candidate;
+  }
+  return null;
+}
+
+// ../adapter/src/events.ts
+var buildId2 = 0;
+function buildEntry(sourcePath2) {
+  return [
+    `import * as __events from ${JSON.stringify(sourcePath2)};`,
+    "",
+    "const __store = () => (globalThis.__vesk_server_ctx ||= {});",
+    "",
+    "const __handlers = {};",
+    "for (const __name of ['onStart', 'onRequest', 'onStop']) {",
+    "  const __fn = __events[__name];",
+    "  if (typeof __fn === 'function') __handlers[__name] = __fn;",
+    "}",
+    "",
+    "function __makeCtx(base) {",
+    "  const store = __store();",
+    "  const start = base && typeof base === 'object' ? base : {};",
+    "  return Object.assign({}, start, {",
+    "    server: start.server !== undefined ? start.server : null,",
+    "    port: start.port !== undefined ? start.port : 0,",
+    "    host: start.host,",
+    "    serverLocals: store,",
+    "    set(key, value) { store[key] = value; return value; },",
+    "    get(key) { return store[key]; },",
+    "  });",
+    "}",
+    "",
+    "export async function executeStart(base) {",
+    "  if (globalThis.__vesk_events_started) return;",
+    "  globalThis.__vesk_events_started = true;",
+    "  if (typeof __handlers.onStart === 'function') await __handlers.onStart(__makeCtx(base));",
+    "}",
+    "",
+    "export async function executeRequest(base) {",
+    "  if (typeof __handlers.onRequest !== 'function') return;",
+    "  await __handlers.onRequest(__makeCtx(base));",
+    "}",
+    "",
+    "export async function executeStop(base) {",
+    "  if (typeof __handlers.onStop !== 'function') return;",
+    "  try {",
+    "    await __handlers.onStop(__makeCtx(base));",
+    "  } finally {",
+    "    globalThis.__vesk_events_started = false;",
+    "  }",
+    "}",
+    "",
+    "export const onStart = __handlers.onStart;",
+    "export const onRequest = __handlers.onRequest;",
+    "export const onStop = __handlers.onStop;",
+    ""
+  ].join("\n");
+}
+async function compileEvents(appDir, outDir2) {
+  const sourcePath2 = collectEventsFile(appDir);
+  if (!sourcePath2) return false;
+  const serverDir = resolve9(outDir2, "server");
+  mkdirSync(serverDir, { recursive: true });
+  const entryFile = resolve9(serverDir, `.events-entry-${buildId2++}.mjs`);
+  writeFileSync2(entryFile, buildEntry(sourcePath2), "utf-8");
+  try {
+    const result2 = await build({
+      entryPoints: [entryFile],
+      bundle: true,
+      platform: "neutral",
+      format: "esm",
+      minify: true,
+      outfile: resolve9(serverDir, "events.js"),
+      external: ["fs", "node:fs", "path", "node:path", "module", "node:module", "node:async_hooks"],
+      target: ["es2022"],
+      treeShaking: true
+    });
+    if (result2.errors.length > 0) {
+      throw new Error(`esbuild errors: ${result2.errors.map((e) => e.text).join(", ")}`);
+    }
+    if (result2.warnings.length > 0) {
+      for (const w of result2.warnings) console.error("vesk build warning:", w.text);
+    }
+    return true;
+  } finally {
+    try {
+      unlinkSync2(entryFile);
+    } catch {
+    }
+  }
+}
+
 // ../adapter/src/client-bundle.ts
 init_esbuild_fallback();
 init_strip_ts();
 init_parser();
 init_client_codegen();
-import { readFileSync as readFileSync9, existsSync as existsSync8, writeFileSync as writeFileSync2, unlinkSync as unlinkSync2, statSync as statSync3, rmSync } from "node:fs";
-import { resolve as resolve9, join as join5, dirname as dirname6, relative as relative2, sep } from "node:path";
+import { readFileSync as readFileSync9, existsSync as existsSync9, writeFileSync as writeFileSync3, unlinkSync as unlinkSync3, statSync as statSync3, rmSync } from "node:fs";
+import { resolve as resolve10, join as join6, dirname as dirname6, relative as relative2, sep } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 init_vsk_imports();
 init_md_inline();
@@ -37341,15 +37509,15 @@ function buildRouterOpts(options2) {
   return "";
 }
 function findRuntimeSrc2(appDir) {
-  const monorepoRoot = resolve9(__dirname3, "..", "..", "..");
+  const monorepoRoot = resolve10(__dirname3, "..", "..", "..");
   const candidates = [
-    resolve9(monorepoRoot, "packages", "runtime", "dist"),
-    resolve9(appDir, "..", "node_modules", "@vesk/runtime"),
-    resolve9(appDir, "node_modules", "@vesk/runtime")
+    resolve10(monorepoRoot, "packages", "runtime", "dist"),
+    resolve10(appDir, "..", "node_modules", "@vesk/runtime"),
+    resolve10(appDir, "node_modules", "@vesk/runtime")
   ];
   for (const base of candidates) {
-    for (const dir of [base, join5(base, "dist")]) {
-      if (existsSync8(join5(dir, "index-client.js"))) return dir;
+    for (const dir of [base, join6(base, "dist")]) {
+      if (existsSync9(join6(dir, "index-client.js"))) return dir;
     }
   }
   throw new Error('@vesk/runtime/dist not found \u2014 run "npm run build" first');
@@ -37638,32 +37806,32 @@ async function generateClientBundle(routeTree, appDir, componentMap, options2) {
     let walkSplit2 = function(nodes, _chain) {
       for (const node of nodes) {
         const chunkCode = [];
-        const pagePath = resolve9(appDir, node.sourceDir, "page.vsk");
-        if (node.page && existsSync8(pagePath)) {
+        const pagePath = resolve10(appDir, node.sourceDir, "page.vsk");
+        if (node.page && existsSync9(pagePath)) {
           compileFile2(pagePath, node.page, chunkCode);
         }
-        const layoutPath = resolve9(appDir, node.sourceDir, "layout.vsk");
-        if (node.layout && existsSync8(layoutPath)) {
+        const layoutPath = resolve10(appDir, node.sourceDir, "layout.vsk");
+        if (node.layout && existsSync9(layoutPath)) {
           compileFile2(layoutPath, node.layout, chunkCode);
         }
-        const errorPath = resolve9(appDir, node.sourceDir, "error.vsk");
-        if (node.error && existsSync8(errorPath)) {
+        const errorPath = resolve10(appDir, node.sourceDir, "error.vsk");
+        if (node.error && existsSync9(errorPath)) {
           compileFile2(errorPath, node.error, chunkCode);
         }
-        const notFoundPath = resolve9(appDir, node.sourceDir, "not-found.vsk");
-        if (node.notFound && existsSync8(notFoundPath)) {
+        const notFoundPath = resolve10(appDir, node.sourceDir, "not-found.vsk");
+        if (node.notFound && existsSync9(notFoundPath)) {
           compileFile2(notFoundPath, node.notFound, chunkCode);
         }
-        const offlinePath = resolve9(appDir, node.sourceDir, "offline.vsk");
-        if (node.offline && existsSync8(offlinePath)) {
+        const offlinePath = resolve10(appDir, node.sourceDir, "offline.vsk");
+        if (node.offline && existsSync9(offlinePath)) {
           compileFile2(offlinePath, node.offline, chunkCode);
         }
-        const networkPath = resolve9(appDir, node.sourceDir, "network.vsk");
-        if (node.network && existsSync8(networkPath)) {
+        const networkPath = resolve10(appDir, node.sourceDir, "network.vsk");
+        if (node.network && existsSync9(networkPath)) {
           compileFile2(networkPath, node.network, chunkCode);
         }
-        const loadingPath = resolve9(appDir, node.sourceDir, "loading.vsk");
-        if (node.loading && existsSync8(loadingPath)) {
+        const loadingPath = resolve10(appDir, node.sourceDir, "loading.vsk");
+        if (node.loading && existsSync9(loadingPath)) {
           compileFile2(loadingPath, node.loading, chunkCode);
         }
         if (chunkCode.length > 0) {
@@ -37740,20 +37908,20 @@ ${entry.code}
       }
     }, walkMono2 = function(nodes) {
       for (const node of nodes) {
-        const pagePath = resolve9(appDir, node.sourceDir, "page.vsk");
-        if (node.page && existsSync8(pagePath)) compileFileMono2(pagePath, node.page);
-        const layoutPath = resolve9(appDir, node.sourceDir, "layout.vsk");
-        if (node.layout && existsSync8(layoutPath)) compileFileMono2(layoutPath, node.layout);
-        const errorPath = resolve9(appDir, node.sourceDir, "error.vsk");
-        if (node.error && existsSync8(errorPath)) compileFileMono2(errorPath, node.error);
-        const notFoundPath = resolve9(appDir, node.sourceDir, "not-found.vsk");
-        if (node.notFound && existsSync8(notFoundPath)) compileFileMono2(notFoundPath, node.notFound);
-        const offlinePath = resolve9(appDir, node.sourceDir, "offline.vsk");
-        if (node.offline && existsSync8(offlinePath)) compileFileMono2(offlinePath, node.offline);
-        const networkPath = resolve9(appDir, node.sourceDir, "network.vsk");
-        if (node.network && existsSync8(networkPath)) compileFileMono2(networkPath, node.network);
-        const loadingPath = resolve9(appDir, node.sourceDir, "loading.vsk");
-        if (node.loading && existsSync8(loadingPath)) compileFileMono2(loadingPath, node.loading);
+        const pagePath = resolve10(appDir, node.sourceDir, "page.vsk");
+        if (node.page && existsSync9(pagePath)) compileFileMono2(pagePath, node.page);
+        const layoutPath = resolve10(appDir, node.sourceDir, "layout.vsk");
+        if (node.layout && existsSync9(layoutPath)) compileFileMono2(layoutPath, node.layout);
+        const errorPath = resolve10(appDir, node.sourceDir, "error.vsk");
+        if (node.error && existsSync9(errorPath)) compileFileMono2(errorPath, node.error);
+        const notFoundPath = resolve10(appDir, node.sourceDir, "not-found.vsk");
+        if (node.notFound && existsSync9(notFoundPath)) compileFileMono2(notFoundPath, node.notFound);
+        const offlinePath = resolve10(appDir, node.sourceDir, "offline.vsk");
+        if (node.offline && existsSync9(offlinePath)) compileFileMono2(offlinePath, node.offline);
+        const networkPath = resolve10(appDir, node.sourceDir, "network.vsk");
+        if (node.network && existsSync9(networkPath)) compileFileMono2(networkPath, node.network);
+        const loadingPath = resolve10(appDir, node.sourceDir, "loading.vsk");
+        if (node.loading && existsSync9(loadingPath)) compileFileMono2(loadingPath, node.loading);
         walkMono2(node.children || []);
       }
     };
@@ -37802,8 +37970,8 @@ function buildRuntimeCode(runtimeDir) {
   ];
   let code = "";
   for (const f of runtimeFiles) {
-    const p = join5(runtimeDir, f);
-    if (existsSync8(p)) {
+    const p = join6(runtimeDir, f);
+    if (existsSync9(p)) {
       let src2 = readFileSync9(p, "utf-8");
       src2 = stripTypes(src2);
       src2 = src2.replace(/^import\s+[\s\S]*?from\s+['"](?:\.\/.*?|@vesk\/runtime\/src\/.*?)['"];?\n?/gm, "");
@@ -37816,7 +37984,7 @@ ${src2}
 `;
     }
   }
-  const indexSrc = readFileSync9(join5(runtimeDir, "index-client.js"), "utf-8");
+  const indexSrc = readFileSync9(join6(runtimeDir, "index-client.js"), "utf-8");
   const exportNames = stripTypes(indexSrc).match(/export\s*\{\s*([^}]+)\s*\}\s*from/g)?.flatMap((m) => m.replace(/export\s*\{\s*|\s*\}\s*from/g, "").split(",").map((s) => s.trim())) || [];
   code += "// --- exports ---\n";
   for (const name of [...new Set(exportNames)]) {
@@ -37826,7 +37994,7 @@ ${src2}
   return code;
 }
 function runtimeExportNames(runtimeDir) {
-  const indexSrc = readFileSync9(join5(runtimeDir, "index-client.js"), "utf-8");
+  const indexSrc = readFileSync9(join6(runtimeDir, "index-client.js"), "utf-8");
   const names = /* @__PURE__ */ new Set();
   for (const m of indexSrc.matchAll(/export\s*\{([^}]+)\}\s*from/g)) {
     for (const raw2 of m[1].split(",")) {
@@ -37845,13 +38013,13 @@ async function buildTreeShakenRuntime(runtimeDir, usedNames) {
     console.error(`vesk: runtime names not exported \u2014 ${missing.join(", ")}; falling back to full runtime`);
     return buildRuntimeCode(runtimeDir);
   }
-  const entry = join5(runtimeDir, RUNTIME_ENTRY);
+  const entry = join6(runtimeDir, RUNTIME_ENTRY);
   try {
     try {
       rmSync(entry);
     } catch {
     }
-    writeFileSync2(entry, `export { ${unique.join(", ")} } from './index-client.js';
+    writeFileSync3(entry, `export { ${unique.join(", ")} } from './index-client.js';
 `);
     const result2 = await build({
       entryPoints: [entry],
@@ -37882,7 +38050,7 @@ export { ${unique.join(", ")} };
     return buildRuntimeCode(runtimeDir);
   } finally {
     try {
-      unlinkSync2(entry);
+      unlinkSync3(entry);
     } catch {
     }
   }
@@ -37982,7 +38150,7 @@ if (typeof document !== 'undefined') __router.start();
 }
 
 // ../adapter/src/manifest.ts
-function generateManifest(routes, ssrRoutes, apiRoutes, staticRoutes, middlewareEnabled, actionMap, headExtra) {
+function generateManifest(routes, ssrRoutes, apiRoutes, staticRoutes, middlewareEnabled, actionMap, headExtra, eventsEnabled = false) {
   const routeEntries = [];
   for (const r of ssrRoutes) {
     const urlParts = r.fullPath.split("/").filter(Boolean);
@@ -38023,24 +38191,25 @@ function generateManifest(routes, ssrRoutes, apiRoutes, staticRoutes, middleware
       dir: "static"
     },
     ...actionEntries.length > 0 ? { actions: actionEntries } : {},
-    ...headExtra ? { headExtra } : {}
+    ...headExtra ? { headExtra } : {},
+    ...eventsEnabled ? { events: true } : {}
   };
 }
 
 // ../adapter/src/static.ts
 init_paths();
-import { mkdirSync, copyFileSync, readdirSync as readdirSync2, statSync as statSync5, existsSync as existsSync10, writeFileSync as writeFileSync3, readFileSync as readFileSync11 } from "node:fs";
-import { resolve as resolve11, join as join6 } from "node:path";
+import { mkdirSync as mkdirSync2, copyFileSync, readdirSync as readdirSync2, statSync as statSync5, existsSync as existsSync11, writeFileSync as writeFileSync4, readFileSync as readFileSync11 } from "node:fs";
+import { resolve as resolve12, join as join7 } from "node:path";
 function copyStaticAssets(publicDir, outDir2) {
-  const targetDir = resolve11(outDir2, "static", "public");
-  mkdirSync(targetDir, { recursive: true });
-  if (!existsSync10(publicDir)) return;
+  const targetDir = resolve12(outDir2, "static", "public");
+  mkdirSync2(targetDir, { recursive: true });
+  if (!existsSync11(publicDir)) return;
   function copyDir(src2, dest) {
-    mkdirSync(dest, { recursive: true });
+    mkdirSync2(dest, { recursive: true });
     const entries = readdirSync2(src2);
     for (const entry of entries) {
-      const srcPath = join6(src2, entry);
-      const destPath = join6(dest, entry);
+      const srcPath = join7(src2, entry);
+      const destPath = join7(dest, entry);
       const st = statSync5(srcPath);
       if (st.isDirectory()) {
         copyDir(srcPath, destPath);
@@ -38053,8 +38222,8 @@ function copyStaticAssets(publicDir, outDir2) {
 }
 
 // ../adapter/src/prod-server.ts
-import { readFileSync as readFileSync12, existsSync as existsSync11, statSync as statSync6 } from "node:fs";
-import { resolve as resolve12, extname as extname3, dirname as dirname7 } from "node:path";
+import { readFileSync as readFileSync12, existsSync as existsSync12, statSync as statSync6 } from "node:fs";
+import { resolve as resolve13, extname as extname3, dirname as dirname7 } from "node:path";
 import { createServer } from "node:http";
 import { createRequire as createRequire2 } from "node:module";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
@@ -38169,10 +38338,10 @@ async function startProdServer(outDir, options) {
   const host = options?.host || "127.0.0.1";
   const maxBodyBytes = options?.maxBodyBytes || DEFAULT_MAX_BODY_BYTES;
   if (!process.env.NODE_ENV) process.env.NODE_ENV = "production";
-  const staticDir = resolve12(outDir, "static");
-  const configPath = resolve12(outDir, "config.json");
-  installMdReadHook([resolve12(staticDir, "public")]);
-  if (!existsSync11(configPath)) {
+  const staticDir = resolve13(outDir, "static");
+  const configPath = resolve13(outDir, "config.json");
+  installMdReadHook([resolve13(staticDir, "public")]);
+  if (!existsSync12(configPath)) {
     console.error(`vesk start: no build found at ${outDir}`);
     console.error('Run "vesk build" first');
     process.exit(1);
@@ -38180,16 +38349,16 @@ async function startProdServer(outDir, options) {
   const buildConfig = JSON.parse(readFileSync12(configPath, "utf-8"));
   const bakedHeadExtra = buildConfig.headExtra || "";
   console.error(`vesk start: serving from ${outDir}`);
-  const projectDir = resolve12(outDir, "..");
+  const projectDir = resolve13(outDir, "..");
   let securityConfig = {};
   let mdConfig;
   try {
-    const veskConfigPath = resolve12(projectDir, "vesk.config.js");
-    const veskConfigTsPath = resolve12(projectDir, "vesk.config.ts");
+    const veskConfigPath = resolve13(projectDir, "vesk.config.js");
+    const veskConfigTsPath = resolve13(projectDir, "vesk.config.ts");
     let rawConfig = {};
-    if (existsSync11(veskConfigPath)) {
+    if (existsSync12(veskConfigPath)) {
       rawConfig = _require(veskConfigPath);
-    } else if (existsSync11(veskConfigTsPath)) {
+    } else if (existsSync12(veskConfigTsPath)) {
       const { transpile } = _require("typescript");
       const src = readFileSync12(veskConfigTsPath, "utf-8");
       const result = transpile(src, { module: 99, target: 99 });
@@ -38220,18 +38389,26 @@ async function startProdServer(outDir, options) {
   } catch {
   }
   let middlewareMod = null;
-  const mwPath = resolve12(outDir, "server", "middleware.js");
-  if (existsSync11(mwPath)) {
+  const mwPath = resolve13(outDir, "server", "middleware.js");
+  if (existsSync12(mwPath)) {
     try {
       middlewareMod = await import(`${mwPath}?t=${Date.now()}`);
     } catch {
     }
   }
+  let eventsMod = null;
+  const eventsPath = resolve13(outDir, "server", "events.js");
+  if (existsSync12(eventsPath)) {
+    try {
+      eventsMod = await import(`${eventsPath}?t=${Date.now()}`);
+    } catch {
+    }
+  }
   const functionCache = /* @__PURE__ */ new Map();
   async function loadFunction(funcPath) {
     if (functionCache.has(funcPath)) return functionCache.get(funcPath);
-    const fullPath = resolve12(outDir, funcPath);
-    if (!existsSync11(fullPath)) return null;
+    const fullPath = resolve13(outDir, funcPath);
+    if (!existsSync12(fullPath)) return null;
     try {
       const mod = await import(`${fullPath}?t=${Date.now()}`);
       functionCache.set(funcPath, mod);
@@ -38291,9 +38468,9 @@ async function startProdServer(outDir, options) {
       }
       return origWriteHead(statusCode, headers2);
     });
-    const publicDir = resolve12(staticDir, "public");
+    const publicDir = resolve13(staticDir, "public");
     const rootFile = url.pathname.length > 1 ? resolveWithin(publicDir, url.pathname.slice(1)) : null;
-    if (rootFile && existsSync11(rootFile) && statSync6(rootFile).isFile()) {
+    if (rootFile && existsSync12(rootFile) && statSync6(rootFile).isFile()) {
       const ext = extname3(rootFile);
       res.writeHead(200, { "Content-Type": MIME[ext] || "application/octet-stream" });
       res.end(readFileSync12(rootFile));
@@ -38312,8 +38489,8 @@ async function startProdServer(outDir, options) {
       return;
     }
     if (url.pathname === "/_vesk/runtime.js") {
-      const clientPath = resolve12(staticDir, "client.js");
-      if (existsSync11(clientPath)) {
+      const clientPath = resolve13(staticDir, "client.js");
+      if (existsSync12(clientPath)) {
         res.writeHead(200, { "Content-Type": "application/javascript" });
         res.end(readFileSync12(clientPath));
         return;
@@ -38327,7 +38504,7 @@ async function startProdServer(outDir, options) {
         res.end("Forbidden");
         return;
       }
-      if (existsSync11(staticPath) && statSync6(staticPath).isFile()) {
+      if (existsSync12(staticPath) && statSync6(staticPath).isFile()) {
         const ext = extname3(staticPath);
         res.writeHead(200, { "Content-Type": MIME[ext] || "application/octet-stream" });
         res.end(readFileSync12(staticPath));
@@ -38337,8 +38514,8 @@ async function startProdServer(outDir, options) {
     if (buildConfig.prerendered) {
       const prerendered = buildConfig.prerendered.find((r) => r.path === url.pathname);
       if (prerendered) {
-        const htmlPath = resolve12(outDir, prerendered.file);
-        if (existsSync11(htmlPath)) {
+        const htmlPath = resolve13(outDir, prerendered.file);
+        if (existsSync12(htmlPath)) {
           res.writeHead(200, { "Content-Type": "text/html" });
           res.end(readFileSync12(htmlPath));
           return;
@@ -38346,12 +38523,13 @@ async function startProdServer(outDir, options) {
       }
     }
     let mwCtx;
+    const serverStore = globalThis.__vesk_server_ctx;
     if (middlewareMod) {
       mwCtx = {
         request: new Request(url.href, { headers: req.headers, method: req.method || "GET" }),
         params: {},
         url,
-        locals: {},
+        locals: Object.assign({}, serverStore || {}),
         cookies: {},
         set(key, value) {
           this.locals[key] = value;
@@ -38360,21 +38538,11 @@ async function startProdServer(outDir, options) {
           return this.locals[key];
         }
       };
-      const mwResult = await middlewareMod.execute(mwCtx);
-      if (mwResult.response) {
-        const body = await mwResult.response.text();
-        res.writeHead(mwResult.response.status, Object.fromEntries(mwResult.response.headers));
-        res.end(body);
-        return;
-      }
-      if (mwResult.rewriteUrl) {
-        url.pathname = mwResult.rewriteUrl;
-      }
     } else {
       mwCtx = {
         params: {},
         url,
-        locals: {},
+        locals: Object.assign({}, serverStore || {}),
         cookies: {},
         request: null,
         set() {
@@ -38384,6 +38552,25 @@ async function startProdServer(outDir, options) {
         }
       };
     }
+    if (eventsMod) {
+      try {
+        await eventsMod.executeRequest?.(mwCtx);
+      } catch (e) {
+        console.error("vesk request: onRequest error:", e instanceof Error ? e.message : e);
+      }
+    }
+    if (middlewareMod) {
+      const mwResult = await middlewareMod.execute(mwCtx);
+      if (mwResult.response) {
+        const body = await mwResult.response.text();
+        res.writeHead(mwResult.response.status, Object.fromEntries(mwResult.response.headers));
+        res.end(body);
+        return;
+      }
+      if (mwResult.rewriteUrl) {
+        url.pathname = mwResult.rewriteUrl;
+      }
+    }
     globalThis.__vesk_request = mwCtx;
     if (url.pathname.startsWith("/_vesk/action/")) {
       const actionId = url.pathname.replace("/_vesk/action/", "");
@@ -38434,16 +38621,16 @@ async function startProdServer(outDir, options) {
         }
       }
     }
-    const appDir = resolve12(projectDir, "app");
+    const appDir = resolve13(projectDir, "app");
     const pageCssUrls = resolveCssUrls({
       tailwind: hasBuiltTailwindCss(outDir),
       userCss: hasUserCss(appDir)
     });
-    const nfPath = resolve12(appDir, "not-found.vsk");
+    const nfPath = resolve13(appDir, "not-found.vsk");
     let notFoundHtml = null;
-    if (existsSync11(nfPath)) {
+    if (existsSync12(nfPath)) {
       try {
-        const runtimePath = resolve12(outDir, "server", "runtime.js");
+        const runtimePath = resolve13(outDir, "server", "runtime.js");
         const { renderFullPage: renderFullPage2, storeDataScriptGlobal } = await import(runtimePath);
         const src2 = readFileSync12(nfPath, "utf-8");
         const compName = resolveComponentName(src2) || "NotFound";
@@ -38503,11 +38690,11 @@ async function startProdServer(outDir, options) {
                 return;
               }
               console.error("vesk ssr error:", err.message);
-              const errPath = resolve12(appDir, "error.vsk");
+              const errPath = resolve13(appDir, "error.vsk");
               let errorHtml = null;
-              if (existsSync11(errPath)) {
+              if (existsSync12(errPath)) {
                 try {
-                  const runtimePath = resolve12(outDir, "server", "runtime.js");
+                  const runtimePath = resolve13(outDir, "server", "runtime.js");
                   const { renderFullPage: renderFullPage2, storeDataScriptGlobal } = await import(runtimePath);
                   const src2 = readFileSync12(errPath, "utf-8");
                   const compName = resolveComponentName(src2) || "Error";
@@ -38527,6 +38714,30 @@ async function startProdServer(outDir, options) {
     res.writeHead(404, { "Content-Type": "text/html" });
     res.end(notFoundHtml || "<!DOCTYPE html><html><body><h1>404</h1><p>Not Found</p></body></html>");
   });
+  try {
+    await eventsMod?.executeStart?.({ server, port, host });
+  } catch (e) {
+    console.error("vesk start: onStart error:", e instanceof Error ? e.message : e);
+  }
+  server.on("close", () => {
+    void (async () => {
+      try {
+        await eventsMod?.executeStop?.({ server, port, host });
+      } catch (e) {
+        console.error("vesk stop: onStop error:", e instanceof Error ? e.message : e);
+      }
+    })();
+  });
+  let shuttingDown = false;
+  function shutdown(signal) {
+    if (shuttingDown) return;
+    shuttingDown = true;
+    console.error(`vesk stop: received ${signal}, closing\u2026`);
+    server.close(() => process.exit(0));
+    setTimeout(() => process.exit(0), 3e3).unref();
+  }
+  process.on("SIGINT", () => shutdown("SIGINT"));
+  process.on("SIGTERM", () => shutdown("SIGTERM"));
   server.listen(port, host, () => {
     console.error(`vesk production server at http://localhost:${port} (listening on ${host})`);
   });
@@ -38626,10 +38837,10 @@ function validateConfig2(config) {
         "[vesk] A plugin is missing a `name` property. Use a Vesk-native plugin factory (e.g. tailwindcss({...}) from @vesk/plugin-tailwind) that returns a plugin object with the correct shape."
       );
     }
-    const hasKnownHook = typeof plugin.onCSS === "function" || typeof plugin.onFileWatch === "function" || typeof plugin.onTransformJS === "function" || typeof plugin.onBuildStart === "function" || typeof plugin.onBuildEnd === "function" || typeof plugin.onRequest === "function" || typeof plugin.onHead === "function" || typeof plugin.onHtml === "function" || plugin.provides && typeof plugin.provides === "object" && Object.keys(plugin.provides).length > 0;
+    const hasKnownHook = typeof plugin.onCSS === "function" || typeof plugin.onFileWatch === "function" || typeof plugin.onTransformJS === "function" || typeof plugin.onBuildStart === "function" || typeof plugin.onBuildEnd === "function" || typeof plugin.onRequest === "function" || typeof plugin.onStart === "function" || typeof plugin.onStop === "function" || typeof plugin.onHead === "function" || typeof plugin.onHtml === "function" || plugin.provides && typeof plugin.provides === "object" && Object.keys(plugin.provides).length > 0;
     if (!hasKnownHook) {
       throw new Error(
-        `[vesk] Plugin "${plugin.name}" implements none of the recognized hooks (onCSS, onFileWatch, onTransformJS, onBuildStart, onBuildEnd, onRequest, onHead, onHtml) or provides \u2014 it will never be called. Check the plugin package version, or see /docu/cli/plugin-api.md for the current hook contract.`
+        `[vesk] Plugin "${plugin.name}" implements none of the recognized hooks (onCSS, onFileWatch, onTransformJS, onBuildStart, onBuildEnd, onRequest, onStart, onStop, onHead, onHtml) or provides \u2014 it will never be called. Check the plugin package version, or see /docu/cli/plugin-api.md for the current hook contract.`
       );
     }
   }
@@ -38645,13 +38856,13 @@ init_paths();
 // ../adapter/dist/index.js
 var __dirname6 = dirname13(fileURLToPath5(import.meta.url));
 async function resolveCompilerApi(name) {
-  const monorepoSrc = resolve20(__dirname6, "..", "..", "compiler", "src");
-  if (existsSync18(monorepoSrc)) {
-    const tsFile = resolve20(monorepoSrc, name.replace(/\.js$/, ".ts"));
-    if (existsSync18(tsFile)) {
+  const monorepoSrc = resolve21(__dirname6, "..", "..", "compiler", "src");
+  if (existsSync19(monorepoSrc)) {
+    const tsFile = resolve21(monorepoSrc, name.replace(/\.js$/, ".ts"));
+    if (existsSync19(tsFile)) {
       return import(tsFile);
     }
-    return import(resolve20(monorepoSrc, name));
+    return import(resolve21(monorepoSrc, name));
   }
   return import(`@vesk/compiler/src/${name.replace(/\.js$/, "")}`);
 }
@@ -38689,9 +38900,9 @@ async function collectPluginHeadExtra(pluginsPipelines) {
   return parts.join("\n");
 }
 async function build2(appDir, options2) {
-  appDir = resolve20(appDir);
-  const outDir2 = resolve20(options2?.outDir || resolve20(appDir, "..", ".vesk"));
-  const publicDir = options2?.publicDir || resolve20(appDir, "..", "public");
+  appDir = resolve21(appDir);
+  const outDir2 = resolve21(options2?.outDir || resolve21(appDir, "..", ".vesk"));
+  const publicDir = options2?.publicDir || resolve21(appDir, "..", "public");
   const plugins = options2?.plugins || [];
   if (options2?.md) {
     const { configureMd: configureMd3 } = await Promise.resolve().then(() => (init_md(), md_exports));
@@ -38731,24 +38942,24 @@ async function build2(appDir, options2) {
     console.error("vesk build: baked plugin head \u2192 config.json + SSR functions");
   console.error(`vesk build: output \u2192 ${outDir2}`);
   const dirs = [
-    resolve20(outDir2, "server", "functions"),
-    resolve20(outDir2, "server", "api"),
-    resolve20(outDir2, "static", "public"),
-    resolve20(outDir2, "prerendered")
+    resolve21(outDir2, "server", "functions"),
+    resolve21(outDir2, "server", "api"),
+    resolve21(outDir2, "static", "public"),
+    resolve21(outDir2, "prerendered")
   ];
   for (const d of dirs)
-    mkdirSync7(d, { recursive: true });
+    mkdirSync8(d, { recursive: true });
   const cssSourcePath = resolveUserCssPath(appDir);
   if (cssSourcePath !== null) {
     const cssContent = readFileSync18(cssSourcePath, "utf-8");
     const userCss = stripTailwindDirectives(cssContent);
-    const userCssTarget = resolve20(outDir2, "static", "global.css");
-    writeFileSync9(userCssTarget, userCss, "utf-8");
+    const userCssTarget = resolve21(outDir2, "static", "global.css");
+    writeFileSync10(userCssTarget, userCss, "utf-8");
     console.error(`vesk build: css  \u2192 static/global.css  (${userCss.length} bytes)`);
-    const twCssTarget = resolve20(outDir2, "static", "_tailwind.css");
+    const twCssTarget = resolve21(outDir2, "static", "_tailwind.css");
     const tailwindActive = isTailwindPlugin(pluginsPipelines);
     if (!tailwindActive) {
-      writeFileSync9(twCssTarget, "", "utf-8");
+      writeFileSync10(twCssTarget, "", "utf-8");
       console.error("vesk build: css  \u2192 static/_tailwind.css  (empty, tailwind plugin inactive)");
     } else {
       let twCss = cssContent;
@@ -38765,14 +38976,14 @@ async function build2(appDir, options2) {
         const lines = twCss.split("\n").filter((l) => !/^\s*@import\s+['"]tailwindcss['"]/.test(l));
         twCss = lines.join("\n").trim();
         if (twCss.length === 0) {
-          writeFileSync9(twCssTarget, "", "utf-8");
+          writeFileSync10(twCssTarget, "", "utf-8");
           console.error("vesk build: css  \u2192 static/_tailwind.css  (empty, tailwind unresolved)");
         } else {
-          writeFileSync9(twCssTarget, twCss, "utf-8");
+          writeFileSync10(twCssTarget, twCss, "utf-8");
           console.error(`vesk build: css  \u2192 static/_tailwind.css  (${twCss.length} bytes, tailwind partially unresolved)`);
         }
       } else {
-        writeFileSync9(twCssTarget, twCss, "utf-8");
+        writeFileSync10(twCssTarget, twCss, "utf-8");
         console.error(`vesk build: css  \u2192 static/_tailwind.css  (${twCss.length} bytes)`);
       }
     }
@@ -38785,14 +38996,14 @@ async function build2(appDir, options2) {
     console.error("vesk build: no routes found in", appDir);
     return;
   }
-  const projectRoot = resolve20(appDir, "..");
-  const componentsDir = resolve20(projectRoot, "components");
+  const projectRoot = resolve21(appDir, "..");
+  const componentsDir = resolve21(projectRoot, "components");
   const componentMap = scanComponents(componentsDir);
   if (componentMap.size > 0) {
     console.error(`vesk build: ${componentMap.size} external components found in ${componentsDir}`);
   }
-  const apiDir = resolve20(appDir, "api");
-  const apiTree = existsSync18(apiDir) ? scanApiRoutes2(apiDir) : [];
+  const apiDir = resolve21(appDir, "api");
+  const apiTree = existsSync19(apiDir) ? scanApiRoutes2(apiDir) : [];
   console.error(`vesk build: ${routeTree.length} root routes, ${apiTree.length} API routes`);
   console.error("vesk build: bundling server runtime...");
   await bundleRuntime(appDir, outDir2);
@@ -38809,17 +39020,17 @@ async function build2(appDir, options2) {
           mwCode = compileMiddlewareCode(mwSources);
         }
         const { funcPath, funcCode, name } = generateSsrFunction(node, appDir, outDir2, componentMap, { ancestorLayouts, middlewareCode: mwCode, headExtra: pluginHeadExtra });
-        writeFileSync9(funcPath, funcCode, "utf-8");
-        const pagePath = resolve20(appDir, node.sourceDir, "page.vsk");
-        if (existsSync18(pagePath)) {
+        writeFileSync10(funcPath, funcCode, "utf-8");
+        const pagePath = resolve21(appDir, node.sourceDir, "page.vsk");
+        if (existsSync19(pagePath)) {
           const src2 = readFileSync18(pagePath, "utf-8");
           const actionIds = collectActionIds(src2);
           if (node.layout) {
-            const layoutSrc = readFileSync18(resolve20(appDir, node.sourceDir, "layout.vsk"), "utf-8");
+            const layoutSrc = readFileSync18(resolve21(appDir, node.sourceDir, "layout.vsk"), "utf-8");
             actionIds.push(...collectActionIds(layoutSrc));
           }
           for (const a of ancestorLayouts) {
-            const ancestorSrc = readFileSync18(resolve20(appDir, a.sourceDir, "layout.vsk"), "utf-8");
+            const ancestorSrc = readFileSync18(resolve21(appDir, a.sourceDir, "layout.vsk"), "utf-8");
             actionIds.push(...collectActionIds(ancestorSrc));
           }
           for (const id of actionIds) {
@@ -38846,7 +39057,7 @@ async function build2(appDir, options2) {
     for (const node of nodes) {
       if (node.filePath) {
         const { funcPath, funcCode, name } = generateApiFunction(node, apiDir, outDir2);
-        writeFileSync9(funcPath, funcCode, "utf-8");
+        writeFileSync10(funcPath, funcCode, "utf-8");
         apiRoutes.push(node);
         console.error(`vesk build: api  \u2192 server/api/${name}.js  (${node.fullPath})`);
       }
@@ -38859,11 +39070,14 @@ async function build2(appDir, options2) {
   if (mwChain.length > 0) {
     const mwCode = compileMiddleware(mwChain, appDir);
     if (mwCode) {
-      writeFileSync9(resolve20(outDir2, "server", "middleware.js"), mwCode, "utf-8");
+      writeFileSync10(resolve21(outDir2, "server", "middleware.js"), mwCode, "utf-8");
       middlewareEnabled = true;
       console.error(`vesk build: mw   \u2192 server/middleware.js  (${mwChain.length} middlewares)`);
     }
   }
+  const hasEvents = await compileEvents(appDir, outDir2);
+  if (hasEvents)
+    console.error("vesk build: evt  \u2192 server/events.js (onStart/onRequest/onStop)");
   console.error("vesk build: bundling client runtime...");
   const bundleOpts = {};
   if (options2?.codeSplit)
@@ -38875,13 +39089,13 @@ async function build2(appDir, options2) {
   if (pluginsPipelines.length > 0)
     bundleOpts.plugins = pluginsPipelines;
   const { main, chunks } = await generateClientBundle(routeTree, appDir, componentMap, bundleOpts);
-  writeFileSync9(resolve20(outDir2, "static", "client.js"), main, "utf-8");
+  writeFileSync10(resolve21(outDir2, "static", "client.js"), main, "utf-8");
   const mode = chunks.length > 0 ? "code-split" : "monolithic";
   console.error(`vesk build: client \u2192 static/client.js  (${main.length} bytes, ${mode})`);
   if (chunks.length > 0) {
-    const staticDir2 = resolve20(outDir2, "static");
+    const staticDir2 = resolve21(outDir2, "static");
     for (const chunk of chunks) {
-      writeFileSync9(resolve20(staticDir2, chunk.name), chunk.code, "utf-8");
+      writeFileSync10(resolve21(staticDir2, chunk.name), chunk.code, "utf-8");
       console.error(`vesk build: chunk \u2192 static/${chunk.name}  (${chunk.code.length} bytes)`);
     }
   }
@@ -38914,23 +39128,23 @@ async function build2(appDir, options2) {
   }
   {
     const { generateSitemap: generateSitemap2, generateRobotsTxt: generateRobotsTxt2 } = await Promise.resolve().then(() => (init_static(), static_exports));
-    const publicDirResolved = resolve20(outDir2, "static", "public");
+    const publicDirResolved = resolve21(outDir2, "static", "public");
     const siteUrl = options2?.siteUrl || "http://localhost:3000";
-    const sitemapOverride = resolve20(publicDirResolved, "sitemap.xml");
-    if (!existsSync18(sitemapOverride)) {
+    const sitemapOverride = resolve21(publicDirResolved, "sitemap.xml");
+    if (!existsSync19(sitemapOverride)) {
       const sitemap = generateSitemap2(routeTree, ssrRoutes, prerenderedRoutes, { siteUrl });
-      writeFileSync9(sitemapOverride, sitemap, "utf-8");
+      writeFileSync10(sitemapOverride, sitemap, "utf-8");
       console.error(`vesk build: seo   \u2192 static/public/sitemap.xml (${sitemap.length} bytes)`);
     }
-    const robotsOverride = resolve20(publicDirResolved, "robots.txt");
-    if (!existsSync18(robotsOverride)) {
+    const robotsOverride = resolve21(publicDirResolved, "robots.txt");
+    if (!existsSync19(robotsOverride)) {
       const robots = generateRobotsTxt2(siteUrl);
-      writeFileSync9(robotsOverride, robots, "utf-8");
+      writeFileSync10(robotsOverride, robots, "utf-8");
       console.error(`vesk build: seo   \u2192 static/public/robots.txt (${robots.length} bytes)`);
     }
   }
-  const manifest = generateManifest(routeTree, ssrRoutes, apiRoutes, prerenderedRoutes, middlewareEnabled, actionMap, pluginHeadExtra);
-  writeFileSync9(resolve20(outDir2, "config.json"), JSON.stringify(manifest, null, 2) + "\n", "utf-8");
+  const manifest = generateManifest(routeTree, ssrRoutes, apiRoutes, prerenderedRoutes, middlewareEnabled, actionMap, pluginHeadExtra, hasEvents);
+  writeFileSync10(resolve21(outDir2, "config.json"), JSON.stringify(manifest, null, 2) + "\n", "utf-8");
   console.error("vesk build: config \u2192 config.json");
   {
     const { detectPlatform: detectPlatform2 } = await Promise.resolve().then(() => (init_platform(), platform_exports));
@@ -38945,7 +39159,8 @@ async function build2(appDir, options2) {
         apiRoutes,
         prerenderedPaths: prerenderedRoutes.map((r) => r.path),
         prerenderedRoutes,
-        hasMiddleware: middlewareEnabled
+        hasMiddleware: middlewareEnabled,
+        hasEvents
       });
       if (outRoot) {
         console.error(`vesk build: ${platform} \u2192 ${relative4(projectRoot, outRoot)}`);
@@ -38969,8 +39184,8 @@ vesk build: done (${outDir2})`);
 init_seo_audit();
 
 // src/dev-server.ts
-import { readFileSync as readFileSync33, watch, statSync as statSync21, existsSync as existsSync35, readdirSync as readdirSync13 } from "node:fs";
-import { resolve as resolve35, extname as extname8, join as join19 } from "node:path";
+import { readFileSync as readFileSync33, watch, statSync as statSync21, existsSync as existsSync37, readdirSync as readdirSync13 } from "node:fs";
+import { resolve as resolve36, extname as extname8, join as join21 } from "node:path";
 import { createServer as createServer2 } from "node:http";
 import { WebSocketServer as WebSocketServer2 } from "ws";
 
@@ -40690,8 +40905,8 @@ init_parser();
 init_tokens();
 init_scan();
 init_strip_ts();
-import { readdirSync as readdirSync7, statSync as statSync12, existsSync as existsSync19, readFileSync as readFileSync19 } from "fs";
-import { join as join10, relative as relative5, basename as basename3 } from "path";
+import { readdirSync as readdirSync7, statSync as statSync12, existsSync as existsSync20, readFileSync as readFileSync19 } from "fs";
+import { join as join11, relative as relative5, basename as basename3 } from "path";
 function collapseSlashes2(p) {
   let out = "";
   let prevSlash = false;
@@ -40708,7 +40923,7 @@ function collapseSlashes2(p) {
   return out;
 }
 function scanRoutes(appDir, options2 = {}) {
-  if (!existsSync19(appDir)) {
+  if (!existsSync20(appDir)) {
     return [];
   }
   return scanDirectory(appDir, appDir, "/", options2);
@@ -40811,7 +41026,7 @@ function scanDirectory(rootDir, dir, parentPath, options2) {
     segmentCount: isGroup || dir === rootDir ? 0 : 1
   };
   for (const entry of entries) {
-    const entryPath = join10(dir, entry);
+    const entryPath = join11(dir, entry);
     let entryStat;
     try {
       entryStat = statSync12(entryPath);
@@ -40863,19 +41078,19 @@ function collectSources(tree) {
   function walk6(nodes) {
     for (const node of nodes) {
       if (node.page)
-        map.set(node.page, join10(node.sourceDir, "page.vsk"));
+        map.set(node.page, join11(node.sourceDir, "page.vsk"));
       if (node.layout)
-        map.set(node.layout, join10(node.sourceDir, "layout.vsk"));
+        map.set(node.layout, join11(node.sourceDir, "layout.vsk"));
       if (node.loading)
-        map.set(node.loading, join10(node.sourceDir, "loading.vsk"));
+        map.set(node.loading, join11(node.sourceDir, "loading.vsk"));
       if (node.error)
-        map.set(node.error, join10(node.sourceDir, "error.vsk"));
+        map.set(node.error, join11(node.sourceDir, "error.vsk"));
       if (node.notFound)
-        map.set(node.notFound, join10(node.sourceDir, "not-found.vsk"));
+        map.set(node.notFound, join11(node.sourceDir, "not-found.vsk"));
       if (node.offline)
-        map.set(node.offline, join10(node.sourceDir, "offline.vsk"));
+        map.set(node.offline, join11(node.sourceDir, "offline.vsk"));
       if (node.network)
-        map.set(node.network, join10(node.sourceDir, "network.vsk"));
+        map.set(node.network, join11(node.sourceDir, "network.vsk"));
       walk6(node.children);
     }
   }
@@ -40961,15 +41176,15 @@ function matchUrl(tree, pathname) {
 }
 
 // ../compiler/dist/api-routes.js
-import { readdirSync as readdirSync8, statSync as statSync13, existsSync as existsSync20 } from "fs";
-import { join as join11 } from "path";
+import { readdirSync as readdirSync8, statSync as statSync13, existsSync as existsSync21 } from "fs";
+import { join as join12 } from "path";
 init_server_utils();
 function basename4(p) {
   const idx = p.lastIndexOf("/");
   return idx === -1 ? p : p.slice(idx + 1);
 }
 function scanApiRoutes(apiDir) {
-  if (!existsSync20(apiDir))
+  if (!existsSync21(apiDir))
     return [];
   return scanApiDir(apiDir, apiDir, "/");
 }
@@ -40999,7 +41214,7 @@ function scanApiDir(rootDir, dir, parentPath) {
     return nodes;
   if (isRouteGroup) {
     for (const entry of entries) {
-      const entryPath = join11(dir, entry);
+      const entryPath = join12(dir, entry);
       let entryStat;
       try {
         entryStat = statSync13(entryPath);
@@ -41029,11 +41244,11 @@ function scanApiDir(rootDir, dir, parentPath) {
     fullPath: collapseSlashes(fullPath) || "/",
     isDynamic,
     isCatchAll,
-    filePath: hasRoute && routeFileName ? join11(dir, routeFileName) : null,
+    filePath: hasRoute && routeFileName ? join12(dir, routeFileName) : null,
     children: []
   };
   for (const entry of entries) {
-    const entryPath = join11(dir, entry);
+    const entryPath = join12(dir, entry);
     let entryStat;
     try {
       entryStat = statSync13(entryPath);
@@ -41334,8 +41549,8 @@ async function executeRewrite(url, originalRequest) {
 }
 
 // ../compiler/dist/middleware.js
-import { existsSync as existsSync21 } from "fs";
-import { resolve as resolve21 } from "path";
+import { existsSync as existsSync22 } from "fs";
+import { resolve as resolve22 } from "path";
 
 // ../compiler/src/api-routes.ts
 init_server_utils();
@@ -41394,8 +41609,8 @@ function collectMiddlewareChain(routeTree, url, appDir) {
   }
   function collectForNode(node) {
     if (node.hasMiddleware) {
-      const mwPath2 = resolve21(appDir, node.sourceDir, "middleware.ts");
-      if (existsSync21(mwPath2)) {
+      const mwPath2 = resolve22(appDir, node.sourceDir, "middleware.ts");
+      if (existsSync22(mwPath2)) {
         chain.push({ sourcePath: mwPath2, node });
       }
     }
@@ -41438,7 +41653,8 @@ async function loadMiddleware(sourcePath) {
 async function executeMiddlewareChain(chain, request, params, options2 = {}) {
   const { onLast, plugins } = options2;
   const url = new URL(request.url, "http://localhost");
-  const locals2 = {};
+  const serverStore = globalThis.__vesk_server_ctx;
+  const locals2 = Object.assign({}, serverStore || {});
   const cookies2 = parseCookies2(request.headers?.get("cookie") || "");
   const ctx2 = new Proxy({
     request,
@@ -41557,9 +41773,45 @@ async function executeMiddlewareChain(chain, request, params, options2 = {}) {
   return { response, redirected: !!response && response.status >= 300 && response.status < 400, locals: locals2, rewriteUrl };
 }
 
+// ../compiler/dist/events.js
+import { existsSync as existsSync23 } from "fs";
+import { join as join13 } from "path";
+var EVENTS_FILE_NAMES2 = ["_events.ts", "_events.js"];
+function collectEventsFile2(appDir) {
+  for (const name of EVENTS_FILE_NAMES2) {
+    const candidate = join13(appDir, name);
+    if (existsSync23(candidate))
+      return candidate;
+  }
+  return null;
+}
+async function loadEvents(sourcePath2) {
+  try {
+    const url = new URL("file://" + sourcePath2);
+    url.searchParams.set("t", String(Date.now()) + Math.random().toString(36).slice(2));
+    const mod = await import(url.href);
+    const handlers = {};
+    if (typeof mod.onStart === "function")
+      handlers.onStart = mod.onStart;
+    if (typeof mod.onRequest === "function")
+      handlers.onRequest = mod.onRequest;
+    if (typeof mod.onStop === "function")
+      handlers.onStop = mod.onStop;
+    return handlers;
+  } catch {
+    return {};
+  }
+}
+async function runEventHandlers(handlers, name, ctx2) {
+  const fn = handlers[name];
+  if (typeof fn !== "function")
+    return;
+  await fn(ctx2);
+}
+
 // ../adapter/dist/client-bundle.js
-import { readFileSync as readFileSync20, existsSync as existsSync22, writeFileSync as writeFileSync10, unlinkSync as unlinkSync3, statSync as statSync14, rmSync as rmSync4 } from "node:fs";
-import { resolve as resolve22, join as join12, dirname as dirname14, relative as relative6, sep as sep3 } from "node:path";
+import { readFileSync as readFileSync20, existsSync as existsSync24, writeFileSync as writeFileSync11, unlinkSync as unlinkSync4, statSync as statSync14, rmSync as rmSync4 } from "node:fs";
+import { resolve as resolve23, join as join14, dirname as dirname14, relative as relative6, sep as sep3 } from "node:path";
 import { fileURLToPath as fileURLToPath6 } from "node:url";
 
 // ../adapter/dist/esbuild-fallback.js
@@ -41632,15 +41884,15 @@ function buildRouterOpts2(options2) {
   return "";
 }
 function findRuntimeSrc3(appDir) {
-  const monorepoRoot = resolve22(__dirname7, "..", "..", "..");
+  const monorepoRoot = resolve23(__dirname7, "..", "..", "..");
   const candidates = [
-    resolve22(monorepoRoot, "packages", "runtime", "dist"),
-    resolve22(appDir, "..", "node_modules", "@vesk/runtime"),
-    resolve22(appDir, "node_modules", "@vesk/runtime")
+    resolve23(monorepoRoot, "packages", "runtime", "dist"),
+    resolve23(appDir, "..", "node_modules", "@vesk/runtime"),
+    resolve23(appDir, "node_modules", "@vesk/runtime")
   ];
   for (const base of candidates) {
-    for (const dir of [base, join12(base, "dist")]) {
-      if (existsSync22(join12(dir, "index-client.js")))
+    for (const dir of [base, join14(base, "dist")]) {
+      if (existsSync24(join14(dir, "index-client.js")))
         return dir;
     }
   }
@@ -41957,32 +42209,32 @@ async function generateClientBundle2(routeTree, appDir, componentMap, options2)
     let walkSplit2 = function(nodes, _chain) {
       for (const node of nodes) {
         const chunkCode = [];
-        const pagePath = resolve22(appDir, node.sourceDir, "page.vsk");
-        if (node.page && existsSync22(pagePath)) {
+        const pagePath = resolve23(appDir, node.sourceDir, "page.vsk");
+        if (node.page && existsSync24(pagePath)) {
           compileFile2(pagePath, node.page, chunkCode);
         }
-        const layoutPath = resolve22(appDir, node.sourceDir, "layout.vsk");
-        if (node.layout && existsSync22(layoutPath)) {
+        const layoutPath = resolve23(appDir, node.sourceDir, "layout.vsk");
+        if (node.layout && existsSync24(layoutPath)) {
           compileFile2(layoutPath, node.layout, chunkCode);
         }
-        const errorPath = resolve22(appDir, node.sourceDir, "error.vsk");
-        if (node.error && existsSync22(errorPath)) {
+        const errorPath = resolve23(appDir, node.sourceDir, "error.vsk");
+        if (node.error && existsSync24(errorPath)) {
           compileFile2(errorPath, node.error, chunkCode);
         }
-        const notFoundPath = resolve22(appDir, node.sourceDir, "not-found.vsk");
-        if (node.notFound && existsSync22(notFoundPath)) {
+        const notFoundPath = resolve23(appDir, node.sourceDir, "not-found.vsk");
+        if (node.notFound && existsSync24(notFoundPath)) {
           compileFile2(notFoundPath, node.notFound, chunkCode);
         }
-        const offlinePath = resolve22(appDir, node.sourceDir, "offline.vsk");
-        if (node.offline && existsSync22(offlinePath)) {
+        const offlinePath = resolve23(appDir, node.sourceDir, "offline.vsk");
+        if (node.offline && existsSync24(offlinePath)) {
           compileFile2(offlinePath, node.offline, chunkCode);
         }
-        const networkPath = resolve22(appDir, node.sourceDir, "network.vsk");
-        if (node.network && existsSync22(networkPath)) {
+        const networkPath = resolve23(appDir, node.sourceDir, "network.vsk");
+        if (node.network && existsSync24(networkPath)) {
           compileFile2(networkPath, node.network, chunkCode);
         }
-        const loadingPath = resolve22(appDir, node.sourceDir, "loading.vsk");
-        if (node.loading && existsSync22(loadingPath)) {
+        const loadingPath = resolve23(appDir, node.sourceDir, "loading.vsk");
+        if (node.loading && existsSync24(loadingPath)) {
           compileFile2(loadingPath, node.loading, chunkCode);
         }
         if (chunkCode.length > 0) {
@@ -42065,26 +42317,26 @@ ${entry.code}
       }
     }, walkMono2 = function(nodes) {
       for (const node of nodes) {
-        const pagePath = resolve22(appDir, node.sourceDir, "page.vsk");
-        if (node.page && existsSync22(pagePath))
+        const pagePath = resolve23(appDir, node.sourceDir, "page.vsk");
+        if (node.page && existsSync24(pagePath))
           compileFileMono2(pagePath, node.page);
-        const layoutPath = resolve22(appDir, node.sourceDir, "layout.vsk");
-        if (node.layout && existsSync22(layoutPath))
+        const layoutPath = resolve23(appDir, node.sourceDir, "layout.vsk");
+        if (node.layout && existsSync24(layoutPath))
           compileFileMono2(layoutPath, node.layout);
-        const errorPath = resolve22(appDir, node.sourceDir, "error.vsk");
-        if (node.error && existsSync22(errorPath))
+        const errorPath = resolve23(appDir, node.sourceDir, "error.vsk");
+        if (node.error && existsSync24(errorPath))
           compileFileMono2(errorPath, node.error);
-        const notFoundPath = resolve22(appDir, node.sourceDir, "not-found.vsk");
-        if (node.notFound && existsSync22(notFoundPath))
+        const notFoundPath = resolve23(appDir, node.sourceDir, "not-found.vsk");
+        if (node.notFound && existsSync24(notFoundPath))
           compileFileMono2(notFoundPath, node.notFound);
-        const offlinePath = resolve22(appDir, node.sourceDir, "offline.vsk");
-        if (node.offline && existsSync22(offlinePath))
+        const offlinePath = resolve23(appDir, node.sourceDir, "offline.vsk");
+        if (node.offline && existsSync24(offlinePath))
           compileFileMono2(offlinePath, node.offline);
-        const networkPath = resolve22(appDir, node.sourceDir, "network.vsk");
-        if (node.network && existsSync22(networkPath))
+        const networkPath = resolve23(appDir, node.sourceDir, "network.vsk");
+        if (node.network && existsSync24(networkPath))
           compileFileMono2(networkPath, node.network);
-        const loadingPath = resolve22(appDir, node.sourceDir, "loading.vsk");
-        if (node.loading && existsSync22(loadingPath))
+        const loadingPath = resolve23(appDir, node.sourceDir, "loading.vsk");
+        if (node.loading && existsSync24(loadingPath))
           compileFileMono2(loadingPath, node.loading);
         walkMono2(node.children || []);
       }
@@ -42134,8 +42386,8 @@ function buildRuntimeCode2(runtimeDir) {
   ];
   let code = "";
   for (const f of runtimeFiles) {
-    const p = join12(runtimeDir, f);
-    if (existsSync22(p)) {
+    const p = join14(runtimeDir, f);
+    if (existsSync24(p)) {
       let src2 = readFileSync20(p, "utf-8");
       src2 = stripTypes2(src2);
       src2 = src2.replace(/^import\s+[\s\S]*?from\s+['"](?:\.\/.*?|@vesk\/runtime\/src\/.*?)['"];?\n?/gm, "");
@@ -42148,7 +42400,7 @@ ${src2}
 `;
     }
   }
-  const indexSrc = readFileSync20(join12(runtimeDir, "index-client.js"), "utf-8");
+  const indexSrc = readFileSync20(join14(runtimeDir, "index-client.js"), "utf-8");
   const exportNames = stripTypes2(indexSrc).match(/export\s*\{\s*([^}]+)\s*\}\s*from/g)?.flatMap((m) => m.replace(/export\s*\{\s*|\s*\}\s*from/g, "").split(",").map((s) => s.trim())) || [];
   code += "// --- exports ---\n";
   for (const name of [...new Set(exportNames)]) {
@@ -42159,7 +42411,7 @@ ${src2}
   return code;
 }
 function runtimeExportNames2(runtimeDir) {
-  const indexSrc = readFileSync20(join12(runtimeDir, "index-client.js"), "utf-8");
+  const indexSrc = readFileSync20(join14(runtimeDir, "index-client.js"), "utf-8");
   const names = /* @__PURE__ */ new Set();
   for (const m of indexSrc.matchAll(/export\s*\{([^}]+)\}\s*from/g)) {
     for (const raw2 of m[1].split(",")) {
@@ -42179,13 +42431,13 @@ async function buildTreeShakenRuntime2(runtimeDir, usedNames) {
     console.error(`vesk: runtime names not exported \u2014 ${missing.join(", ")}; falling back to full runtime`);
     return buildRuntimeCode2(runtimeDir);
   }
-  const entry = join12(runtimeDir, RUNTIME_ENTRY2);
+  const entry = join14(runtimeDir, RUNTIME_ENTRY2);
   try {
     try {
       rmSync4(entry);
     } catch {
     }
-    writeFileSync10(entry, `export { ${unique.join(", ")} } from './index-client.js';
+    writeFileSync11(entry, `export { ${unique.join(", ")} } from './index-client.js';
 `);
     const result2 = await build3({
       entryPoints: [entry],
@@ -42216,7 +42468,7 @@ export { ${unique.join(", ")} };
     return buildRuntimeCode2(runtimeDir);
   } finally {
     try {
-      unlinkSync3(entry);
+      unlinkSync4(entry);
     } catch {
     }
   }
@@ -42316,18 +42568,18 @@ if (typeof document !== 'undefined') __router.start();
 }
 
 // ../adapter/dist/paths.js
-import { resolve as resolve23, sep as sep4 } from "node:path";
-import { existsSync as existsSync23, statSync as statSync15, readFileSync as readFileSync21 } from "node:fs";
+import { resolve as resolve24, sep as sep4 } from "node:path";
+import { existsSync as existsSync25, statSync as statSync15, readFileSync as readFileSync21 } from "node:fs";
 function resolveWithin2(baseDir, relPath) {
-  const base = resolve23(baseDir);
-  const target = resolve23(baseDir, relPath);
+  const base = resolve24(baseDir);
+  const target = resolve24(baseDir, relPath);
   const prefix = base + sep4;
   if (!target.startsWith(prefix))
     return null;
   return target;
 }
 function installMdReadHook2(publicDirs) {
-  const dirs = publicDirs.map((d) => resolve23(d));
+  const dirs = publicDirs.map((d) => resolve24(d));
   globalThis.__vsk_md_read_file = (p) => {
     for (const dir of dirs) {
       try {
@@ -42340,7 +42592,7 @@ function installMdReadHook2(publicDirs) {
         const lower = abs.toLowerCase();
         if (!lower.endsWith(".md") && !lower.endsWith(".markdown"))
           continue;
-        if (existsSync23(abs) && statSync15(abs).isFile())
+        if (existsSync25(abs) && statSync15(abs).isFile())
           return readFileSync21(abs, "utf8");
       } catch {
       }
@@ -42408,13 +42660,13 @@ function urlAuthority3(url) {
 }
 
 // ../adapter/dist/dev-api.js
-import { readFileSync as readFileSync24, statSync as statSync17, existsSync as existsSync26, readdirSync as readdirSync9 } from "node:fs";
-import { resolve as resolve26 } from "node:path";
+import { readFileSync as readFileSync24, statSync as statSync17, existsSync as existsSync28, readdirSync as readdirSync9 } from "node:fs";
+import { resolve as resolve27 } from "node:path";
 
 // ../adapter/dist/plugins.js
 init_paths();
-import { readFileSync as readFileSync22, writeFileSync as writeFileSync11, existsSync as existsSync24, mkdirSync as mkdirSync8, statSync as statSync16 } from "node:fs";
-import { resolve as resolve24, dirname as dirname15, join as join13, extname as extname7, basename as basename5 } from "node:path";
+import { readFileSync as readFileSync22, writeFileSync as writeFileSync12, existsSync as existsSync26, mkdirSync as mkdirSync9, statSync as statSync16 } from "node:fs";
+import { resolve as resolve25, dirname as dirname15, join as join15, extname as extname7, basename as basename5 } from "node:path";
 import { createRequire as createRequire4 } from "node:module";
 import { spawn as spawn2 } from "node:child_process";
 var PLUGIN_STATE_FILENAME2 = "plugins.json";
@@ -42429,11 +42681,11 @@ function eqIgnoreCase2(a, b) {
   return String(a || "").toLowerCase() === String(b || "").toLowerCase();
 }
 function stateFilePath2(veskDir) {
-  return resolve24(veskDir, PLUGIN_STATE_FILENAME2);
+  return resolve25(veskDir, PLUGIN_STATE_FILENAME2);
 }
 function readPluginState2(veskDir) {
   const file = stateFilePath2(veskDir);
-  if (!existsSync24(file))
+  if (!existsSync26(file))
     return defaultState2();
   let raw2;
   try {
@@ -42456,12 +42708,12 @@ function readPluginState2(veskDir) {
 function writePluginState2(veskDir, state) {
   const file = stateFilePath2(veskDir);
   const dir = dirname15(file);
-  if (!existsSync24(dir))
-    mkdirSync8(dir, { recursive: true });
-  writeFileSync11(file, JSON.stringify(state, null, 2) + "\n", "utf-8");
+  if (!existsSync26(dir))
+    mkdirSync9(dir, { recursive: true });
+  writeFileSync12(file, JSON.stringify(state, null, 2) + "\n", "utf-8");
 }
 function resolvePackage2(appDir, pkg) {
-  const require3 = createRequire4(resolve24(appDir, "package.json"));
+  const require3 = createRequire4(resolve25(appDir, "package.json"));
   let entryPath = null;
   let pkgJsonPath = null;
   let pkgJson = null;
@@ -42474,8 +42726,8 @@ function resolvePackage2(appDir, pkg) {
       const seen = /* @__PURE__ */ new Set();
       while (cur && cur !== dirname15(cur) && !seen.has(cur)) {
         seen.add(cur);
-        const candidate = join13(cur, "package.json");
-        if (existsSync24(candidate)) {
+        const candidate = join15(cur, "package.json");
+        if (existsSync26(candidate)) {
           pkgJsonPath = candidate;
           break;
         }
@@ -42487,15 +42739,15 @@ function resolvePackage2(appDir, pkg) {
     } catch {
     }
   }
-  if (pkgJsonPath && existsSync24(pkgJsonPath)) {
+  if (pkgJsonPath && existsSync26(pkgJsonPath)) {
     pkgJson = readJsonFile2(pkgJsonPath);
     const main = pkgJson?.main || pkgJson?.module || "index.js";
-    entryPath = resolve24(dirname15(pkgJsonPath), main);
+    entryPath = resolve25(dirname15(pkgJsonPath), main);
   }
   let localPath = localDir2(appDir, pkg);
   if (!localPath) {
     for (const sub of ["src/plugins", "plugins", "lib/plugins"]) {
-      const candidate = localDir2(resolve24(appDir, sub), pkg);
+      const candidate = localDir2(resolve25(appDir, sub), pkg);
       if (candidate) {
         localPath = candidate;
         break;
@@ -42503,32 +42755,32 @@ function resolvePackage2(appDir, pkg) {
     }
   }
   if (localPath) {
-    const localJson = join13(localPath, "package.json");
+    const localJson = join15(localPath, "package.json");
     let json = null;
-    if (existsSync24(localJson)) {
+    if (existsSync26(localJson)) {
       json = readJsonFile2(localJson);
     }
     return { installed: true, path: localPath, dir: localPath, packageJson: json ?? pkgJson };
   }
-  const installed2 = !!pkgJsonPath && existsSync24(pkgJsonPath);
+  const installed2 = !!pkgJsonPath && existsSync26(pkgJsonPath);
   return { installed: installed2, path: entryPath, dir: installed2 ? dirname15(pkgJsonPath) : null, packageJson: pkgJson };
 }
 function localDir2(base, pkg) {
   if (pkg.startsWith("@")) {
     const parts = pkg.split("/");
-    const p2 = resolve24(base, parts[0], parts[1] ?? "");
-    if (existsSync24(p2))
+    const p2 = resolve25(base, parts[0], parts[1] ?? "");
+    if (existsSync26(p2))
       return p2;
     return null;
   }
-  const p = resolve24(base, pkg);
-  if (existsSync24(p))
+  const p = resolve25(base, pkg);
+  if (existsSync26(p))
     return p;
   return null;
 }
 function readJsonFile2(file) {
   try {
-    if (existsSync24(file))
+    if (existsSync26(file))
       return JSON.parse(readFileSync22(file, "utf-8"));
   } catch {
   }
@@ -42575,7 +42827,7 @@ function repositoryToString2(r) {
 function assemblePluginMeta2(probe) {
   const pkgJson = probe.packageJson || {};
   const dir = probe.dir;
-  const meta = dir ? readJsonFile2(resolve24(dir, "vesk.meta.json")) : null;
+  const meta = dir ? readJsonFile2(resolve25(dir, "vesk.meta.json")) : null;
   const hasMeta = !!meta && Object.keys(meta).length > 0;
   const m = meta || {};
   const metaSource = hasMeta ? "vesk.meta.json" : probe.packageJson ? "package.json" : "none";
@@ -42812,12 +43064,12 @@ function findIconFile2(dir, meta) {
   const explicit = str2(meta?.icon);
   if (explicit) {
     const p = resolveWithin(dir, explicit);
-    if (p && existsSync24(p) && statSync16(p).isFile())
+    if (p && existsSync26(p) && statSync16(p).isFile())
       return p;
   }
   for (const name of ["icon.png", "icon.ico"]) {
-    const p = resolve24(dir, name);
-    if (existsSync24(p) && statSync16(p).isFile())
+    const p = resolve25(dir, name);
+    if (existsSync26(p) && statSync16(p).isFile())
       return p;
   }
   return null;
@@ -42827,7 +43079,7 @@ function findPluginIcon2(appDir, name) {
   const dir = probe.dir;
   if (!dir)
     return null;
-  const meta = readJsonFile2(resolve24(dir, "vesk.meta.json"));
+  const meta = readJsonFile2(resolve25(dir, "vesk.meta.json"));
   const iconPath = findIconFile2(dir, meta);
   if (!iconPath)
     return null;
@@ -42902,7 +43154,7 @@ function resolveDtsPath2(probe, pkgJson) {
     if (!rel)
       continue;
     const abs = resolveWithin(dir, rel);
-    if (abs && existsSync24(abs) && statSync16(abs).isFile())
+    if (abs && existsSync26(abs) && statSync16(abs).isFile())
       return abs;
   }
   return null;
@@ -43389,16 +43641,16 @@ var __internals2 = {
 };
 
 // ../adapter/dist/dev-config.js
-import { existsSync as existsSync25, readFileSync as readFileSync23, writeFileSync as writeFileSync12, mkdirSync as mkdirSync9, mkdtempSync, rmSync as rmSync5 } from "node:fs";
+import { existsSync as existsSync27, readFileSync as readFileSync23, writeFileSync as writeFileSync13, mkdirSync as mkdirSync10, mkdtempSync, rmSync as rmSync5 } from "node:fs";
 import { tmpdir } from "node:os";
-import { resolve as resolve25, dirname as dirname16, join as join14 } from "node:path";
+import { resolve as resolve26, dirname as dirname16, join as join16 } from "node:path";
 init_parser();
 function findConfigFile2(projectDir2) {
-  const ts9 = resolve25(projectDir2, "vesk.config.ts");
-  if (existsSync25(ts9))
+  const ts9 = resolve26(projectDir2, "vesk.config.ts");
+  if (existsSync27(ts9))
     return { path: ts9, isTs: true };
-  const js = resolve25(projectDir2, "vesk.config.js");
-  if (existsSync25(js))
+  const js = resolve26(projectDir2, "vesk.config.js");
+  if (existsSync27(js))
     return { path: js, isTs: false };
   return { path: null, isTs: false };
 }
@@ -43419,11 +43671,11 @@ async function parseConfigSource(source, isTs, projectDir2) {
     js = `const { defineConfig, definePlugin, preset } = globalThis.__vesk_inject;
 ` + js;
   }
-  const base = projectDir2 ? (mkdirSync9(join14(projectDir2, ".vesk"), { recursive: true }), join14(projectDir2, ".vesk")) : void 0;
-  const dir = base ? mkdtempSync(join14(base, "cfg-")) : mkdtempSync(join14(tmpdir(), "vesk-cfg-"));
-  const tmpFile = join14(dir, "config.mjs");
+  const base = projectDir2 ? (mkdirSync10(join16(projectDir2, ".vesk"), { recursive: true }), join16(projectDir2, ".vesk")) : void 0;
+  const dir = base ? mkdtempSync(join16(base, "cfg-")) : mkdtempSync(join16(tmpdir(), "vesk-cfg-"));
+  const tmpFile = join16(dir, "config.mjs");
   try {
-    writeFileSync12(tmpFile, js, "utf-8");
+    writeFileSync13(tmpFile, js, "utf-8");
     globalThis.__vesk_inject = {
       defineConfig: defineConfig2,
       // Pass-through like the real definePlugin (which validates + returns
@@ -43454,10 +43706,10 @@ async function readConfig2(projectDir2) {
 }
 async function writeConfigSource2(projectDir2, source) {
   const { path, isTs } = findConfigFile2(projectDir2);
-  const target = path || resolve25(projectDir2, "vesk.config.ts");
+  const target = path || resolve26(projectDir2, "vesk.config.ts");
   await parseConfigSource(source, isTs, projectDir2);
-  mkdirSync9(dirname16(target), { recursive: true });
-  writeFileSync12(target, source, "utf-8");
+  mkdirSync10(dirname16(target), { recursive: true });
+  writeFileSync13(target, source, "utf-8");
   const config = await parseConfigSource(source, isTs, projectDir2);
   return { path: target, exists: true, source, config };
 }
@@ -44164,7 +44416,7 @@ export default defineConfig({
 	]
 })
 `;
-    target = resolve25(projectDir2, "vesk.config.ts");
+    target = resolve26(projectDir2, "vesk.config.ts");
     await writeConfigSource2(projectDir2, source);
     return;
   }
@@ -44326,7 +44578,7 @@ function jsonStatus(status, data2) {
 function createDevApiRouter2(opts) {
   const veskDir = opts.veskDir;
   const caps = new CapabilityTable2(opts.caps, opts.commandAllowlist);
-  const projectDir2 = opts.projectDir || resolve26(opts.appDir, "..");
+  const projectDir2 = opts.projectDir || resolve27(opts.appDir, "..");
   const getState = opts.getHmrState || (() => ({ status: "up", lastCompileMs: null, error: null, hasError: false, componentCount: 0 }));
   function denied2(cap) {
     return jsonStatus(403, { error: `capability denied: ${cap}` });
@@ -44408,7 +44660,7 @@ function createDevApiRouter2(opts) {
         const resolved = resolveWithin2(projectDir2, target);
         if (!resolved)
           return jsonStatus(403, { error: "path escapes project root" });
-        if (!existsSync26(resolved))
+        if (!existsSync28(resolved))
           return jsonStatus(404, { error: "not found" });
         if (statSync17(resolved).isDirectory()) {
           const entries = readdirSync9(resolved, { withFileTypes: true }).map((e) => e.name);
@@ -44608,8 +44860,8 @@ function produceDiagnostics(input) {
 }
 
 // ../agentic/dist/checkpoints.js
-import { existsSync as existsSync27, mkdirSync as mkdirSync10, readFileSync as readFileSync25, writeFileSync as writeFileSync13, statSync as statSync18, unlinkSync as unlinkSync4, rmSync as rmSync6, renameSync } from "node:fs";
-import { join as join15, resolve as resolve27, dirname as dirname17, sep as sep5 } from "node:path";
+import { existsSync as existsSync29, mkdirSync as mkdirSync11, readFileSync as readFileSync25, writeFileSync as writeFileSync14, statSync as statSync18, unlinkSync as unlinkSync5, rmSync as rmSync6, renameSync } from "node:fs";
+import { join as join17, resolve as resolve28, dirname as dirname17, sep as sep5 } from "node:path";
 import { randomUUID as nodeRandomUUID } from "node:crypto";
 function generateId() {
   try {
@@ -44742,23 +44994,23 @@ var CheckpointManager = class {
   }
 };
 function getAgenticDir(projectDir2) {
-  return join15(resolve27(projectDir2), ".vesk", "agentic");
+  return join17(resolve28(projectDir2), ".vesk", "agentic");
 }
 function getHistoryPath(projectDir2) {
-  return join15(getAgenticDir(projectDir2), "history.json");
+  return join17(getAgenticDir(projectDir2), "history.json");
 }
 function getCheckpointDir(projectDir2, id) {
-  return join15(getAgenticDir(projectDir2), "checkpoints", id);
+  return join17(getAgenticDir(projectDir2), "checkpoints", id);
 }
 function getCheckpointPath(projectDir2, id) {
-  return join15(getCheckpointDir(projectDir2, id), "checkpoint.json");
+  return join17(getCheckpointDir(projectDir2, id), "checkpoint.json");
 }
 function ensureDir(dir) {
-  mkdirSync10(dir, { recursive: true });
+  mkdirSync11(dir, { recursive: true });
 }
 function readJson(filePath, fallback) {
   try {
-    if (!existsSync27(filePath))
+    if (!existsSync29(filePath))
       return fallback;
     const raw2 = readFileSync25(filePath, "utf-8");
     if (raw2.trim() === "")
@@ -44771,14 +45023,14 @@ function readJson(filePath, fallback) {
 function writeJsonAtomic(filePath, data2) {
   ensureDir(dirname17(filePath));
   const tmp = `${filePath}.tmp`;
-  writeFileSync13(tmp, JSON.stringify(data2, null, 2), "utf-8");
+  writeFileSync14(tmp, JSON.stringify(data2, null, 2), "utf-8");
   try {
     renameSync(tmp, filePath);
   } catch {
     try {
-      writeFileSync13(filePath, JSON.stringify(data2, null, 2), "utf-8");
+      writeFileSync14(filePath, JSON.stringify(data2, null, 2), "utf-8");
       try {
-        unlinkSync4(tmp);
+        unlinkSync5(tmp);
       } catch {
       }
     } catch {
@@ -44831,7 +45083,7 @@ function createCheckpoint(projectDir2, message, changes = {}, buildResult) {
   };
   const agenticDir = getAgenticDir(projectDir2);
   ensureDir(agenticDir);
-  ensureDir(join15(agenticDir, "checkpoints"));
+  ensureDir(join17(agenticDir, "checkpoints"));
   const cpDir = getCheckpointDir(projectDir2, id);
   ensureDir(cpDir);
   writeJsonAtomic(getCheckpointPath(projectDir2, id), checkpoint);
@@ -44852,26 +45104,26 @@ function rollback(projectDir2, id) {
   const cp = getCheckpoint(projectDir2, id);
   if (!cp)
     return null;
-  const projectRoot = resolve27(projectDir2);
+  const projectRoot = resolve28(projectDir2);
   for (const f of cp.files) {
     if (!f.path || !f.path.trim())
       continue;
-    const abs = resolve27(projectRoot, f.path);
+    const abs = resolve28(projectRoot, f.path);
     if (f.before === null) {
       try {
-        if (existsSync27(abs)) {
+        if (existsSync29(abs)) {
           const s = statSync18(abs);
           if (s.isDirectory())
             rmSync6(abs, { recursive: true, force: true });
           else
-            unlinkSync4(abs);
+            unlinkSync5(abs);
         }
       } catch {
       }
     } else {
       try {
         ensureDir(dirname17(abs));
-        writeFileSync13(abs, f.before, "utf-8");
+        writeFileSync14(abs, f.before, "utf-8");
       } catch {
       }
     }
@@ -44880,8 +45132,8 @@ function rollback(projectDir2, id) {
 }
 
 // ../agentic/dist/config.js
-import { readFileSync as readFileSync26, writeFileSync as writeFileSync14, existsSync as existsSync28, mkdirSync as mkdirSync11, chmodSync } from "node:fs";
-import { resolve as resolve28, dirname as dirname18 } from "node:path";
+import { readFileSync as readFileSync26, writeFileSync as writeFileSync15, existsSync as existsSync30, mkdirSync as mkdirSync12, chmodSync } from "node:fs";
+import { resolve as resolve29, dirname as dirname18 } from "node:path";
 var DEFAULT_CONFIG = {
   provider: "openai",
   model: "gpt-4o-mini",
@@ -44900,10 +45152,10 @@ var SUPPORTED_PROVIDERS = [
   "custom"
 ];
 function configPath2(projectDir2) {
-  return resolve28(projectDir2, ".vesk", "agentic", "config.json");
+  return resolve29(projectDir2, ".vesk", "agentic", "config.json");
 }
 function keysDir(projectDir2) {
-  return resolve28(projectDir2, ".vesk", "agentic", "keys");
+  return resolve29(projectDir2, ".vesk", "agentic", "keys");
 }
 function sanitizeProvider(provider) {
   const p = provider.trim().toLowerCase();
@@ -44915,19 +45167,19 @@ function normalizeProvider(provider) {
   return provider.trim().toLowerCase();
 }
 function providerKeyPath(projectDir2, provider) {
-  return resolve28(keysDir(projectDir2), `${sanitizeProvider(provider)}.key`);
+  return resolve29(keysDir(projectDir2), `${sanitizeProvider(provider)}.key`);
 }
 function providerDotenvVar(provider) {
   const prov = sanitizeProvider(provider);
   return `VK_${prov.toUpperCase().replace(/[^A-Z0-9]/g, "_")}_KEY`;
 }
 function dotenvPath(projectDir2) {
-  return resolve28(projectDir2, ".env.local");
+  return resolve29(projectDir2, ".env.local");
 }
 function readDotenvValue(projectDir2, key, def = null) {
   try {
     const p = dotenvPath(projectDir2);
-    if (!existsSync28(p))
+    if (!existsSync30(p))
       return def;
     const content = readFileSync26(p, "utf-8");
     for (const rawLine of content.split("\n")) {
@@ -44956,7 +45208,7 @@ function writeDotenvValue(projectDir2, key, value) {
   try {
     let out = "";
     let replaced = false;
-    if (existsSync28(p)) {
+    if (existsSync30(p)) {
       const lines = readFileSync26(p, "utf-8").split("\n");
       for (const rawLine of lines) {
         const trimmed = rawLine.trim();
@@ -44971,7 +45223,7 @@ function writeDotenvValue(projectDir2, key, value) {
     }
     if (!replaced)
       out += newLine + "\n";
-    writeFileSync14(p, out, { mode: 384 });
+    writeFileSync15(p, out, { mode: 384 });
     try {
       chmodSync(p, 384);
     } catch {
@@ -44986,7 +45238,7 @@ function loadAgenticConfig(projectDir2) {
   const p = configPath2(projectDir2);
   let cfg = { ...DEFAULT_CONFIG };
   try {
-    if (existsSync28(p))
+    if (existsSync30(p))
       cfg = { ...cfg, ...JSON.parse(readFileSync26(p, "utf-8")) };
   } catch {
   }
@@ -45010,8 +45262,8 @@ function saveAgenticConfig(projectDir2, patch) {
   if (next.baseUrl)
     toWrite.baseUrl = next.baseUrl;
   try {
-    mkdirSync11(dirname18(p), { recursive: true });
-    writeFileSync14(p, JSON.stringify(toWrite, null, 2), "utf-8");
+    mkdirSync12(dirname18(p), { recursive: true });
+    writeFileSync15(p, JSON.stringify(toWrite, null, 2), "utf-8");
   } catch {
   }
   return next;
@@ -45029,7 +45281,7 @@ function getProviderSpecificKey(projectDir2, provider) {
     return dotenvFile.trim();
   try {
     const pp2 = providerKeyPath(projectDir2, prov);
-    if (existsSync28(pp2)) {
+    if (existsSync30(pp2)) {
       const v = readFileSync26(pp2, "utf-8").trim();
       if (v)
         return v;
@@ -45077,7 +45329,7 @@ function getApiKey(projectDir2, provider) {
     }
     try {
       const pp2 = providerKeyPath(projectDir2, prov);
-      if (existsSync28(pp2)) {
+      if (existsSync30(pp2)) {
         const v = readFileSync26(pp2, "utf-8").trim();
         if (v)
           return v;
@@ -45101,8 +45353,8 @@ function getApiKey(projectDir2, provider) {
 }
 
 // ../agentic/dist/dev-api.js
-import { existsSync as existsSync29, readFileSync as readFileSync27 } from "node:fs";
-import { resolve as resolve29 } from "node:path";
+import { existsSync as existsSync31, readFileSync as readFileSync27 } from "node:fs";
+import { resolve as resolve30 } from "node:path";
 
 // ../agentic/dist/providers/openai.js
 var OPENAI_FALLBACK_MODELS = ["gpt-4o-mini", "gpt-4o", "gpt-3.5-turbo"];
@@ -45472,8 +45724,8 @@ function getPerProviderKeyRaw(projectDir2, provider) {
   } catch {
   }
   try {
-    const p = resolve29(projectDir2, ".vesk", "agentic", "keys", `${sanitizeProviderName(prov)}.key`);
-    if (existsSync29(p)) {
+    const p = resolve30(projectDir2, ".vesk", "agentic", "keys", `${sanitizeProviderName(prov)}.key`);
+    if (existsSync31(p)) {
       const v = readFileSync27(p, "utf-8").trim();
       if (v)
         return v;
@@ -46335,11 +46587,11 @@ var Agent = class {
 };
 
 // ../agentic/dist/tools/vesk.js
-import { existsSync as existsSync30, readFileSync as readFileSync28, writeFileSync as writeFileSync15, mkdirSync as mkdirSync12, readdirSync as readdirSync10, statSync as statSync19 } from "node:fs";
-import { resolve as resolve30, join as join16, dirname as dirname19, sep as sep6 } from "node:path";
+import { existsSync as existsSync32, readFileSync as readFileSync28, writeFileSync as writeFileSync16, mkdirSync as mkdirSync13, readdirSync as readdirSync10, statSync as statSync19 } from "node:fs";
+import { resolve as resolve31, join as join18, dirname as dirname19, sep as sep6 } from "node:path";
 function resolveWithin3(baseDir, relPath) {
-  const base = resolve30(baseDir);
-  const target = resolve30(baseDir, relPath);
+  const base = resolve31(baseDir);
+  const target = resolve31(baseDir, relPath);
   const prefix = base + sep6;
   if (target === base || !target.startsWith(prefix))
     return null;
@@ -46347,11 +46599,11 @@ function resolveWithin3(baseDir, relPath) {
 }
 var PLUGIN_STATE_FILENAME3 = "plugins.json";
 function stateFilePath3(veskDir) {
-  return resolve30(veskDir, PLUGIN_STATE_FILENAME3);
+  return resolve31(veskDir, PLUGIN_STATE_FILENAME3);
 }
 function readPluginState3(veskDir) {
   const file = stateFilePath3(veskDir);
-  if (!existsSync30(file))
+  if (!existsSync32(file))
     return { version: 1, plugins: [] };
   try {
     const raw2 = JSON.parse(readFileSync28(file, "utf-8"));
@@ -46369,8 +46621,8 @@ function readPluginState3(veskDir) {
 }
 function writePluginState3(veskDir, state) {
   const file = stateFilePath3(veskDir);
-  mkdirSync12(dirname19(file), { recursive: true });
-  writeFileSync15(file, JSON.stringify(state, null, 2) + "\n", "utf-8");
+  mkdirSync13(dirname19(file), { recursive: true });
+  writeFileSync16(file, JSON.stringify(state, null, 2) + "\n", "utf-8");
 }
 function eqIgnoreCase3(a, b) {
   return String(a || "").toLowerCase() === String(b || "").toLowerCase();
@@ -46389,16 +46641,16 @@ function validatePackageSpec3(pkg) {
   return null;
 }
 function findConfigFile3(projectDir2) {
-  const ts9 = resolve30(projectDir2, "vesk.config.ts");
-  if (existsSync30(ts9))
+  const ts9 = resolve31(projectDir2, "vesk.config.ts");
+  if (existsSync32(ts9))
     return { path: ts9, isTs: true };
-  const js = resolve30(projectDir2, "vesk.config.js");
-  if (existsSync30(js))
+  const js = resolve31(projectDir2, "vesk.config.js");
+  if (existsSync32(js))
     return { path: js, isTs: false };
   return { path: null, isTs: false };
 }
 function checkpointDir(veskDir) {
-  return join16(resolve30(veskDir), "checkpoints");
+  return join18(resolve31(veskDir), "checkpoints");
 }
 function findMatchingBrace2(src2, openIdx) {
   let inStr = null;
@@ -46527,9 +46779,9 @@ function jsonError(message, extra) {
   return JSON.stringify({ ok: false, error: message, ...extra || {} });
 }
 function createVeskTools(deps) {
-  const projectDir2 = resolve30(deps.projectDir);
-  const appDir = resolve30(deps.appDir);
-  const veskDir = resolve30(deps.veskDir);
+  const projectDir2 = resolve31(deps.projectDir);
+  const appDir = resolve31(deps.appDir);
+  const veskDir = resolve31(deps.veskDir);
   const tools = [
     // 1. vesk.inspectProject
     {
@@ -46542,16 +46794,16 @@ function createVeskTools(deps) {
       },
       async execute(_args) {
         try {
-          const projExists = existsSync30(projectDir2);
+          const projExists = existsSync32(projectDir2);
           const projEntries = projExists ? readdirSync10(projectDir2, { withFileTypes: true }).map((e) => e.isDirectory() ? e.name + "/" : e.name) : [];
-          const appExists = existsSync30(appDir);
+          const appExists = existsSync32(appDir);
           const appEntries = appExists ? readdirSync10(appDir, { withFileTypes: true }).map((e) => e.isDirectory() ? e.name + "/" : e.name) : [];
-          const veskExists = existsSync30(veskDir);
+          const veskExists = existsSync32(veskDir);
           const veskEntries = veskExists ? readdirSync10(veskDir, { withFileTypes: true }).map((e) => e.isDirectory() ? e.name + "/" : e.name) : [];
           const cfgInfo = findConfigFile3(projectDir2);
           let configSource = null;
           let configExists = false;
-          if (cfgInfo.path && existsSync30(cfgInfo.path)) {
+          if (cfgInfo.path && existsSync32(cfgInfo.path)) {
             configExists = true;
             try {
               configSource = readFileSync28(cfgInfo.path, "utf-8").slice(0, 8e3);
@@ -46560,8 +46812,8 @@ function createVeskTools(deps) {
             }
           }
           let packageJson = null;
-          const pkgPath = resolve30(projectDir2, "package.json");
-          if (existsSync30(pkgPath)) {
+          const pkgPath = resolve31(projectDir2, "package.json");
+          if (existsSync32(pkgPath)) {
             try {
               packageJson = JSON.parse(readFileSync28(pkgPath, "utf-8"));
             } catch {
@@ -46643,7 +46895,7 @@ function createVeskTools(deps) {
             resolved = resolveWithin3(appDir, rel);
           if (!resolved)
             return jsonError("path escapes project root", { path: rel });
-          if (!existsSync30(resolved))
+          if (!existsSync32(resolved))
             return jsonError("not found", { path: rel });
           const st = statSync19(resolved);
           if (st.isDirectory()) {
@@ -46684,7 +46936,7 @@ function createVeskTools(deps) {
             }
           }
           const info = findConfigFile3(projectDir2);
-          if (!info.path || !existsSync30(info.path)) {
+          if (!info.path || !existsSync32(info.path)) {
             return jsonOk({ ok: true, path: null, exists: false, source: "", config: {} });
           }
           const source = readFileSync28(info.path, "utf-8");
@@ -46720,17 +46972,17 @@ function createVeskTools(deps) {
               target = info.path;
               const rel = target.startsWith(projectDir2 + sep6) ? target.slice(projectDir2.length + 1) : "vesk.config.ts";
               const contained = resolveWithin3(projectDir2, rel);
-              if (!contained && target !== resolve30(projectDir2, "vesk.config.ts") && target !== resolve30(projectDir2, "vesk.config.js")) {
+              if (!contained && target !== resolve31(projectDir2, "vesk.config.ts") && target !== resolve31(projectDir2, "vesk.config.js")) {
                 return jsonError("path escapes project root");
               }
             } else {
-              target = resolve30(projectDir2, "vesk.config.ts");
+              target = resolve31(projectDir2, "vesk.config.ts");
               const contained = resolveWithin3(projectDir2, "vesk.config.ts");
               if (!contained)
                 return jsonError("path escapes project root");
             }
-            mkdirSync12(dirname19(target), { recursive: true });
-            writeFileSync15(target, source, "utf-8");
+            mkdirSync13(dirname19(target), { recursive: true });
+            writeFileSync16(target, source, "utf-8");
             return jsonOk({ ok: true, path: target, source });
           }
           if (typeof a.key === "string" && a.key) {
@@ -46751,7 +47003,7 @@ function createVeskTools(deps) {
               return jsonError("could not safely edit the config object; use the source editor");
             if (patched === current2)
               return jsonOk({ ok: true, path: info.path, source: patched, unchanged: true });
-            writeFileSync15(info.path, patched, "utf-8");
+            writeFileSync16(info.path, patched, "utf-8");
             return jsonOk({ ok: true, path: info.path, source: patched });
           }
           return jsonError("expected { source } or { key, value }");
@@ -47011,9 +47263,9 @@ function createVeskTools(deps) {
           } catch {
           }
           const dir = checkpointDir(veskDir);
-          mkdirSync12(dir, { recursive: true });
+          mkdirSync13(dir, { recursive: true });
           const id = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
-          const file = join16(dir, `${id}.json`);
+          const file = join18(dir, `${id}.json`);
           const check = resolveWithin3(dir, `${id}.json`);
           if (!check)
             return jsonError("path escapes project root");
@@ -47025,7 +47277,7 @@ function createVeskTools(deps) {
             appDir,
             veskDir
           };
-          writeFileSync15(file, JSON.stringify(payload, null, 2) + "\n", "utf-8");
+          writeFileSync16(file, JSON.stringify(payload, null, 2) + "\n", "utf-8");
           return jsonOk({ ok: true, checkpointId: id, message: payload.message, timestamp: payload.timestamp });
         } catch (e) {
           return jsonError(e instanceof Error ? e.message : String(e));
@@ -47062,11 +47314,11 @@ function createVeskTools(deps) {
           } catch {
           }
           const dir = checkpointDir(veskDir);
-          const file = join16(dir, `${checkpointId}.json`);
+          const file = join18(dir, `${checkpointId}.json`);
           const contained = resolveWithin3(dir, `${checkpointId}.json`);
           if (!contained)
             return jsonError("path escapes project root");
-          if (!existsSync30(file))
+          if (!existsSync32(file))
             return jsonError(`checkpoint not found: ${checkpointId}`, { checkpointId });
           const raw2 = readFileSync28(file, "utf-8");
           let data2;
@@ -47087,16 +47339,16 @@ function createVeskTools(deps) {
 
 // ../adapter/dist/css.js
 init_scan();
-import { readFileSync as readFileSync29, existsSync as existsSync31 } from "node:fs";
-import { resolve as resolve31 } from "node:path";
+import { readFileSync as readFileSync29, existsSync as existsSync33 } from "node:fs";
+import { resolve as resolve32 } from "node:path";
 var TAILWIND_CSS_URL2 = "/_vesk/static/_tailwind.css";
 var GLOBAL_CSS_URL2 = "/_vesk/static/global.css";
 function resolveUserCssPath2(appDir) {
-  const cssSrc = resolve31(appDir, "..", "src", "global.css");
-  if (existsSync31(cssSrc))
+  const cssSrc = resolve32(appDir, "..", "src", "global.css");
+  if (existsSync33(cssSrc))
     return cssSrc;
-  const altCssSrc = resolve31(appDir, "..", "src", "app.css");
-  if (existsSync31(altCssSrc))
+  const altCssSrc = resolve32(appDir, "..", "src", "app.css");
+  if (existsSync33(altCssSrc))
     return altCssSrc;
   return null;
 }
@@ -47137,8 +47389,8 @@ function stripTailwindDirectives2(css) {
 // ../adapter/dist/hmr.js
 init_client_codegen();
 import { WebSocketServer } from "ws";
-import { readFileSync as readFileSync30, existsSync as existsSync32, writeFileSync as writeFileSync16 } from "node:fs";
-import { resolve as resolve32, dirname as dirname20 } from "node:path";
+import { readFileSync as readFileSync30, existsSync as existsSync34, writeFileSync as writeFileSync17 } from "node:fs";
+import { resolve as resolve33, dirname as dirname20 } from "node:path";
 import { fileURLToPath as fileURLToPath7 } from "node:url";
 init_paths();
 
@@ -47361,8 +47613,8 @@ function buildErrorPayload(error, filename, opts = {}) {
   if (line !== null && line >= 1 && typeof opts.appDir === "string") {
     let src2;
     try {
-      const absPath = resolve32(opts.appDir, file);
-      if (existsSync32(absPath))
+      const absPath = resolve33(opts.appDir, file);
+      if (existsSync34(absPath))
         src2 = readFileSync30(absPath, "utf-8");
     } catch {
       src2 = void 0;
@@ -47376,7 +47628,7 @@ function buildErrorPayload(error, filename, opts = {}) {
     }
   }
   const tipsData = suggestFor(message);
-  const filePath = typeof opts.appDir === "string" ? resolve32(opts.appDir, file) : void 0;
+  const filePath = typeof opts.appDir === "string" ? resolve33(opts.appDir, file) : void 0;
   const cleanMessage = filePath && message.endsWith(` in ${filePath}`) ? message.slice(0, -` in ${filePath}`.length).trim() : message.endsWith(` in ${file}`) ? message.slice(0, -` in ${file}`.length).trim() : message;
   const payload = {
     file,
@@ -47426,13 +47678,13 @@ function buildCodeframe2(src2, line, column, context = 5) {
 
 // src/build-packages.ts
 import { spawnSync } from "node:child_process";
-import { cpSync, existsSync as existsSync33, mkdirSync as mkdirSync13, readFileSync as readFileSync31, readdirSync as readdirSync11, statSync as statSync20, writeFileSync as writeFileSync17 } from "node:fs";
+import { cpSync, existsSync as existsSync35, mkdirSync as mkdirSync14, readFileSync as readFileSync31, readdirSync as readdirSync11, statSync as statSync20, writeFileSync as writeFileSync18 } from "node:fs";
 import { createRequire as createRequire5 } from "node:module";
-import { dirname as dirname21, join as join17, resolve as resolve33 } from "node:path";
+import { dirname as dirname21, join as join19, resolve as resolve34 } from "node:path";
 import { fileURLToPath as fileURLToPath8 } from "node:url";
 var require2 = createRequire5(import.meta.url);
 var __dirname9 = dirname21(fileURLToPath8(import.meta.url));
-var root2 = resolve33(__dirname9, "..", "..", "..");
+var root2 = resolve34(__dirname9, "..", "..", "..");
 var PACKAGES = {
   // types first — it is a dependency-free leaf that compiler and adapter
   // import for their shared type definitions.
@@ -47452,7 +47704,7 @@ var PACKAGES = {
 function newestSourceMtime(srcDir) {
   let newest = 0;
   for (const name of readdirSync11(srcDir)) {
-    const p = join17(srcDir, name);
+    const p = join19(srcDir, name);
     const st = statSync20(p);
     if (st.isDirectory()) {
       newest = Math.max(newest, newestSourceMtime(p));
@@ -47463,11 +47715,11 @@ function newestSourceMtime(srcDir) {
   return newest;
 }
 function distStale(pkgDir, entry) {
-  const distIndex = join17(pkgDir, "dist", `${entry}.js`);
-  if (!existsSync33(distIndex)) return true;
-  const distPkg = join17(pkgDir, "dist", "package.json");
-  const distStamp = Math.max(statSync20(distIndex).mtimeMs, existsSync33(distPkg) ? statSync20(distPkg).mtimeMs : 0);
-  return newestSourceMtime(join17(pkgDir, "src")) > distStamp;
+  const distIndex = join19(pkgDir, "dist", `${entry}.js`);
+  if (!existsSync35(distIndex)) return true;
+  const distPkg = join19(pkgDir, "dist", "package.json");
+  const distStamp = Math.max(statSync20(distIndex).mtimeMs, existsSync35(distPkg) ? statSync20(distPkg).mtimeMs : 0);
+  return newestSourceMtime(join19(pkgDir, "src")) > distStamp;
 }
 function distPackageJson(pkgName, entry, serverEntry, version2) {
   const exports = {
@@ -47490,24 +47742,24 @@ function distPackageJson(pkgName, entry, serverEntry, version2) {
 }
 function buildPackages(force = false) {
   for (const [pkg, cfg] of Object.entries(PACKAGES)) {
-    const pkgDir = resolve33(root2, "packages", pkg);
-    if (!existsSync33(join17(pkgDir, "src"))) continue;
+    const pkgDir = resolve34(root2, "packages", pkg);
+    if (!existsSync35(join19(pkgDir, "src"))) continue;
     if (!force && !distStale(pkgDir, cfg.entry)) continue;
     console.log(`[build] ${cfg.name} -> tsc`);
     const tscBin = require2.resolve("typescript/bin/tsc");
-    const result2 = spawnSync(process.execPath, [tscBin, "-p", join17(pkgDir, "tsconfig.build.json")], {
+    const result2 = spawnSync(process.execPath, [tscBin, "-p", join19(pkgDir, "tsconfig.build.json")], {
       stdio: "inherit"
     });
     if (result2.status !== 0) {
       throw new Error(`tsc failed for ${cfg.name}`);
     }
-    const distDir = join17(pkgDir, "dist");
+    const distDir = join19(pkgDir, "dist");
     for (const c of cfg.copy || []) {
-      const to = join17(distDir, c.to);
-      mkdirSync13(dirname21(to), { recursive: true });
-      cpSync(join17(pkgDir, c.from), to, { recursive: true });
+      const to = join19(distDir, c.to);
+      mkdirSync14(dirname21(to), { recursive: true });
+      cpSync(join19(pkgDir, c.from), to, { recursive: true });
     }
-    const srcPkg = JSON.parse(readFileSync31(join17(pkgDir, "package.json"), "utf-8"));
+    const srcPkg = JSON.parse(readFileSync31(join19(pkgDir, "package.json"), "utf-8"));
     if (pkg === "lucide-vesk") {
       const lucideDistPkg = {
         name: srcPkg.name,
@@ -47521,9 +47773,9 @@ function buildPackages(force = false) {
           "./package.json": "./package.json"
         }
       };
-      writeFileSync17(join17(distDir, "package.json"), JSON.stringify(lucideDistPkg, null, 2) + "\n");
+      writeFileSync18(join19(distDir, "package.json"), JSON.stringify(lucideDistPkg, null, 2) + "\n");
     } else {
-      writeFileSync17(join17(distDir, "package.json"), distPackageJson(cfg.name, cfg.entry, cfg.serverEntry, srcPkg.version || "1.0.0"));
+      writeFileSync18(join19(distDir, "package.json"), distPackageJson(cfg.name, cfg.entry, cfg.serverEntry, srcPkg.version || "1.0.0"));
     }
     console.log(`[build] ${cfg.name} -> dist`);
   }
@@ -47531,13 +47783,13 @@ function buildPackages(force = false) {
 function ensurePackagesBuilt() {
   buildPackages(false);
 }
-if (process.argv[1] && resolve33(process.argv[1]) === fileURLToPath8(import.meta.url)) {
+if (process.argv[1] && resolve34(process.argv[1]) === fileURLToPath8(import.meta.url)) {
   buildPackages(process.argv.includes("--force"));
 }
 
 // src/action-handler.ts
-import { existsSync as existsSync34, readFileSync as readFileSync32, readdirSync as readdirSync12 } from "node:fs";
-import { resolve as resolve34, join as join18 } from "node:path";
+import { existsSync as existsSync36, readFileSync as readFileSync32, readdirSync as readdirSync12 } from "node:fs";
+import { resolve as resolve35, join as join20 } from "node:path";
 
 // ../compiler/dist/server-cookies.js
 function parseCookies3(str3) {
@@ -47593,9 +47845,9 @@ function issuesToFieldMap2(issues) {
 function actionCssUrls(appDirPath) {
   let tailwind = true;
   try {
-    const veskDir = join18(resolve34(appDirPath, ".."), ".vesk");
-    const statePath = join18(veskDir, "plugins.json");
-    if (existsSync34(statePath)) {
+    const veskDir = join20(resolve35(appDirPath, ".."), ".vesk");
+    const statePath = join20(veskDir, "plugins.json");
+    if (existsSync36(statePath)) {
       const raw2 = readFileSync32(statePath, "utf-8");
       const state = JSON.parse(raw2);
       const entries = state?.plugins || [];
@@ -47634,8 +47886,8 @@ function pageSourcesFor(appDirPath, routeTree) {
   const out = [];
   function walk6(nodes) {
     for (const node of nodes) {
-      if (node.page) out.push(resolve34(appDirPath, node.sourceDir, "page.vsk"));
-      if (node.layout) out.push(resolve34(appDirPath, node.sourceDir, "layout.vsk"));
+      if (node.page) out.push(resolve35(appDirPath, node.sourceDir, "page.vsk"));
+      if (node.layout) out.push(resolve35(appDirPath, node.sourceDir, "layout.vsk"));
       walk6(node.children);
     }
   }
@@ -47643,7 +47895,7 @@ function pageSourcesFor(appDirPath, routeTree) {
   return out;
 }
 function walkVskFiles(dir, out, seen) {
-  if (!existsSync34(dir)) return;
+  if (!existsSync36(dir)) return;
   let entries;
   try {
     entries = readdirSync12(dir, { withFileTypes: true });
@@ -47651,7 +47903,7 @@ function walkVskFiles(dir, out, seen) {
     return;
   }
   for (const entry of entries) {
-    const full = resolve34(dir, entry.name);
+    const full = resolve35(dir, entry.name);
     if (seen.has(full)) continue;
     seen.add(full);
     if (entry.isDirectory()) {
@@ -47671,14 +47923,14 @@ function candidateSources(appDirPath, routeTree) {
     seen.add(src2);
     out.push(src2);
   }
-  const projectRoot = resolve34(appDirPath, "..");
-  for (const dir of [resolve34(projectRoot, "components"), appDirPath, projectRoot]) {
+  const projectRoot = resolve35(appDirPath, "..");
+  for (const dir of [resolve35(projectRoot, "components"), appDirPath, projectRoot]) {
     walkVskFiles(dir, out, seen);
   }
   return out;
 }
 function registerSource(sourcePath2) {
-  if (!existsSync34(sourcePath2)) return;
+  if (!existsSync36(sourcePath2)) return;
   try {
     compileFile(readFileSync32(sourcePath2, "utf-8"), { sourcePath: sourcePath2 });
   } catch {
@@ -47689,8 +47941,8 @@ function ensureActionRegistered(actionId, pagePathname, appDirPath, routeTree) {
   const match = matchUrl(routeTree, pagePathname);
   if (match) {
     for (let i = match.nodes.length - 1; i >= 0; i--) {
-      registerSource(resolve34(appDirPath, match.nodes[i].sourceDir, "page.vsk"));
-      registerSource(resolve34(appDirPath, match.nodes[i].sourceDir, "layout.vsk"));
+      registerSource(resolve35(appDirPath, match.nodes[i].sourceDir, "page.vsk"));
+      registerSource(resolve35(appDirPath, match.nodes[i].sourceDir, "layout.vsk"));
     }
   }
   if (getAction2(actionId)) return;
@@ -47716,16 +47968,16 @@ async function renderPageHtml(pagePathname, params, ctx2) {
   let head = "";
   for (let i = chain.length - 1; i >= 0; i--) {
     const node = chain[i];
-    const pageFilePath = resolve34(ctx2.appDirPath, node.sourceDir, "page.vsk");
-    const layoutFilePath = resolve34(ctx2.appDirPath, node.sourceDir, "layout.vsk");
-    if (i === chain.length - 1 && node.page && existsSync34(pageFilePath)) {
+    const pageFilePath = resolve35(ctx2.appDirPath, node.sourceDir, "page.vsk");
+    const layoutFilePath = resolve35(ctx2.appDirPath, node.sourceDir, "layout.vsk");
+    if (i === chain.length - 1 && node.page && existsSync36(pageFilePath)) {
       const src3 = readFileSync32(pageFilePath, "utf-8");
       const compName2 = resolveComponentName(src3) || node.page;
       const result2 = await renderPage(src3, compName2, { params }, /* @__PURE__ */ new Map(), { hydrate: true, sourcePath: pageFilePath });
       body = result2.body;
       head = result2.head || "";
     }
-    if (node.layout && existsSync34(layoutFilePath)) {
+    if (node.layout && existsSync36(layoutFilePath)) {
       const src3 = readFileSync32(layoutFilePath, "utf-8");
       const compName2 = resolveComponentName(src3) || node.layout;
       const result2 = await renderPage(src3, compName2, { children: body }, /* @__PURE__ */ new Map(), { hydrate: true, sourcePath: layoutFilePath });
@@ -47733,7 +47985,7 @@ async function renderPageHtml(pagePathname, params, ctx2) {
       head = (result2.head || "") + head;
     }
   }
-  const hasLayout = chain.some((n) => n.layout && existsSync34(resolve34(ctx2.appDirPath, n.sourceDir, "layout.vsk")));
+  const hasLayout = chain.some((n) => n.layout && existsSync36(resolve35(ctx2.appDirPath, n.sourceDir, "layout.vsk")));
   if (hasLayout) {
     const secMeta = securityMeta(ctx2.security);
     const headBlock = await applyHeadInjects(
@@ -47757,9 +48009,9 @@ ${prettifyHtml(body)}
   }
   const leaf = chain.find((n) => n.page);
   if (!leaf) return null;
-  const src2 = readFileSync32(resolve34(ctx2.appDirPath, leaf.sourceDir, "page.vsk"), "utf-8");
+  const src2 = readFileSync32(resolve35(ctx2.appDirPath, leaf.sourceDir, "page.vsk"), "utf-8");
   const compName = resolveComponentName(src2) || leaf.page;
-  const html = await renderFullPage(src2, compName, { params }, /* @__PURE__ */ new Map(), { hydrate: true, clientScriptUrl: "/_vesk/client.js", cssUrls: actionCssUrls(ctx2.appDirPath), security: ctx2.security, sourcePath: resolve34(ctx2.appDirPath, leaf.sourceDir, "page.vsk"), plugins: ctx2.plugins });
+  const html = await renderFullPage(src2, compName, { params }, /* @__PURE__ */ new Map(), { hydrate: true, clientScriptUrl: "/_vesk/client.js", cssUrls: actionCssUrls(ctx2.appDirPath), security: ctx2.security, sourcePath: resolve35(ctx2.appDirPath, leaf.sourceDir, "page.vsk"), plugins: ctx2.plugins });
   return applyHtmlPlugins(html.replace("</body>", '	<script type="module" src="/_vesk/hmr.js"></script>\n</body>'), ctx2.plugins, { sourcePath: ctx2.url.pathname });
 }
 async function handleActionRequest(req, res, ctx2) {
@@ -47941,14 +48193,14 @@ function buildDevErrorPayload(input) {
 function resolveRuntimeDir(projectDir2) {
   const candidates = [
     // installed app layout
-    resolve35(projectDir2, "node_modules", "@vesk", "runtime"),
+    resolve36(projectDir2, "node_modules", "@vesk", "runtime"),
     // monorepo checkout (tests/probes run from the repo root)
-    resolve35(import.meta.dirname ?? ".", "..", "..", "runtime", "dist")
+    resolve36(import.meta.dirname ?? ".", "..", "..", "runtime", "dist")
   ];
   for (const dir of candidates) {
-    if (existsSync35(join19(dir, "ripple-runtime.js"))) return dir;
-    const distDir = join19(dir, "dist");
-    if (existsSync35(join19(distDir, "ripple-runtime.js"))) return distDir;
+    if (existsSync37(join21(dir, "ripple-runtime.js"))) return dir;
+    const distDir = join21(dir, "dist");
+    if (existsSync37(join21(distDir, "ripple-runtime.js"))) return distDir;
   }
   return null;
 }
@@ -48098,10 +48350,10 @@ function collectRoutePaths(nodes, out = []) {
   return out;
 }
 function countFilesNamed(dir, name) {
-  if (!existsSync35(dir)) return 0;
+  if (!existsSync37(dir)) return 0;
   let n = 0;
   for (const entry of readdirSync13(dir, { withFileTypes: true })) {
-    const p = join19(dir, entry.name);
+    const p = join21(dir, entry.name);
     if (entry.isDirectory()) n += countFilesNamed(p, name);
     else if (entry.name === name) n++;
   }
@@ -48112,8 +48364,8 @@ async function startDevServer(port2, projectDir2, config, host2) {
   if (!process.env.NODE_ENV) process.env.NODE_ENV = "development";
   const secCfg = config.security || {};
   const maxBodyBytes2 = (typeof secCfg.maxBodyBytes === "number" ? secCfg.maxBodyBytes : void 0) || DEFAULT_MAX_BODY_BYTES;
-  const appDirPath = join19(projectDir2, "app");
-  const publicDir = join19(projectDir2, "public");
+  const appDirPath = join21(projectDir2, "app");
+  const publicDir = join21(projectDir2, "public");
   installMdReadHook2([publicDir]);
   try {
     ensurePackagesBuilt();
@@ -48126,7 +48378,7 @@ async function startDevServer(port2, projectDir2, config, host2) {
     process.exit(1);
   }
   const runtimeDir = runtimeDirUnchecked;
-  const veskStateDir = join19(projectDir2, ".vesk");
+  const veskStateDir = join21(projectDir2, ".vesk");
   const configPluginsRaw = config.plugins || [];
   const configPluginNames = configPluginsRaw.map((p) => typeof p === "string" ? p : p?.name).filter((n) => !!n);
   const rawDevPlugins = config.plugins || [];
@@ -48138,6 +48390,83 @@ async function startDevServer(port2, projectDir2, config, host2) {
       return rawDevPlugins;
     }
   }
+  let eventsFile = collectEventsFile2(appDirPath);
+  let appEventsHandlers = {};
+  async function reloadAppEvents() {
+    eventsFile = collectEventsFile2(appDirPath);
+    if (eventsFile) {
+      try {
+        appEventsHandlers = await loadEvents(eventsFile);
+      } catch (e) {
+        LOG.err(`events load error: ${e.message}`);
+        appEventsHandlers = {};
+      }
+    } else {
+      appEventsHandlers = {};
+    }
+  }
+  function eventsStore() {
+    const g2 = globalThis;
+    if (!g2.__vesk_server_ctx) g2.__vesk_server_ctx = {};
+    return g2.__vesk_server_ctx;
+  }
+  function makeEventCtx(overrides) {
+    const store = eventsStore();
+    return {
+      server: null,
+      port: port2,
+      host: bindHost,
+      locals: { ...store },
+      serverLocals: store,
+      set(key, value) {
+        store[key] = value;
+        return value;
+      },
+      get(key) {
+        return store[key];
+      },
+      ...overrides
+    };
+  }
+  let devServerRef = null;
+  async function runAppStart(includePlugins) {
+    const bootCtx = makeEventCtx({ server: devServerRef });
+    try {
+      await runEventHandlers(appEventsHandlers, "onStart", bootCtx);
+    } catch (e) {
+      LOG.err(`onStart error: ${e.message}`);
+    }
+    if (includePlugins) {
+      for (const plugin of getActiveDevPlugins()) {
+        if (typeof plugin.onStart === "function") {
+          try {
+            await plugin.onStart(bootCtx);
+          } catch (e) {
+            LOG.err(`plugin onStart error: ${e.message}`);
+          }
+        }
+      }
+    }
+  }
+  async function runAppStop(includePlugins) {
+    const stopCtx = makeEventCtx({ server: devServerRef });
+    try {
+      await runEventHandlers(appEventsHandlers, "onStop", stopCtx);
+    } catch (e) {
+      LOG.err(`onStop error: ${e.message}`);
+    }
+    if (includePlugins) {
+      for (const plugin of getActiveDevPlugins()) {
+        if (typeof plugin.onStop === "function") {
+          try {
+            await plugin.onStop(stopCtx);
+          } catch (e) {
+            LOG.err(`plugin onStop error: ${e.message}`);
+          }
+        }
+      }
+    }
+  }
   function isTailwindActive() {
     return isTailwindPlugin2(getActiveDevPlugins());
   }
@@ -48154,13 +48483,13 @@ async function startDevServer(port2, projectDir2, config, host2) {
   let devTailwindCssContent = "";
   let lastServedCssGlobal = "";
   let lastServedCssTailwind = "";
-  const srcDir = join19(projectDir2, "src");
-  const cssPath = join19(srcDir, "global.css");
-  const altCssPath = join19(srcDir, "app.css");
+  const srcDir = join21(projectDir2, "src");
+  const cssPath = join21(srcDir, "global.css");
+  const altCssPath = join21(srcDir, "app.css");
   let rawCss = "";
-  if (existsSync35(cssPath)) {
+  if (existsSync37(cssPath)) {
     rawCss = readFileSync33(cssPath, "utf-8");
-  } else if (existsSync35(altCssPath)) {
+  } else if (existsSync37(altCssPath)) {
     rawCss = readFileSync33(altCssPath, "utf-8");
   }
   if (rawCss) {
@@ -48416,17 +48745,32 @@ async function startDevServer(port2, projectDir2, config, host2) {
     let debounceTimer = null;
     let cssDebounceTimer = null;
     const watchDirs = [appDirPath];
-    if (existsSync35(srcDir)) watchDirs.push(srcDir);
+    if (existsSync37(srcDir)) watchDirs.push(srcDir);
     for (const watchDir of watchDirs) {
       watch(watchDir, { recursive: true }, (eventType, filename) => {
         if (!filename) return;
         const isVsk = filename.endsWith(".vsk") || filename.endsWith(".md") || filename.endsWith(".markdown");
         const isCss = filename.endsWith(".css");
         const isApiRoute = filename.endsWith(".ts") || filename.endsWith(".js") || filename.endsWith(".tsx");
-        if (!isVsk && !isCss && !isApiRoute) return;
-        const fullPath = filename.startsWith("/") ? filename : join19(watchDir, filename);
-        const fileExists = existsSync35(fullPath);
-        if (isVsk) {
+        const isEvents = filename === "_events.ts" || filename === "_events.js";
+        if (!isVsk && !isCss && !isApiRoute && !isEvents) return;
+        const fullPath = filename.startsWith("/") ? filename : join21(watchDir, filename);
+        const fileExists = existsSync37(fullPath);
+        if (isEvents) {
+          if (debounceTimer) clearTimeout(debounceTimer);
+          debounceTimer = setTimeout(async () => {
+            try {
+              await runAppStop(false);
+              await reloadAppEvents();
+              await runAppStart(false);
+              const bcast = globalThis.__vesk_broadcastHmr;
+              if (typeof bcast === "function") bcast({ type: "reload" });
+              LOG.info(`events reloaded (${filename})`);
+            } catch (e) {
+              LOG.err(`events reload error: ${e.message}`);
+            }
+          }, HMR_DEBOUNCE_MS);
+        } else if (isVsk) {
           if (debounceTimer) clearTimeout(debounceTimer);
           debounceTimer = setTimeout(async () => {
             const t0 = Date.now();
@@ -48589,9 +48933,9 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
     ".json": "application/json",
     ".webmanifest": "application/manifest+json"
   };
-  const hmrJsPath = join19(runtimeDir, "hmr-client.js");
-  const hmrTsPath = join19(runtimeDir, "hmr-client.ts");
-  const hmrClientPath = existsSync35(hmrJsPath) ? hmrJsPath : existsSync35(hmrTsPath) ? hmrTsPath : null;
+  const hmrJsPath = join21(runtimeDir, "hmr-client.js");
+  const hmrTsPath = join21(runtimeDir, "hmr-client.ts");
+  const hmrClientPath = existsSync37(hmrJsPath) ? hmrJsPath : existsSync37(hmrTsPath) ? hmrTsPath : null;
   function extractCompName2(src2) {
     return resolveComponentName(src2);
   }
@@ -48726,21 +49070,37 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
         return;
       }
     }
-    if (await handleActionRequest(req, res, { url, appDirPath, routeTree, security, maxBodyBytes: maxBodyBytes2, plugins: getActiveDevPlugins() })) {
-      return;
-    }
     if (url.pathname !== "/") {
       const staticPath = url.pathname.length > 1 ? resolveWithin2(publicDir, url.pathname.slice(1)) : null;
-      if (staticPath && existsSync35(staticPath) && statSync21(staticPath).isFile()) {
+      if (staticPath && existsSync37(staticPath) && statSync21(staticPath).isFile()) {
         const ext = extname8(staticPath);
         res.writeHead(200, { "Content-Type": MIME3[ext] || "application/octet-stream" });
         res.end(readFileSync33(staticPath));
         return;
       }
     }
+    const eventsCtx = makeEventCtx({
+      request: new Request(`http://localhost:${port2}${req.url || "/"}`, {
+        headers: req.headers,
+        method: req.method || "GET"
+      }),
+      params: {},
+      url,
+      cookies: rawCtx.cookies
+    });
+    rawCtx.locals = eventsCtx.locals;
+    globalThis.__vesk_request = eventsCtx;
+    try {
+      await runEventHandlers(appEventsHandlers, "onRequest", eventsCtx);
+    } catch (e) {
+      LOG.err(`onRequest error: ${e.message}`);
+    }
+    if (await handleActionRequest(req, res, { url, appDirPath, routeTree, security, maxBodyBytes: maxBodyBytes2, plugins: getActiveDevPlugins() })) {
+      return;
+    }
     const mwChain = collectMiddlewareChain(routeTree, url.pathname, appDirPath);
-    const apiDirPath = join19(appDirPath, "api");
-    if (url.pathname.startsWith("/api") && existsSync35(apiDirPath)) {
+    const apiDirPath = join21(appDirPath, "api");
+    if (url.pathname.startsWith("/api") && existsSync37(apiDirPath)) {
       const apiRoutes = await scanApiRoutes(apiDirPath);
       const apiMatch = matchApiUrl(apiRoutes, req.url || url.pathname);
       if (apiMatch) {
@@ -48767,7 +49127,7 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
         for (const [k, v] of Object.entries(req.headers)) {
           rawHeaders[k] = Array.isArray(v) ? v.join(", ") : v || "";
         }
-        let apiLocals = {};
+        let apiLocals = Object.assign({}, eventsCtx?.locals || globalThis.__vesk_server_ctx || {});
         if (mwChain.length > 0) {
           const mwReq = new Request(requestUrl, { headers: rawHeaders, method: req.method || "GET" });
           try {
@@ -48815,8 +49175,8 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
       const rootNode = routeTree.find((n) => n.fullPath === "/");
       let notFoundHtml = null;
       if (rootNode && rootNode.notFound) {
-        const nfPath = resolve35(appDirPath, rootNode.sourceDir, "not-found.vsk");
-        if (existsSync35(nfPath)) {
+        const nfPath = resolve36(appDirPath, rootNode.sourceDir, "not-found.vsk");
+        if (existsSync37(nfPath)) {
           try {
             const nfSrc = readFileSync33(nfPath, "utf-8");
             const nfCompName = extractCompName2(nfSrc) || rootNode.notFound;
@@ -48855,9 +49215,9 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
         let props;
         for (let i = chain.length - 1; i >= 0; i--) {
           const node = chain[i];
-          const pageFilePath = resolve35(appDirPath, node.sourceDir, "page.vsk");
-          const layoutFilePath = resolve35(appDirPath, node.sourceDir, "layout.vsk");
-          if (i === chain.length - 1 && node.page && existsSync35(pageFilePath)) {
+          const pageFilePath = resolve36(appDirPath, node.sourceDir, "page.vsk");
+          const layoutFilePath = resolve36(appDirPath, node.sourceDir, "layout.vsk");
+          if (i === chain.length - 1 && node.page && existsSync37(pageFilePath)) {
             const src2 = readFileSync33(pageFilePath, "utf-8");
             const compName = extractCompName2(src2) || node.page;
             const result2 = await renderPage(src2, compName, { params: matched.params }, /* @__PURE__ */ new Map(), { hydrate: true, sourcePath: pageFilePath });
@@ -48865,7 +49225,7 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
             head = result2.head || "";
             props = result2.props;
           }
-          if (node.layout && existsSync35(layoutFilePath)) {
+          if (node.layout && existsSync37(layoutFilePath)) {
             const src2 = readFileSync33(layoutFilePath, "utf-8");
             const compName = extractCompName2(src2) || node.layout;
             const result2 = await renderPage(src2, compName, { children: body }, /* @__PURE__ */ new Map(), { hydrate: true, sourcePath: layoutFilePath });
@@ -48876,7 +49236,7 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
         if (forData) {
           return { html: "", props: props || { params: matched.params }, head };
         }
-        const hasLayout = chain.some((n) => n.layout && existsSync35(resolve35(appDirPath, n.sourceDir, "layout.vsk")));
+        const hasLayout = chain.some((n) => n.layout && existsSync37(resolve36(appDirPath, n.sourceDir, "layout.vsk")));
         let html;
         if (hasLayout) {
           const ssrData = ssrSink3.snapshot();
@@ -48907,9 +49267,9 @@ ${prettifyHtml(body)}
         } else {
           const leaf = chain.find((n) => n.page);
           if (leaf) {
-            const src2 = readFileSync33(resolve35(appDirPath, leaf.sourceDir, "page.vsk"), "utf-8");
+            const src2 = readFileSync33(resolve36(appDirPath, leaf.sourceDir, "page.vsk"), "utf-8");
             const compName = extractCompName2(src2) || leaf.page;
-            html = await renderFullPage(src2, compName, { params: matched.params }, /* @__PURE__ */ new Map(), { hydrate: true, clientScriptUrl: "/_vesk/client.js", cssUrls: activeCssUrls(), security, externalDataScript: storeDataScript, sourcePath: resolve35(appDirPath, leaf.sourceDir, "page.vsk"), plugins: getActiveDevPlugins() });
+            html = await renderFullPage(src2, compName, { params: matched.params }, /* @__PURE__ */ new Map(), { hydrate: true, clientScriptUrl: "/_vesk/client.js", cssUrls: activeCssUrls(), security, externalDataScript: storeDataScript, sourcePath: resolve36(appDirPath, leaf.sourceDir, "page.vsk"), plugins: getActiveDevPlugins() });
             html = html.replace("</body>", '	<script type="module" src="/_vesk/hmr.js"></script>\n</body>');
             html = await applyHtmlPlugins(html, getActiveDevPlugins(), { sourcePath: url.pathname });
           } else {
@@ -48922,13 +49282,13 @@ ${prettifyHtml(body)}
     function renderSSRStream() {
       async function* raw2() {
         const chain = cleanChain;
-        const hasLayout = chain.some((n) => n.layout && existsSync35(resolve35(appDirPath, n.sourceDir, "layout.vsk")));
+        const hasLayout = chain.some((n) => n.layout && existsSync37(resolve36(appDirPath, n.sourceDir, "layout.vsk")));
         if (!hasLayout) {
           const leaf = chain.find((n) => n.page);
           if (leaf) {
-            const src2 = readFileSync33(resolve35(appDirPath, leaf.sourceDir, "page.vsk"), "utf-8");
+            const src2 = readFileSync33(resolve36(appDirPath, leaf.sourceDir, "page.vsk"), "utf-8");
             const compName = extractCompName2(src2) || leaf.page;
-            yield* renderPageStream(src2, compName, { params: matched.params }, /* @__PURE__ */ new Map(), { hydrate: true, clientScriptUrl: "/_vesk/client.js", cssUrls: activeCssUrls(), security, externalDataScript: storeDataScript, sourcePath: resolve35(appDirPath, leaf.sourceDir, "page.vsk"), plugins: getActiveDevPlugins() });
+            yield* renderPageStream(src2, compName, { params: matched.params }, /* @__PURE__ */ new Map(), { hydrate: true, clientScriptUrl: "/_vesk/client.js", cssUrls: activeCssUrls(), security, externalDataScript: storeDataScript, sourcePath: resolve36(appDirPath, leaf.sourceDir, "page.vsk"), plugins: getActiveDevPlugins() });
           } else {
             throw new Error("No page or layout matched");
           }
@@ -48939,9 +49299,9 @@ ${prettifyHtml(body)}
         let props;
         for (let i = chain.length - 1; i >= 0; i--) {
           const node = chain[i];
-          const pageFilePath = resolve35(appDirPath, node.sourceDir, "page.vsk");
-          const layoutFilePath = resolve35(appDirPath, node.sourceDir, "layout.vsk");
-          if (i === chain.length - 1 && node.page && existsSync35(pageFilePath)) {
+          const pageFilePath = resolve36(appDirPath, node.sourceDir, "page.vsk");
+          const layoutFilePath = resolve36(appDirPath, node.sourceDir, "layout.vsk");
+          if (i === chain.length - 1 && node.page && existsSync37(pageFilePath)) {
             const src2 = readFileSync33(pageFilePath, "utf-8");
             const compName = extractCompName2(src2) || node.page;
             const result2 = await renderPage(src2, compName, { params: matched.params }, /* @__PURE__ */ new Map(), { hydrate: true, sourcePath: pageFilePath });
@@ -48949,7 +49309,7 @@ ${prettifyHtml(body)}
             head = result2.head || "";
             props = result2.props;
           }
-          if (node.layout && existsSync35(layoutFilePath)) {
+          if (node.layout && existsSync37(layoutFilePath)) {
             const src2 = readFileSync33(layoutFilePath, "utf-8");
             const compName = extractCompName2(src2) || node.layout;
             const result2 = await renderPage(src2, compName, { children: body }, /* @__PURE__ */ new Map(), { hydrate: true, sourcePath: layoutFilePath });
@@ -49079,8 +49439,8 @@ ${prettifyHtml(body)}
           for (let i = match.nodes.length - 1; i >= 0; i--) {
             const node = match.nodes[i];
             if (node.notFound) {
-              const nfPath = resolve35(appDirPath, node.sourceDir, "not-found.vsk");
-              if (existsSync35(nfPath)) {
+              const nfPath = resolve36(appDirPath, node.sourceDir, "not-found.vsk");
+              if (existsSync37(nfPath)) {
                 try {
                   const nfSrc = readFileSync33(nfPath, "utf-8");
                   const nfCompName = extractCompName2(nfSrc) || node.notFound;
@@ -49102,8 +49462,8 @@ ${prettifyHtml(body)}
           for (let i = match.nodes.length - 1; i >= 0; i--) {
             const node = match.nodes[i];
             if (node.error) {
-              const errPath = resolve35(appDirPath, node.sourceDir, "error.vsk");
-              if (existsSync35(errPath)) {
+              const errPath = resolve36(appDirPath, node.sourceDir, "error.vsk");
+              if (existsSync37(errPath)) {
                 try {
                   const errSrc = readFileSync33(errPath, "utf-8");
                   const errCompName = extractCompName2(errSrc) || node.error;
@@ -49128,6 +49488,17 @@ ${err.stack}</pre></body></html>`);
       }
     }
   });
+  devServerRef = server2;
+  try {
+    await reloadAppEvents();
+  } catch (e) {
+    LOG.err(`events load error: ${e.message}`);
+  }
+  try {
+    await runAppStart(true);
+  } catch (e) {
+    LOG.err(`boot onStart error: ${e.message}`);
+  }
   server2.on("error", (e) => {
     if (e.code === "EADDRINUSE") {
       LOG.err(`port ${port2} is already in use \u2014 is another vesk dev server running?`);
@@ -49139,7 +49510,7 @@ ${err.stack}</pre></body></html>`);
     LOG.ok(`dev server at http://localhost:${port2} (listening on ${bindHost})`);
     const routes = collectRoutePaths(routeTree);
     const pageCount = countPages(routeTree);
-    const apiCount = countFilesNamed(join19(appDirPath, "api"), "route.ts");
+    const apiCount = countFilesNamed(join21(appDirPath, "api"), "route.ts");
     LOG.info(`${projectDir2}`);
     LOG.info(`${pageCount} page${pageCount === 1 ? "" : "s"}: ${routes.join(", ") || "(none)"}`);
     if (apiCount > 0) LOG.info(`${apiCount} api route${apiCount === 1 ? "" : "s"} (app/api)`);
@@ -49173,6 +49544,23 @@ ${err.stack}</pre></body></html>`);
       if (ws.readyState === 1) ws.send(msg);
     }
   };
+  let stopping = false;
+  const shutdown2 = (signal) => {
+    if (stopping) return;
+    stopping = true;
+    LOG.info(`dev server: ${signal} \u2014 stopping`);
+    void (async () => {
+      try {
+        await runAppStop(true);
+      } catch (e) {
+        LOG.err(`shutdown onStop error: ${e.message}`);
+      }
+      server2.close(() => process.exit(0));
+    })();
+    setTimeout(() => process.exit(0), 3e3).unref();
+  };
+  process.on("SIGINT", () => shutdown2("SIGINT"));
+  process.on("SIGTERM", () => shutdown2("SIGTERM"));
   await new Promise(() => {
   });
 }
@@ -49243,7 +49631,9 @@ __export(index_server_exports2, {
   buildRouteTree: () => buildRouteTree,
   clearActions: () => clearActions,
   clearIsrCache: () => clearIsrCache,
+  clearServerContext: () => clearServerContext,
   clearSsrData: () => clearSsrData,
+  clear_server_context: () => clear_server_context,
   componentIsr: () => componentIsr,
   configureLoadingIndicator: () => configureLoadingIndicator,
   cookies: () => cookies,
@@ -49269,6 +49659,8 @@ __export(index_server_exports2, {
   getActiveComponent: () => getActiveComponent,
   getLoadingError: () => getLoadingError,
   getLoadingProgress: () => getLoadingProgress,
+  getServerContext: () => getServerContext,
+  get_server_context: () => get_server_context,
   headers: () => headers,
   isFormAction: () => isFormAction,
   isLoadingActive: () => isLoadingActive,
@@ -49304,13 +49696,17 @@ __export(index_server_exports2, {
   runHooks: () => runHooks,
   safe_scope: () => safe_scope,
   scope: () => scope,
+  serverLocals: () => serverLocals,
+  server_locals: () => server_locals,
   set: () => set,
   setActiveComponent: () => setActiveComponent,
+  setServerContext: () => setServerContext,
   setSignedCookie: () => setSignedCookie2,
   setSsrData: () => setSsrData,
   setSsrSink: () => setSsrSink,
   set_active_block: () => set_active_block,
   set_active_component: () => set_active_component,
+  set_server_context: () => set_server_context,
   signCookie: () => signCookie2,
   tick: () => tick,
   track: () => track,
@@ -49336,6 +49732,7 @@ __export(index_server_exports2, {
 init_ripple_runtime();
 init_ripple_blocks();
 init_context();
+init_server_events();
 init_resource();
 init_portal();
 init_router();
@@ -49352,7 +49749,7 @@ init_action();
 
 // src/index.ts
 var __filename2 = fileURLToPath9(import.meta.url);
-var __dirname10 = resolve37(__filename2, "..");
+var __dirname10 = resolve38(__filename2, "..");
 var args = process.argv.slice(2);
 var cmd = args[0];
 function usage(code = 0) {
@@ -49395,11 +49792,11 @@ if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
 }
 function loadEnvFiles(projectDir2) {
   const files = [
-    join21(projectDir2, ".env"),
-    join21(projectDir2, ".env.local")
+    join23(projectDir2, ".env"),
+    join23(projectDir2, ".env.local")
   ];
   for (const filePath of files) {
-    if (!existsSync36(filePath)) continue;
+    if (!existsSync38(filePath)) continue;
     const content = readFileSync35(filePath, "utf-8");
     for (const line of content.split("\n")) {
       const trimmed = line.trim();
@@ -49419,11 +49816,11 @@ function loadEnvFiles(projectDir2) {
 }
 async function loadConfig(projectDir2) {
   loadEnvFiles(projectDir2);
-  const jsPath = join21(projectDir2, "vesk.config.js");
-  const tsPath = join21(projectDir2, "vesk.config.ts");
+  const jsPath = join23(projectDir2, "vesk.config.js");
+  const tsPath = join23(projectDir2, "vesk.config.ts");
   let configPath3 = null;
-  if (existsSync36(jsPath)) configPath3 = jsPath;
-  else if (existsSync36(tsPath)) configPath3 = tsPath;
+  if (existsSync38(jsPath)) configPath3 = jsPath;
+  else if (existsSync38(tsPath)) configPath3 = tsPath;
   if (!configPath3) return {};
   let raw2;
   if (configPath3.endsWith(".ts")) {
@@ -49433,9 +49830,9 @@ async function loadConfig(projectDir2) {
     js = js.replace(/import\s+\{[^}]*\}\s*from\s+['"]@vesk\/compiler['"]\s*;?\s*/g, "");
     js = `const { defineConfig, definePlugin, preset } = globalThis.__vesk_inject;
 ` + js;
-    const tmpFile = join21(projectDir2, ".vesk", "config.tmp.js");
-    mkdirSync15(dirname23(tmpFile), { recursive: true });
-    writeFileSync18(tmpFile, js, "utf-8");
+    const tmpFile = join23(projectDir2, ".vesk", "config.tmp.js");
+    mkdirSync16(dirname23(tmpFile), { recursive: true });
+    writeFileSync19(tmpFile, js, "utf-8");
     globalThis.__vesk_inject = { defineConfig, definePlugin, preset };
     raw2 = (await import(tmpFile)).default;
     delete globalThis.__vesk_inject;
@@ -49455,9 +49852,9 @@ async function loadConfig(projectDir2) {
 }
 if (cmd === "build") {
   const projectDir2 = process.cwd();
-  const appDirPath = join21(projectDir2, "app");
-  const publicDir = join21(projectDir2, "public");
-  if (!existsSync36(appDirPath)) {
+  const appDirPath = join23(projectDir2, "app");
+  const publicDir = join23(projectDir2, "public");
+  if (!existsSync38(appDirPath)) {
     console.error(`vesk build: no app/ directory found in ${projectDir2}`);
     process.exit(1);
   }
@@ -49527,8 +49924,8 @@ ${code}`;
 }
 if (cmd === "seo") {
   const projectDir2 = process.cwd();
-  const appDirPath = join21(projectDir2, "app");
-  if (!existsSync36(appDirPath)) {
+  const appDirPath = join23(projectDir2, "app");
+  if (!existsSync38(appDirPath)) {
     console.error(`vesk seo: no app/ directory found in ${projectDir2}`);
     process.exit(1);
   }
@@ -49542,8 +49939,8 @@ if (cmd === "seo") {
 }
 if (cmd === "typecheck") {
   const projectDir2 = process.cwd();
-  const appDirPath = join21(projectDir2, "app");
-  if (!existsSync36(appDirPath)) {
+  const appDirPath = join23(projectDir2, "app");
+  if (!existsSync38(appDirPath)) {
     console.error(`vesk typecheck: no app/ directory found in ${projectDir2}`);
     process.exit(1);
   }
@@ -49567,7 +49964,7 @@ if (cmd === "typecheck") {
 }
 if (cmd === "start") {
   const projectDir2 = process.cwd();
-  const outDir2 = join21(projectDir2, ".vesk");
+  const outDir2 = join23(projectDir2, ".vesk");
   const port2 = parsePortArg(args);
   const host2 = parseHostArg(args);
   startProdServer(outDir2, { port: port2, host: host2 });
@@ -49576,14 +49973,14 @@ if (cmd === "start") {
 }
 if (cmd === "init") {
   const projectDir2 = process.cwd();
-  const srcDir = join21(projectDir2, "src");
-  const target = join21(srcDir, "global.css");
-  if (existsSync36(target)) {
+  const srcDir = join23(projectDir2, "src");
+  const target = join23(srcDir, "global.css");
+  if (existsSync38(target)) {
     console.error(`vesk init: ${target} already exists \u2014 skipping`);
     process.exit(0);
   }
-  mkdirSync15(srcDir, { recursive: true });
-  writeFileSync18(target, [
+  mkdirSync16(srcDir, { recursive: true });
+  writeFileSync19(target, [
     `@import 'tailwindcss';`,
     ``,
     `@layer base {`,
@@ -49596,10 +49993,10 @@ if (cmd === "init") {
 }
 if (cmd === "dev") {
   const projectDir2 = process.cwd();
-  const appDirPath = join21(projectDir2, "app");
+  const appDirPath = join23(projectDir2, "app");
   const port2 = parsePortArg(args);
   const host2 = parseHostArg(args);
-  if (!existsSync36(appDirPath)) {
+  if (!existsSync38(appDirPath)) {
     console.error(`vesk: no app/ directory found in ${projectDir2}`);
     console.error('Run "npx create-vesk@latest <project-name>" first');
     process.exit(1);