@faapi/faapi 6.22.0 → 6.24.0

package/dist/cli/index.js

@@ -3082,8 +3082,6 @@ var init_generateToolArtifacts = __esm({
 
 // src/agents/scanAgents.ts
 import fg3 from "fast-glob";
-import path15 from "path";
-import fs12 from "fs";
 function extractAgentNameFromPath(filePath) {
   const normalized = filePath.replace(/\\/g, "/");
   const match = normalized.match(/(?:^|\/)agents\/(.+)\/handler\.ts$/);
@@ -3094,11 +3092,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 fg3(patterns, {
     cwd: rootDir,
@@ -3113,9 +3106,6 @@ async function scanAgents(rootDir, patterns) {
     if (fileName !== "handler.ts" && fileName !== "handler.js") {
       continue;
     }
-    const absPath = path15.resolve(rootDir, normalizedFile);
-    const source = await fs12.promises.readFile(absPath, "utf8").catch(() => "");
-    const { hasRun } = detectAgentExports(source);
     const name = extractAgentNameFromPath(normalizedFile);
     const prevFile = seen.get(name);
     if (prevFile) {
@@ -3126,18 +3116,16 @@ async function scanAgents(rootDir, patterns) {
     seen.set(name, normalizedFile);
     agents.push({
       name,
-      filePath: normalizedFile,
-      hasRun
+      filePath: normalizedFile
     });
   }
   return agents;
 }
-var DEFAULT_AGENT_PATTERNS, RUN_EXPORT_RE;
+var DEFAULT_AGENT_PATTERNS;
 var init_scanAgents = __esm({
   "src/agents/scanAgents.ts"() {
     "use strict";
     DEFAULT_AGENT_PATTERNS = ["src/agents/**/handler.ts"];
-    RUN_EXPORT_RE = /export\s+(?:async\s+)?(?:function\s+|const\s+)run\b/;
   }
 });
 
@@ -3146,12 +3134,21 @@ import ts11 from "typescript";
 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
     );
   }
@@ -3167,16 +3164,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,
@@ -3184,6 +3178,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) => {
@@ -3226,6 +3239,7 @@ function getReturnObjectLiteral(fn) {
 }
 function extractConfigFields(objLit, sourceFile) {
   let systemPrompt;
+  let systemPromptFile;
   let tools;
   let agents;
   let model;
@@ -3249,6 +3263,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;
@@ -3268,20 +3285,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;
@@ -3364,13 +3389,13 @@ var init_extractAgentMetadata = __esm({
 });
 
 // src/cli/generateAgentArtifacts.ts
-import path16 from "path";
+import path15 from "path";
 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,
@@ -3390,8 +3415,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,
@@ -3423,14 +3448,13 @@ function validateAgentList(metadata) {
 }
 async function generateAgentArtifacts(agents, rootDir, dist) {
   const metadata = [];
-  const programByFile = createPrograms(agents.map((m) => path16.resolve(rootDir, m.filePath)));
+  const programByFile = createPrograms(agents.map((m) => path15.resolve(rootDir, m.filePath)));
   for (const manifest of agents) {
-    const absPath = path16.resolve(rootDir, manifest.filePath);
+    const absPath = path15.resolve(rootDir, manifest.filePath);
     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(
@@ -3441,7 +3465,7 @@ async function generateAgentArtifacts(agents, rootDir, dist) {
   }
   validateAgentList(metadata);
   const serialized = serializeAgents(metadata, dist);
-  const agentsPath = path16.resolve(rootDir, dist, AGENTS_FILE);
+  const agentsPath = path15.resolve(rootDir, dist, AGENTS_FILE);
   await writeAgentsModule(serialized, agentsPath);
   return metadata;
 }
@@ -3459,8 +3483,8 @@ var init_generateAgentArtifacts = __esm({
 
 // src/task/scanTasks.ts
 import fg4 from "fast-glob";
-import path17 from "path";
-import fs13 from "fs";
+import path16 from "path";
+import fs12 from "fs";
 function parseNumericLiteral(raw) {
   return Number(raw.replace(/_/g, ""));
 }
@@ -3482,12 +3506,12 @@ async function scanTasks(rootDir, patterns) {
   const seen = /* @__PURE__ */ new Map();
   for (const file of files) {
     const normalizedFile = file.replace(/\\/g, "/");
-    const fileName = path17.posix.basename(normalizedFile);
+    const fileName = path16.posix.basename(normalizedFile);
     if (fileName !== TASK_FILENAME) {
       continue;
     }
-    const absPath = path17.resolve(rootDir, normalizedFile);
-    const source = await fs13.promises.readFile(absPath, "utf8").catch(() => "");
+    const absPath = path16.resolve(rootDir, normalizedFile);
+    const source = await fs12.promises.readFile(absPath, "utf8").catch(() => "");
     const name = filePathToTaskName(normalizedFile);
     const prevFile = seen.get(name);
     if (prevFile) {
@@ -3536,7 +3560,7 @@ var init_scanTasks = __esm({
 });
 
 // src/cli/generateTaskArtifacts.ts
-import path18 from "path";
+import path17 from "path";
 function serializeTasks(tasks, dist = "dist") {
   return tasks.map((t) => ({
     name: t.name,
@@ -3569,7 +3593,7 @@ function collectTaskSchemaSources(tasks, rootDir) {
   const tasksByFile = /* @__PURE__ */ new Map();
   for (const task of tasks) {
     if (!task.inputTypeName) continue;
-    const absPath = path18.resolve(rootDir, task.filePath);
+    const absPath = path17.resolve(rootDir, task.filePath);
     let list = tasksByFile.get(absPath);
     if (!list) {
       list = [];
@@ -3626,9 +3650,9 @@ function generateTaskSchemaFileSource(sources, resolveType, helpersImportPath) {
 async function generateTaskArtifacts(manifests, rootDir, dist) {
   const metadata = [];
   if (manifests.length > 0) {
-    const programByFile = createPrograms(manifests.map((m) => path18.resolve(rootDir, m.filePath)));
+    const programByFile = createPrograms(manifests.map((m) => path17.resolve(rootDir, m.filePath)));
     for (const manifest of manifests) {
-      const absPath = path18.resolve(rootDir, manifest.filePath);
+      const absPath = path17.resolve(rootDir, manifest.filePath);
       const result = extractToolMetadata(programByFile.get(absPath), absPath, "run", {
         name: manifest.name,
         filePath: manifest.filePath
@@ -3639,7 +3663,7 @@ async function generateTaskArtifacts(manifests, rootDir, dist) {
     }
   }
   const serialized = serializeTasks(manifests, dist);
-  const tasksPath = path18.resolve(rootDir, dist, TASKS_FILE);
+  const tasksPath = path17.resolve(rootDir, dist, TASKS_FILE);
   await writeTasksModule(serialized, tasksPath);
   if (metadata.length === 0) {
     return hydrateTasks(serialized);
@@ -3672,8 +3696,8 @@ var init_generateTaskArtifacts = __esm({
 });
 
 // src/cli/compileSourceFiles.ts
-import path19 from "path";
-import fs14 from "fs";
+import path18 from "path";
+import fs13 from "fs";
 import fg5 from "fast-glob";
 async function compileSourceFiles(options) {
   const { rootDir, dist, files, logLevel = "silent", production, atomicWrite } = options;
@@ -3681,16 +3705,16 @@ async function compileSourceFiles(options) {
     cwd: rootDir,
     onlyFiles: true,
     absolute: true,
-    ignore: ["**/*.test.ts", "**/*.e2e.test.ts", "**/*.d.ts"]
+    ignore: SOURCE_IGNORE
   });
   if (entryPoints.length === 0) {
     return { compiledFiles: [] };
   }
-  const absDist = path19.resolve(rootDir, dist);
-  await fs14.promises.mkdir(absDist, { recursive: true });
+  const absDist = path18.resolve(rootDir, dist);
+  await fs13.promises.mkdir(absDist, { recursive: true });
   const plugins = buildAliasPlugins(rootDir);
   const esbuild = await import("esbuild");
-  const outbase = path19.resolve(rootDir, APP_DIR);
+  const outbase = path18.resolve(rootDir, APP_DIR);
   const result = await esbuild.build({
     entryPoints,
     outdir: absDist,
@@ -3710,20 +3734,22 @@ async function compileSourceFiles(options) {
   if (atomicWrite && result.outputFiles) {
     await Promise.all(
       result.outputFiles.map(async (file) => {
-        await fs14.promises.mkdir(path19.dirname(file.path), { recursive: true });
+        await fs13.promises.mkdir(path18.dirname(file.path), { recursive: true });
         const tmp = `${file.path}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;
-        await fs14.promises.writeFile(tmp, file.contents);
-        await fs14.promises.rename(tmp, file.path);
+        await fs13.promises.writeFile(tmp, file.contents);
+        await fs13.promises.rename(tmp, file.path);
       })
     );
   }
   return { compiledFiles: entryPoints };
 }
+var SOURCE_IGNORE;
 var init_compileSourceFiles = __esm({
   "src/cli/compileSourceFiles.ts"() {
     "use strict";
     init_aliasPlugin();
     init_prodPaths();
+    SOURCE_IGNORE = ["**/*.test.ts", "**/*.e2e.test.ts", "**/*.d.ts", `${APP_DIR}/resources/**`];
   }
 });
 
@@ -3739,12 +3765,12 @@ var init_compileDevRoutes = __esm({
 });
 
 // src/cli/compileOnDemand.ts
-import path20 from "path";
-import fs15 from "fs";
+import path19 from "path";
+import fs14 from "fs";
 function isProductFresh(sourceAbsPath, productAbsPath) {
   try {
-    const srcStat = fs15.statSync(sourceAbsPath);
-    const prodStat = fs15.statSync(productAbsPath);
+    const srcStat = fs14.statSync(sourceAbsPath);
+    const prodStat = fs14.statSync(productAbsPath);
     return prodStat.mtimeMs >= srcStat.mtimeMs;
   } catch {
     return false;
@@ -3774,7 +3800,7 @@ async function ensureCompiled(sourceAbsPath, rootDir, dist) {
   if (state.compiledFiles.has(sourceAbsPath)) {
     return false;
   }
-  if (!fs15.existsSync(sourceAbsPath)) {
+  if (!fs14.existsSync(sourceAbsPath)) {
     return false;
   }
   const productPath = prodSourcePathToProductPath(sourceAbsPath, rootDir, dist);
@@ -3824,11 +3850,11 @@ async function ensureMiddlewaresCompiled(middlewarePaths, rootDir) {
   }
 }
 function prodSourcePathToProductPath(sourceAbsPath, rootDir, dist) {
-  const rel = path20.relative(rootDir, sourceAbsPath).replace(/\\/g, "/");
+  const rel = path19.relative(rootDir, sourceAbsPath).replace(/\\/g, "/");
   if (!rel.startsWith("src/")) return null;
   const relWithoutSrc = rel.slice(4);
   const jsRel = relWithoutSrc.replace(/\.ts$/, ".js");
-  return path20.resolve(rootDir, dist, jsRel);
+  return path19.resolve(rootDir, dist, jsRel);
 }
 function clearGeneratedSchemas() {
   state.generatedSchemas.clear();
@@ -3843,9 +3869,9 @@ async function ensureSchemaGenerated(schemaPath, routeFilePath, routes, rootDir,
   if (state.generatedSchemas.has(schemaPath)) {
     return false;
   }
-  const prodAbsPath = path20.resolve(rootDir, routeFilePath);
+  const prodAbsPath = path19.resolve(rootDir, routeFilePath);
   const sourceAbsPath = prodPathToSourcePath(prodAbsPath, rootDir, dist);
-  if (!fs15.existsSync(sourceAbsPath)) {
+  if (!fs14.existsSync(sourceAbsPath)) {
     return false;
   }
   if (isProductFresh(sourceAbsPath, schemaPath)) {
@@ -3857,7 +3883,7 @@ async function ensureSchemaGenerated(schemaPath, routeFilePath, routes, rootDir,
   if (fileRoutes.length === 0 && fileWsRoutes.length === 0) {
     return false;
   }
-  const sourceRelPath = path20.relative(rootDir, sourceAbsPath).replace(/\\/g, "/");
+  const sourceRelPath = path19.relative(rootDir, sourceAbsPath).replace(/\\/g, "/");
   const sourceRoutes = fileRoutes.map((r) => ({ ...r, filePath: sourceRelPath }));
   const sourceWsRoutes = fileWsRoutes.map((r) => ({ ...r, filePath: sourceRelPath }));
   const generatePromise = (async () => {
@@ -3879,7 +3905,7 @@ async function deleteSchemaFiles(routes, rootDir, dist) {
     if (deleted.has(schemaPath)) continue;
     deleted.add(schemaPath);
     try {
-      await fs15.promises.unlink(schemaPath);
+      await fs14.promises.unlink(schemaPath);
     } catch {
     }
   }
@@ -3887,19 +3913,19 @@ async function deleteSchemaFiles(routes, rootDir, dist) {
 function prodPathToSourcePath(prodAbsPath, rootDir, dist) {
   const cached = sourcePathCache.get(prodAbsPath);
   if (cached) return cached;
-  const rel = path20.relative(rootDir, prodAbsPath).replace(/\\/g, "/");
+  const rel = path19.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 = path20.resolve(rootDir, tsRel);
+  const tsAbs = path19.resolve(rootDir, tsRel);
   let result;
-  if (fs15.existsSync(tsAbs)) {
+  if (fs14.existsSync(tsAbs)) {
     result = tsAbs;
   } else {
-    result = path20.resolve(rootDir, srcRel);
+    result = path19.resolve(rootDir, srcRel);
   }
   sourcePathCache.set(prodAbsPath, result);
   return result;
@@ -3930,15 +3956,15 @@ var init_compileOnDemand = __esm({
 });
 
 // src/config/loadConfig.ts
-import path21 from "path";
-import fs16 from "fs";
+import path20 from "path";
+import fs15 from "fs";
 async function loadConfig(rootDir, dist) {
-  const configProductPath = path21.resolve(rootDir, dist, CONFIG_PRODUCT_FILE);
-  if (fs16.existsSync(configProductPath)) {
+  const configProductPath = path20.resolve(rootDir, dist, CONFIG_PRODUCT_FILE);
+  if (fs15.existsSync(configProductPath)) {
     const module = await importWithCacheBust(configProductPath);
     return module.default ?? {};
   }
-  const hasSourceConfig = fs16.existsSync(path21.join(rootDir, "faapi.config.ts")) || fs16.existsSync(path21.join(rootDir, "faapi.config.js"));
+  const hasSourceConfig = fs15.existsSync(path20.join(rootDir, "faapi.config.ts")) || fs15.existsSync(path20.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`
@@ -3956,8 +3982,8 @@ var init_loadConfig = __esm({
 });
 
 // src/cli/loadEnv.ts
-import fs17 from "fs";
-import path22 from "path";
+import fs16 from "fs";
+import path21 from "path";
 function resolveEnv() {
   return process.env.NODE_ENV || "development";
 }
@@ -4024,9 +4050,9 @@ function loadEnv(rootDir) {
   const files = getEnvFiles(env);
   const merged = {};
   for (const file of files) {
-    const filePath = path22.join(rootDir, file);
-    if (!fs17.existsSync(filePath)) continue;
-    const content = fs17.readFileSync(filePath, "utf-8");
+    const filePath = path21.join(rootDir, file);
+    if (!fs16.existsSync(filePath)) continue;
+    const content = fs16.readFileSync(filePath, "utf-8");
     const parsed = parseEnvFile(content, merged);
     Object.assign(merged, parsed);
   }
@@ -5816,6 +5842,53 @@ var init_rebuildScheduler = __esm({
   }
 });
 
+// src/cli/copyResources.ts
+import path22 from "path";
+import fs17 from "fs";
+function isResourceSourcePath(rootDir, absPath) {
+  return isInsideDir(absPath, path22.resolve(rootDir, RESOURCES_DIR));
+}
+function resolveResourcesDir(rootDir, dist) {
+  return path22.resolve(rootDir, dist, RESOURCES_OUTPUT_DIR);
+}
+async function copyResources(rootDir, dist) {
+  const sourceDir = path22.resolve(rootDir, RESOURCES_DIR);
+  if (!fs17.existsSync(sourceDir)) return false;
+  const outDir = resolveResourcesDir(rootDir, dist);
+  await fs17.promises.rm(outDir, { recursive: true, force: true });
+  await fs17.promises.cp(sourceDir, outDir, { recursive: true });
+  return true;
+}
+async function copyResourceFile(rootDir, dist, absSourceFile) {
+  const sourceDir = path22.resolve(rootDir, RESOURCES_DIR);
+  if (!isInsideDir(absSourceFile, sourceDir)) {
+    throw new Error(`[faapi] copyResourceFile: ${absSourceFile} is not under ${RESOURCES_DIR}`);
+  }
+  if (!fs17.existsSync(absSourceFile)) return;
+  const rel = path22.relative(sourceDir, absSourceFile);
+  const dest = path22.join(resolveResourcesDir(rootDir, dist), rel);
+  await fs17.promises.mkdir(path22.dirname(dest), { recursive: true });
+  await fs17.promises.cp(absSourceFile, dest);
+}
+async function removeResourceFile(rootDir, dist, absSourceFile) {
+  const sourceDir = path22.resolve(rootDir, RESOURCES_DIR);
+  if (!isInsideDir(absSourceFile, sourceDir)) {
+    throw new Error(`[faapi] removeResourceFile: ${absSourceFile} is not under ${RESOURCES_DIR}`);
+  }
+  const rel = path22.relative(sourceDir, absSourceFile);
+  const dest = path22.join(resolveResourcesDir(rootDir, dist), rel);
+  await fs17.promises.rm(dest, { force: true });
+}
+var RESOURCES_DIR, RESOURCES_OUTPUT_DIR;
+var init_copyResources = __esm({
+  "src/cli/copyResources.ts"() {
+    "use strict";
+    init_prodPaths();
+    RESOURCES_DIR = "src/resources";
+    RESOURCES_OUTPUT_DIR = "resources";
+  }
+});
+
 // src/cli/watcher.ts
 import path23 from "path";
 import { existsSync as existsSync2 } from "fs";
@@ -5865,6 +5938,7 @@ function startWatcher(options) {
       }
       if (!stats) return false;
       if (stats.isDirectory()) return false;
+      if (isResourceSourcePath(rootDir, path23.resolve(rootDir, filePath))) return false;
       return !filePath.endsWith(".ts") && !filePath.endsWith(".js");
     }
   });
@@ -5872,6 +5946,15 @@ function startWatcher(options) {
   watcher.on("change", (file) => handleFileEvent(file));
   function handleFileEvent(file) {
     const abs = path23.resolve(rootDir, file);
+    if (isResourceSourcePath(rootDir, abs)) {
+      void copyResourceFile(rootDir, devDist, abs).catch((err) => {
+        console.error(
+          "- Error copying resource:",
+          err instanceof Error ? err.message : String(err)
+        );
+      });
+      return;
+    }
     if (scheduleOnly.has(abs)) {
       scheduler.schedule();
       return;
@@ -5882,7 +5965,17 @@ function startWatcher(options) {
     scheduler.addFiles([abs]);
   }
   watcher.on("unlink", (file) => {
-    scheduler.removeFiles([path23.resolve(rootDir, file)]);
+    const abs = path23.resolve(rootDir, file);
+    if (isResourceSourcePath(rootDir, abs)) {
+      void removeResourceFile(rootDir, devDist, abs).catch((err) => {
+        console.error(
+          "- Error removing resource:",
+          err instanceof Error ? err.message : String(err)
+        );
+      });
+      return;
+    }
+    scheduler.removeFiles([abs]);
     scheduler.schedule();
   });
   watcher.on("error", (err) => {
@@ -5903,6 +5996,7 @@ var init_watcher = __esm({
     init_compileDevRoutes();
     init_compileConfig();
     init_rebuildScheduler();
+    init_copyResources();
   }
 });
 
@@ -6962,10 +7056,18 @@ function formatSetCookie(name, value, options) {
   if (options?.sameSite) cookie += `; SameSite=${options.sameSite}`;
   return cookie;
 }
-function createContext(request, params, config = {}, ip = "", registries) {
-  return createContextFromUrl(request, new URL(request.url), params, config, ip, registries);
+function createContext(request, params, config = {}, ip = "", registries, resourcesDir) {
+  return createContextFromUrl(
+    request,
+    new URL(request.url),
+    params,
+    config,
+    ip,
+    registries,
+    resourcesDir
+  );
 }
-function createContextFromUrl(request, url, params, config = {}, ip = "", registries) {
+function createContextFromUrl(request, url, params, config = {}, ip = "", registries, resourcesDir) {
   const meta = { headers: {}, setCookies: [] };
   const parsedCookies = parseCookies(request.headers.get("cookie") ?? "");
   const cookiesObj = {};
@@ -6993,6 +7095,9 @@ function createContextFromUrl(request, url, params, config = {}, ip = "", regist
     ua: request.headers.get("user-agent") ?? "",
     cookies: cookiesObj,
     config,
+    // 运行时资源根目录（HTTP/WS 链路由 createServer/handleWsUpgrade 传入；
+    // testing 直调未传时为 undefined，见 contextTypes.resourcesDir 注释）
+    resourcesDir,
     meta,
     setStatus(status) {
       meta.status = status;
@@ -8528,6 +8633,7 @@ function attachWebSocket(options) {
     trustedProxy = false,
     registries
   } = options;
+  const resourcesDir = resolveResourcesDir(rootDir, dist);
   const wss = new WebSocketServer({ noServer: true });
   server.on("upgrade", async (req, socket, head) => {
     try {
@@ -8559,7 +8665,14 @@ function attachWebSocket(options) {
     const host = req.headers.host ?? "localhost";
     const fullUrl = new URL(`http://${host}${req.url ?? "/"}`);
     const request = new Request(fullUrl.toString(), { method: "GET", headers });
-    const ctx = createContext(request, params, config, getClientIp(req, trustedProxy), registries);
+    const ctx = createContext(
+      request,
+      params,
+      config,
+      getClientIp(req, trustedProxy),
+      registries,
+      resourcesDir
+    );
     const meta = ctx.meta;
     let upgraded = false;
     const finalHandler = async () => {
@@ -8661,6 +8774,7 @@ var init_handleWsUpgrade = __esm({
     "use strict";
     init_matchRoute();
     init_createContext();
+    init_copyResources();
     init_invokeHandler();
     init_importWithCacheBust();
     init_getClientIp();
@@ -8787,6 +8901,7 @@ function createServer(options) {
     trustedProxy = false
   } = options;
   const routesRef = { current: routes, wsCurrent: wsRoutes ?? [] };
+  const resourcesDir = resolveResourcesDir(rootDir, dist);
   const configMiddlewares = [];
   if (compressionOption) {
     const compOpts = typeof compressionOption === "object" ? compressionOption : {};
@@ -8833,7 +8948,8 @@ function createServer(options) {
       bodyLimit,
       trustedProxy,
       registries,
-      routesRef.wsCurrent
+      routesRef.wsCurrent,
+      resourcesDir
     ).catch((err) => {
       console.error("[faapi] Request pipeline failed after error response attempt:", err);
       try {
@@ -8859,7 +8975,7 @@ function createServer(options) {
   });
   return { server, routesRef };
 }
-function prepareRequest(req, request, url, config, trustedProxy, registries, preMatched) {
+function prepareRequest(req, request, url, config, trustedProxy, registries, preMatched, resourcesDir) {
   const method = request.method.toUpperCase();
   const urlPath = url.pathname;
   const ctx = createContextFromUrl(
@@ -8868,7 +8984,8 @@ function prepareRequest(req, request, url, config, trustedProxy, registries, pre
     preMatched?.params ?? {},
     config,
     getClientIp(req, trustedProxy),
-    registries
+    registries,
+    resourcesDir
   );
   const meta = ctx.meta;
   return { request, url, ctx, meta, method, urlPath };
@@ -9008,7 +9125,7 @@ async function sendErrorResponse(err, meta, res, onError, ctx) {
     }
   }
 }
-async function handleRequest(routes, rootDir, dist, req, res, outerMiddlewares, onError, config, globalInjectors, bodyLimit, trustedProxy, registries, wsRoutes) {
+async function handleRequest(routes, rootDir, dist, req, res, outerMiddlewares, onError, config, globalInjectors, bodyLimit, trustedProxy, registries, wsRoutes, resourcesDir) {
   let meta = { headers: {}, setCookies: [] };
   let ctx;
   let sseEarlySent = false;
@@ -9028,7 +9145,8 @@ async function handleRequest(routes, rootDir, dist, req, res, outerMiddlewares,
       config,
       trustedProxy,
       registries,
-      preMatched
+      preMatched,
+      resourcesDir
     );
     ctx = prepared.ctx;
     meta = prepared.meta;
@@ -9097,6 +9215,7 @@ var init_createServer = __esm({
     init_handleWsUpgrade();
     init_serverUtils();
     init_generateSchemaFiles();
+    init_copyResources();
     init_compileOnDemand();
     init_loadMiddlewares();
     DEFAULT_BODY_LIMIT = 10 * 1024 * 1024;
@@ -9317,7 +9436,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
       });
@@ -9541,6 +9664,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(),
@@ -9571,6 +9695,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}`, {
@@ -10204,8 +10329,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) {
@@ -10219,6 +10343,7 @@ function logStartupSummary(routes, wsRoutes, tools, agents, taskMetas, p) {
 async function createAppBase(options) {
   const rootDir = options?.rootDir ?? process.cwd();
   const dist = options?.dist ?? process.env.FAAPI_DIST ?? DEFAULT_DIST;
+  const resourcesDir = resolveResourcesDir(rootDir, dist);
   const routesPath = path30.resolve(rootDir, dist, ROUTES_FILE);
   if (!fs22.existsSync(routesPath)) {
     throw new Error(
@@ -10241,6 +10366,7 @@ async function createAppBase(options) {
     registry: registries.task,
     rootDir,
     config,
+    resourcesDir,
     registries: createTaskRegistriesView(registries),
     driver: taskDriver,
     onFailed: config?.task?.onFailed
@@ -10282,6 +10408,7 @@ async function createAppBase(options) {
     config?.plugins,
     {
       rootDir,
+      resourcesDir,
       registries,
       routes: sorted,
       getRoutes: () => sorted,
@@ -10299,6 +10426,8 @@ async function createAppBase(options) {
     routes: sorted,
     wsRoutes,
     rootDir,
+    dist,
+    resourcesDir,
     tasks: taskQueue,
     async listen(listenPort) {
       const envPort = process.env.PORT ? Number(process.env.PORT) : void 0;
@@ -10310,7 +10439,8 @@ async function createAppBase(options) {
             routes: sorted,
             server,
             registries,
-            tasks: taskQueue
+            tasks: taskQueue,
+            resourcesDir
           });
           console.log("- onBoot hook executed");
         } catch (err) {
@@ -10345,7 +10475,8 @@ async function createAppBase(options) {
               routes: sorted,
               server,
               registries,
-              tasks: taskQueue
+              tasks: taskQueue,
+              resourcesDir
             });
             console.log("- onReady hook executed");
           }
@@ -10369,7 +10500,8 @@ async function createAppBase(options) {
           routes: sorted,
           server,
           registries,
-          tasks: taskQueue
+          tasks: taskQueue,
+          resourcesDir
         });
       }
       registries.tool.clear();
@@ -10451,6 +10583,7 @@ var init_createAppCore = __esm({
     init_manifestLoader();
     init_appSingleton();
     init_injectMock();
+    init_copyResources();
     init_manifestLoader();
     DEFAULT_DIST = "dist";
     DEFAULT_PORT = 3e3;
@@ -10604,6 +10737,10 @@ async function devCommand(options) {
   await generateAgentArtifactsForDev(rootDir, devDist);
   console.log("- Generating task artifacts...");
   await generateTaskArtifactsForDev(rootDir, devDist);
+  console.log("- Copying resources...");
+  const copied = await copyResources(rootDir, devDist);
+  if (copied)
+    console.log(`  Copied src/resources \u2192 ${path32.resolve(rootDir, devDist, "resources")}`);
   console.log("- Starting dev app...");
   const app = await createDevApp({ rootDir, port: options?.port });
   await app.listen();
@@ -10653,6 +10790,7 @@ var init_devCommand = __esm({
     init_watcher();
     init_createDevApp();
     init_compileOnDemand();
+    init_copyResources();
     init_prodPaths();
     DEV_DIST = ".faapi";
     ROUTES_FILE2 = "faapi-routes.js";
@@ -10707,7 +10845,7 @@ async function buildCommand(options) {
   console.log(`- Root: ${rootDir}`);
   console.log(`- Source: src/`);
   console.log(`- Output: ${outdir}`);
-  console.log("\n[1/8] Compiling TypeScript (bundle: false)...");
+  console.log("\n[1/9] Compiling TypeScript (bundle: false)...");
   const result = await compileBuildRoutes({
     rootDir,
     dist: outdir,
@@ -10720,7 +10858,7 @@ async function buildCommand(options) {
   }
   const localPluginSources = extractLocalPluginSources(_config?.plugins, rootDir);
   if (localPluginSources.length > 0) {
-    console.log("\n[2.5/8] Compiling local plugins...");
+    console.log("\n[2.5/9] Compiling local plugins...");
     const outside = localPluginSources.filter((p) => {
       const rel = path33.relative(rootDir, p).replace(/\\/g, "/");
       return !rel.startsWith("src/");
@@ -10730,35 +10868,40 @@ async function buildCommand(options) {
     }
     console.log(`  Compiled ${localPluginSources.length} local plugin(s)`);
   }
-  console.log("\n[3/8] Scanning routes...");
+  console.log("\n[3/9] Scanning routes...");
   const { routes, wsRoutes } = await scanRoutes(rootDir, ROUTE_PATTERNS, outdir);
   const sorted = sortRoutes(routes);
   console.log(`  Found ${sorted.length} routes, ${wsRoutes.length} WS routes`);
   reportRouteConflicts(sorted);
-  console.log("\n[4/8] Generating schema...");
+  console.log("\n[4/9] Generating schema...");
   await generateSchemaFiles(sorted, rootDir, outdir, wsRoutes);
   console.log(`  Schema: zod.js files under ${path33.resolve(rootDir, outdir)}`);
-  console.log("\n[5/8] Generating routes manifest...");
+  console.log("\n[5/9] Generating routes manifest...");
   const routesPath = path33.resolve(rootDir, outdir, "faapi-routes.js");
   const serialized = serializeRoutes(sorted, wsRoutes, rootDir, outdir);
   await writeRoutesModule(serialized, routesPath);
   console.log(`  Written to ${routesPath}`);
-  console.log("\n[6/8] Generating tool manifest and schema...");
+  console.log("\n[6/9] Generating tool manifest and schema...");
   const tools = await scanTools(rootDir, TOOL_PATTERNS);
   const toolMeta = await generateToolArtifacts(tools, rootDir, outdir);
   console.log(`  Found ${toolMeta.length} tool(s)`);
   console.log(`  Tool manifest: ${path33.resolve(rootDir, outdir, "faapi-tools.js")}`);
-  console.log("\n[7/8] Generating agent manifest...");
+  console.log("\n[7/9] Generating agent manifest...");
   const agents = await scanAgents(rootDir, DEFAULT_AGENT_PATTERNS);
   const agentMeta = await generateAgentArtifacts(agents, rootDir, outdir);
   console.log(`  Found ${agentMeta.length} agent(s)`);
   console.log(`  Agent manifest: ${path33.resolve(rootDir, outdir, "faapi-agents.js")}`);
-  console.log("\n[7.5/8] Generating task manifest and schema...");
+  console.log("\n[7.5/9] Generating task manifest and schema...");
   const tasks = await scanTasks(rootDir, TASK_PATTERNS);
   const taskMeta = await generateTaskArtifacts(tasks, rootDir, outdir);
   console.log(`  Found ${taskMeta.length} task(s)`);
   console.log(`  Task manifest: ${path33.resolve(rootDir, outdir, "faapi-tasks.js")}`);
-  console.log("\n[8/8] Generating entry file...");
+  console.log("\n[8/9] Copying resources...");
+  const resourcesCopied = await copyResources(rootDir, outdir);
+  if (resourcesCopied) {
+    console.log(`  Copied src/resources \u2192 ${path33.resolve(rootDir, outdir, "resources")}`);
+  }
+  console.log("\n[9/9] Generating entry file...");
   const mainPath = path33.resolve(rootDir, outdir, "main.js");
   const createProdAppArgs = options?.dist && options.dist !== DEFAULT_DIST2 ? `{ dist: ${JSON.stringify(outdir)} }` : "";
   const mainContent = `// \u7531 faapi build \u81EA\u52A8\u751F\u6210\uFF0C\u8BF7\u52FF\u624B\u52A8\u7F16\u8F91
@@ -10814,6 +10957,7 @@ var init_buildCommand = __esm({
     init_generateSchemaFiles();
     init_generateRoutes();
     init_compileBuildRoutes();
+    init_copyResources();
     init_prodPaths();
     init_compileConfig();
     init_loadConfig();