@faapi/faapi 6.23.0 → 6.24.0

package/dist/index.js

@@ -2046,14 +2046,14 @@ var ValidationError = class extends FaapiError {
   issues;
 };
 var RouteNotFoundError = class extends FaapiError {
-  constructor(path32) {
-    super("ROUTE_NOT_FOUND", `Route not found: ${path32}`, 404);
+  constructor(path31) {
+    super("ROUTE_NOT_FOUND", `Route not found: ${path31}`, 404);
     this.name = "RouteNotFoundError";
   }
 };
 var MethodNotAllowedError = class extends FaapiError {
-  constructor(method, path32, allowedMethods) {
-    super("METHOD_NOT_ALLOWED", `Method ${method} not allowed for ${path32}`, 405);
+  constructor(method, path31, allowedMethods) {
+    super("METHOD_NOT_ALLOWED", `Method ${method} not allowed for ${path31}`, 405);
     this.allowedMethods = allowedMethods;
     this.name = "MethodNotAllowedError";
   }
@@ -2362,7 +2362,11 @@ async function runTaskInWorker(options) {
       worker.postMessage({
         type: "run",
         payload,
-        taskCtx: { config: safeConfig(taskCtx.config), job: taskCtx.job },
+        taskCtx: {
+          config: safeConfig(taskCtx.config),
+          resourcesDir: taskCtx.resourcesDir,
+          job: taskCtx.job
+        },
         registries: options.registries,
         log: options.log
       });
@@ -2712,6 +2716,7 @@ function createTaskQueue(deps) {
           payload: job.payload,
           taskCtx: {
             config: deps.config,
+            resourcesDir: deps.resourcesDir,
             job: { id: job.id, name: job.name, attempt: job.attempt }
           },
           registries: snapshotRegistries(),
@@ -2742,6 +2747,7 @@ function createTaskQueue(deps) {
         const taskCtx = {
           signal: job.signal,
           config: deps.config,
+          resourcesDir: deps.resourcesDir,
           job: { id: job.id, name: job.name, attempt: job.attempt },
           registries: registriesView,
           log: createLogger(`task:${job.name}`, {
@@ -3086,7 +3092,7 @@ function listSkills() {
   return defaultRegistries.skill.list();
 }
 
-// src/loader/loadAgentModule.ts
+// src/loader/loadToolModule.ts
 import fs12 from "fs";
 
 // src/loader/resolveExports.ts
@@ -3737,52 +3743,13 @@ function getDevDist() {
   return state.distDir;
 }
 
-// src/loader/loadAgentModule.ts
-async function loadAgentModule(filePath, hasRun, rootDir) {
-  if (isDevOnDemandEnabled() && rootDir) {
-    const dist = getDevDist();
-    if (dist) {
-      const sourcePath = prodPathToSourcePath(filePath, rootDir, dist);
-      if (sourcePath && fs12.existsSync(sourcePath)) {
-        try {
-          await ensureCompiled(sourcePath, rootDir, dist);
-        } catch (compileErr) {
-          const reason = compileErr instanceof Error ? compileErr.message : String(compileErr);
-          throw new Error(`Failed to compile agent module "${sourcePath}": ${reason}`, {
-            cause: compileErr
-          });
-        }
-      }
-    }
-  }
-  let module;
-  try {
-    module = await importWithCacheBust(filePath, isDevOnDemandEnabled());
-  } catch (err) {
-    const reason = err instanceof Error ? err.message : String(err);
-    throw new Error(`Failed to load agent module "${filePath}": ${reason}`, { cause: err });
-  }
-  let run;
-  if (hasRun) {
-    const runExport = resolveExport(module, "run");
-    if (typeof runExport !== "function") {
-      throw new Error(
-        `Agent module "${filePath}" does not export a valid "run" function (hasRun=true). Expected a function, got ${runExport === void 0 ? "undefined" : typeof runExport}.`
-      );
-    }
-    run = runExport;
-  }
-  return { run };
-}
-
 // src/loader/loadToolModule.ts
-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 && fs13.existsSync(sourcePath)) {
+      if (sourcePath && fs12.existsSync(sourcePath)) {
         try {
           await ensureCompiled(sourcePath, rootDir, dist);
         } catch (compileErr) {
@@ -4254,15 +4221,15 @@ function helmet(options = {}) {
 
 // src/config/loadConfig.ts
 import path16 from "path";
-import fs14 from "fs";
+import fs13 from "fs";
 var CONFIG_PRODUCT_FILE = "faapi-config.js";
 async function loadConfig(rootDir, dist) {
   const configProductPath = path16.resolve(rootDir, dist, CONFIG_PRODUCT_FILE);
-  if (fs14.existsSync(configProductPath)) {
+  if (fs13.existsSync(configProductPath)) {
     const module = await importWithCacheBust(configProductPath);
     return module.default ?? {};
   }
-  const hasSourceConfig = fs14.existsSync(path16.join(rootDir, "faapi.config.ts")) || fs14.existsSync(path16.join(rootDir, "faapi.config.js"));
+  const hasSourceConfig = fs13.existsSync(path16.join(rootDir, "faapi.config.ts")) || fs13.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`
@@ -4272,7 +4239,7 @@ async function loadConfig(rootDir, dist) {
 }
 
 // src/cli/loadEnv.ts
-import fs15 from "fs";
+import fs14 from "fs";
 import path17 from "path";
 function resolveEnv() {
   return process.env.NODE_ENV || "development";
@@ -4341,8 +4308,8 @@ function loadEnv(rootDir) {
   const merged = {};
   for (const file of files) {
     const filePath = path17.join(rootDir, file);
-    if (!fs15.existsSync(filePath)) continue;
-    const content = fs15.readFileSync(filePath, "utf-8");
+    if (!fs14.existsSync(filePath)) continue;
+    const content = fs14.readFileSync(filePath, "utf-8");
     const parsed = parseEnvFile(content, merged);
     Object.assign(merged, parsed);
   }
@@ -4354,7 +4321,7 @@ function loadEnv(rootDir) {
 }
 
 // src/cli/createAppCore.ts
-import fs22 from "fs";
+import fs21 from "fs";
 import path27 from "path";
 
 // src/router/sortRoutes.ts
@@ -4461,25 +4428,25 @@ function getWsIndex(routes) {
   wsIndexCache.set(routes, index);
   return index;
 }
-function matchRoute(routes, method, path32) {
+function matchRoute(routes, method, path31) {
   const index = getHttpIndex(routes);
   const upper = method.toUpperCase();
-  const hit = matchByMethod(index, upper, path32);
+  const hit = matchByMethod(index, upper, path31);
   if (hit) return hit;
   if (upper === "HEAD") {
-    return matchByMethod(index, "GET", path32);
+    return matchByMethod(index, "GET", path31);
   }
   return null;
 }
-function matchByMethod(index, method, path32) {
-  const staticHit = index.static.get(`${method}|${path32}`);
+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 = path32.split("/").filter(Boolean);
+  const pathSegments = path31.split("/").filter(Boolean);
   for (const entry of index.dynamics) {
     const route = entry.route;
     if (route.method !== method) {
@@ -4492,31 +4459,31 @@ function matchByMethod(index, method, path32) {
   }
   return null;
 }
-function matchWsRoute(wsRoutes, path32) {
+function matchWsRoute(wsRoutes, path31) {
   const index = getWsIndex(wsRoutes);
-  const staticHit = index.static.get(path32);
+  const staticHit = index.static.get(path31);
   if (staticHit) {
     return { route: staticHit, params: {} };
   }
   for (const route of index.dynamics) {
-    const params = matchDynamicPath(route.urlPath, path32, 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, path32) {
+function findAllowedMethods(routes, path31) {
   const index = getHttpIndex(routes);
   const methods = /* @__PURE__ */ new Set();
-  const staticMethods = index.methodsByStaticPath.get(path32);
+  const staticMethods = index.methodsByStaticPath.get(path31);
   if (staticMethods) {
     for (const method of staticMethods) {
       methods.add(method);
     }
   }
   if (index.dynamics.length > 0) {
-    const pathSegments = path32.split("/").filter(Boolean);
+    const pathSegments = path31.split("/").filter(Boolean);
     for (const entry of index.dynamics) {
       const params = matchSegments(
         entry.segments,
@@ -4534,10 +4501,10 @@ function findAllowedMethods(routes, path32) {
   }
   return Array.from(methods);
 }
-function matchDynamicPath(pattern, path32, paramNames, isCatchAll) {
+function matchDynamicPath(pattern, path31, paramNames, isCatchAll) {
   return matchSegments(
     pattern.split("/").filter(Boolean),
-    path32.split("/").filter(Boolean),
+    path31.split("/").filter(Boolean),
     paramNames,
     isCatchAll
   );
@@ -5676,9 +5643,9 @@ async function validateInput(schemaPath, method, inputType, input) {
 function mapZodIssues(error) {
   return error.issues.map((issue) => {
     const code = mapZodCode(issue);
-    const path32 = issue.path.map(String).join(".") || "";
+    const path31 = issue.path.map(String).join(".") || "";
     return {
-      path: path32,
+      path: path31,
       code,
       expected: issue.expected ?? mapExpectedFromMessage(issue.message),
       received: issue.received ?? mapReceivedFromMessage(issue.message),
@@ -5899,13 +5866,13 @@ function etag(options = {}) {
 }
 
 // src/server/handleWsUpgrade.ts
-import fs17 from "fs";
+import fs16 from "fs";
 import { WebSocketServer, WebSocket } from "ws";
 import path19 from "path";
 
 // src/cli/copyResources.ts
 import path18 from "path";
-import fs16 from "fs";
+import fs15 from "fs";
 var RESOURCES_OUTPUT_DIR = "resources";
 function resolveResourcesDir(rootDir, dist) {
   return path18.resolve(rootDir, dist, RESOURCES_OUTPUT_DIR);
@@ -6049,7 +6016,7 @@ async function loadWsHandler(filePath, ctx, rootDir) {
     const dist = getDevDist();
     if (dist) {
       const sourcePath = prodPathToSourcePath(filePath, rootDir, dist);
-      if (sourcePath && fs17.existsSync(sourcePath)) {
+      if (sourcePath && fs16.existsSync(sourcePath)) {
         await ensureCompiled(sourcePath, rootDir, dist);
       }
     }
@@ -6191,7 +6158,7 @@ function attachWebSocket(options) {
     let upgraded = false;
     const finalHandler = async () => {
       const schemaPath = getRuntimeSchemaPath(route.filePath, dist, rootDir);
-      if (fs17.existsSync(schemaPath)) {
+      if (fs16.existsSync(schemaPath)) {
         if (isDevOnDemandEnabled()) {
           const devDist = getDevDist();
           if (devDist) {
@@ -6713,7 +6680,7 @@ function applyPluginWrappers(server, handlerWrappers, upgradeWrappers) {
 }
 
 // src/cli/generateRoutes.ts
-import fs18 from "fs";
+import fs17 from "fs";
 import path21 from "path";
 async function hydrateRoutes(manifest) {
   const hydrateRoute = (serialized) => ({
@@ -6759,12 +6726,12 @@ function createIdleTaskDriver() {
 
 // src/cli/loadPlugins.ts
 import path23 from "path";
-import fs20 from "fs";
+import fs19 from "fs";
 import { pathToFileURL as pathToFileURL3 } from "url";
 
 // src/cli/compileConfig.ts
 import path22 from "path";
-import fs19 from "fs";
+import fs18 from "fs";
 async function compileProjectModules(entryPoints, rootDir, dist) {
   const { insideFiles, outsideFiles } = await collectRelativeImports(entryPoints, rootDir);
   const esbuild = await import("esbuild");
@@ -6865,12 +6832,12 @@ 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)) && fs20.existsSync(base)) return base;
+  if ((TS_EXTS.test(base) || JS_EXTS.test(base)) && fs19.existsSync(base)) return base;
   for (const ext of [".ts", ".js"]) {
-    if (fs20.existsSync(base + ext)) return base + ext;
+    if (fs19.existsSync(base + ext)) return base + ext;
   }
   for (const indexExt of ["/index.ts", "/index.js"]) {
-    if (fs20.existsSync(base + indexExt)) return base + indexExt;
+    if (fs19.existsSync(base + indexExt)) return base + indexExt;
   }
   return null;
 }
@@ -6887,7 +6854,7 @@ async function importPluginModule(specifier, baseDir, dist) {
   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 && fs20.existsSync(productPath) && (sourcePath === null || isProductFresh(sourcePath, productPath))) {
+  if (productPath !== null && fs19.existsSync(productPath) && (sourcePath === null || isProductFresh(sourcePath, productPath))) {
     return import(pathToFileURL3(productPath).href);
   }
   if (sourcePath && TS_EXTS.test(sourcePath)) {
@@ -6902,7 +6869,7 @@ async function importPluginModule(specifier, baseDir, dist) {
     } else {
       await compileProjectModules([sourcePath], baseDir, dist);
     }
-    if (productPath && fs20.existsSync(productPath)) {
+    if (productPath && fs19.existsSync(productPath)) {
       return import(pathToFileURL3(productPath).href);
     }
   }
@@ -6939,7 +6906,7 @@ function resolveDeclaration(decl) {
 }
 
 // src/cli/manifestLoader.ts
-import fs21 from "fs";
+import fs20 from "fs";
 import path26 from "path";
 
 // src/cli/generateAgentArtifacts.ts
@@ -6951,12 +6918,21 @@ init_resolveTypeNode();
 function extractAgentMetadata(program, filePath, pathMeta) {
   const sourceFile = program.getSourceFile(filePath);
   if (!sourceFile) return null;
+  const runOwner = findRunExportOwner(sourceFile);
+  if (runOwner) {
+    throw SchemaExtractionError.at(
+      runOwner,
+      "run",
+      "agent \u81EA\u5B9A\u4E49 run \u5DF2\u79FB\u9664\u2014\u2014agent \u7EDF\u4E00\u4E3A\u58F0\u660E\u5F0F\u6267\u884C\uFF08config + \u9ED8\u8BA4 reactLoop\uFF09\u3002\u7F16\u6392\u573A\u666F\u8BF7\u6CE8\u518C tool\uFF08src/tools/ \u4E0B\u5BFC\u51FA\u51FD\u6570\uFF0C\u6709 schema/trace/\u9274\u6743\u94A9\u5B50\uFF09\uFF0C\u591A agent \u534F\u4F5C\u7528 config.agents \u58F0\u660E sub-agent",
+      sourceFile
+    );
+  }
   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",
+      "agent \u5FC5\u586B\u2014\u2014\u8BF7\u5728 config \u5757\u58F0\u660E systemPrompt\uFF08\u5B57\u7B26\u4E32\u5B57\u9762\u91CF\u3001\u65E0\u63D2\u503C\u6A21\u677F\u5B57\u7B26\u4E32\u6216\u5176 + \u62FC\u63A5\uFF09\u6216 systemPromptFile\uFF08\u76F8\u5BF9 resources \u76EE\u5F55\u7684\u8DEF\u5F84\u5B57\u9762\u91CF\uFF09\u4E8C\u9009\u4E00",
       sourceFile
     );
   }
@@ -6972,16 +6948,13 @@ function extractAgentMetadata(program, filePath, pathMeta) {
   const jsDoc = getJSDocFromNode(configFound.jsDocOwner);
   const description = extractDescription(jsDoc);
   const agentNameOverride = extractJSDocTagValue(jsDoc, "agent");
-  const { systemPrompt, tools, agents, model, maxTurns, inputDescription } = extractConfigFields(
-    objectLiteral,
-    sourceFile
-  );
+  const { systemPrompt, systemPromptFile, tools, agents, model, maxTurns, inputDescription } = extractConfigFields(objectLiteral, sourceFile);
   return {
     name: agentNameOverride ?? pathMeta.name,
     description,
     filePath: pathMeta.filePath,
-    hasRun: pathMeta.hasRun,
     systemPrompt,
+    systemPromptFile,
     tools,
     agents,
     model,
@@ -6989,6 +6962,25 @@ function extractAgentMetadata(program, filePath, pathMeta) {
     inputDescription
   };
 }
+function findRunExportOwner(sourceFile) {
+  let result = null;
+  ts11.forEachChild(sourceFile, (node) => {
+    if (result) return;
+    if (ts11.isFunctionDeclaration(node) && hasExportModifier(node) && node.name?.text === "run") {
+      result = node;
+      return;
+    }
+    if (ts11.isVariableStatement(node) && hasExportModifier(node)) {
+      for (const decl of node.declarationList.declarations) {
+        if (ts11.isIdentifier(decl.name) && decl.name.text === "run") {
+          result = node;
+          return;
+        }
+      }
+    }
+  });
+  return result;
+}
 function findConfigExport(sourceFile) {
   let result = null;
   ts11.forEachChild(sourceFile, (node) => {
@@ -7031,6 +7023,7 @@ function getReturnObjectLiteral(fn) {
 }
 function extractConfigFields(objLit, sourceFile) {
   let systemPrompt;
+  let systemPromptFile;
   let tools;
   let agents;
   let model;
@@ -7054,6 +7047,9 @@ function extractConfigFields(objLit, sourceFile) {
       case "systemPrompt":
         systemPrompt = requireStringValue(prop, "systemPrompt", sourceFile);
         break;
+      case "systemPromptFile":
+        systemPromptFile = requireStringValue(prop, "systemPromptFile", sourceFile);
+        break;
       case "tools":
         tools = requireStringArrayValue(prop, "tools", sourceFile);
         break;
@@ -7073,20 +7069,28 @@ function extractConfigFields(objLit, sourceFile) {
         throw SchemaExtractionError.at(
           prop,
           `config.${propName}`,
-          "\u672A\u77E5 config \u5B57\u6BB5\u2014\u2014\u4EC5\u652F\u6301 systemPrompt / tools / agents / model / maxTurns / inputDescription",
+          "\u672A\u77E5 config \u5B57\u6BB5\u2014\u2014\u4EC5\u652F\u6301 systemPrompt / systemPromptFile / tools / agents / model / maxTurns / inputDescription",
           sourceFile
         );
     }
   }
-  if (systemPrompt === void 0) {
+  if (systemPrompt !== void 0 && systemPromptFile !== void 0) {
+    throw SchemaExtractionError.at(
+      objLit,
+      "config.systemPrompt",
+      "systemPrompt \u4E0E systemPromptFile \u4E92\u65A5\u2014\u2014\u5185\u8054\u7CFB\u7EDF\u63D0\u793A\u8BCD\u4E0E resources \u6587\u4EF6\u4E8C\u9009\u4E00",
+      sourceFile
+    );
+  }
+  if (systemPrompt === void 0 && systemPromptFile === void 0) {
     throw SchemaExtractionError.at(
       objLit,
       "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",
+      "agent \u5FC5\u586B\u2014\u2014\u8BF7\u5728 config \u5757\u58F0\u660E systemPrompt\uFF08\u5B57\u7B26\u4E32\u5B57\u9762\u91CF\u3001\u65E0\u63D2\u503C\u6A21\u677F\u5B57\u7B26\u4E32\u6216\u5176 + \u62FC\u63A5\uFF09\u6216 systemPromptFile\uFF08\u76F8\u5BF9 resources \u76EE\u5F55\u7684\u8DEF\u5F84\u5B57\u9762\u91CF\uFF09\u4E8C\u9009\u4E00",
       sourceFile
     );
   }
-  return { systemPrompt, tools, agents, model, maxTurns, inputDescription };
+  return { systemPrompt, systemPromptFile, tools, agents, model, maxTurns, inputDescription };
 }
 function getPropertyName(name) {
   if (ts11.isIdentifier(name)) return name.text;
@@ -7169,8 +7173,8 @@ function serializeAgents(agents, dist = "dist") {
   return agents.map((a) => ({
     name: a.name,
     description: a.description,
-    hasRun: a.hasRun,
     systemPrompt: a.systemPrompt,
+    systemPromptFile: a.systemPromptFile,
     tools: a.tools,
     agents: a.agents,
     model: a.model,
@@ -7190,8 +7194,8 @@ function hydrateAgents(manifest) {
     name: a.name,
     description: a.description ?? void 0,
     filePath: a.filePath,
-    hasRun: a.hasRun,
     systemPrompt: a.systemPrompt ?? void 0,
+    systemPromptFile: a.systemPromptFile ?? void 0,
     tools: a.tools ?? void 0,
     agents: a.agents ?? void 0,
     model: a.model ?? void 0,
@@ -7229,8 +7233,7 @@ async function generateAgentArtifacts(agents, rootDir, dist) {
     const program = programByFile.get(absPath);
     const result = extractAgentMetadata(program, absPath, {
       name: manifest.name,
-      filePath: manifest.filePath,
-      hasRun: manifest.hasRun
+      filePath: manifest.filePath
     });
     if (!result) {
       throw new Error(
@@ -7379,7 +7382,7 @@ var TOOLS_FILE2 = "faapi-tools.js";
 var AGENTS_FILE2 = "faapi-agents.js";
 async function loadAndHydrateTools(rootDir, dist, registries = defaultRegistries) {
   const toolsPath = path26.resolve(rootDir, dist, TOOLS_FILE2);
-  if (!fs21.existsSync(toolsPath)) {
+  if (!fs20.existsSync(toolsPath)) {
     return [];
   }
   const serialized = await importWithCacheBust(toolsPath);
@@ -7389,7 +7392,7 @@ async function loadAndHydrateTools(rootDir, dist, registries = defaultRegistries
 }
 async function loadAndHydrateAgents(rootDir, dist, registries = defaultRegistries) {
   const agentsPath = path26.resolve(rootDir, dist, AGENTS_FILE2);
-  if (!fs21.existsSync(agentsPath)) {
+  if (!fs20.existsSync(agentsPath)) {
     return [];
   }
   const serialized = await importWithCacheBust(agentsPath);
@@ -7405,7 +7408,7 @@ function getTaskDriverOptions(config) {
 }
 async function loadAndHydrateTasks(rootDir, dist, registries = defaultRegistries) {
   const tasksPath = path26.resolve(rootDir, dist, TASKS_FILE);
-  if (!fs21.existsSync(tasksPath)) {
+  if (!fs20.existsSync(tasksPath)) {
     return [];
   }
   const serialized = await importWithCacheBust(tasksPath);
@@ -7582,8 +7585,7 @@ function logStartupSummary(routes, wsRoutes, tools, agents, taskMetas, p) {
   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}`);
+      console.log(`  ${agent.name}  ${agent.filePath}`);
     }
   }
   if (taskMetas.length > 0) {
@@ -7599,7 +7601,7 @@ async function createAppBase(options) {
   const dist = options?.dist ?? process.env.FAAPI_DIST ?? DEFAULT_DIST;
   const resourcesDir = resolveResourcesDir(rootDir, dist);
   const routesPath = path27.resolve(rootDir, dist, ROUTES_FILE);
-  if (!fs22.existsSync(routesPath)) {
+  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`
     );
@@ -7620,6 +7622,7 @@ async function createAppBase(options) {
     registry: registries.task,
     rootDir,
     config,
+    resourcesDir,
     registries: createTaskRegistriesView(registries),
     driver: taskDriver,
     onFailed: config?.task?.onFailed
@@ -7661,6 +7664,7 @@ async function createAppBase(options) {
     config?.plugins,
     {
       rootDir,
+      resourcesDir,
       registries,
       routes: sorted,
       getRoutes: () => sorted,
@@ -7815,21 +7819,21 @@ async function createAppBase(options) {
 }
 
 // src/cli/createDevApp.ts
-import path31 from "path";
+import path30 from "path";
 
 // src/router/scanRoutes.ts
 import fg3 from "fast-glob";
 import path28 from "path";
-import fs23 from "fs";
+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(path32) {
-  if (!path32) return "";
-  let result = path32.replace(/\\/g, "/");
+function normalizePath(path31) {
+  if (!path31) return "";
+  let result = path31.replace(/\\/g, "/");
   result = result.replace(/\/+/g, "/");
   result = result.replace(/\/+$/, "");
   if (result && !result.startsWith("/")) {
@@ -7900,7 +7904,7 @@ function collectMiddlewarePaths(routeFilePath, rootDir, dist) {
       const mwJsPath = path28.join(currentDir, "middlewares.js");
       const absTsPath = path28.resolve(rootDir, mwTsPath);
       const absJsPath = path28.resolve(rootDir, mwJsPath);
-      const absMwPath = fs23.existsSync(absTsPath) ? absTsPath : fs23.existsSync(absJsPath) ? absJsPath : null;
+      const absMwPath = fs22.existsSync(absTsPath) ? absTsPath : fs22.existsSync(absJsPath) ? absJsPath : null;
       if (absMwPath) {
         const relMwPath = path28.relative(rootDir, absMwPath);
         const prodAbsPath = path28.resolve(rootDir, toProdFilePath(relMwPath, dist));
@@ -7910,7 +7914,7 @@ function collectMiddlewarePaths(routeFilePath, rootDir, dist) {
       for (const ext of [".ts", ".js"]) {
         const mwPath = path28.join(currentDir, `middlewares${ext}`);
         const absMwPath = path28.resolve(rootDir, mwPath);
-        if (fs23.existsSync(absMwPath)) {
+        if (fs22.existsSync(absMwPath)) {
           paths.push(absMwPath);
           break;
         }
@@ -7949,7 +7953,7 @@ async function scanRoutes(rootDir, patterns, dist) {
         const mwPaths = collectMiddlewarePaths(normalizedFile, rootDir);
         middlewareBundle = await loadMergedMiddlewares(mwPaths);
       }
-      const source = await fs23.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) {
@@ -7986,7 +7990,7 @@ async function scanRoutes(rootDir, patterns, dist) {
 // src/tools/scanTools.ts
 import fg4 from "fast-glob";
 import path29 from "path";
-import fs24 from "fs";
+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*(?:\(|=)`,
@@ -8037,7 +8041,7 @@ async function scanTools(rootDir, patterns) {
       continue;
     }
     const absPath = path29.resolve(rootDir, normalizedFile);
-    const source = await fs24.promises.readFile(absPath, "utf8").catch(() => "");
+    const source = await fs23.promises.readFile(absPath, "utf8").catch(() => "");
     const exportNames = extractToolExportsFromSource(source);
     const namespace = filePathToToolNamespace(normalizedFile);
     for (const fnName of exportNames) {
@@ -8061,10 +8065,7 @@ async function scanTools(rootDir, patterns) {
 
 // src/agents/scanAgents.ts
 import fg5 from "fast-glob";
-import path30 from "path";
-import fs25 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) {
   const normalized = filePath.replace(/\\/g, "/");
   const match = normalized.match(/(?:^|\/)agents\/(.+)\/handler\.ts$/);
@@ -8075,11 +8076,6 @@ function extractAgentNameFromPath(filePath) {
   }
   return match[1].replace(/\//g, ".");
 }
-function detectAgentExports(source) {
-  return {
-    hasRun: RUN_EXPORT_RE.test(source)
-  };
-}
 async function scanAgents(rootDir, patterns) {
   const files = await fg5(patterns, {
     cwd: rootDir,
@@ -8094,9 +8090,6 @@ async function scanAgents(rootDir, patterns) {
     if (fileName !== "handler.ts" && fileName !== "handler.js") {
       continue;
     }
-    const absPath = path30.resolve(rootDir, normalizedFile);
-    const source = await fs25.promises.readFile(absPath, "utf8").catch(() => "");
-    const { hasRun } = detectAgentExports(source);
     const name = extractAgentNameFromPath(normalizedFile);
     const prevFile = seen.get(name);
     if (prevFile) {
@@ -8107,8 +8100,7 @@ async function scanAgents(rootDir, patterns) {
     seen.set(name, normalizedFile);
     agents.push({
       name,
-      filePath: normalizedFile,
-      hasRun
+      filePath: normalizedFile
     });
   }
   return agents;
@@ -8166,7 +8158,7 @@ async function createDevApp(options) {
     if (!suppressProgramInvalidation) invalidateProgramCache();
     const tasks = await scanTasks(ctx.rootDir, TASK_PATTERNS);
     for (const task of tasks) {
-      await ensureCompiled(path31.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();
@@ -8232,7 +8224,6 @@ export {
   hydrateSkillRegistry,
   invalidateProgramCache,
   listSkills,
-  loadAgentModule,
   loadConfig,
   loadEnv,
   loadTaskDriver,