@faapi/faapi 6.17.0 → 6.18.1

package/dist/index.js

@@ -1234,21 +1234,6 @@ var init_collectRouteSchemaSources = __esm({
   }
 });
 
-// src/utils/atomicWrite.ts
-import path10 from "path";
-import fs8 from "fs";
-async function atomicWriteFile(outputPath, content) {
-  await fs8.promises.mkdir(path10.dirname(outputPath), { recursive: true });
-  const tmp = `${outputPath}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;
-  await fs8.promises.writeFile(tmp, content, "utf-8");
-  await fs8.promises.rename(tmp, outputPath);
-}
-var init_atomicWrite = __esm({
-  "src/utils/atomicWrite.ts"() {
-    "use strict";
-  }
-});
-
 // src/ast/generateZodSchema.ts
 function collectNamedTypes(type, ctx) {
   switch (type.kind) {
@@ -1579,6 +1564,74 @@ var init_generateZodSchema = __esm({
   }
 });
 
+// src/utils/atomicWrite.ts
+import path10 from "path";
+import fs9 from "fs";
+async function atomicWriteFile(outputPath, content) {
+  await fs9.promises.mkdir(path10.dirname(outputPath), { recursive: true });
+  const tmp = `${outputPath}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;
+  await fs9.promises.writeFile(tmp, content, "utf-8");
+  await fs9.promises.rename(tmp, outputPath);
+}
+var init_atomicWrite = __esm({
+  "src/utils/atomicWrite.ts"() {
+    "use strict";
+  }
+});
+
+// src/cli/generateZodArtifacts.ts
+import path11 from "path";
+import { existsSync } from "fs";
+async function generateZodArtifacts(sources, options) {
+  const { generateFileSource, resolversByFile, rootDir, dist } = options;
+  if (sources.length === 0) return;
+  const sourcesByFile = /* @__PURE__ */ new Map();
+  for (const source of sources) {
+    let list = sourcesByFile.get(source.filePath);
+    if (!list) {
+      list = [];
+      sourcesByFile.set(source.filePath, list);
+    }
+    list.push(source);
+  }
+  const fileEntries = [];
+  for (const [filePath, fileSources] of sourcesByFile) {
+    const relFile = path11.relative(rootDir, filePath).replace(/\\/g, "/");
+    const outputPath = getSchemaOutputPath(relFile, dist, rootDir);
+    const resolver = resolversByFile.get(filePath);
+    let relForDir = relFile;
+    if (relForDir.startsWith("src/")) {
+      relForDir = relForDir.slice(4);
+    }
+    const dirIdx = relForDir.lastIndexOf("/");
+    const zodRelDir = dirIdx >= 0 ? relForDir.slice(0, dirIdx) : "";
+    const source = generateFileSource(
+      fileSources,
+      (name) => resolver?.resolve(name)?.runtimeType,
+      getHelpersImportPath(zodRelDir)
+    );
+    fileEntries.push({ outputPath, source });
+  }
+  const allSourceCode = fileEntries.map((e) => e.source).join("\n");
+  if (usesCoerceHelpers(allSourceCode)) {
+    const helpersPath = path11.resolve(rootDir, dist, HELPERS_FILENAME);
+    if (!existsSync(helpersPath)) {
+      await atomicWriteFile(helpersPath, generateHelpersFileSource());
+    }
+  }
+  await Promise.all(
+    fileEntries.map(({ outputPath, source }) => atomicWriteFile(outputPath, source))
+  );
+}
+var init_generateZodArtifacts = __esm({
+  "src/cli/generateZodArtifacts.ts"() {
+    "use strict";
+    init_atomicWrite();
+    init_generateZodSchema();
+    init_generateSchemaFiles();
+  }
+});
+
 // src/cli/generateSchemaFiles.ts
 var generateSchemaFiles_exports = {};
 __export(generateSchemaFiles_exports, {
@@ -1588,7 +1641,7 @@ __export(generateSchemaFiles_exports, {
   getRuntimeSchemaPath: () => getRuntimeSchemaPath,
   getSchemaOutputPath: () => getSchemaOutputPath
 });
-import path11 from "path";
+import path12 from "path";
 function getSchemaOutputPath(sourceFile, dist, rootDir) {
   let rel = sourceFile.replace(/\\/g, "/");
   if (rel.startsWith("src/")) {
@@ -1596,7 +1649,7 @@ function getSchemaOutputPath(sourceFile, dist, rootDir) {
   }
   const idx = rel.lastIndexOf("/");
   const relDir = idx >= 0 ? rel.slice(0, idx) : "";
-  return path11.resolve(rootDir, dist, relDir, "zod.js");
+  return path12.resolve(rootDir, dist, relDir, "zod.js");
 }
 function getRuntimeSchemaPath(filePath, dist, rootDir) {
   let rel = filePath.replace(/\\/g, "/");
@@ -1607,7 +1660,7 @@ function getRuntimeSchemaPath(filePath, dist, rootDir) {
   }
   const idx = rel.lastIndexOf("/");
   const relDir = idx >= 0 ? rel.slice(0, idx) : "";
-  return path11.resolve(rootDir, dist, relDir, "zod.js");
+  return path12.resolve(rootDir, dist, relDir, "zod.js");
 }
 function getHelpersImportPath(relDir) {
   if (!relDir) return `./${HELPERS_FILENAME}`;
@@ -1655,52 +1708,19 @@ function generateSchemaFileSource(sources, resolveType, helpersImportPath) {
 async function generateSchemaFiles(routes, rootDir, dist) {
   if (routes.length === 0) return;
   const { sources, resolversByFile } = collectRouteSchemaSources(routes, rootDir);
-  const sourcesByFile = /* @__PURE__ */ new Map();
-  for (const source of sources) {
-    let list = sourcesByFile.get(source.filePath);
-    if (!list) {
-      list = [];
-      sourcesByFile.set(source.filePath, list);
-    }
-    list.push(source);
-  }
-  const fileEntries = [];
-  for (const [filePath, fileSources] of sourcesByFile) {
-    const relFile = path11.relative(rootDir, filePath).replace(/\\/g, "/");
-    const outputPath = getSchemaOutputPath(relFile, dist, rootDir);
-    let relForDir = relFile;
-    if (relForDir.startsWith("src/")) {
-      relForDir = relForDir.slice(4);
-    }
-    const dirIdx = relForDir.lastIndexOf("/");
-    const zodRelDir = dirIdx >= 0 ? relForDir.slice(0, dirIdx) : "";
-    const helpersImportPath = getHelpersImportPath(zodRelDir);
-    const resolver = resolversByFile.get(filePath);
-    const source = generateSchemaFileSource(
-      fileSources,
-      (name) => resolver?.resolve(name)?.runtimeType,
-      helpersImportPath
-    );
-    fileEntries.push({ outputPath, source });
-  }
-  const allSourceCode = fileEntries.map((e) => e.source).join("\n");
-  if (usesCoerceHelpers(allSourceCode)) {
-    const helpersPath = path11.resolve(rootDir, dist, HELPERS_FILENAME);
-    await writeSchemaFile(helpersPath, generateHelpersFileSource());
-  }
-  await Promise.all(
-    fileEntries.map(({ outputPath, source }) => writeSchemaFile(outputPath, source))
-  );
-}
-async function writeSchemaFile(outputPath, source) {
-  await atomicWriteFile(outputPath, source);
+  await generateZodArtifacts(sources, {
+    generateFileSource: generateSchemaFileSource,
+    resolversByFile,
+    rootDir,
+    dist
+  });
 }
 var init_generateSchemaFiles = __esm({
   "src/cli/generateSchemaFiles.ts"() {
     "use strict";
-    init_atomicWrite();
     init_collectRouteSchemaSources();
     init_generateZodSchema();
+    init_generateZodArtifacts();
   }
 });
 
@@ -1945,14 +1965,14 @@ var ValidationError = class extends FaapiError {
   issues;
 };
 var RouteNotFoundError = class extends FaapiError {
-  constructor(path29) {
-    super("ROUTE_NOT_FOUND", `Route not found: ${path29}`, 404);
+  constructor(path31) {
+    super("ROUTE_NOT_FOUND", `Route not found: ${path31}`, 404);
     this.name = "RouteNotFoundError";
   }
 };
 var MethodNotAllowedError = class extends FaapiError {
-  constructor(method, path29, allowedMethods) {
-    super("METHOD_NOT_ALLOWED", `Method ${method} not allowed for ${path29}`, 405);
+  constructor(method, path31, allowedMethods) {
+    super("METHOD_NOT_ALLOWED", `Method ${method} not allowed for ${path31}`, 405);
     this.allowedMethods = allowedMethods;
     this.name = "MethodNotAllowedError";
   }
@@ -2352,15 +2372,19 @@ function createFileLogSink(options) {
     }
     drainWaiters.push(resolve);
   });
-  const close = () => Promise.all(
-    [...streams.values()].map(
+  let closed = false;
+  const close = () => {
+    if (closed) return Promise.resolve();
+    closed = true;
+    const closing = [...streams.values()].map(
       (stream) => new Promise((resolve) => {
         stream.end(() => resolve());
       })
-    )
-  ).then(() => {
+    );
     streams.clear();
-  });
+    return Promise.all(closing).then(() => {
+    });
+  };
   return { write, flush, close };
 }
 
@@ -2692,7 +2716,11 @@ function createTaskQueue(deps) {
       const id = await driver.enqueue(name, data, {
         delayMs: opts?.delayMs,
         retries: meta.retries ?? 0,
-        dedupId: opts?.dedupId
+        dedupId: opts?.dedupId,
+        // 执行硬限预算透传驱动（pgboss 映射 expireInSeconds）：未声明 timeoutMs 时
+        // 两字段为 undefined，驱动用自身兜底
+        timeoutMs: meta.timeoutMs,
+        graceMs: meta.graceMs
       });
       if (!records.has(id)) {
         records.set(id, {
@@ -2841,16 +2869,19 @@ function createCronScheduler(registry, enqueue) {
       this.stop();
       for (const task of registry.list()) {
         if (!task.cron) continue;
+        let pendingSlot = null;
         const schedule = new Cron(task.cron, () => {
-          const runAt = schedule.currentRun();
+          const slot = pendingSlot;
+          pendingSlot = schedule.nextRun();
           void Promise.resolve().then(
             () => enqueue(task.name, {
-              dedupId: runAt ? `cron:${task.name}:${runAt.toISOString()}` : void 0
+              dedupId: slot ? `cron:${task.name}:${slot.toISOString()}` : void 0
             })
           ).catch((err) => {
             console.error(`[faapi] Cron enqueue failed for task "${task.name}":`, err);
           });
         });
+        pendingSlot = schedule.nextRun();
         schedules.push(schedule);
       }
     },
@@ -2975,7 +3006,7 @@ function listSkills() {
 }
 
 // src/loader/loadAgentModule.ts
-import fs11 from "fs";
+import fs12 from "fs";
 
 // src/loader/resolveExports.ts
 function resolveExport(module, exportName) {
@@ -2993,6 +3024,7 @@ function resolveExport(module, exportName) {
 }
 
 // src/utils/importWithCacheBust.ts
+import fs4 from "fs";
 import { pathToFileURL as pathToFileURL2 } from "url";
 var loadTs;
 function setLoadTimestamp(ts11) {
@@ -3003,13 +3035,26 @@ function getVitestImportActual() {
   if (typeof vi?.importActual !== "function") return void 0;
   return vi.importActual.bind(vi);
 }
+var bustCache = /* @__PURE__ */ new Map();
+var bustCounter = 0;
 async function importWithCacheBust(filePath, bustViteCache = false) {
   const importActual = getVitestImportActual();
   if (importActual) {
     if (bustViteCache) {
+      let mtimeMs = 0;
+      try {
+        mtimeMs = fs4.statSync(filePath).mtimeMs;
+      } catch {
+      }
+      const cached = bustCache.get(filePath);
+      if (cached && cached.mtimeMs === mtimeMs) {
+        return cached.module;
+      }
       let url2 = pathToFileURL2(filePath).href;
-      url2 += `?t=${Date.now()}`;
-      return await import(url2);
+      url2 += `?t=${Date.now()}-${++bustCounter}`;
+      const module = await import(url2);
+      bustCache.set(filePath, { mtimeMs, module });
+      return module;
     }
     return await importActual(filePath);
   }
@@ -3021,18 +3066,18 @@ async function importWithCacheBust(filePath, bustViteCache = false) {
 }
 
 // src/cli/compileOnDemand.ts
-import path13 from "path";
-import fs10 from "fs";
+import path14 from "path";
+import fs11 from "fs";
 
 // src/cli/compileSourceFiles.ts
 import path9 from "path";
-import fs7 from "fs";
+import fs8 from "fs";
 import fg2 from "fast-glob";
 
 // src/cli/aliasPlugin.ts
 import ts7 from "typescript";
 import path8 from "path";
-import fs6 from "fs";
+import fs7 from "fs";
 
 // src/utils/resolveAlias.ts
 function resolveAlias(specifier, config) {
@@ -3059,7 +3104,7 @@ function resolveAlias(specifier, config) {
 
 // src/utils/prodPaths.ts
 import path6 from "path";
-import fs4 from "fs";
+import fs5 from "fs";
 var APP_DIR = "src";
 var ROUTE_PATTERNS = ["src/api/**/*.ts"];
 function toProdFilePath(filePath, dist) {
@@ -3078,7 +3123,7 @@ function toProdExtension(filePath) {
 }
 function toRealPath(p) {
   try {
-    return fs4.realpathSync(p);
+    return fs5.realpathSync(p);
   } catch {
     return p;
   }
@@ -3091,14 +3136,14 @@ function isInsideDir(filePath, dir) {
 // src/utils/readTsconfig.ts
 import ts6 from "typescript";
 import path7 from "path";
-import fs5 from "fs";
+import fs6 from "fs";
 var tsconfigCache = /* @__PURE__ */ new Map();
 function readTsconfig(rootDir) {
   const tsconfigPath = path7.resolve(rootDir, "tsconfig.json");
-  if (!fs5.existsSync(tsconfigPath)) return null;
+  if (!fs6.existsSync(tsconfigPath)) return null;
   let mtimeMs;
   try {
-    mtimeMs = fs5.statSync(tsconfigPath).mtimeMs;
+    mtimeMs = fs6.statSync(tsconfigPath).mtimeMs;
   } catch {
     return null;
   }
@@ -3161,25 +3206,25 @@ function resolveRelativeSpecifier(importer, specifier) {
   const importerDir = path8.dirname(importer);
   const base = path8.resolve(importerDir, specifier);
   if (PROD_EXTS.some((ext) => specifier.endsWith(ext))) {
-    if (fs6.existsSync(base)) return base;
+    if (fs7.existsSync(base)) return base;
     if (base.endsWith(".js")) {
       for (const ext of [".ts", ".tsx", ".jsx"]) {
         const file = base.slice(0, -3) + ext;
-        if (fs6.existsSync(file)) return file;
+        if (fs7.existsSync(file)) return file;
       }
     }
     return null;
   }
   if (/\.(ts|tsx|jsx)$/.test(specifier)) {
-    return fs6.existsSync(base) ? base : null;
+    return fs7.existsSync(base) ? base : null;
   }
   for (const ext of SOURCE_EXTS) {
     const file = base + ext;
-    if (fs6.existsSync(file)) return file;
+    if (fs7.existsSync(file)) return file;
   }
   for (const indexExt of INDEX_EXTS) {
     const file = base + indexExt;
-    if (fs6.existsSync(file)) return file;
+    if (fs7.existsSync(file)) return file;
   }
   return null;
 }
@@ -3188,11 +3233,11 @@ function createAliasPlugin(config, options) {
   const probeCandidateFile = (candidate) => {
     for (const ext of SOURCE_EXTS) {
       const file = candidate + ext;
-      if (fs6.existsSync(file)) return file;
+      if (fs7.existsSync(file)) return file;
     }
     for (const indexExt of INDEX_EXTS) {
       const file = candidate + indexExt;
-      if (fs6.existsSync(file)) return file;
+      if (fs7.existsSync(file)) return file;
     }
     return null;
   };
@@ -3202,7 +3247,7 @@ function createAliasPlugin(config, options) {
       build.onLoad({ filter: /\.(ts|tsx|js|jsx|mjs|cjs)$/ }, (args) => {
         let source;
         try {
-          source = fs6.readFileSync(args.path, "utf8");
+          source = fs7.readFileSync(args.path, "utf8");
         } catch {
           return void 0;
         }
@@ -3328,7 +3373,7 @@ async function compileSourceFiles(options) {
     return { compiledFiles: [] };
   }
   const absDist = path9.resolve(rootDir, dist);
-  await fs7.promises.mkdir(absDist, { recursive: true });
+  await fs8.promises.mkdir(absDist, { recursive: true });
   const plugins = buildAliasPlugins(rootDir);
   const esbuild = await import("esbuild");
   const outbase = path9.resolve(rootDir, APP_DIR);
@@ -3351,10 +3396,10 @@ async function compileSourceFiles(options) {
   if (atomicWrite && result.outputFiles) {
     await Promise.all(
       result.outputFiles.map(async (file) => {
-        await fs7.promises.mkdir(path9.dirname(file.path), { recursive: true });
+        await fs8.promises.mkdir(path9.dirname(file.path), { recursive: true });
         const tmp = `${file.path}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;
-        await fs7.promises.writeFile(tmp, file.contents);
-        await fs7.promises.rename(tmp, file.path);
+        await fs8.promises.writeFile(tmp, file.contents);
+        await fs8.promises.rename(tmp, file.path);
       })
     );
   }
@@ -3371,8 +3416,8 @@ init_generateSchemaFiles();
 init_generateSchemaFiles();
 
 // src/cli/collectImports.ts
-import path12 from "path";
-import fs9 from "fs";
+import path13 from "path";
+import fs10 from "fs";
 var SPEC_RE = /(\bfrom\s*|import\s*\(\s*)(['"])([^'"]+)\2/g;
 function extractImportSpecifiers(source) {
   const specifiers = [];
@@ -3384,10 +3429,10 @@ function extractImportSpecifiers(source) {
   return specifiers;
 }
 function resolveSpecifierFromDir(dir, specifier) {
-  return resolveRelativeSpecifier(path12.join(dir, "__faapi_probe__.ts"), specifier);
+  return resolveRelativeSpecifier(path13.join(dir, "__faapi_probe__.ts"), specifier);
 }
 async function collectRelativeImports(entryFiles, rootDir) {
-  const appDirAbs = toRealPath(path12.resolve(rootDir, "src"));
+  const appDirAbs = toRealPath(path13.resolve(rootDir, "src"));
   const tsconfig = readTsconfig(rootDir);
   const visited = /* @__PURE__ */ new Set();
   const insideFiles = /* @__PURE__ */ new Set();
@@ -3397,7 +3442,7 @@ async function collectRelativeImports(entryFiles, rootDir) {
     visited.add(filePath);
     let source;
     try {
-      source = await fs9.promises.readFile(filePath, "utf8");
+      source = await fs10.promises.readFile(filePath, "utf8");
     } catch {
       return;
     }
@@ -3419,7 +3464,7 @@ async function collectRelativeImports(entryFiles, rootDir) {
         resolved = null;
       }
       if (!resolved) continue;
-      if (!isInsideDir(toRealPath(resolved), toRealPath(path12.resolve(rootDir)))) continue;
+      if (!isInsideDir(toRealPath(resolved), toRealPath(path13.resolve(rootDir)))) continue;
       if (isInsideDir(toRealPath(resolved), appDirAbs)) {
         insideFiles.add(resolved);
       } else {
@@ -3440,8 +3485,8 @@ async function collectRelativeImports(entryFiles, rootDir) {
 // src/cli/compileOnDemand.ts
 function isProductFresh(sourceAbsPath, productAbsPath) {
   try {
-    const srcStat = fs10.statSync(sourceAbsPath);
-    const prodStat = fs10.statSync(productAbsPath);
+    const srcStat = fs11.statSync(sourceAbsPath);
+    const prodStat = fs11.statSync(productAbsPath);
     return prodStat.mtimeMs >= srcStat.mtimeMs;
   } catch {
     return false;
@@ -3466,14 +3511,13 @@ function clearCompiledFiles() {
 async function ensureCompiled(sourceAbsPath, rootDir, dist) {
   const inFlight2 = state.inFlightCompilations.get(sourceAbsPath);
   if (inFlight2) {
-    await inFlight2.catch(() => {
-    });
+    await inFlight2;
     return false;
   }
   if (state.compiledFiles.has(sourceAbsPath)) {
     return false;
   }
-  if (!fs10.existsSync(sourceAbsPath)) {
+  if (!fs11.existsSync(sourceAbsPath)) {
     return false;
   }
   const productPath = prodSourcePathToProductPath(sourceAbsPath, rootDir, dist);
@@ -3523,11 +3567,11 @@ async function ensureMiddlewaresCompiled(middlewarePaths, rootDir) {
   }
 }
 function prodSourcePathToProductPath(sourceAbsPath, rootDir, dist) {
-  const rel = path13.relative(rootDir, sourceAbsPath).replace(/\\/g, "/");
+  const rel = path14.relative(rootDir, sourceAbsPath).replace(/\\/g, "/");
   if (!rel.startsWith("src/")) return null;
   const relWithoutSrc = rel.slice(4);
   const jsRel = relWithoutSrc.replace(/\.ts$/, ".js");
-  return path13.resolve(rootDir, dist, jsRel);
+  return path14.resolve(rootDir, dist, jsRel);
 }
 function clearGeneratedSchemas() {
   state.generatedSchemas.clear();
@@ -3536,16 +3580,15 @@ function clearGeneratedSchemas() {
 async function ensureSchemaGenerated(schemaPath, routeFilePath, routes, rootDir, dist) {
   const inFlight2 = state.inFlightSchemaGenerations.get(schemaPath);
   if (inFlight2) {
-    await inFlight2.catch(() => {
-    });
+    await inFlight2;
     return false;
   }
   if (state.generatedSchemas.has(schemaPath)) {
     return false;
   }
-  const prodAbsPath = path13.resolve(rootDir, routeFilePath);
+  const prodAbsPath = path14.resolve(rootDir, routeFilePath);
   const sourceAbsPath = prodPathToSourcePath(prodAbsPath, rootDir, dist);
-  if (!fs10.existsSync(sourceAbsPath)) {
+  if (!fs11.existsSync(sourceAbsPath)) {
     return false;
   }
   if (isProductFresh(sourceAbsPath, schemaPath)) {
@@ -3556,7 +3599,7 @@ async function ensureSchemaGenerated(schemaPath, routeFilePath, routes, rootDir,
   if (fileRoutes.length === 0) {
     return false;
   }
-  const sourceRelPath = path13.relative(rootDir, sourceAbsPath).replace(/\\/g, "/");
+  const sourceRelPath = path14.relative(rootDir, sourceAbsPath).replace(/\\/g, "/");
   const sourceRoutes = fileRoutes.map((r) => ({ ...r, filePath: sourceRelPath }));
   const generatePromise = (async () => {
     await generateSchemaFiles(sourceRoutes, rootDir, dist);
@@ -3577,7 +3620,7 @@ async function deleteSchemaFiles(routes, rootDir, dist) {
     if (deleted.has(schemaPath)) continue;
     deleted.add(schemaPath);
     try {
-      await fs10.promises.unlink(schemaPath);
+      await fs11.promises.unlink(schemaPath);
     } catch {
     }
   }
@@ -3586,19 +3629,19 @@ var sourcePathCache = /* @__PURE__ */ new Map();
 function prodPathToSourcePath(prodAbsPath, rootDir, dist) {
   const cached = sourcePathCache.get(prodAbsPath);
   if (cached) return cached;
-  const rel = path13.relative(rootDir, prodAbsPath).replace(/\\/g, "/");
+  const rel = path14.relative(rootDir, prodAbsPath).replace(/\\/g, "/");
   let relWithoutDist = rel;
   if (relWithoutDist.startsWith(`${dist}/`)) {
     relWithoutDist = relWithoutDist.slice(dist.length + 1);
   }
   const srcRel = `src/${relWithoutDist}`;
   const tsRel = srcRel.replace(/\.js$/, ".ts");
-  const tsAbs = path13.resolve(rootDir, tsRel);
+  const tsAbs = path14.resolve(rootDir, tsRel);
   let result;
-  if (fs10.existsSync(tsAbs)) {
+  if (fs11.existsSync(tsAbs)) {
     result = tsAbs;
   } else {
-    result = path13.resolve(rootDir, srcRel);
+    result = path14.resolve(rootDir, srcRel);
   }
   sourcePathCache.set(prodAbsPath, result);
   return result;
@@ -3616,7 +3659,7 @@ async function loadAgentModule(filePath, hasRun, rootDir) {
     const dist = getDevDist();
     if (dist) {
       const sourcePath = prodPathToSourcePath(filePath, rootDir, dist);
-      if (sourcePath && fs11.existsSync(sourcePath)) {
+      if (sourcePath && fs12.existsSync(sourcePath)) {
         try {
           await ensureCompiled(sourcePath, rootDir, dist);
         } catch (compileErr) {
@@ -3649,13 +3692,13 @@ async function loadAgentModule(filePath, hasRun, rootDir) {
 }
 
 // src/loader/loadToolModule.ts
-import fs12 from "fs";
+import fs13 from "fs";
 async function loadToolModule(filePath, functionName, rootDir) {
   if (isDevOnDemandEnabled() && rootDir) {
     const dist = getDevDist();
     if (dist) {
       const sourcePath = prodPathToSourcePath(filePath, rootDir, dist);
-      if (sourcePath && fs12.existsSync(sourcePath)) {
+      if (sourcePath && fs13.existsSync(sourcePath)) {
         try {
           await ensureCompiled(sourcePath, rootDir, dist);
         } catch (compileErr) {
@@ -3687,8 +3730,8 @@ async function loadToolModule(filePath, functionName, rootDir) {
 import { existsSync as existsSync2 } from "fs";
 
 // src/cli/generateToolArtifacts.ts
-import path14 from "path";
-import { existsSync } from "fs";
+init_generateZodArtifacts();
+import path15 from "path";
 
 // src/ast/extractToolMetadata.ts
 import ts9 from "typescript";
@@ -3777,11 +3820,9 @@ function getFirstParamTypeName(fn, sourceFile) {
 // src/cli/generateToolArtifacts.ts
 init_createProgram();
 init_atomicWrite();
-init_generateSchemaFiles();
 init_extractHandlerTypes();
 init_generateZodSchema();
 init_generateSchemaFiles();
-init_generateSchemaFiles();
 var TOOLS_FILE = "faapi-tools.js";
 function serializeTools(tools, dist = "dist") {
   return tools.map((t) => ({
@@ -3811,7 +3852,7 @@ function collectToolSchemaSources(tools, rootDir) {
   const toolsByFile = /* @__PURE__ */ new Map();
   for (const tool of tools) {
     if (!tool.inputTypeName) continue;
-    const absPath = path14.resolve(rootDir, tool.filePath);
+    const absPath = path15.resolve(rootDir, tool.filePath);
     let list = toolsByFile.get(absPath);
     if (!list) {
       list = [];
@@ -3869,17 +3910,11 @@ function generateToolSchemaFileSource(sources, resolveType, helpersImportPath) {
   lines.push(...schemaBlocks);
   return lines.join("\n").replace(/\n+$/, "\n");
 }
-async function maybeGenerateHelpers(allSourceCode, distDir) {
-  if (!usesCoerceHelpers(allSourceCode)) return;
-  const helpersPath = path14.resolve(distDir, HELPERS_FILENAME);
-  if (existsSync(helpersPath)) return;
-  await atomicWriteFile(helpersPath, generateHelpersFileSource());
-}
 async function generateToolArtifacts(tools, rootDir, dist, options) {
   const metadata = [];
-  const programByFile = createPrograms(tools.map((m) => path14.resolve(rootDir, m.filePath)));
+  const programByFile = createPrograms(tools.map((m) => path15.resolve(rootDir, m.filePath)));
   for (const manifest of tools) {
-    const absPath = path14.resolve(rootDir, manifest.filePath);
+    const absPath = path15.resolve(rootDir, manifest.filePath);
     const program = programByFile.get(absPath);
     const result = extractToolMetadata(program, absPath, manifest.functionName, {
       name: manifest.name,
@@ -3890,7 +3925,7 @@ async function generateToolArtifacts(tools, rootDir, dist, options) {
     }
   }
   const serialized = serializeTools(metadata, dist);
-  const toolsPath = path14.resolve(rootDir, dist, TOOLS_FILE);
+  const toolsPath = path15.resolve(rootDir, dist, TOOLS_FILE);
   await writeToolsModule(serialized, toolsPath);
   if (options?.skipSchema) {
     return metadata;
@@ -3902,45 +3937,14 @@ async function generateToolArtifacts(tools, rootDir, dist, options) {
   if (sources.length === 0) {
     return metadata;
   }
-  const sourcesByFile = /* @__PURE__ */ new Map();
-  for (const source of sources) {
-    let list = sourcesByFile.get(source.filePath);
-    if (!list) {
-      list = [];
-      sourcesByFile.set(source.filePath, list);
-    }
-    list.push(source);
-  }
-  const fileEntries = [];
-  for (const [filePath, fileSources] of sourcesByFile) {
-    const relFile = path14.relative(rootDir, filePath).replace(/\\/g, "/");
-    const outputPath = getSchemaOutputPath(relFile, dist, rootDir);
-    const resolver = resolversByFile.get(filePath);
-    let relForDir = relFile;
-    if (relForDir.startsWith("src/")) {
-      relForDir = relForDir.slice(4);
-    }
-    const dirIdx = relForDir.lastIndexOf("/");
-    const zodRelDir = dirIdx >= 0 ? relForDir.slice(0, dirIdx) : "";
-    const helpersImportPath = getHelpersImportPath(zodRelDir);
-    const source = generateToolSchemaFileSource(
-      fileSources,
-      (name) => resolver?.resolve(name)?.runtimeType,
-      helpersImportPath
-    );
-    fileEntries.push({ outputPath, source });
-  }
-  const allSourceCode = fileEntries.map((e) => e.source).join("\n");
-  const distDir = path14.resolve(rootDir, dist);
-  await maybeGenerateHelpers(allSourceCode, distDir);
-  await Promise.all(
-    fileEntries.map(({ outputPath, source }) => writeToolSchemaFile(outputPath, source))
-  );
+  await generateZodArtifacts(sources, {
+    generateFileSource: generateToolSchemaFileSource,
+    resolversByFile,
+    rootDir,
+    dist
+  });
   return metadata;
 }
-async function writeToolSchemaFile(outputPath, source) {
-  await atomicWriteFile(outputPath, source);
-}
 
 // src/loader/loadToolSchema.ts
 function getDist() {
@@ -3979,6 +3983,20 @@ function clearAgentHandleFactory() {
   defaultRegistries.agentHandle.clear();
 }
 
+// src/middleware/mergeVary.ts
+function mergeVary(meta, value) {
+  const existing = meta.headers["Vary"] ?? meta.headers["vary"];
+  if (!existing) {
+    meta.headers["Vary"] = value;
+    return;
+  }
+  const segments = existing.split(",").map((s) => s.trim().toLowerCase());
+  if (!segments.includes(value.toLowerCase())) {
+    const key = meta.headers["Vary"] !== void 0 ? "Vary" : "vary";
+    meta.headers[key] = `${existing}, ${value}`;
+  }
+}
+
 // src/middleware/cors.ts
 var DEFAULT_METHODS = ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"];
 function cors(options = {}) {
@@ -3991,6 +4009,7 @@ function cors(options = {}) {
     maxAge
   } = options;
   return async (ctx, next) => {
+    const meta = ctx.meta;
     const reqOrigin = ctx.headers.get("origin");
     if (!reqOrigin) {
       await next();
@@ -4005,14 +4024,7 @@ function cors(options = {}) {
       allowOrigin = origin.includes(reqOrigin) ? reqOrigin : null;
     }
     if (origin === true || Array.isArray(origin)) {
-      const existingVary = ctx.headers.get("vary");
-      if (existingVary) {
-        if (!existingVary.toLowerCase().includes("origin")) {
-          ctx.setHeader("Vary", `${existingVary}, Origin`);
-        }
-      } else {
-        ctx.setHeader("Vary", "Origin");
-      }
+      mergeVary(meta, "Origin");
     }
     if (!allowOrigin) {
       await next();
@@ -4157,16 +4169,16 @@ function helmet(options = {}) {
 }
 
 // src/config/loadConfig.ts
-import path15 from "path";
-import fs13 from "fs";
+import path16 from "path";
+import fs14 from "fs";
 var CONFIG_PRODUCT_FILE = "faapi-config.js";
 async function loadConfig(rootDir, dist) {
-  const configProductPath = path15.resolve(rootDir, dist, CONFIG_PRODUCT_FILE);
-  if (fs13.existsSync(configProductPath)) {
+  const configProductPath = path16.resolve(rootDir, dist, CONFIG_PRODUCT_FILE);
+  if (fs14.existsSync(configProductPath)) {
     const module = await importWithCacheBust(configProductPath);
     return module.default ?? {};
   }
-  const hasSourceConfig = fs13.existsSync(path15.join(rootDir, "faapi.config.ts")) || fs13.existsSync(path15.join(rootDir, "faapi.config.js"));
+  const hasSourceConfig = fs14.existsSync(path16.join(rootDir, "faapi.config.ts")) || fs14.existsSync(path16.join(rootDir, "faapi.config.js"));
   if (hasSourceConfig) {
     throw new Error(
       `[faapi] ${dist}/${CONFIG_PRODUCT_FILE} \u4E0D\u5B58\u5728\uFF0C\u8BF7\u5148\u6267\u884C \`faapi build\`\uFF08\u6216 \`faapi dev\`\uFF09\u751F\u6210\u4EA7\u7269\u3002`
@@ -4176,8 +4188,8 @@ async function loadConfig(rootDir, dist) {
 }
 
 // src/cli/loadEnv.ts
-import fs14 from "fs";
-import path16 from "path";
+import fs15 from "fs";
+import path17 from "path";
 function resolveEnv() {
   return process.env.NODE_ENV || "development";
 }
@@ -4244,9 +4256,9 @@ function loadEnv(rootDir) {
   const files = getEnvFiles(env);
   const merged = {};
   for (const file of files) {
-    const filePath = path16.join(rootDir, file);
-    if (!fs14.existsSync(filePath)) continue;
-    const content = fs14.readFileSync(filePath, "utf-8");
+    const filePath = path17.join(rootDir, file);
+    if (!fs15.existsSync(filePath)) continue;
+    const content = fs15.readFileSync(filePath, "utf-8");
     const parsed = parseEnvFile(content, merged);
     Object.assign(merged, parsed);
   }
@@ -4258,9 +4270,8 @@ function loadEnv(rootDir) {
 }
 
 // src/cli/createAppCore.ts
-import fs19 from "fs";
-import path24 from "path";
-import { PassThrough, Readable as Readable3 } from "stream";
+import fs21 from "fs";
+import path26 from "path";
 
 // src/router/sortRoutes.ts
 function sortRoutes(routes) {
@@ -4304,6 +4315,18 @@ function detectRouteConflicts(routes) {
   }
   return conflicts;
 }
+function reportRouteConflicts(routes) {
+  const conflicts = detectRouteConflicts(routes);
+  if (conflicts.length === 0) return false;
+  console.warn("! \u8DEF\u7531\u51B2\u7A81:");
+  for (const conflict of conflicts) {
+    console.warn(`  ${conflict.method} ${conflict.urlPath}`);
+    for (const file of conflict.files) {
+      console.warn(`    - ${file}`);
+    }
+  }
+  return true;
+}
 
 // src/server/createServer.ts
 import {
@@ -4312,7 +4335,7 @@ import {
 import { createSecureServer as createHttp2SecureServer } from "http2";
 import { readFileSync } from "fs";
 import { Readable as Readable2 } from "stream";
-import path18 from "path";
+import path19 from "path";
 
 // src/router/matchRoute.ts
 var httpIndexCache = /* @__PURE__ */ new WeakMap();
@@ -4354,65 +4377,72 @@ function getWsIndex(routes) {
   wsIndexCache.set(routes, index);
   return index;
 }
-function matchRoute(routes, method, path29) {
+function matchRoute(routes, method, path31) {
   const index = getHttpIndex(routes);
   const upper = method.toUpperCase();
-  const hit = matchByMethod(index, upper, path29);
+  const hit = matchByMethod(index, upper, path31);
   if (hit) return hit;
   if (upper === "HEAD") {
-    return matchByMethod(index, "GET", path29);
+    return matchByMethod(index, "GET", path31);
   }
   return null;
 }
-function matchByMethod(index, method, path29) {
-  const staticHit = index.static.get(`${method}|${path29}`);
+function matchByMethod(index, method, path31) {
+  const staticHit = index.static.get(`${method}|${path31}`);
   if (staticHit) {
     return { route: staticHit, params: {} };
   }
+  if (index.dynamics.length === 0) {
+    return null;
+  }
+  const pathSegments = path31.split("/").filter(Boolean);
   for (const entry of index.dynamics) {
     const route = entry.route;
     if (route.method !== method) {
       continue;
     }
-    const params = matchSegments(entry.segments, path29, route.paramNames, route.isCatchAll);
+    const params = matchSegments(entry.segments, pathSegments, route.paramNames, route.isCatchAll);
     if (params !== null) {
       return { route, params };
     }
   }
   return null;
 }
-function matchWsRoute(wsRoutes, path29) {
+function matchWsRoute(wsRoutes, path31) {
   const index = getWsIndex(wsRoutes);
-  const staticHit = index.static.get(path29);
+  const staticHit = index.static.get(path31);
   if (staticHit) {
     return { route: staticHit, params: {} };
   }
   for (const route of index.dynamics) {
-    const params = matchDynamicPath(route.urlPath, path29, route.paramNames, route.isCatchAll);
+    const params = matchDynamicPath(route.urlPath, path31, route.paramNames, route.isCatchAll);
     if (params !== null) {
       return { route, params };
     }
   }
   return null;
 }
-function findAllowedMethods(routes, path29) {
+function findAllowedMethods(routes, path31) {
   const index = getHttpIndex(routes);
   const methods = /* @__PURE__ */ new Set();
-  const staticMethods = index.methodsByStaticPath.get(path29);
+  const staticMethods = index.methodsByStaticPath.get(path31);
   if (staticMethods) {
     for (const method of staticMethods) {
       methods.add(method);
     }
   }
-  for (const entry of index.dynamics) {
-    const params = matchSegments(
-      entry.segments,
-      path29,
-      entry.route.paramNames,
-      entry.route.isCatchAll
-    );
-    if (params !== null) {
-      methods.add(entry.route.method);
+  if (index.dynamics.length > 0) {
+    const pathSegments = path31.split("/").filter(Boolean);
+    for (const entry of index.dynamics) {
+      const params = matchSegments(
+        entry.segments,
+        pathSegments,
+        entry.route.paramNames,
+        entry.route.isCatchAll
+      );
+      if (params !== null) {
+        methods.add(entry.route.method);
+      }
     }
   }
   if (methods.has("GET")) {
@@ -4420,11 +4450,15 @@ function findAllowedMethods(routes, path29) {
   }
   return Array.from(methods);
 }
-function matchDynamicPath(pattern, path29, paramNames, isCatchAll) {
-  return matchSegments(pattern.split("/").filter(Boolean), path29, paramNames, isCatchAll);
+function matchDynamicPath(pattern, path31, paramNames, isCatchAll) {
+  return matchSegments(
+    pattern.split("/").filter(Boolean),
+    path31.split("/").filter(Boolean),
+    paramNames,
+    isCatchAll
+  );
 }
-function matchSegments(patternSegments, path29, paramNames, isCatchAll) {
-  const pathSegments = path29.split("/").filter(Boolean);
+function matchSegments(patternSegments, pathSegments, paramNames, isCatchAll) {
   if (isCatchAll) {
     const nonCatchAllCount = patternSegments.length - 1;
     if (pathSegments.length <= nonCatchAllCount) {
@@ -4508,6 +4542,15 @@ async function loadRouteModule(filePath, method, rootDir) {
   return { handler, method };
 }
 
+// src/response/bufferedBody.ts
+var bufferedBodyResponses = /* @__PURE__ */ new WeakSet();
+function markBufferedBody(response) {
+  bufferedBodyResponses.add(response);
+}
+function hasBufferedBody(response) {
+  return bufferedBodyResponses.has(response);
+}
+
 // src/utils/isPlainObject.ts
 function isPlainObject(value) {
   if (value === null || typeof value !== "object") {
@@ -4522,8 +4565,50 @@ function isPlainObject(value) {
 
 // src/utils/stringifyJson.ts
 function stringifyJson(value) {
+  if (!needsConversion(value, /* @__PURE__ */ new Set())) {
+    return JSON.stringify(value);
+  }
   return JSON.stringify(convertValue(value, /* @__PURE__ */ new Set()));
 }
+function needsConversion(value, ancestors) {
+  if (value === null) return false;
+  const type = typeof value;
+  if (type === "bigint") return true;
+  if (type === "number") return !Number.isFinite(value);
+  if (type !== "object") return false;
+  const obj = value;
+  if (ancestors.has(obj)) {
+    throw new TypeError("[faapi] Converting circular structure to JSON");
+  }
+  if (obj instanceof Date || obj instanceof Map || obj instanceof Set || obj instanceof RegExp) {
+    return true;
+  }
+  if (typeof obj.toJSON === "function") return true;
+  if (Array.isArray(obj)) {
+    ancestors.add(obj);
+    for (let i = 0; i < obj.length; i++) {
+      if (needsConversion(obj[i], ancestors)) {
+        ancestors.delete(obj);
+        return true;
+      }
+    }
+    ancestors.delete(obj);
+    return false;
+  }
+  if (isPlainObject(obj)) {
+    ancestors.add(obj);
+    for (const key in obj) {
+      if (!Object.prototype.hasOwnProperty.call(obj, key)) continue;
+      if (needsConversion(obj[key], ancestors)) {
+        ancestors.delete(obj);
+        return true;
+      }
+    }
+    ancestors.delete(obj);
+    return false;
+  }
+  return false;
+}
 function convertValue(value, ancestors) {
   if (value === null) return value;
   const type = typeof value;
@@ -4618,16 +4703,30 @@ function createSseWriter() {
   let controller = null;
   let closed = false;
   let aborted = false;
-  const stream = new ReadableStream({
-    start(c) {
-      controller = c;
+  let drainWaiters = [];
+  const resolveDrainWaiters = () => {
+    const waiters = drainWaiters;
+    drainWaiters = [];
+    for (const resolve of waiters) resolve();
+  };
+  const stream = new ReadableStream(
+    {
+      start(c) {
+        controller = c;
+      },
+      // 消费者排空缓冲后再要数据 → 背压解除，唤醒 waitForDrain 等待方
+      pull() {
+        resolveDrainWaiters();
+      },
+      cancel() {
+        aborted = true;
+        closed = true;
+        controller = null;
+        resolveDrainWaiters();
+      }
     },
-    cancel() {
-      aborted = true;
-      closed = true;
-      controller = null;
-    }
-  });
+    { highWaterMark: 16 }
+  );
   const response = new Response(stream, {
     status: 200,
     headers: {
@@ -4662,6 +4761,7 @@ function createSseWriter() {
     close() {
       if (closed) return;
       closed = true;
+      resolveDrainWaiters();
       if (controller) {
         try {
           controller.close();
@@ -4673,8 +4773,18 @@ function createSseWriter() {
     get closed() {
       return closed;
     },
-    get aborted() {
-      return aborted;
+    get desiredSize() {
+      return controller ? controller.desiredSize : null;
+    },
+    waitForDrain() {
+      if (closed || !controller) return Promise.resolve();
+      if ((controller.desiredSize ?? 0) > 0) return Promise.resolve();
+      return new Promise((resolve) => {
+        drainWaiters.push(resolve);
+      });
+    },
+    get aborted() {
+      return aborted;
     },
     get response() {
       return response;
@@ -4710,7 +4820,9 @@ function jsonRaw(body, status, extraHeaders) {
     const extra = new Headers(extraHeaders);
     extra.forEach((value, key) => headers.set(key, value));
   }
-  return new Response(stringifyJson(body), { status, headers });
+  const response = new Response(stringifyJson(body), { status, headers });
+  markBufferedBody(response);
+  return response;
 }
 function wrapOkResult(result, config) {
   if (result instanceof Response) return result;
@@ -4727,12 +4839,9 @@ function formatFailResponse(options, config) {
 }
 function formatErrorResponse(error, config) {
   const failFn = resolveFailFn(config);
+  const buildFailBody = (e) => failFn({ status: e.statusCode, code: e.code, message: e.message });
   if (error instanceof ValidationError) {
-    const body2 = failFn({
-      status: error.statusCode,
-      code: error.code,
-      message: error.message
-    });
+    const body2 = buildFailBody(error);
     const bodyObj = typeof body2 === "object" && body2 !== null ? { ...body2 } : { error: body2 };
     const existingError = bodyObj.error;
     if (existingError && typeof existingError === "object") {
@@ -4745,28 +4854,15 @@ function formatErrorResponse(error, config) {
     return jsonOk(bodyObj, error.statusCode);
   }
   if (error instanceof MethodNotAllowedError) {
-    const body2 = failFn({
-      status: error.statusCode,
-      code: error.code,
-      message: error.message
+    return jsonOk(buildFailBody(error), error.statusCode, {
+      Allow: error.allowedMethods.join(", ")
     });
-    return jsonOk(body2, error.statusCode, { Allow: error.allowedMethods.join(", ") });
   }
   if (error instanceof PayloadTooLargeError) {
-    const body2 = failFn({
-      status: error.statusCode,
-      code: error.code,
-      message: error.message
-    });
-    return jsonOk(body2, error.statusCode);
+    return jsonOk(buildFailBody(error), error.statusCode);
   }
   if (error instanceof FaapiError) {
-    const body2 = failFn({
-      status: error.statusCode,
-      code: error.code,
-      message: error.message
-    });
-    return jsonOk(body2, error.statusCode);
+    return jsonOk(buildFailBody(error), error.statusCode);
   }
   const message = error instanceof Error ? error.message : "An unknown error occurred";
   const body = failFn({ status: 500, code: "INTERNAL_ERROR", message });
@@ -4851,10 +4947,12 @@ function createContextFromUrl(request, url, params, config = {}, ip = "", regist
     },
     html(html, status) {
       const headers = { "Content-Type": "text/html; charset=utf-8" };
-      return new Response(html, {
+      const response = new Response(html, {
         status: status ?? 200,
         headers
       });
+      markBufferedBody(response);
+      return response;
     },
     getCookie(name) {
       return parsedCookies.get(name);
@@ -4921,7 +5019,10 @@ function createContextFromUrl(request, url, params, config = {}, ip = "", regist
 }
 
 // src/utils/queryToObject.ts
+var queryCache = /* @__PURE__ */ new WeakMap();
 function queryToObject(params) {
+  const cached = queryCache.get(params);
+  if (cached) return cached;
   const result = {};
   for (const [key, value] of params) {
     const existing = result[key];
@@ -4933,6 +5034,7 @@ function queryToObject(params) {
       result[key] = [existing, value];
     }
   }
+  queryCache.set(params, result);
   return result;
 }
 
@@ -5101,51 +5203,67 @@ async function toResponse(value, meta) {
   if (typeof Buffer !== "undefined" && Buffer.isBuffer(value)) {
     const headers2 = new Headers({ "Content-Type": "application/octet-stream" });
     applyMeta(headers2);
-    return new Response(value, {
-      status: meta?.status ?? 200,
-      headers: headers2
-    });
+    return markBuffered(
+      new Response(value, {
+        status: meta?.status ?? 200,
+        headers: headers2
+      })
+    );
   }
   if (value instanceof Uint8Array) {
     const headers2 = new Headers({ "Content-Type": "application/octet-stream" });
     applyMeta(headers2);
-    return new Response(value, {
-      status: meta?.status ?? 200,
-      headers: headers2
-    });
+    return markBuffered(
+      new Response(value, {
+        status: meta?.status ?? 200,
+        headers: headers2
+      })
+    );
   }
   if (isPlainObject(value) || Array.isArray(value)) {
     const body2 = stringifyJson(value);
     const headers2 = new Headers({ "Content-Type": "application/json" });
     applyMeta(headers2);
-    return new Response(body2, {
-      status: meta?.status ?? 200,
-      headers: headers2
-    });
+    return markBuffered(
+      new Response(body2, {
+        status: meta?.status ?? 200,
+        headers: headers2
+      })
+    );
   }
   if (typeof value === "string") {
     const headers2 = new Headers({ "Content-Type": "text/plain" });
     applyMeta(headers2);
-    return new Response(value, {
-      status: meta?.status ?? 200,
-      headers: headers2
-    });
+    return markBuffered(
+      new Response(value, {
+        status: meta?.status ?? 200,
+        headers: headers2
+      })
+    );
   }
   if (typeof value === "number" || typeof value === "boolean") {
     const headers2 = new Headers({ "Content-Type": "text/plain" });
     applyMeta(headers2);
-    return new Response(String(value), {
-      status: meta?.status ?? 200,
-      headers: headers2
-    });
+    return markBuffered(
+      new Response(String(value), {
+        status: meta?.status ?? 200,
+        headers: headers2
+      })
+    );
   }
   const body = stringifyJson(value);
   const headers = new Headers({ "Content-Type": "application/json" });
   applyMeta(headers);
-  return new Response(body, {
-    status: meta?.status ?? 200,
-    headers
-  });
+  return markBuffered(
+    new Response(body, {
+      status: meta?.status ?? 200,
+      headers
+    })
+  );
+}
+function markBuffered(response) {
+  markBufferedBody(response);
+  return response;
 }
 
 // src/injection/injectParams.ts
@@ -5285,18 +5403,7 @@ async function invokeHandler(handler, ctx, body, middlewares, injectors) {
       sseWriter.close();
     }
   };
-  if (!middlewares || middlewares.length === 0) {
-    try {
-      const result = await injectParamsAsync(handler, ctx, body, injectors);
-      const sseResponse = pickSseAndAutoClose();
-      if (sseResponse) return sseResponse;
-      return toResponse(wrapResult(result, ctx), meta);
-    } catch (err) {
-      autoCloseSseOnError();
-      throw err;
-    }
-  }
-  const finalHandler = async () => {
+  const executeAndFormat = async () => {
     try {
       const result = await injectParamsAsync(handler, ctx, body, injectors);
       const sseResponse = pickSseAndAutoClose();
@@ -5307,6 +5414,10 @@ async function invokeHandler(handler, ctx, body, middlewares, injectors) {
       throw err;
     }
   };
+  if (!middlewares || middlewares.length === 0) {
+    return executeAndFormat();
+  }
+  const finalHandler = executeAndFormat;
   return await compose(middlewares, ctx, finalHandler);
 }
 
@@ -5328,6 +5439,20 @@ async function sendNodeResponse(response, res) {
     }
   }
   if (response.body) {
+    if (hasBufferedBody(response)) {
+      const buffer = await readBufferedBody(response.body);
+      await new Promise((resolve) => {
+        res.on("close", () => {
+          if (!res.writableEnded) res.destroy();
+        });
+        if (res.destroyed) {
+          resolve();
+          return;
+        }
+        res.end(buffer, () => resolve());
+      });
+      return;
+    }
     const nodeStream = Readable.fromWeb(response.body);
     await new Promise((resolve, reject) => {
       nodeStream.on("error", reject);
@@ -5346,6 +5471,25 @@ async function sendNodeResponse(response, res) {
   }
   res.end();
 }
+async function readBufferedBody(body) {
+  const reader = body.getReader();
+  const chunks = [];
+  try {
+    for (; ; ) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      chunks.push(value);
+    }
+  } finally {
+    try {
+      reader.releaseLock();
+    } catch {
+    }
+  }
+  if (chunks.length === 0) return new Uint8Array(0);
+  if (chunks.length === 1) return chunks[0];
+  return Buffer.concat(chunks);
+}
 
 // src/validator/validateInput.ts
 init_schemaName();
@@ -5389,9 +5533,9 @@ async function validateInput(schemaPath, method, inputType, input) {
 function mapZodIssues(error) {
   return error.issues.map((issue) => {
     const code = mapZodCode(issue);
-    const path29 = issue.path.map(String).join(".") || "";
+    const path31 = issue.path.map(String).join(".") || "";
     return {
-      path: path29,
+      path: path31,
       code,
       expected: issue.expected ?? mapExpectedFromMessage(issue.message),
       received: issue.received ?? mapReceivedFromMessage(issue.message),
@@ -5513,17 +5657,6 @@ async function compressBody(encoding, body) {
       return deflateAsync(buf);
   }
 }
-function mergeVary(meta, value) {
-  const existing = meta.headers["Vary"] ?? meta.headers["vary"];
-  if (!existing) {
-    meta.headers["Vary"] = value;
-    return;
-  }
-  if (!existing.toLowerCase().includes(value.toLowerCase())) {
-    const key = meta.headers["Vary"] !== void 0 ? "Vary" : "vary";
-    meta.headers[key] = `${existing}, ${value}`;
-  }
-}
 function compression(options = {}) {
   const threshold = options.threshold ?? DEFAULT_THRESHOLD;
   return async (ctx, next) => {
@@ -5623,9 +5756,9 @@ function etag(options = {}) {
 }
 
 // src/server/handleWsUpgrade.ts
-import fs15 from "fs";
+import fs16 from "fs";
 import { WebSocketServer, WebSocket } from "ws";
-import path17 from "path";
+import path18 from "path";
 
 // src/server/serverUtils.ts
 function nodeHttpToWebHeaders(req) {
@@ -5644,13 +5777,15 @@ function buildErrorResponse(err, config) {
   try {
     return formatErrorResponse(err, config);
   } catch {
-    return new Response(
+    const fallback = new Response(
       JSON.stringify({ error: { code: "INTERNAL_ERROR", message: "Internal Server Error" } }),
       {
         status: 500,
         headers: { "Content-Type": "application/json" }
       }
     );
+    markBufferedBody(fallback);
+    return fallback;
   }
 }
 
@@ -5760,7 +5895,7 @@ async function loadWsHandler(filePath, ctx, rootDir) {
     const dist = getDevDist();
     if (dist) {
       const sourcePath = prodPathToSourcePath(filePath, rootDir, dist);
-      if (sourcePath && fs15.existsSync(sourcePath)) {
+      if (sourcePath && fs16.existsSync(sourcePath)) {
         await ensureCompiled(sourcePath, rootDir, dist);
       }
     }
@@ -5775,27 +5910,47 @@ async function loadWsHandler(filePath, ctx, rootDir) {
 function bindEvents(rawSocket, handlers) {
   if (!handlers) return;
   const ws = wrapWsSocket(rawSocket);
+  const guard = (event, fn) => {
+    try {
+      fn();
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      if (handlers.onError) {
+        try {
+          handlers.onError(ws, error);
+        } catch (hookErr) {
+          console.error(`[faapi] WS onError \u56DE\u8C03\u629B\u9519 (after ${event}):`, hookErr);
+        }
+      } else {
+        console.error(`[faapi] WS ${event} \u56DE\u8C03\u629B\u9519:`, error);
+      }
+    }
+  };
   if (handlers.onOpen) {
     if (rawSocket.readyState === WebSocket.OPEN) {
-      handlers.onOpen(ws);
+      guard("onOpen", () => handlers.onOpen(ws));
     } else {
-      rawSocket.once("open", () => handlers.onOpen(ws));
+      rawSocket.once("open", () => guard("onOpen", () => handlers.onOpen(ws)));
     }
   }
   if (handlers.onMessage) {
     rawSocket.on("message", (data, isBinary) => {
       const buf = toWsBuffer(data);
-      handlers.onMessage(ws, isBinary ? buf : buf.toString("utf8"));
+      guard("onMessage", () => handlers.onMessage(ws, isBinary ? buf : buf.toString("utf8")));
     });
   }
   if (handlers.onClose) {
     rawSocket.on("close", (code, reason) => {
-      handlers.onClose(ws, code, reason.toString("utf8"));
+      guard("onClose", () => handlers.onClose(ws, code, reason.toString("utf8")));
     });
   }
   if (handlers.onError) {
     rawSocket.on("error", (err) => {
-      handlers.onError(ws, err);
+      try {
+        handlers.onError(ws, err);
+      } catch (hookErr) {
+        console.error("[faapi] WS onError \u56DE\u8C03\u629B\u9519 (after onError):", hookErr);
+      }
     });
   }
 }
@@ -5874,7 +6029,7 @@ function attachWebSocket(options) {
     const finalHandler = async () => {
       let handlers;
       try {
-        const absoluteFilePath = path17.resolve(rootDir, route.filePath);
+        const absoluteFilePath = path18.resolve(rootDir, route.filePath);
         handlers = await loadWsHandler(absoluteFilePath, ctx, rootDir);
       } catch (err) {
         const reason = err instanceof Error ? err.message : String(err);
@@ -6080,9 +6235,17 @@ function createServer(options) {
       bodyLimit,
       trustedProxy,
       registries
-    ).catch(() => {
-      res.statusCode = 500;
-      res.end();
+    ).catch((err) => {
+      console.error("[faapi] Request pipeline failed after error response attempt:", err);
+      try {
+        if (!res.headersSent) {
+          res.statusCode = 500;
+          res.end();
+        } else if (!res.writableEnded) {
+          res.end();
+        }
+      } catch {
+      }
     });
   });
   attachWebSocket({
@@ -6125,13 +6288,14 @@ function getRoutePaths(route, rootDir, dist) {
   let cached = routePathCache.get(route);
   if (!cached) {
     cached = {
-      absFilePath: path18.resolve(rootDir, route.filePath),
+      absFilePath: path19.resolve(rootDir, route.filePath),
       schemaPath: getRuntimeSchemaPath(route.filePath, dist, rootDir)
     };
     routePathCache.set(route, cached);
   }
   return cached;
 }
+var mergedInjectorsCache = /* @__PURE__ */ new WeakMap();
 function createRoutePipeline(opts) {
   const { routes, method, urlPath, url, ctx, request, rootDir, dist, globalInjectors } = opts;
   return async () => {
@@ -6164,7 +6328,15 @@ function createRoutePipeline(opts) {
         route.injectors = {};
       }
     }
-    const mergedInjectors = globalInjectors ? { ...globalInjectors, ...route.injectors } : route.injectors;
+    let mergedInjectors = route.injectors;
+    if (globalInjectors) {
+      let merged = mergedInjectorsCache.get(route);
+      if (!merged) {
+        merged = { ...globalInjectors, ...route.injectors };
+        mergedInjectorsCache.set(route, merged);
+      }
+      mergedInjectors = merged;
+    }
     return await invokeHandler(routeModule.handler, ctx, body, route.middlewares, mergedInjectors);
   };
 }
@@ -6214,6 +6386,10 @@ async function handleRequest(routes, rootDir, dist, req, res, outerMiddlewares,
     await sendSuccessResponse(response, res);
   } catch (err) {
     if (res.destroyed || res.writableEnded) return;
+    if (err instanceof PayloadTooLargeError) {
+      res.setHeader("Connection", "close");
+      res.once("finish", () => req.destroy());
+    }
     await sendErrorResponse(err, meta, res, onError, ctx);
   }
 }
@@ -6247,8 +6423,8 @@ function applyPluginWrappers(server, handlerWrappers, upgradeWrappers) {
 }
 
 // src/cli/generateRoutes.ts
-import fs16 from "fs";
-import path19 from "path";
+import fs17 from "fs";
+import path20 from "path";
 async function hydrateRoutes(manifest) {
   const hydrateRoute = (serialized) => ({
     method: serialized.method,
@@ -6272,102 +6448,306 @@ async function hydrateRoutes(manifest) {
   return { routes, wsRoutes };
 }
 
-// src/cli/generateAgentArtifacts.ts
-import path20 from "path";
-
-// src/ast/extractAgentMetadata.ts
-import ts10 from "typescript";
-init_resolveTypeNode();
-function extractAgentMetadata(program, filePath, pathMeta) {
-  const sourceFile = program.getSourceFile(filePath);
-  if (!sourceFile) return null;
-  const configFound = findConfigExport(sourceFile);
-  if (!configFound) {
-    throw SchemaExtractionError.at(
-      sourceFile,
-      "config.systemPrompt",
-      "agent \u5FC5\u586B\u2014\u2014\u8BF7\u5728 config \u5757\u58F0\u660E\u7CFB\u7EDF\u63D0\u793A\u8BCD\uFF08\u5B57\u7B26\u4E32\u5B57\u9762\u91CF\u3001\u65E0\u63D2\u503C\u6A21\u677F\u5B57\u7B26\u4E32\u6216\u5176 + \u62FC\u63A5\uFF09",
-      sourceFile
-    );
-  }
-  if (!configFound.objectLiteral) {
-    throw SchemaExtractionError.at(
-      configFound.jsDocOwner,
-      "config",
-      "\u4EC5\u652F\u6301\u5BF9\u8C61\u5B57\u9762\u91CF\u3001\u7BAD\u5934\u51FD\u6570\u8FD4\u56DE\u5BF9\u8C61\u5B57\u9762\u91CF\u6216\u51FD\u6570\u8FD4\u56DE\u5BF9\u8C61\u5B57\u9762\u91CF",
-      sourceFile
-    );
-  }
-  const objectLiteral = configFound.objectLiteral;
-  const jsDoc = getJSDocFromNode(configFound.jsDocOwner);
-  const description = extractDescription(jsDoc);
-  const agentNameOverride = extractJSDocTagValue(jsDoc, "agent");
-  const { systemPrompt, tools, agents, model, maxTurns, inputDescription } = extractConfigFields(
-    objectLiteral,
-    sourceFile
-  );
+// src/task/idleTaskDriver.ts
+function createIdleTaskDriver() {
   return {
-    name: agentNameOverride ?? pathMeta.name,
-    description,
-    filePath: pathMeta.filePath,
-    hasRun: pathMeta.hasRun,
-    systemPrompt,
-    tools,
-    agents,
-    model,
-    maxTurns,
-    inputDescription
+    enqueue() {
+      return Promise.reject(
+        new Error(
+          "[faapi] New task(s) were registered without a queue driver. Set config.task.driver to 'pgboss' or 'bullmq' (install the matching @faapi/task-* package) and restart the server."
+        )
+      );
+    },
+    startWorker() {
+    },
+    async stop() {
+    },
+    async stopWorkers() {
+    }
   };
 }
-function findConfigExport(sourceFile) {
-  let result = null;
-  ts10.forEachChild(sourceFile, (node) => {
-    if (result) return;
-    if (ts10.isVariableStatement(node) && hasExportModifier(node)) {
-      for (const decl of node.declarationList.declarations) {
-        if (result) break;
-        const nameText = ts10.isIdentifier(decl.name) ? decl.name.text : "";
-        if (nameText !== "config" || !decl.initializer) continue;
-        if (ts10.isObjectLiteralExpression(decl.initializer)) {
-          result = { jsDocOwner: node, objectLiteral: decl.initializer };
-        } else if (ts10.isArrowFunction(decl.initializer)) {
-          result = { jsDocOwner: node, objectLiteral: getReturnObjectLiteral(decl.initializer) };
-        } else {
-          result = { jsDocOwner: node, objectLiteral: null };
-        }
-      }
-    }
-    if (ts10.isFunctionDeclaration(node) && hasExportModifier(node) && node.name?.text === "config") {
-      const returnObj = getReturnObjectLiteral(node);
-      result = { jsDocOwner: node, objectLiteral: returnObj };
-    }
+
+// src/cli/loadPlugins.ts
+import path22 from "path";
+import fs19 from "fs";
+import { pathToFileURL as pathToFileURL3 } from "url";
+
+// src/cli/compileConfig.ts
+import path21 from "path";
+import fs18 from "fs";
+async function compileProjectModules(entryPoints, rootDir, dist) {
+  const { insideFiles, outsideFiles } = await collectRelativeImports(entryPoints, rootDir);
+  const esbuild = await import("esbuild");
+  const aliasPlugins = buildAliasPlugins(rootDir);
+  const absDist = path21.resolve(rootDir, dist);
+  await esbuild.build({
+    entryPoints: [...entryPoints, ...outsideFiles],
+    outdir: absDist,
+    outbase: rootDir,
+    bundle: false,
+    platform: "node",
+    format: "esm",
+    sourcemap: true,
+    packages: "external",
+    plugins: aliasPlugins,
+    logLevel: "silent"
   });
-  return result;
-}
-function getReturnObjectLiteral(fn) {
-  const body = fn.body;
-  if (!body) return null;
-  if (ts10.isObjectLiteralExpression(body)) {
-    return body;
-  }
-  if (ts10.isBlock(body)) {
-    for (const stmt of body.statements) {
-      if (ts10.isReturnStatement(stmt) && stmt.expression && ts10.isObjectLiteralExpression(stmt.expression)) {
-        return stmt.expression;
-      }
-    }
+  if (insideFiles.length > 0) {
+    const appOutbase = path21.resolve(rootDir, "src");
+    await esbuild.build({
+      entryPoints: insideFiles,
+      outdir: absDist,
+      outbase: appOutbase,
+      bundle: false,
+      platform: "node",
+      format: "esm",
+      sourcemap: true,
+      packages: "external",
+      plugins: aliasPlugins,
+      logLevel: "silent"
+    });
   }
-  return null;
+  return { insideFiles, outsideFiles };
 }
-function extractConfigFields(objLit, sourceFile) {
-  let systemPrompt;
-  let tools;
-  let agents;
-  let model;
-  let maxTurns;
-  let inputDescription;
-  for (const prop of objLit.properties) {
-    if (ts10.isSpreadAssignment(prop)) continue;
+
+// src/cli/loadPlugins.ts
+async function loadPlugins(declarations, ctx, rootDir, dist) {
+  const handlerWrappers = [];
+  const upgradeWrappers = [];
+  const failures = [];
+  if (!declarations || declarations.length === 0) {
+    return { handlerWrappers, upgradeWrappers, failures };
+  }
+  const fullCtx = {
+    ...ctx,
+    wrapHandler: (fn) => {
+      handlerWrappers.push(fn);
+    },
+    wrapUpgradeHandler: (fn) => {
+      upgradeWrappers.push(fn);
+    }
+  };
+  const loaded = /* @__PURE__ */ new Set();
+  for (const decl of declarations) {
+    let specifier;
+    let options;
+    let enable;
+    try {
+      ({ specifier, options, enable } = resolveDeclaration(decl));
+    } catch (err) {
+      failures.push({
+        specifier: JSON.stringify(decl),
+        reason: err instanceof Error ? err.message : String(err)
+      });
+      continue;
+    }
+    if (enable === false) continue;
+    if (loaded.has(specifier)) {
+      console.warn(`! Plugin already loaded: ${specifier}, skipping`);
+      continue;
+    }
+    loaded.add(specifier);
+    try {
+      const mod = await importPluginModule(specifier, rootDir ?? process.cwd(), dist);
+      const plugin = mod.default ?? mod;
+      if (typeof plugin.setup !== "function") {
+        failures.push({ specifier, reason: "plugin has no setup function" });
+        continue;
+      }
+      await plugin.setup({ ...fullCtx, options });
+      console.log(`- Plugin loaded: ${plugin.name ?? specifier}`);
+    } catch (err) {
+      failures.push({
+        specifier,
+        reason: err instanceof Error ? err.message : String(err)
+      });
+    }
+  }
+  if (failures.length > 0) {
+    console.error(
+      `[faapi] ${failures.length} plugin(s) failed to load:
+` + failures.map((f) => `  - ${f.specifier}: ${f.reason}`).join("\n")
+    );
+  }
+  return { handlerWrappers, upgradeWrappers, failures };
+}
+var TS_EXTS = /\.(ts|tsx|mts|cts)$/;
+var JS_EXTS = /\.(js|mjs|cjs|jsx)$/;
+function resolveLocalPluginSource(specifier, baseDir) {
+  const base = path22.isAbsolute(specifier) ? specifier : path22.resolve(baseDir, specifier);
+  if ((TS_EXTS.test(base) || JS_EXTS.test(base)) && fs19.existsSync(base)) return base;
+  for (const ext of [".ts", ".js"]) {
+    if (fs19.existsSync(base + ext)) return base + ext;
+  }
+  for (const indexExt of ["/index.ts", "/index.js"]) {
+    if (fs19.existsSync(base + indexExt)) return base + indexExt;
+  }
+  return null;
+}
+function mirrorProductPath(sourcePath, baseDir, distDir) {
+  let rel = path22.relative(baseDir, sourcePath).replace(/\\/g, "/");
+  if (rel.startsWith("src/")) rel = rel.slice(4);
+  return path22.resolve(distDir, rel.replace(TS_EXTS, ".js"));
+}
+async function importPluginModule(specifier, baseDir, dist) {
+  const isRelative = specifier.startsWith("./") || specifier.startsWith("../");
+  if (!isRelative && !path22.isAbsolute(specifier)) {
+    return import(specifier);
+  }
+  const distDir = dist ? path22.resolve(baseDir, dist) : null;
+  const sourcePath = resolveLocalPluginSource(specifier, baseDir);
+  const productPath = sourcePath && distDir ? mirrorProductPath(sourcePath, baseDir, distDir) : null;
+  if (productPath !== null && fs19.existsSync(productPath) && (sourcePath === null || isProductFresh(sourcePath, productPath))) {
+    return import(pathToFileURL3(productPath).href);
+  }
+  if (sourcePath && TS_EXTS.test(sourcePath)) {
+    if (!isDevOnDemandEnabled() || !distDir) {
+      throw new Error(
+        `Local plugin "${specifier}" has no up-to-date build artifact (dist is stale or missing). Run "faapi build" first, or use "faapi dev" for on-demand compilation.`
+      );
+    }
+    const relFromRoot = path22.relative(baseDir, sourcePath).replace(/\\/g, "/");
+    if (relFromRoot.startsWith("src/")) {
+      await ensureCompiled(sourcePath, baseDir, dist);
+    } else {
+      await compileProjectModules([sourcePath], baseDir, dist);
+    }
+    if (productPath && fs19.existsSync(productPath)) {
+      return import(pathToFileURL3(productPath).href);
+    }
+  }
+  if (sourcePath && JS_EXTS.test(sourcePath)) {
+    return import(pathToFileURL3(sourcePath).href);
+  }
+  const candidates = [
+    `${specifier}.ts`,
+    `${specifier}/index.ts`,
+    `${specifier}.js`,
+    `${specifier}/index.js`
+  ].map((c) => path22.isAbsolute(c) ? c : path22.join(baseDir, c));
+  throw new Error(
+    `Cannot find local plugin "${specifier}" (resolved from ${baseDir}). Expected one of:
+  ${candidates.join("\n  ")}
+Create the plugin file (export default { name, setup(ctx) {...} }) or fix the path.`
+  );
+}
+function resolveDeclaration(decl) {
+  if (typeof decl === "string") {
+    return { specifier: decl };
+  }
+  if (Array.isArray(decl)) {
+    const [specifier, options] = decl;
+    return { specifier, options };
+  }
+  if ("package" in decl) {
+    return { specifier: decl.package, options: decl.options, enable: decl.enable };
+  }
+  if ("path" in decl) {
+    return { specifier: decl.path, options: decl.options, enable: decl.enable };
+  }
+  throw new Error(`Invalid plugin declaration: ${JSON.stringify(decl)}`);
+}
+
+// src/cli/manifestLoader.ts
+import fs20 from "fs";
+import path25 from "path";
+
+// src/cli/generateAgentArtifacts.ts
+import path23 from "path";
+
+// src/ast/extractAgentMetadata.ts
+import ts10 from "typescript";
+init_resolveTypeNode();
+function extractAgentMetadata(program, filePath, pathMeta) {
+  const sourceFile = program.getSourceFile(filePath);
+  if (!sourceFile) return null;
+  const configFound = findConfigExport(sourceFile);
+  if (!configFound) {
+    throw SchemaExtractionError.at(
+      sourceFile,
+      "config.systemPrompt",
+      "agent \u5FC5\u586B\u2014\u2014\u8BF7\u5728 config \u5757\u58F0\u660E\u7CFB\u7EDF\u63D0\u793A\u8BCD\uFF08\u5B57\u7B26\u4E32\u5B57\u9762\u91CF\u3001\u65E0\u63D2\u503C\u6A21\u677F\u5B57\u7B26\u4E32\u6216\u5176 + \u62FC\u63A5\uFF09",
+      sourceFile
+    );
+  }
+  if (!configFound.objectLiteral) {
+    throw SchemaExtractionError.at(
+      configFound.jsDocOwner,
+      "config",
+      "\u4EC5\u652F\u6301\u5BF9\u8C61\u5B57\u9762\u91CF\u3001\u7BAD\u5934\u51FD\u6570\u8FD4\u56DE\u5BF9\u8C61\u5B57\u9762\u91CF\u6216\u51FD\u6570\u8FD4\u56DE\u5BF9\u8C61\u5B57\u9762\u91CF",
+      sourceFile
+    );
+  }
+  const objectLiteral = configFound.objectLiteral;
+  const jsDoc = getJSDocFromNode(configFound.jsDocOwner);
+  const description = extractDescription(jsDoc);
+  const agentNameOverride = extractJSDocTagValue(jsDoc, "agent");
+  const { systemPrompt, tools, agents, model, maxTurns, inputDescription } = extractConfigFields(
+    objectLiteral,
+    sourceFile
+  );
+  return {
+    name: agentNameOverride ?? pathMeta.name,
+    description,
+    filePath: pathMeta.filePath,
+    hasRun: pathMeta.hasRun,
+    systemPrompt,
+    tools,
+    agents,
+    model,
+    maxTurns,
+    inputDescription
+  };
+}
+function findConfigExport(sourceFile) {
+  let result = null;
+  ts10.forEachChild(sourceFile, (node) => {
+    if (result) return;
+    if (ts10.isVariableStatement(node) && hasExportModifier(node)) {
+      for (const decl of node.declarationList.declarations) {
+        if (result) break;
+        const nameText = ts10.isIdentifier(decl.name) ? decl.name.text : "";
+        if (nameText !== "config" || !decl.initializer) continue;
+        if (ts10.isObjectLiteralExpression(decl.initializer)) {
+          result = { jsDocOwner: node, objectLiteral: decl.initializer };
+        } else if (ts10.isArrowFunction(decl.initializer)) {
+          result = { jsDocOwner: node, objectLiteral: getReturnObjectLiteral(decl.initializer) };
+        } else {
+          result = { jsDocOwner: node, objectLiteral: null };
+        }
+      }
+    }
+    if (ts10.isFunctionDeclaration(node) && hasExportModifier(node) && node.name?.text === "config") {
+      const returnObj = getReturnObjectLiteral(node);
+      result = { jsDocOwner: node, objectLiteral: returnObj };
+    }
+  });
+  return result;
+}
+function getReturnObjectLiteral(fn) {
+  const body = fn.body;
+  if (!body) return null;
+  if (ts10.isObjectLiteralExpression(body)) {
+    return body;
+  }
+  if (ts10.isBlock(body)) {
+    for (const stmt of body.statements) {
+      if (ts10.isReturnStatement(stmt) && stmt.expression && ts10.isObjectLiteralExpression(stmt.expression)) {
+        return stmt.expression;
+      }
+    }
+  }
+  return null;
+}
+function extractConfigFields(objLit, sourceFile) {
+  let systemPrompt;
+  let tools;
+  let agents;
+  let model;
+  let maxTurns;
+  let inputDescription;
+  for (const prop of objLit.properties) {
+    if (ts10.isSpreadAssignment(prop)) continue;
     if (!ts10.isPropertyAssignment(prop)) {
       throw SchemaExtractionError.at(
         prop,
@@ -6553,9 +6933,9 @@ function validateAgentList(metadata) {
 }
 async function generateAgentArtifacts(agents, rootDir, dist) {
   const metadata = [];
-  const programByFile = createPrograms(agents.map((m) => path20.resolve(rootDir, m.filePath)));
+  const programByFile = createPrograms(agents.map((m) => path23.resolve(rootDir, m.filePath)));
   for (const manifest of agents) {
-    const absPath = path20.resolve(rootDir, manifest.filePath);
+    const absPath = path23.resolve(rootDir, manifest.filePath);
     const program = programByFile.get(absPath);
     const result = extractAgentMetadata(program, absPath, {
       name: manifest.name,
@@ -6565,394 +6945,151 @@ async function generateAgentArtifacts(agents, rootDir, dist) {
     if (!result) {
       throw new Error(
         `agent "${manifest.name}" \u6E90\u6587\u4EF6\u4E0D\u5728 Program \u4E2D: ${manifest.filePath}\u2014\u2014\u65E0\u6CD5\u751F\u6210\u6E05\u5355`
-      );
-    }
-    metadata.push(result);
-  }
-  validateAgentList(metadata);
-  const serialized = serializeAgents(metadata, dist);
-  const agentsPath = path20.resolve(rootDir, dist, AGENTS_FILE);
-  await writeAgentsModule(serialized, agentsPath);
-  return metadata;
-}
-
-// src/cli/generateTaskArtifacts.ts
-import path21 from "path";
-init_createProgram();
-init_atomicWrite();
-init_generateSchemaFiles();
-init_extractHandlerTypes();
-init_generateZodSchema();
-var TASKS_FILE = "faapi-tasks.js";
-function serializeTasks(tasks, dist = "dist") {
-  return tasks.map((t) => ({
-    name: t.name,
-    filePath: toProdFilePath(t.filePath, dist),
-    ...t.cron !== void 0 ? { cron: t.cron } : {},
-    ...t.concurrency !== void 0 ? { concurrency: t.concurrency } : {},
-    ...t.retries !== void 0 ? { retries: t.retries } : {},
-    ...t.timeoutMs !== void 0 ? { timeoutMs: t.timeoutMs } : {},
-    ...t.graceMs !== void 0 ? { graceMs: t.graceMs } : {}
-  }));
-}
-async function writeTasksModule(manifest, outputPath) {
-  const content = `// \u81EA\u52A8\u751F\u6210,\u8BF7\u52FF\u624B\u52A8\u7F16\u8F91(faapi build/dev \u4EA7\u7269)
-export const tasks = ${JSON.stringify(manifest, null, 2)};
-`;
-  await atomicWriteFile(outputPath, content);
-}
-function hydrateTasks(manifest) {
-  return manifest.map((t) => ({
-    name: t.name,
-    filePath: t.filePath,
-    cron: t.cron ?? void 0,
-    concurrency: t.concurrency ?? void 0,
-    retries: t.retries ?? void 0,
-    timeoutMs: t.timeoutMs ?? void 0,
-    graceMs: t.graceMs ?? void 0
-  }));
-}
-function collectTaskSchemaSources(tasks, rootDir) {
-  const tasksByFile = /* @__PURE__ */ new Map();
-  for (const task of tasks) {
-    if (!task.inputTypeName) continue;
-    const absPath = path21.resolve(rootDir, task.filePath);
-    let list = tasksByFile.get(absPath);
-    if (!list) {
-      list = [];
-      tasksByFile.set(absPath, list);
-    }
-    list.push(task);
-  }
-  const programByFile = createPrograms([...tasksByFile.keys()]);
-  const resolversByFile = /* @__PURE__ */ new Map();
-  for (const filePath of tasksByFile.keys()) {
-    resolversByFile.set(filePath, createLazyTypeResolver(programByFile.get(filePath), filePath));
-  }
-  const sources = [];
-  for (const [filePath, fileTasks] of tasksByFile) {
-    const program = programByFile.get(filePath);
-    for (const task of fileTasks) {
-      const typeInfo = extractTypeInfo(program, filePath, task.inputTypeName);
-      sources.push({
-        name: task.taskName,
-        filePath,
-        schemaName: task.inputTypeName,
-        typeInfo
-      });
-    }
-  }
-  return { sources, resolversByFile };
-}
-function generateTaskSchemaFileSource(sources, resolveType, helpersImportPath) {
-  const lines = ["import { z } from 'zod';"];
-  const schemaBlocks = [];
-  for (const source of sources) {
-    if (!source.typeInfo) continue;
-    const block = [`// task ${source.name} \u2192 ${source.schemaName}`];
-    const schemaCode = generateZodSchemaSource(
-      source.typeInfo,
-      resolveType,
-      source.schemaName,
-      false
-    ).replace(/^import \{ z \} from 'zod';\s*\n\s*\n/, "");
-    block.push(schemaCode);
-    block.push("");
-    schemaBlocks.push(block.join("\n"));
-  }
-  const allSchemaCode = schemaBlocks.join("\n");
-  if (helpersImportPath && usesCoerceHelpers(allSchemaCode)) {
-    lines.push(
-      `import { coerceNumber, coerceBoolean, coerceMap, coerceSet } from '${helpersImportPath}';`
-    );
-  }
-  lines.push("");
-  lines.push(...schemaBlocks);
-  return lines.join("\n").replace(/\n+$/, "\n");
-}
-async function generateTaskArtifacts(manifests, rootDir, dist) {
-  const metadata = [];
-  if (manifests.length > 0) {
-    const programByFile = createPrograms(manifests.map((m) => path21.resolve(rootDir, m.filePath)));
-    for (const manifest of manifests) {
-      const absPath = path21.resolve(rootDir, manifest.filePath);
-      const result = extractToolMetadata(programByFile.get(absPath), absPath, "run", {
-        name: manifest.name,
-        filePath: manifest.filePath
-      });
-      if (result) {
-        metadata.push({ ...result, taskName: manifest.name });
-      }
-    }
-  }
-  const serialized = serializeTasks(manifests, dist);
-  const tasksPath = path21.resolve(rootDir, dist, TASKS_FILE);
-  await writeTasksModule(serialized, tasksPath);
-  if (metadata.length === 0) {
-    return hydrateTasks(serialized);
-  }
-  const { sources, resolversByFile } = collectTaskSchemaSources(metadata, rootDir);
-  if (sources.length === 0) {
-    return hydrateTasks(serialized);
-  }
-  const sourcesByFile = /* @__PURE__ */ new Map();
-  for (const source of sources) {
-    let list = sourcesByFile.get(source.filePath);
-    if (!list) {
-      list = [];
-      sourcesByFile.set(source.filePath, list);
-    }
-    list.push(source);
-  }
-  const fileEntries = [];
-  for (const [filePath, fileSources] of sourcesByFile) {
-    const relFile = path21.relative(rootDir, filePath).replace(/\\/g, "/");
-    const outputPath = getSchemaOutputPath(relFile, dist, rootDir);
-    const resolver = resolversByFile.get(filePath);
-    let relForDir = relFile;
-    if (relForDir.startsWith("src/")) {
-      relForDir = relForDir.slice(4);
-    }
-    const dirIdx = relForDir.lastIndexOf("/");
-    const zodRelDir = dirIdx >= 0 ? relForDir.slice(0, dirIdx) : "";
-    const helpersImportPath = getHelpersImportPath(zodRelDir);
-    const source = generateTaskSchemaFileSource(
-      fileSources,
-      (name) => resolver?.resolve(name)?.runtimeType,
-      helpersImportPath
-    );
-    fileEntries.push({ outputPath, source });
-  }
-  const allSourceCode = fileEntries.map((e) => e.source).join("\n");
-  if (usesCoerceHelpers(allSourceCode)) {
-    const helpersPath = path21.resolve(rootDir, dist, HELPERS_FILENAME);
-    const { existsSync: existsSync3 } = await import("fs");
-    if (!existsSync3(helpersPath)) {
-      await atomicWriteFile(helpersPath, generateHelpersFileSource());
-    }
-  }
-  await Promise.all(
-    fileEntries.map(({ outputPath, source }) => atomicWriteFile(outputPath, source))
-  );
-  return hydrateTasks(serialized);
-}
-
-// src/task/idleTaskDriver.ts
-function createIdleTaskDriver() {
-  return {
-    enqueue() {
-      return Promise.reject(
-        new Error(
-          "[faapi] New task(s) were registered without a queue driver. Set config.task.driver to 'pgboss' or 'bullmq' (install the matching @faapi/task-* package) and restart the server."
-        )
-      );
-    },
-    startWorker() {
-    },
-    async stop() {
-    },
-    async stopWorkers() {
-    }
-  };
-}
-
-// src/cli/loadPlugins.ts
-import path23 from "path";
-import fs18 from "fs";
-import { pathToFileURL as pathToFileURL3 } from "url";
-
-// src/cli/compileConfig.ts
-import path22 from "path";
-import fs17 from "fs";
-async function compileProjectModules(entryPoints, rootDir, dist) {
-  const { insideFiles, outsideFiles } = await collectRelativeImports(entryPoints, rootDir);
-  const esbuild = await import("esbuild");
-  const aliasPlugins = buildAliasPlugins(rootDir);
-  const absDist = path22.resolve(rootDir, dist);
-  await esbuild.build({
-    entryPoints: [...entryPoints, ...outsideFiles],
-    outdir: absDist,
-    outbase: rootDir,
-    bundle: false,
-    platform: "node",
-    format: "esm",
-    sourcemap: true,
-    packages: "external",
-    plugins: aliasPlugins,
-    logLevel: "silent"
-  });
-  if (insideFiles.length > 0) {
-    const appOutbase = path22.resolve(rootDir, "src");
-    await esbuild.build({
-      entryPoints: insideFiles,
-      outdir: absDist,
-      outbase: appOutbase,
-      bundle: false,
-      platform: "node",
-      format: "esm",
-      sourcemap: true,
-      packages: "external",
-      plugins: aliasPlugins,
-      logLevel: "silent"
-    });
-  }
-  return { insideFiles, outsideFiles };
-}
-
-// src/cli/loadPlugins.ts
-async function loadPlugins(declarations, ctx, rootDir, dist) {
-  const handlerWrappers = [];
-  const upgradeWrappers = [];
-  const failures = [];
-  if (!declarations || declarations.length === 0) {
-    return { handlerWrappers, upgradeWrappers, failures };
-  }
-  const fullCtx = {
-    ...ctx,
-    wrapHandler: (fn) => {
-      handlerWrappers.push(fn);
-    },
-    wrapUpgradeHandler: (fn) => {
-      upgradeWrappers.push(fn);
-    }
-  };
-  const loaded = /* @__PURE__ */ new Set();
-  for (const decl of declarations) {
-    let specifier;
-    let options;
-    let enable;
-    try {
-      ({ specifier, options, enable } = resolveDeclaration(decl));
-    } catch (err) {
-      failures.push({
-        specifier: JSON.stringify(decl),
-        reason: err instanceof Error ? err.message : String(err)
-      });
-      continue;
-    }
-    if (enable === false) continue;
-    if (loaded.has(specifier)) {
-      console.warn(`! Plugin already loaded: ${specifier}, skipping`);
-      continue;
-    }
-    loaded.add(specifier);
-    try {
-      const mod = await importPluginModule(specifier, rootDir ?? process.cwd(), dist);
-      const plugin = mod.default ?? mod;
-      if (typeof plugin.setup !== "function") {
-        failures.push({ specifier, reason: "plugin has no setup function" });
-        continue;
-      }
-      await plugin.setup({ ...fullCtx, options });
-      console.log(`- Plugin loaded: ${plugin.name ?? specifier}`);
-    } catch (err) {
-      failures.push({
-        specifier,
-        reason: err instanceof Error ? err.message : String(err)
-      });
-    }
-  }
-  if (failures.length > 0) {
-    console.error(
-      `[faapi] ${failures.length} plugin(s) failed to load:
-` + failures.map((f) => `  - ${f.specifier}: ${f.reason}`).join("\n")
-    );
-  }
-  return { handlerWrappers, upgradeWrappers, failures };
-}
-var TS_EXTS = /\.(ts|tsx|mts|cts)$/;
-var JS_EXTS = /\.(js|mjs|cjs|jsx)$/;
-function resolveLocalPluginSource(specifier, baseDir) {
-  const base = path23.isAbsolute(specifier) ? specifier : path23.resolve(baseDir, specifier);
-  if ((TS_EXTS.test(base) || JS_EXTS.test(base)) && fs18.existsSync(base)) return base;
-  for (const ext of [".ts", ".js"]) {
-    if (fs18.existsSync(base + ext)) return base + ext;
-  }
-  for (const indexExt of ["/index.ts", "/index.js"]) {
-    if (fs18.existsSync(base + indexExt)) return base + indexExt;
+      );
+    }
+    metadata.push(result);
   }
-  return null;
+  validateAgentList(metadata);
+  const serialized = serializeAgents(metadata, dist);
+  const agentsPath = path23.resolve(rootDir, dist, AGENTS_FILE);
+  await writeAgentsModule(serialized, agentsPath);
+  return metadata;
 }
-function mirrorProductPath(sourcePath, baseDir, distDir) {
-  let rel = path23.relative(baseDir, sourcePath).replace(/\\/g, "/");
-  if (rel.startsWith("src/")) rel = rel.slice(4);
-  return path23.resolve(distDir, rel.replace(TS_EXTS, ".js"));
+
+// src/cli/generateTaskArtifacts.ts
+init_generateZodArtifacts();
+import path24 from "path";
+init_createProgram();
+init_atomicWrite();
+init_extractHandlerTypes();
+init_generateZodSchema();
+var TASKS_FILE = "faapi-tasks.js";
+function serializeTasks(tasks, dist = "dist") {
+  return tasks.map((t) => ({
+    name: t.name,
+    filePath: toProdFilePath(t.filePath, dist),
+    ...t.cron !== void 0 ? { cron: t.cron } : {},
+    ...t.concurrency !== void 0 ? { concurrency: t.concurrency } : {},
+    ...t.retries !== void 0 ? { retries: t.retries } : {},
+    ...t.timeoutMs !== void 0 ? { timeoutMs: t.timeoutMs } : {},
+    ...t.graceMs !== void 0 ? { graceMs: t.graceMs } : {}
+  }));
 }
-function isSourceNewer(sourcePath, productPath) {
-  try {
-    return fs18.statSync(sourcePath).mtimeMs > fs18.statSync(productPath).mtimeMs;
-  } catch {
-    return true;
-  }
+async function writeTasksModule(manifest, outputPath) {
+  const content = `// \u81EA\u52A8\u751F\u6210,\u8BF7\u52FF\u624B\u52A8\u7F16\u8F91(faapi build/dev \u4EA7\u7269)
+export const tasks = ${JSON.stringify(manifest, null, 2)};
+`;
+  await atomicWriteFile(outputPath, content);
 }
-async function importPluginModule(specifier, baseDir, dist) {
-  const isRelative = specifier.startsWith("./") || specifier.startsWith("../");
-  if (!isRelative && !path23.isAbsolute(specifier)) {
-    return import(specifier);
+function hydrateTasks(manifest) {
+  return manifest.map((t) => ({
+    name: t.name,
+    filePath: t.filePath,
+    cron: t.cron ?? void 0,
+    concurrency: t.concurrency ?? void 0,
+    retries: t.retries ?? void 0,
+    timeoutMs: t.timeoutMs ?? void 0,
+    graceMs: t.graceMs ?? void 0
+  }));
+}
+function collectTaskSchemaSources(tasks, rootDir) {
+  const tasksByFile = /* @__PURE__ */ new Map();
+  for (const task of tasks) {
+    if (!task.inputTypeName) continue;
+    const absPath = path24.resolve(rootDir, task.filePath);
+    let list = tasksByFile.get(absPath);
+    if (!list) {
+      list = [];
+      tasksByFile.set(absPath, list);
+    }
+    list.push(task);
   }
-  const distDir = dist ? path23.resolve(baseDir, dist) : null;
-  const sourcePath = resolveLocalPluginSource(specifier, baseDir);
-  const productPath = sourcePath && distDir ? mirrorProductPath(sourcePath, baseDir, distDir) : null;
-  if (productPath !== null && fs18.existsSync(productPath) && (sourcePath === null || !isSourceNewer(sourcePath, productPath))) {
-    return import(pathToFileURL3(productPath).href);
+  const programByFile = createPrograms([...tasksByFile.keys()]);
+  const resolversByFile = /* @__PURE__ */ new Map();
+  for (const filePath of tasksByFile.keys()) {
+    resolversByFile.set(filePath, createLazyTypeResolver(programByFile.get(filePath), filePath));
   }
-  if (sourcePath && TS_EXTS.test(sourcePath)) {
-    if (!isDevOnDemandEnabled() || !distDir) {
-      throw new Error(
-        `Local plugin "${specifier}" has no up-to-date build artifact (dist is stale or missing). Run "faapi build" first, or use "faapi dev" for on-demand compilation.`
-      );
-    }
-    const relFromRoot = path23.relative(baseDir, sourcePath).replace(/\\/g, "/");
-    if (relFromRoot.startsWith("src/")) {
-      await ensureCompiled(sourcePath, baseDir, dist);
-    } else {
-      await compileProjectModules([sourcePath], baseDir, dist);
-    }
-    if (productPath && fs18.existsSync(productPath)) {
-      return import(pathToFileURL3(productPath).href);
+  const sources = [];
+  for (const [filePath, fileTasks] of tasksByFile) {
+    const program = programByFile.get(filePath);
+    for (const task of fileTasks) {
+      const typeInfo = extractTypeInfo(program, filePath, task.inputTypeName);
+      sources.push({
+        name: task.taskName,
+        filePath,
+        schemaName: task.inputTypeName,
+        typeInfo
+      });
     }
   }
-  if (sourcePath && JS_EXTS.test(sourcePath)) {
-    return import(pathToFileURL3(sourcePath).href);
-  }
-  const candidates = [
-    `${specifier}.ts`,
-    `${specifier}/index.ts`,
-    `${specifier}.js`,
-    `${specifier}/index.js`
-  ].map((c) => path23.isAbsolute(c) ? c : path23.join(baseDir, c));
-  throw new Error(
-    `Cannot find local plugin "${specifier}" (resolved from ${baseDir}). Expected one of:
-  ${candidates.join("\n  ")}
-Create the plugin file (export default { name, setup(ctx) {...} }) or fix the path.`
-  );
+  return { sources, resolversByFile };
 }
-function resolveDeclaration(decl) {
-  if (typeof decl === "string") {
-    return { specifier: decl };
+function generateTaskSchemaFileSource(sources, resolveType, helpersImportPath) {
+  const lines = ["import { z } from 'zod';"];
+  const schemaBlocks = [];
+  for (const source of sources) {
+    if (!source.typeInfo) continue;
+    const block = [`// task ${source.name} \u2192 ${source.schemaName}`];
+    const schemaCode = generateZodSchemaSource(
+      source.typeInfo,
+      resolveType,
+      source.schemaName,
+      false
+    ).replace(/^import \{ z \} from 'zod';\s*\n\s*\n/, "");
+    block.push(schemaCode);
+    block.push("");
+    schemaBlocks.push(block.join("\n"));
   }
-  if (Array.isArray(decl)) {
-    const [specifier, options] = decl;
-    return { specifier, options };
+  const allSchemaCode = schemaBlocks.join("\n");
+  if (helpersImportPath && usesCoerceHelpers(allSchemaCode)) {
+    lines.push(
+      `import { coerceNumber, coerceBoolean, coerceMap, coerceSet } from '${helpersImportPath}';`
+    );
   }
-  if ("package" in decl) {
-    return { specifier: decl.package, options: decl.options, enable: decl.enable };
+  lines.push("");
+  lines.push(...schemaBlocks);
+  return lines.join("\n").replace(/\n+$/, "\n");
+}
+async function generateTaskArtifacts(manifests, rootDir, dist) {
+  const metadata = [];
+  if (manifests.length > 0) {
+    const programByFile = createPrograms(manifests.map((m) => path24.resolve(rootDir, m.filePath)));
+    for (const manifest of manifests) {
+      const absPath = path24.resolve(rootDir, manifest.filePath);
+      const result = extractToolMetadata(programByFile.get(absPath), absPath, "run", {
+        name: manifest.name,
+        filePath: manifest.filePath
+      });
+      if (result) {
+        metadata.push({ ...result, taskName: manifest.name });
+      }
+    }
   }
-  if ("path" in decl) {
-    return { specifier: decl.path, options: decl.options, enable: decl.enable };
+  const serialized = serializeTasks(manifests, dist);
+  const tasksPath = path24.resolve(rootDir, dist, TASKS_FILE);
+  await writeTasksModule(serialized, tasksPath);
+  if (metadata.length === 0) {
+    return hydrateTasks(serialized);
   }
-  throw new Error(`Invalid plugin declaration: ${JSON.stringify(decl)}`);
+  const { sources, resolversByFile } = collectTaskSchemaSources(metadata, rootDir);
+  if (sources.length === 0) {
+    return hydrateTasks(serialized);
+  }
+  await generateZodArtifacts(sources, {
+    generateFileSource: generateTaskSchemaFileSource,
+    resolversByFile,
+    rootDir,
+    dist
+  });
+  return hydrateTasks(serialized);
 }
 
-// src/cli/createAppCore.ts
-var DEFAULT_DIST = "dist";
-var DEFAULT_PORT = 3e3;
-var ROUTES_FILE = "faapi-routes.js";
+// src/cli/manifestLoader.ts
 var TOOLS_FILE2 = "faapi-tools.js";
 var AGENTS_FILE2 = "faapi-agents.js";
 async function loadAndHydrateTools(rootDir, dist, registries = defaultRegistries) {
-  const toolsPath = path24.resolve(rootDir, dist, TOOLS_FILE2);
-  if (!fs19.existsSync(toolsPath)) {
+  const toolsPath = path25.resolve(rootDir, dist, TOOLS_FILE2);
+  if (!fs20.existsSync(toolsPath)) {
     return [];
   }
   const serialized = await importWithCacheBust(toolsPath);
@@ -6961,8 +7098,8 @@ async function loadAndHydrateTools(rootDir, dist, registries = defaultRegistries
   return hydrated;
 }
 async function loadAndHydrateAgents(rootDir, dist, registries = defaultRegistries) {
-  const agentsPath = path24.resolve(rootDir, dist, AGENTS_FILE2);
-  if (!fs19.existsSync(agentsPath)) {
+  const agentsPath = path25.resolve(rootDir, dist, AGENTS_FILE2);
+  if (!fs20.existsSync(agentsPath)) {
     return [];
   }
   const serialized = await importWithCacheBust(agentsPath);
@@ -6977,8 +7114,8 @@ function getTaskDriverOptions(config) {
   return void 0;
 }
 async function loadAndHydrateTasks(rootDir, dist, registries = defaultRegistries) {
-  const tasksPath = path24.resolve(rootDir, dist, TASKS_FILE);
-  if (!fs19.existsSync(tasksPath)) {
+  const tasksPath = path25.resolve(rootDir, dist, TASKS_FILE);
+  if (!fs20.existsSync(tasksPath)) {
     return [];
   }
   const serialized = await importWithCacheBust(tasksPath);
@@ -6986,6 +7123,8 @@ async function loadAndHydrateTasks(rootDir, dist, registries = defaultRegistries
   registries.task.hydrate(hydrated);
   return hydrated;
 }
+
+// src/cli/appSingleton.ts
 var APP_INSTANCE_KEY = /* @__PURE__ */ Symbol.for("faapi.app.instance");
 function getCurrentApp() {
   return globalThis[APP_INSTANCE_KEY] ?? null;
@@ -7023,6 +7162,94 @@ function getApp() {
   }
   return app;
 }
+
+// src/cli/injectMock.ts
+import { PassThrough, Readable as Readable3 } from "stream";
+function performInject(server, injectOpts) {
+  const {
+    method = "GET",
+    path: reqPath = "/",
+    headers: reqHeaders = {},
+    query,
+    body
+  } = injectOpts ?? {};
+  const queryStr = query ? "?" + new URLSearchParams(Object.entries(query).map(([k, v]) => [k, String(v)])).toString() : "";
+  return new Promise((resolve, reject) => {
+    const chunks = [];
+    const mockRes = new PassThrough();
+    mockRes.statusCode = 200;
+    mockRes._headers = {};
+    mockRes.setHeader = function(name, value) {
+      this._headers[name.toLowerCase()] = value;
+    };
+    mockRes.appendHeader = function(name, value) {
+      const key = name.toLowerCase();
+      const existing = this._headers[key];
+      this._headers[key] = existing ? `${existing}, ${value}` : value;
+    };
+    mockRes.writeHead = function(status, headers) {
+      this.statusCode = status;
+      if (headers) {
+        Object.assign(this._headers, headers);
+      }
+    };
+    mockRes.on("data", (chunk) => chunks.push(chunk));
+    mockRes.on("error", reject);
+    mockRes.on("finish", () => {
+      const bodyBuf = Buffer.concat(chunks);
+      let parsed;
+      try {
+        parsed = JSON.parse(bodyBuf.toString());
+      } catch {
+        parsed = bodyBuf.toString();
+      }
+      resolve({
+        status: mockRes.statusCode,
+        headers: new Headers(mockRes._headers),
+        body: parsed
+      });
+    });
+    const listeners = server.listeners("request");
+    const handler = listeners[listeners.length - 1];
+    if (typeof handler !== "function") {
+      reject(new Error("No request handler found"));
+      return;
+    }
+    let payload;
+    let defaultContentType;
+    if (body !== void 0) {
+      if (typeof body === "string") {
+        payload = Buffer.from(body, "utf-8");
+        defaultContentType = "text/plain";
+      } else if (body instanceof Uint8Array) {
+        payload = Buffer.from(body);
+        defaultContentType = "application/octet-stream";
+      } else {
+        payload = Buffer.from(JSON.stringify(body));
+        defaultContentType = "application/json";
+      }
+    }
+    const mockReq = Readable3.from(payload !== void 0 ? [payload] : []);
+    mockReq.method = method;
+    mockReq.url = `${reqPath}${queryStr}`;
+    const hasCallerContentType = "content-type" in reqHeaders || "Content-Type" in reqHeaders;
+    mockReq.headers = {
+      ...reqHeaders,
+      host: "localhost",
+      ...payload !== void 0 && !hasCallerContentType ? { "content-type": defaultContentType } : {}
+    };
+    mockReq.socket = { remoteAddress: "127.0.0.1" };
+    handler(
+      mockReq,
+      mockRes
+    );
+  });
+}
+
+// src/cli/createAppCore.ts
+var DEFAULT_DIST = "dist";
+var DEFAULT_PORT = 3e3;
+var ROUTES_FILE = "faapi-routes.js";
 var FAAPI_CONFIG_KEYS = /* @__PURE__ */ new Set([
   "cors",
   "lifecycle",
@@ -7043,11 +7270,45 @@ var FAAPI_CONFIG_KEYS = /* @__PURE__ */ new Set([
 function isFaapiConfigKey(key) {
   return FAAPI_CONFIG_KEYS.has(key);
 }
+function logStartupSummary(routes, wsRoutes, tools, agents, taskMetas, p) {
+  console.log("faapi server started");
+  console.log(`- Local: http://localhost:${p}`);
+  console.log("- Loaded routes:");
+  for (const route of routes) {
+    console.log(`  ${route.method.padEnd(6)}${route.urlPath}  ${route.filePath}`);
+  }
+  if (wsRoutes.length > 0) {
+    console.log("- WebSocket routes:");
+    for (const route of wsRoutes) {
+      console.log(`  WS     ${route.urlPath}  ${route.filePath}`);
+    }
+  }
+  if (tools.length > 0) {
+    console.log(`- Loaded ${tools.length} tool(s):`);
+    for (const tool of tools) {
+      console.log(`  ${tool.name}  ${tool.filePath}`);
+    }
+  }
+  if (agents.length > 0) {
+    console.log(`- Loaded ${agents.length} agent(s):`);
+    for (const agent of agents) {
+      const exports = agent.hasRun ? "run" : "-";
+      console.log(`  ${agent.name} [${exports}]  ${agent.filePath}`);
+    }
+  }
+  if (taskMetas.length > 0) {
+    console.log(`- Loaded ${taskMetas.length} task(s):`);
+    for (const taskMeta of taskMetas) {
+      const schedule = taskMeta.cron ? ` cron=${taskMeta.cron}` : "";
+      console.log(`  ${taskMeta.name}${schedule}  ${taskMeta.filePath}`);
+    }
+  }
+}
 async function createAppBase(options) {
   const rootDir = options?.rootDir ?? process.cwd();
   const dist = options?.dist ?? process.env.FAAPI_DIST ?? DEFAULT_DIST;
-  const routesPath = path24.resolve(rootDir, dist, ROUTES_FILE);
-  if (!fs19.existsSync(routesPath)) {
+  const routesPath = path26.resolve(rootDir, dist, ROUTES_FILE);
+  if (!fs21.existsSync(routesPath)) {
     throw new Error(
       `[faapi] ${dist}/${ROUTES_FILE} \u4E0D\u5B58\u5728\uFF0C\u8BF7\u5148\u6267\u884C \`faapi build\`\uFF08\u6216 \`faapi dev\`\uFF09\u751F\u6210\u4EA7\u7269\u3002`
     );
@@ -7058,15 +7319,7 @@ async function createAppBase(options) {
   const hydrated = await hydrateRoutes(serialized);
   let sorted = sortRoutes(hydrated.routes);
   let wsRoutes = hydrated.wsRoutes;
-  const conflicts = detectRouteConflicts(sorted);
-  if (conflicts.length > 0) {
-    for (const conflict of conflicts) {
-      console.warn(`! \u8DEF\u7531\u51B2\u7A81: ${conflict.method} ${conflict.urlPath}`);
-      for (const file of conflict.files) {
-        console.warn(`  - ${file}`);
-      }
-    }
-  }
+  reportRouteConflicts(sorted);
   const registries = createAppRegistries();
   const tools = await loadAndHydrateTools(rootDir, dist, registries);
   const agents = await loadAndHydrateAgents(rootDir, dist, registries);
@@ -7172,38 +7425,7 @@ async function createAppBase(options) {
           server.off("error", onListenError);
           const address = server.address();
           const p = typeof address === "object" && address !== null ? address.port : actualPort;
-          console.log("faapi server started");
-          console.log(`- Local: http://localhost:${p}`);
-          console.log("- Loaded routes:");
-          for (const route of sorted) {
-            console.log(`  ${route.method.padEnd(6)}${route.urlPath}  ${route.filePath}`);
-          }
-          if (wsRoutes.length > 0) {
-            console.log("- WebSocket routes:");
-            for (const route of wsRoutes) {
-              console.log(`  WS     ${route.urlPath}  ${route.filePath}`);
-            }
-          }
-          if (tools.length > 0) {
-            console.log(`- Loaded ${tools.length} tool(s):`);
-            for (const tool of tools) {
-              console.log(`  ${tool.name}  ${tool.filePath}`);
-            }
-          }
-          if (agents.length > 0) {
-            console.log(`- Loaded ${agents.length} agent(s):`);
-            for (const agent of agents) {
-              const exports = agent.hasRun ? "run" : "-";
-              console.log(`  ${agent.name} [${exports}]  ${agent.filePath}`);
-            }
-          }
-          if (taskMetas.length > 0) {
-            console.log(`- Loaded ${taskMetas.length} task(s):`);
-            for (const taskMeta of taskMetas) {
-              const schedule = taskMeta.cron ? ` cron=${taskMeta.cron}` : "";
-              console.log(`  ${taskMeta.name}${schedule}  ${taskMeta.filePath}`);
-            }
-          }
+          logStartupSummary(sorted, wsRoutes, tools, agents, taskMetas, p);
           registerDefaultShutdownHandlers();
           if (config?.lifecycle?.onReady) {
             await config.lifecycle.onReady({
@@ -7220,85 +7442,8 @@ async function createAppBase(options) {
         });
       });
     },
-    async inject(injectOpts) {
-      const {
-        method = "GET",
-        path: reqPath = "/",
-        headers: reqHeaders = {},
-        query,
-        body
-      } = injectOpts ?? {};
-      const queryStr = query ? "?" + new URLSearchParams(Object.entries(query).map(([k, v]) => [k, String(v)])).toString() : "";
-      return new Promise((resolve, reject) => {
-        const chunks = [];
-        const mockRes = new PassThrough();
-        mockRes.statusCode = 200;
-        mockRes._headers = {};
-        mockRes.setHeader = function(name, value) {
-          this._headers[name.toLowerCase()] = value;
-        };
-        mockRes.appendHeader = function(name, value) {
-          const key = name.toLowerCase();
-          const existing = this._headers[key];
-          this._headers[key] = existing ? `${existing}, ${value}` : value;
-        };
-        mockRes.writeHead = function(status, headers) {
-          this.statusCode = status;
-          if (headers) {
-            Object.assign(this._headers, headers);
-          }
-        };
-        mockRes.on("data", (chunk) => chunks.push(chunk));
-        mockRes.on("error", reject);
-        mockRes.on("finish", () => {
-          const body2 = Buffer.concat(chunks);
-          let parsed;
-          try {
-            parsed = JSON.parse(body2.toString());
-          } catch {
-            parsed = body2.toString();
-          }
-          resolve({
-            status: mockRes.statusCode,
-            headers: new Headers(mockRes._headers),
-            body: parsed
-          });
-        });
-        const listeners = server.listeners("request");
-        const handler = listeners[listeners.length - 1];
-        if (typeof handler !== "function") {
-          reject(new Error("No request handler found"));
-          return;
-        }
-        let payload;
-        let defaultContentType;
-        if (body !== void 0) {
-          if (typeof body === "string") {
-            payload = Buffer.from(body, "utf-8");
-            defaultContentType = "text/plain";
-          } else if (body instanceof Uint8Array) {
-            payload = Buffer.from(body);
-            defaultContentType = "application/octet-stream";
-          } else {
-            payload = Buffer.from(JSON.stringify(body));
-            defaultContentType = "application/json";
-          }
-        }
-        const mockReq = Readable3.from(payload !== void 0 ? [payload] : []);
-        mockReq.method = method;
-        mockReq.url = `${reqPath}${queryStr}`;
-        const hasCallerContentType = "content-type" in reqHeaders || "Content-Type" in reqHeaders;
-        mockReq.headers = {
-          ...reqHeaders,
-          host: "localhost",
-          ...payload !== void 0 && !hasCallerContentType ? { "content-type": defaultContentType } : {}
-        };
-        mockReq.socket = { remoteAddress: "127.0.0.1" };
-        handler(
-          mockReq,
-          mockRes
-        );
-      });
+    inject(injectOpts) {
+      return performInject(server, injectOpts);
     },
     async close() {
       if (closed) return;
@@ -7374,21 +7519,21 @@ async function createAppBase(options) {
 }
 
 // src/cli/createDevApp.ts
-import path28 from "path";
+import path30 from "path";
 
 // src/router/scanRoutes.ts
 import fg3 from "fast-glob";
-import path25 from "path";
-import fs20 from "fs";
+import path27 from "path";
+import fs22 from "fs";
 
 // src/router/constants.ts
 var HTTP_METHODS = ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"];
 var HTTP_METHOD_SET = new Set(HTTP_METHODS);
 
 // src/utils/normalizePath.ts
-function normalizePath(path29) {
-  if (!path29) return "";
-  let result = path29.replace(/\\/g, "/");
+function normalizePath(path31) {
+  if (!path31) return "";
+  let result = path31.replace(/\\/g, "/");
   result = result.replace(/\/+/g, "/");
   result = result.replace(/\/+$/, "");
   if (result && !result.startsWith("/")) {
@@ -7449,34 +7594,34 @@ function extractExportsFromSource(source) {
   return names;
 }
 function collectMiddlewarePaths(routeFilePath, rootDir, dist) {
-  const routeDir = path25.dirname(routeFilePath);
-  const resolvedRoot = path25.resolve(rootDir);
+  const routeDir = path27.dirname(routeFilePath);
+  const resolvedRoot = path27.resolve(rootDir);
   const paths = [];
-  let currentDir = path25.resolve(rootDir, routeDir);
+  let currentDir = path27.resolve(rootDir, routeDir);
   while (true) {
     if (dist) {
-      const mwTsPath = path25.join(currentDir, "middlewares.ts");
-      const mwJsPath = path25.join(currentDir, "middlewares.js");
-      const absTsPath = path25.resolve(rootDir, mwTsPath);
-      const absJsPath = path25.resolve(rootDir, mwJsPath);
-      const absMwPath = fs20.existsSync(absTsPath) ? absTsPath : fs20.existsSync(absJsPath) ? absJsPath : null;
+      const mwTsPath = path27.join(currentDir, "middlewares.ts");
+      const mwJsPath = path27.join(currentDir, "middlewares.js");
+      const absTsPath = path27.resolve(rootDir, mwTsPath);
+      const absJsPath = path27.resolve(rootDir, mwJsPath);
+      const absMwPath = fs22.existsSync(absTsPath) ? absTsPath : fs22.existsSync(absJsPath) ? absJsPath : null;
       if (absMwPath) {
-        const relMwPath = path25.relative(rootDir, absMwPath);
-        const prodAbsPath = path25.resolve(rootDir, toProdFilePath(relMwPath, dist));
+        const relMwPath = path27.relative(rootDir, absMwPath);
+        const prodAbsPath = path27.resolve(rootDir, toProdFilePath(relMwPath, dist));
         paths.push(prodAbsPath);
       }
     } else {
       for (const ext of [".ts", ".js"]) {
-        const mwPath = path25.join(currentDir, `middlewares${ext}`);
-        const absMwPath = path25.resolve(rootDir, mwPath);
-        if (fs20.existsSync(absMwPath)) {
+        const mwPath = path27.join(currentDir, `middlewares${ext}`);
+        const absMwPath = path27.resolve(rootDir, mwPath);
+        if (fs22.existsSync(absMwPath)) {
           paths.push(absMwPath);
           break;
         }
       }
     }
     if (currentDir === resolvedRoot) break;
-    const parentDir = path25.dirname(currentDir);
+    const parentDir = path27.dirname(currentDir);
     if (parentDir === currentDir) break;
     currentDir = parentDir;
   }
@@ -7495,7 +7640,7 @@ async function scanRoutes(rootDir, patterns, dist) {
     const normalizedFile = file.replace(/\\/g, "/");
     const fileName = normalizedFile.split("/").pop();
     if (fileName === "handler.ts" || fileName === "handler.js") {
-      const absPath = path25.resolve(rootDir, normalizedFile);
+      const absPath = path27.resolve(rootDir, normalizedFile);
       const urlPath = filePathToUrlPath(normalizedFile);
       const paramNames = extractParamNames(urlPath);
       const isDynamic = paramNames.length > 0;
@@ -7508,7 +7653,7 @@ async function scanRoutes(rootDir, patterns, dist) {
         const mwPaths = collectMiddlewarePaths(normalizedFile, rootDir);
         middlewareBundle = await loadMergedMiddlewares(mwPaths);
       }
-      const source = await fs20.promises.readFile(absPath, "utf8").catch(() => "");
+      const source = await fs22.promises.readFile(absPath, "utf8").catch(() => "");
       const exportNames = extractExportsFromSource(source);
       const methods = HTTP_METHODS.filter((m) => exportNames.has(m));
       for (const method of methods) {
@@ -7544,8 +7689,8 @@ async function scanRoutes(rootDir, patterns, dist) {
 
 // src/tools/scanTools.ts
 import fg4 from "fast-glob";
-import path26 from "path";
-import fs21 from "fs";
+import path28 from "path";
+import fs23 from "fs";
 var TOOL_PATTERNS = ["src/tools/**/*.ts"];
 var TOOL_EXPORT_RE = new RegExp(
   String.raw`export\s+(?:async\s+)?(?:function\s+|const\s+)([A-Za-z_$][\w$]*)\s*(?:\(|=)`,
@@ -7595,8 +7740,8 @@ async function scanTools(rootDir, patterns) {
     if (fileName !== "handler.ts" && fileName !== "handler.js") {
       continue;
     }
-    const absPath = path26.resolve(rootDir, normalizedFile);
-    const source = await fs21.promises.readFile(absPath, "utf8").catch(() => "");
+    const absPath = path28.resolve(rootDir, normalizedFile);
+    const source = await fs23.promises.readFile(absPath, "utf8").catch(() => "");
     const exportNames = extractToolExportsFromSource(source);
     const namespace = filePathToToolNamespace(normalizedFile);
     for (const fnName of exportNames) {
@@ -7620,8 +7765,8 @@ async function scanTools(rootDir, patterns) {
 
 // src/agents/scanAgents.ts
 import fg5 from "fast-glob";
-import path27 from "path";
-import fs22 from "fs";
+import path29 from "path";
+import fs24 from "fs";
 var DEFAULT_AGENT_PATTERNS = ["src/agents/**/handler.ts"];
 var RUN_EXPORT_RE = /export\s+(?:async\s+)?(?:function\s+|const\s+)run\b/;
 function extractAgentNameFromPath(filePath) {
@@ -7653,8 +7798,8 @@ async function scanAgents(rootDir, patterns) {
     if (fileName !== "handler.ts" && fileName !== "handler.js") {
       continue;
     }
-    const absPath = path27.resolve(rootDir, normalizedFile);
-    const source = await fs22.promises.readFile(absPath, "utf8").catch(() => "");
+    const absPath = path29.resolve(rootDir, normalizedFile);
+    const source = await fs24.promises.readFile(absPath, "utf8").catch(() => "");
     const { hasRun } = detectAgentExports(source);
     const name = extractAgentNameFromPath(normalizedFile);
     const prevFile = seen.get(name);
@@ -7675,13 +7820,14 @@ async function scanAgents(rootDir, patterns) {
 
 // src/cli/createDevApp.ts
 init_createProgram();
+var suppressProgramInvalidation = false;
 async function createDevApp(options) {
   const { app, ctx } = await createAppBase(options);
   const devApp = app;
   devApp.reloadRoutes = async () => {
     setLoadTimestamp(Date.now());
     invalidateMiddlewareCache();
-    invalidateProgramCache();
+    if (!suppressProgramInvalidation) invalidateProgramCache();
     invalidateSchemaCache();
     clearCompiledFiles();
     const reScanned = await scanRoutes(ctx.rootDir, ctx.patterns, ctx.dist);
@@ -7705,7 +7851,7 @@ async function createDevApp(options) {
   };
   devApp.reloadTools = async () => {
     setLoadTimestamp(Date.now());
-    invalidateProgramCache();
+    if (!suppressProgramInvalidation) invalidateProgramCache();
     const tools = await scanTools(ctx.rootDir, TOOL_PATTERNS);
     await generateToolArtifacts(tools, ctx.rootDir, ctx.dist, {
       skipSchema: isDevOnDemandEnabled()
@@ -7714,17 +7860,17 @@ async function createDevApp(options) {
   };
   devApp.reloadAgents = async () => {
     setLoadTimestamp(Date.now());
-    invalidateProgramCache();
+    if (!suppressProgramInvalidation) invalidateProgramCache();
     const agents = await scanAgents(ctx.rootDir, DEFAULT_AGENT_PATTERNS);
     await generateAgentArtifacts(agents, ctx.rootDir, ctx.dist);
     await loadAndHydrateAgents(ctx.rootDir, ctx.dist, ctx.registries);
   };
   devApp.reloadTasks = async () => {
     setLoadTimestamp(Date.now());
-    invalidateProgramCache();
+    if (!suppressProgramInvalidation) invalidateProgramCache();
     const tasks = await scanTasks(ctx.rootDir, TASK_PATTERNS);
     for (const task of tasks) {
-      await ensureCompiled(path28.resolve(ctx.rootDir, task.filePath), ctx.rootDir, ctx.dist);
+      await ensureCompiled(path30.resolve(ctx.rootDir, task.filePath), ctx.rootDir, ctx.dist);
     }
     await generateTaskArtifacts(tasks, ctx.rootDir, ctx.dist);
     ctx.taskQueue.invalidateModules();
@@ -7732,6 +7878,19 @@ async function createDevApp(options) {
     await ctx.taskQueue.reload();
     await loadAndHydrateTasks(ctx.rootDir, ctx.dist, ctx.registries);
   };
+  devApp.reloadAll = async () => {
+    invalidateProgramCache();
+    const prev = suppressProgramInvalidation;
+    suppressProgramInvalidation = true;
+    try {
+      await devApp.reloadRoutes();
+      await devApp.reloadTools();
+      await devApp.reloadAgents();
+      await devApp.reloadTasks();
+    } finally {
+      suppressProgramInvalidation = prev;
+    }
+  };
   return devApp;
 }