@faapi/faapi 6.24.0 → 6.26.0

package/dist/cli/index.js

@@ -649,9 +649,9 @@ var init_constants = __esm({
 });
 
 // src/utils/normalizePath.ts
-function normalizePath(path34) {
-  if (!path34) return "";
-  let result = path34.replace(/\\/g, "/");
+function normalizePath(path35) {
+  if (!path35) return "";
+  let result = path35.replace(/\\/g, "/");
   result = result.replace(/\/+/g, "/");
   result = result.replace(/\/+$/, "");
   if (result && !result.startsWith("/")) {
@@ -3536,6 +3536,11 @@ async function scanTasks(rootDir, patterns) {
           `[faapi] Task "${name}" timeoutMs ${value} is below the minimum ${MIN_ISOLATED_TIMEOUT_MS}ms (1 minute). Declaring a timeout means this is a long-running task that needs real cancellation \u2014 tasks finishing within a minute do not need one: remove timeoutMs to run in-process (implement your own deadline with Promise.race if needed), or raise it.`
         );
       }
+      if (value > MAX_ISOLATED_TIMEOUT_MS) {
+        throw new Error(
+          `[faapi] Task "${name}" timeoutMs ${value} exceeds the maximum ${MAX_ISOLATED_TIMEOUT_MS}ms (23 hours). The pg-boss driver budgets expire_in from timeoutMs (execution budget preventing mid-run re-delivery), and pg-boss versions before 12.28 assert expire_in strictly below 24h \u2014 the 23h cap keeps every driver and pg-boss version on a single bound. Split the work into a resumable pipeline (persist progress, enqueue the next stage), or use the bullmq driver (Redis has no such cap).`
+        );
+      }
       manifest.timeoutMs = value;
     }
     if (graceMs !== void 0) manifest.graceMs = parseNumericLiteral(graceMs);
@@ -3543,7 +3548,7 @@ async function scanTasks(rootDir, patterns) {
   }
   return tasks.sort((a, b) => a.name.localeCompare(b.name));
 }
-var TASK_PATTERNS, TASK_FILENAME, CRON_RE, NUM_LITERAL, CONCURRENCY_RE, RETRIES_RE, TIMEOUT_MS_RE, GRACE_MS_RE, MIN_ISOLATED_TIMEOUT_MS;
+var TASK_PATTERNS, TASK_FILENAME, CRON_RE, NUM_LITERAL, CONCURRENCY_RE, RETRIES_RE, TIMEOUT_MS_RE, GRACE_MS_RE, MIN_ISOLATED_TIMEOUT_MS, MAX_ISOLATED_TIMEOUT_MS;
 var init_scanTasks = __esm({
   "src/task/scanTasks.ts"() {
     "use strict";
@@ -3556,6 +3561,7 @@ var init_scanTasks = __esm({
     TIMEOUT_MS_RE = new RegExp(`(?:^|\\n)\\s*timeoutMs:\\s*${NUM_LITERAL}`);
     GRACE_MS_RE = new RegExp(`(?:^|\\n)\\s*graceMs:\\s*${NUM_LITERAL}`);
     MIN_ISOLATED_TIMEOUT_MS = 6e4;
+    MAX_ISOLATED_TIMEOUT_MS = 23 * 60 * 6e4;
   }
 });
 
@@ -4158,7 +4164,7 @@ var init_esm = __esm({
         this._directoryFilter = normalizeFilter(opts.directoryFilter);
         const statMethod = opts.lstat ? lstat : stat;
         if (wantBigintFsStats) {
-          this._stat = (path34) => statMethod(path34, { bigint: true });
+          this._stat = (path35) => statMethod(path35, { bigint: true });
         } else {
           this._stat = statMethod;
         }
@@ -4183,8 +4189,8 @@ var init_esm = __esm({
             const par = this.parent;
             const fil = par && par.files;
             if (fil && fil.length > 0) {
-              const { path: path34, depth } = par;
-              const slice = fil.splice(0, batch).map((dirent) => this._formatEntry(dirent, path34));
+              const { path: path35, depth } = par;
+              const slice = fil.splice(0, batch).map((dirent) => this._formatEntry(dirent, path35));
               const awaited = await Promise.all(slice);
               for (const entry of awaited) {
                 if (!entry)
@@ -4224,20 +4230,20 @@ var init_esm = __esm({
           this.reading = false;
         }
       }
-      async _exploreDir(path34, depth) {
+      async _exploreDir(path35, depth) {
         let files;
         try {
-          files = await readdir(path34, this._rdOptions);
+          files = await readdir(path35, this._rdOptions);
         } catch (error) {
           this._onError(error);
         }
-        return { files, depth, path: path34 };
+        return { files, depth, path: path35 };
       }
-      async _formatEntry(dirent, path34) {
+      async _formatEntry(dirent, path35) {
         let entry;
         const basename3 = this._isDirent ? dirent.name : dirent;
         try {
-          const fullPath = presolve(pjoin(path34, basename3));
+          const fullPath = presolve(pjoin(path35, basename3));
           entry = { path: prelative(this._root, fullPath), fullPath, basename: basename3 };
           entry[this._statsProp] = this._isDirent ? dirent : await this._stat(fullPath);
         } catch (err) {
@@ -4298,16 +4304,16 @@ import { watchFile, unwatchFile, watch as fs_watch } from "fs";
 import { open, stat as stat2, lstat as lstat2, realpath as fsrealpath } from "fs/promises";
 import * as sysPath from "path";
 import { type as osType } from "os";
-function createFsWatchInstance(path34, options, listener, errHandler, emitRaw) {
+function createFsWatchInstance(path35, options, listener, errHandler, emitRaw) {
   const handleEvent = (rawEvent, evPath) => {
-    listener(path34);
-    emitRaw(rawEvent, evPath, { watchedPath: path34 });
-    if (evPath && path34 !== evPath) {
-      fsWatchBroadcast(sysPath.resolve(path34, evPath), KEY_LISTENERS, sysPath.join(path34, evPath));
+    listener(path35);
+    emitRaw(rawEvent, evPath, { watchedPath: path35 });
+    if (evPath && path35 !== evPath) {
+      fsWatchBroadcast(sysPath.resolve(path35, evPath), KEY_LISTENERS, sysPath.join(path35, evPath));
     }
   };
   try {
-    return fs_watch(path34, {
+    return fs_watch(path35, {
       persistent: options.persistent
     }, handleEvent);
   } catch (error) {
@@ -4652,12 +4658,12 @@ var init_handler = __esm({
         listener(val1, val2, val3);
       });
     };
-    setFsWatchListener = (path34, fullPath, options, handlers) => {
+    setFsWatchListener = (path35, fullPath, options, handlers) => {
       const { listener, errHandler, rawEmitter } = handlers;
       let cont = FsWatchInstances.get(fullPath);
       let watcher;
       if (!options.persistent) {
-        watcher = createFsWatchInstance(path34, options, listener, errHandler, rawEmitter);
+        watcher = createFsWatchInstance(path35, options, listener, errHandler, rawEmitter);
         if (!watcher)
           return;
         return watcher.close.bind(watcher);
@@ -4668,7 +4674,7 @@ var init_handler = __esm({
         addAndConvert(cont, KEY_RAW, rawEmitter);
       } else {
         watcher = createFsWatchInstance(
-          path34,
+          path35,
           options,
           fsWatchBroadcast.bind(null, fullPath, KEY_LISTENERS),
           errHandler,
@@ -4683,7 +4689,7 @@ var init_handler = __esm({
             cont.watcherUnusable = true;
           if (isWindows && error.code === "EPERM") {
             try {
-              const fd = await open(path34, "r");
+              const fd = await open(path35, "r");
               await fd.close();
               broadcastErr(error);
             } catch (err) {
@@ -4714,7 +4720,7 @@ var init_handler = __esm({
       };
     };
     FsWatchFileInstances = /* @__PURE__ */ new Map();
-    setFsWatchFileListener = (path34, fullPath, options, handlers) => {
+    setFsWatchFileListener = (path35, fullPath, options, handlers) => {
       const { listener, rawEmitter } = handlers;
       let cont = FsWatchFileInstances.get(fullPath);
       const copts = cont && cont.options;
@@ -4736,7 +4742,7 @@ var init_handler = __esm({
             });
             const currmtime = curr.mtimeMs;
             if (curr.size !== prev.size || currmtime > prev.mtimeMs || currmtime === 0) {
-              foreach(cont.listeners, (listener2) => listener2(path34, curr));
+              foreach(cont.listeners, (listener2) => listener2(path35, curr));
             }
           })
         };
@@ -4764,13 +4770,13 @@ var init_handler = __esm({
        * @param listener on fs change
        * @returns closer for the watcher instance
        */
-      _watchWithNodeFs(path34, listener) {
+      _watchWithNodeFs(path35, listener) {
         const opts = this.fsw.options;
-        const directory = sysPath.dirname(path34);
-        const basename3 = sysPath.basename(path34);
+        const directory = sysPath.dirname(path35);
+        const basename3 = sysPath.basename(path35);
         const parent = this.fsw._getWatchedDir(directory);
         parent.add(basename3);
-        const absolutePath = sysPath.resolve(path34);
+        const absolutePath = sysPath.resolve(path35);
         const options = {
           persistent: opts.persistent
         };
@@ -4780,12 +4786,12 @@ var init_handler = __esm({
         if (opts.usePolling) {
           const enableBin = opts.interval !== opts.binaryInterval;
           options.interval = enableBin && isBinaryPath(basename3) ? opts.binaryInterval : opts.interval;
-          closer = setFsWatchFileListener(path34, absolutePath, options, {
+          closer = setFsWatchFileListener(path35, absolutePath, options, {
             listener,
             rawEmitter: this.fsw._emitRaw
           });
         } else {
-          closer = setFsWatchListener(path34, absolutePath, options, {
+          closer = setFsWatchListener(path35, absolutePath, options, {
             listener,
             errHandler: this._boundHandleError,
             rawEmitter: this.fsw._emitRaw
@@ -4807,7 +4813,7 @@ var init_handler = __esm({
         let prevStats = stats;
         if (parent.has(basename3))
           return;
-        const listener = async (path34, newStats) => {
+        const listener = async (path35, newStats) => {
           if (!this.fsw._throttle(THROTTLE_MODE_WATCH, file, 5))
             return;
           if (!newStats || newStats.mtimeMs === 0) {
@@ -4821,11 +4827,11 @@ var init_handler = __esm({
                 this.fsw._emit(EV.CHANGE, file, newStats2);
               }
               if ((isMacos || isLinux || isFreeBSD) && prevStats.ino !== newStats2.ino) {
-                this.fsw._closeFile(path34);
+                this.fsw._closeFile(path35);
                 prevStats = newStats2;
                 const closer2 = this._watchWithNodeFs(file, listener);
                 if (closer2)
-                  this.fsw._addPathCloser(path34, closer2);
+                  this.fsw._addPathCloser(path35, closer2);
               } else {
                 prevStats = newStats2;
               }
@@ -4857,7 +4863,7 @@ var init_handler = __esm({
        * @param item basename of this item
        * @returns true if no more processing is needed for this entry.
        */
-      async _handleSymlink(entry, directory, path34, item) {
+      async _handleSymlink(entry, directory, path35, item) {
         if (this.fsw.closed) {
           return;
         }
@@ -4867,7 +4873,7 @@ var init_handler = __esm({
           this.fsw._incrReadyCount();
           let linkPath;
           try {
-            linkPath = await fsrealpath(path34);
+            linkPath = await fsrealpath(path35);
           } catch (e) {
             this.fsw._emitReady();
             return true;
@@ -4877,12 +4883,12 @@ var init_handler = __esm({
           if (dir.has(item)) {
             if (this.fsw._symlinkPaths.get(full) !== linkPath) {
               this.fsw._symlinkPaths.set(full, linkPath);
-              this.fsw._emit(EV.CHANGE, path34, entry.stats);
+              this.fsw._emit(EV.CHANGE, path35, entry.stats);
             }
           } else {
             dir.add(item);
             this.fsw._symlinkPaths.set(full, linkPath);
-            this.fsw._emit(EV.ADD, path34, entry.stats);
+            this.fsw._emit(EV.ADD, path35, entry.stats);
           }
           this.fsw._emitReady();
           return true;
@@ -4911,9 +4917,9 @@ var init_handler = __esm({
             return;
           }
           const item = entry.path;
-          let path34 = sysPath.join(directory, item);
+          let path35 = sysPath.join(directory, item);
           current.add(item);
-          if (entry.stats.isSymbolicLink() && await this._handleSymlink(entry, directory, path34, item)) {
+          if (entry.stats.isSymbolicLink() && await this._handleSymlink(entry, directory, path35, item)) {
             return;
           }
           if (this.fsw.closed) {
@@ -4922,8 +4928,8 @@ var init_handler = __esm({
           }
           if (item === target || !target && !previous.has(item)) {
             this.fsw._incrReadyCount();
-            path34 = sysPath.join(dir, sysPath.relative(dir, path34));
-            this._addToNodeFs(path34, initialAdd, wh, depth + 1);
+            path35 = sysPath.join(dir, sysPath.relative(dir, path35));
+            this._addToNodeFs(path35, initialAdd, wh, depth + 1);
           }
         }).on(EV.ERROR, this._boundHandleError);
         return new Promise((resolve3, reject) => {
@@ -4992,13 +4998,13 @@ var init_handler = __esm({
        * @param depth Child path actually targeted for watch
        * @param target Child path actually targeted for watch
        */
-      async _addToNodeFs(path34, initialAdd, priorWh, depth, target) {
+      async _addToNodeFs(path35, initialAdd, priorWh, depth, target) {
         const ready = this.fsw._emitReady;
-        if (this.fsw._isIgnored(path34) || this.fsw.closed) {
+        if (this.fsw._isIgnored(path35) || this.fsw.closed) {
           ready();
           return false;
         }
-        const wh = this.fsw._getWatchHelpers(path34);
+        const wh = this.fsw._getWatchHelpers(path35);
         if (priorWh) {
           wh.filterPath = (entry) => priorWh.filterPath(entry);
           wh.filterDir = (entry) => priorWh.filterDir(entry);
@@ -5014,8 +5020,8 @@ var init_handler = __esm({
           const follow = this.fsw.options.followSymlinks;
           let closer;
           if (stats.isDirectory()) {
-            const absPath = sysPath.resolve(path34);
-            const targetPath = follow ? await fsrealpath(path34) : path34;
+            const absPath = sysPath.resolve(path35);
+            const targetPath = follow ? await fsrealpath(path35) : path35;
             if (this.fsw.closed)
               return;
             closer = await this._handleDir(wh.watchPath, stats, initialAdd, depth, target, wh, targetPath);
@@ -5025,29 +5031,29 @@ var init_handler = __esm({
               this.fsw._symlinkPaths.set(absPath, targetPath);
             }
           } else if (stats.isSymbolicLink()) {
-            const targetPath = follow ? await fsrealpath(path34) : path34;
+            const targetPath = follow ? await fsrealpath(path35) : path35;
             if (this.fsw.closed)
               return;
             const parent = sysPath.dirname(wh.watchPath);
             this.fsw._getWatchedDir(parent).add(wh.watchPath);
             this.fsw._emit(EV.ADD, wh.watchPath, stats);
-            closer = await this._handleDir(parent, stats, initialAdd, depth, path34, wh, targetPath);
+            closer = await this._handleDir(parent, stats, initialAdd, depth, path35, wh, targetPath);
             if (this.fsw.closed)
               return;
             if (targetPath !== void 0) {
-              this.fsw._symlinkPaths.set(sysPath.resolve(path34), targetPath);
+              this.fsw._symlinkPaths.set(sysPath.resolve(path35), targetPath);
             }
           } else {
             closer = this._handleFile(wh.watchPath, stats, initialAdd);
           }
           ready();
           if (closer)
-            this.fsw._addPathCloser(path34, closer);
+            this.fsw._addPathCloser(path35, closer);
           return false;
         } catch (error) {
           if (this.fsw._handleError(error)) {
             ready();
-            return path34;
+            return path35;
           }
         }
       }
@@ -5086,26 +5092,26 @@ function createPattern(matcher) {
   }
   return () => false;
 }
-function normalizePath2(path34) {
-  if (typeof path34 !== "string")
+function normalizePath2(path35) {
+  if (typeof path35 !== "string")
     throw new Error("string expected");
-  path34 = sysPath2.normalize(path34);
-  path34 = path34.replace(/\\/g, "/");
+  path35 = sysPath2.normalize(path35);
+  path35 = path35.replace(/\\/g, "/");
   let prepend = false;
-  if (path34.startsWith("//"))
+  if (path35.startsWith("//"))
     prepend = true;
   const DOUBLE_SLASH_RE2 = /\/\//;
-  while (path34.match(DOUBLE_SLASH_RE2))
-    path34 = path34.replace(DOUBLE_SLASH_RE2, "/");
+  while (path35.match(DOUBLE_SLASH_RE2))
+    path35 = path35.replace(DOUBLE_SLASH_RE2, "/");
   if (prepend)
-    path34 = "/" + path34;
-  return path34;
+    path35 = "/" + path35;
+  return path35;
 }
 function matchPatterns(patterns, testString, stats) {
-  const path34 = normalizePath2(testString);
+  const path35 = normalizePath2(testString);
   for (let index = 0; index < patterns.length; index++) {
     const pattern = patterns[index];
-    if (pattern(path34, stats)) {
+    if (pattern(path35, stats)) {
       return true;
     }
   }
@@ -5166,19 +5172,19 @@ var init_esm2 = __esm({
       }
       return str;
     };
-    normalizePathToUnix = (path34) => toUnix(sysPath2.normalize(toUnix(path34)));
-    normalizeIgnored = (cwd = "") => (path34) => {
-      if (typeof path34 === "string") {
-        return normalizePathToUnix(sysPath2.isAbsolute(path34) ? path34 : sysPath2.join(cwd, path34));
+    normalizePathToUnix = (path35) => toUnix(sysPath2.normalize(toUnix(path35)));
+    normalizeIgnored = (cwd = "") => (path35) => {
+      if (typeof path35 === "string") {
+        return normalizePathToUnix(sysPath2.isAbsolute(path35) ? path35 : sysPath2.join(cwd, path35));
       } else {
-        return path34;
+        return path35;
       }
     };
-    getAbsolutePath = (path34, cwd) => {
-      if (sysPath2.isAbsolute(path34)) {
-        return path34;
+    getAbsolutePath = (path35, cwd) => {
+      if (sysPath2.isAbsolute(path35)) {
+        return path35;
       }
-      return sysPath2.join(cwd, path34);
+      return sysPath2.join(cwd, path35);
     };
     EMPTY_SET = Object.freeze(/* @__PURE__ */ new Set());
     DirEntry = class {
@@ -5233,10 +5239,10 @@ var init_esm2 = __esm({
     STAT_METHOD_F = "stat";
     STAT_METHOD_L = "lstat";
     WatchHelper = class {
-      constructor(path34, follow, fsw) {
+      constructor(path35, follow, fsw) {
         this.fsw = fsw;
-        const watchPath = path34;
-        this.path = path34 = path34.replace(REPLACER_RE, "");
+        const watchPath = path35;
+        this.path = path35 = path35.replace(REPLACER_RE, "");
         this.watchPath = watchPath;
         this.fullWatchPath = sysPath2.resolve(watchPath);
         this.dirParts = [];
@@ -5358,20 +5364,20 @@ var init_esm2 = __esm({
         this._closePromise = void 0;
         let paths = unifyPaths(paths_);
         if (cwd) {
-          paths = paths.map((path34) => {
-            const absPath = getAbsolutePath(path34, cwd);
+          paths = paths.map((path35) => {
+            const absPath = getAbsolutePath(path35, cwd);
             return absPath;
           });
         }
-        paths.forEach((path34) => {
-          this._removeIgnoredPath(path34);
+        paths.forEach((path35) => {
+          this._removeIgnoredPath(path35);
         });
         this._userIgnored = void 0;
         if (!this._readyCount)
           this._readyCount = 0;
         this._readyCount += paths.length;
-        Promise.all(paths.map(async (path34) => {
-          const res = await this._nodeFsHandler._addToNodeFs(path34, !_internal, void 0, 0, _origAdd);
+        Promise.all(paths.map(async (path35) => {
+          const res = await this._nodeFsHandler._addToNodeFs(path35, !_internal, void 0, 0, _origAdd);
           if (res)
             this._emitReady();
           return res;
@@ -5393,17 +5399,17 @@ var init_esm2 = __esm({
           return this;
         const paths = unifyPaths(paths_);
         const { cwd } = this.options;
-        paths.forEach((path34) => {
-          if (!sysPath2.isAbsolute(path34) && !this._closers.has(path34)) {
+        paths.forEach((path35) => {
+          if (!sysPath2.isAbsolute(path35) && !this._closers.has(path35)) {
             if (cwd)
-              path34 = sysPath2.join(cwd, path34);
-            path34 = sysPath2.resolve(path34);
+              path35 = sysPath2.join(cwd, path35);
+            path35 = sysPath2.resolve(path35);
           }
-          this._closePath(path34);
-          this._addIgnoredPath(path34);
-          if (this._watched.has(path34)) {
+          this._closePath(path35);
+          this._addIgnoredPath(path35);
+          if (this._watched.has(path35)) {
             this._addIgnoredPath({
-              path: path34,
+              path: path35,
               recursive: true
             });
           }
@@ -5467,38 +5473,38 @@ var init_esm2 = __esm({
        * @param stats arguments to be passed with event
        * @returns the error if defined, otherwise the value of the FSWatcher instance's `closed` flag
        */
-      async _emit(event, path34, stats) {
+      async _emit(event, path35, stats) {
         if (this.closed)
           return;
         const opts = this.options;
         if (isWindows)
-          path34 = sysPath2.normalize(path34);
+          path35 = sysPath2.normalize(path35);
         if (opts.cwd)
-          path34 = sysPath2.relative(opts.cwd, path34);
-        const args = [path34];
+          path35 = sysPath2.relative(opts.cwd, path35);
+        const args = [path35];
         if (stats != null)
           args.push(stats);
         const awf = opts.awaitWriteFinish;
         let pw;
-        if (awf && (pw = this._pendingWrites.get(path34))) {
+        if (awf && (pw = this._pendingWrites.get(path35))) {
           pw.lastChange = /* @__PURE__ */ new Date();
           return this;
         }
         if (opts.atomic) {
           if (event === EVENTS.UNLINK) {
-            this._pendingUnlinks.set(path34, [event, ...args]);
+            this._pendingUnlinks.set(path35, [event, ...args]);
             setTimeout(() => {
-              this._pendingUnlinks.forEach((entry, path35) => {
+              this._pendingUnlinks.forEach((entry, path36) => {
                 this.emit(...entry);
                 this.emit(EVENTS.ALL, ...entry);
-                this._pendingUnlinks.delete(path35);
+                this._pendingUnlinks.delete(path36);
               });
             }, typeof opts.atomic === "number" ? opts.atomic : 100);
             return this;
           }
-          if (event === EVENTS.ADD && this._pendingUnlinks.has(path34)) {
+          if (event === EVENTS.ADD && this._pendingUnlinks.has(path35)) {
             event = EVENTS.CHANGE;
-            this._pendingUnlinks.delete(path34);
+            this._pendingUnlinks.delete(path35);
           }
         }
         if (awf && (event === EVENTS.ADD || event === EVENTS.CHANGE) && this._readyEmitted) {
@@ -5516,16 +5522,16 @@ var init_esm2 = __esm({
               this.emitWithAll(event, args);
             }
           };
-          this._awaitWriteFinish(path34, awf.stabilityThreshold, event, awfEmit);
+          this._awaitWriteFinish(path35, awf.stabilityThreshold, event, awfEmit);
           return this;
         }
         if (event === EVENTS.CHANGE) {
-          const isThrottled = !this._throttle(EVENTS.CHANGE, path34, 50);
+          const isThrottled = !this._throttle(EVENTS.CHANGE, path35, 50);
           if (isThrottled)
             return this;
         }
         if (opts.alwaysStat && stats === void 0 && (event === EVENTS.ADD || event === EVENTS.ADD_DIR || event === EVENTS.CHANGE)) {
-          const fullPath = opts.cwd ? sysPath2.join(opts.cwd, path34) : path34;
+          const fullPath = opts.cwd ? sysPath2.join(opts.cwd, path35) : path35;
           let stats2;
           try {
             stats2 = await stat3(fullPath);
@@ -5556,23 +5562,23 @@ var init_esm2 = __esm({
        * @param timeout duration of time to suppress duplicate actions
        * @returns tracking object or false if action should be suppressed
        */
-      _throttle(actionType, path34, timeout) {
+      _throttle(actionType, path35, timeout) {
         if (!this._throttled.has(actionType)) {
           this._throttled.set(actionType, /* @__PURE__ */ new Map());
         }
         const action = this._throttled.get(actionType);
         if (!action)
           throw new Error("invalid throttle");
-        const actionPath = action.get(path34);
+        const actionPath = action.get(path35);
         if (actionPath) {
           actionPath.count++;
           return false;
         }
         let timeoutObject;
         const clear = () => {
-          const item = action.get(path34);
+          const item = action.get(path35);
           const count = item ? item.count : 0;
-          action.delete(path34);
+          action.delete(path35);
           clearTimeout(timeoutObject);
           if (item)
             clearTimeout(item.timeoutObject);
@@ -5580,7 +5586,7 @@ var init_esm2 = __esm({
         };
         timeoutObject = setTimeout(clear, timeout);
         const thr = { timeoutObject, clear, count: 0 };
-        action.set(path34, thr);
+        action.set(path35, thr);
         return thr;
       }
       _incrReadyCount() {
@@ -5594,44 +5600,44 @@ var init_esm2 = __esm({
        * @param event
        * @param awfEmit Callback to be called when ready for event to be emitted.
        */
-      _awaitWriteFinish(path34, threshold, event, awfEmit) {
+      _awaitWriteFinish(path35, threshold, event, awfEmit) {
         const awf = this.options.awaitWriteFinish;
         if (typeof awf !== "object")
           return;
         const pollInterval = awf.pollInterval;
         let timeoutHandler;
-        let fullPath = path34;
-        if (this.options.cwd && !sysPath2.isAbsolute(path34)) {
-          fullPath = sysPath2.join(this.options.cwd, path34);
+        let fullPath = path35;
+        if (this.options.cwd && !sysPath2.isAbsolute(path35)) {
+          fullPath = sysPath2.join(this.options.cwd, path35);
         }
         const now = /* @__PURE__ */ new Date();
         const writes = this._pendingWrites;
         function awaitWriteFinishFn(prevStat) {
           statcb(fullPath, (err, curStat) => {
-            if (err || !writes.has(path34)) {
+            if (err || !writes.has(path35)) {
               if (err && err.code !== "ENOENT")
                 awfEmit(err);
               return;
             }
             const now2 = Number(/* @__PURE__ */ new Date());
             if (prevStat && curStat.size !== prevStat.size) {
-              writes.get(path34).lastChange = now2;
+              writes.get(path35).lastChange = now2;
             }
-            const pw = writes.get(path34);
+            const pw = writes.get(path35);
             const df = now2 - pw.lastChange;
             if (df >= threshold) {
-              writes.delete(path34);
+              writes.delete(path35);
               awfEmit(void 0, curStat);
             } else {
               timeoutHandler = setTimeout(awaitWriteFinishFn, pollInterval, curStat);
             }
           });
         }
-        if (!writes.has(path34)) {
-          writes.set(path34, {
+        if (!writes.has(path35)) {
+          writes.set(path35, {
             lastChange: now,
             cancelWait: () => {
-              writes.delete(path34);
+              writes.delete(path35);
               clearTimeout(timeoutHandler);
               return event;
             }
@@ -5642,8 +5648,8 @@ var init_esm2 = __esm({
       /**
        * Determines whether user has asked to ignore this path.
        */
-      _isIgnored(path34, stats) {
-        if (this.options.atomic && DOT_RE.test(path34))
+      _isIgnored(path35, stats) {
+        if (this.options.atomic && DOT_RE.test(path35))
           return true;
         if (!this._userIgnored) {
           const { cwd } = this.options;
@@ -5653,17 +5659,17 @@ var init_esm2 = __esm({
           const list = [...ignoredPaths.map(normalizeIgnored(cwd)), ...ignored];
           this._userIgnored = anymatch(list, void 0);
         }
-        return this._userIgnored(path34, stats);
+        return this._userIgnored(path35, stats);
       }
-      _isntIgnored(path34, stat4) {
-        return !this._isIgnored(path34, stat4);
+      _isntIgnored(path35, stat4) {
+        return !this._isIgnored(path35, stat4);
       }
       /**
        * Provides a set of common helpers and properties relating to symlink handling.
        * @param path file or directory pattern being watched
        */
-      _getWatchHelpers(path34) {
-        return new WatchHelper(path34, this.options.followSymlinks, this);
+      _getWatchHelpers(path35) {
+        return new WatchHelper(path35, this.options.followSymlinks, this);
       }
       // Directory helpers
       // -----------------
@@ -5695,63 +5701,63 @@ var init_esm2 = __esm({
        * @param item      base path of item/directory
        */
       _remove(directory, item, isDirectory) {
-        const path34 = sysPath2.join(directory, item);
-        const fullPath = sysPath2.resolve(path34);
-        isDirectory = isDirectory != null ? isDirectory : this._watched.has(path34) || this._watched.has(fullPath);
-        if (!this._throttle("remove", path34, 100))
+        const path35 = sysPath2.join(directory, item);
+        const fullPath = sysPath2.resolve(path35);
+        isDirectory = isDirectory != null ? isDirectory : this._watched.has(path35) || this._watched.has(fullPath);
+        if (!this._throttle("remove", path35, 100))
           return;
         if (!isDirectory && this._watched.size === 1) {
           this.add(directory, item, true);
         }
-        const wp = this._getWatchedDir(path34);
+        const wp = this._getWatchedDir(path35);
         const nestedDirectoryChildren = wp.getChildren();
-        nestedDirectoryChildren.forEach((nested) => this._remove(path34, nested));
+        nestedDirectoryChildren.forEach((nested) => this._remove(path35, nested));
         const parent = this._getWatchedDir(directory);
         const wasTracked = parent.has(item);
         parent.remove(item);
         if (this._symlinkPaths.has(fullPath)) {
           this._symlinkPaths.delete(fullPath);
         }
-        let relPath = path34;
+        let relPath = path35;
         if (this.options.cwd)
-          relPath = sysPath2.relative(this.options.cwd, path34);
+          relPath = sysPath2.relative(this.options.cwd, path35);
         if (this.options.awaitWriteFinish && this._pendingWrites.has(relPath)) {
           const event = this._pendingWrites.get(relPath).cancelWait();
           if (event === EVENTS.ADD)
             return;
         }
-        this._watched.delete(path34);
+        this._watched.delete(path35);
         this._watched.delete(fullPath);
         const eventName = isDirectory ? EVENTS.UNLINK_DIR : EVENTS.UNLINK;
-        if (wasTracked && !this._isIgnored(path34))
-          this._emit(eventName, path34);
-        this._closePath(path34);
+        if (wasTracked && !this._isIgnored(path35))
+          this._emit(eventName, path35);
+        this._closePath(path35);
       }
       /**
        * Closes all watchers for a path
        */
-      _closePath(path34) {
-        this._closeFile(path34);
-        const dir = sysPath2.dirname(path34);
-        this._getWatchedDir(dir).remove(sysPath2.basename(path34));
+      _closePath(path35) {
+        this._closeFile(path35);
+        const dir = sysPath2.dirname(path35);
+        this._getWatchedDir(dir).remove(sysPath2.basename(path35));
       }
       /**
        * Closes only file-specific watchers
        */
-      _closeFile(path34) {
-        const closers = this._closers.get(path34);
+      _closeFile(path35) {
+        const closers = this._closers.get(path35);
         if (!closers)
           return;
         closers.forEach((closer) => closer());
-        this._closers.delete(path34);
+        this._closers.delete(path35);
       }
-      _addPathCloser(path34, closer) {
+      _addPathCloser(path35, closer) {
         if (!closer)
           return;
-        let list = this._closers.get(path34);
+        let list = this._closers.get(path35);
         if (!list) {
           list = [];
-          this._closers.set(path34, list);
+          this._closers.set(path35, list);
         }
         list.push(closer);
       }
@@ -6080,25 +6086,25 @@ function getWsIndex(routes) {
   wsIndexCache.set(routes, index);
   return index;
 }
-function matchRoute(routes, method, path34) {
+function matchRoute(routes, method, path35) {
   const index = getHttpIndex(routes);
   const upper = method.toUpperCase();
-  const hit = matchByMethod(index, upper, path34);
+  const hit = matchByMethod(index, upper, path35);
   if (hit) return hit;
   if (upper === "HEAD") {
-    return matchByMethod(index, "GET", path34);
+    return matchByMethod(index, "GET", path35);
   }
   return null;
 }
-function matchByMethod(index, method, path34) {
-  const staticHit = index.static.get(`${method}|${path34}`);
+function matchByMethod(index, method, path35) {
+  const staticHit = index.static.get(`${method}|${path35}`);
   if (staticHit) {
     return { route: staticHit, params: {} };
   }
   if (index.dynamics.length === 0) {
     return null;
   }
-  const pathSegments = path34.split("/").filter(Boolean);
+  const pathSegments = path35.split("/").filter(Boolean);
   for (const entry of index.dynamics) {
     const route = entry.route;
     if (route.method !== method) {
@@ -6111,31 +6117,31 @@ function matchByMethod(index, method, path34) {
   }
   return null;
 }
-function matchWsRoute(wsRoutes, path34) {
+function matchWsRoute(wsRoutes, path35) {
   const index = getWsIndex(wsRoutes);
-  const staticHit = index.static.get(path34);
+  const staticHit = index.static.get(path35);
   if (staticHit) {
     return { route: staticHit, params: {} };
   }
   for (const route of index.dynamics) {
-    const params = matchDynamicPath(route.urlPath, path34, route.paramNames, route.isCatchAll);
+    const params = matchDynamicPath(route.urlPath, path35, route.paramNames, route.isCatchAll);
     if (params !== null) {
       return { route, params };
     }
   }
   return null;
 }
-function findAllowedMethods(routes, path34) {
+function findAllowedMethods(routes, path35) {
   const index = getHttpIndex(routes);
   const methods = /* @__PURE__ */ new Set();
-  const staticMethods = index.methodsByStaticPath.get(path34);
+  const staticMethods = index.methodsByStaticPath.get(path35);
   if (staticMethods) {
     for (const method of staticMethods) {
       methods.add(method);
     }
   }
   if (index.dynamics.length > 0) {
-    const pathSegments = path34.split("/").filter(Boolean);
+    const pathSegments = path35.split("/").filter(Boolean);
     for (const entry of index.dynamics) {
       const params = matchSegments(
         entry.segments,
@@ -6153,10 +6159,10 @@ function findAllowedMethods(routes, path34) {
   }
   return Array.from(methods);
 }
-function matchDynamicPath(pattern, path34, paramNames, isCatchAll) {
+function matchDynamicPath(pattern, path35, paramNames, isCatchAll) {
   return matchSegments(
     pattern.split("/").filter(Boolean),
-    path34.split("/").filter(Boolean),
+    path35.split("/").filter(Boolean),
     paramNames,
     isCatchAll
   );
@@ -6635,14 +6641,14 @@ var init_httpErrors = __esm({
       issues;
     };
     RouteNotFoundError = class extends FaapiError {
-      constructor(path34) {
-        super("ROUTE_NOT_FOUND", `Route not found: ${path34}`, 404);
+      constructor(path35) {
+        super("ROUTE_NOT_FOUND", `Route not found: ${path35}`, 404);
         this.name = "RouteNotFoundError";
       }
     };
     MethodNotAllowedError = class extends FaapiError {
-      constructor(method, path34, allowedMethods) {
-        super("METHOD_NOT_ALLOWED", `Method ${method} not allowed for ${path34}`, 405);
+      constructor(method, path35, allowedMethods) {
+        super("METHOD_NOT_ALLOWED", `Method ${method} not allowed for ${path35}`, 405);
         this.allowedMethods = allowedMethods;
         this.name = "MethodNotAllowedError";
       }
@@ -7026,6 +7032,24 @@ var init_queryToObject = __esm({
   }
 });
 
+// src/utils/readResource.ts
+import path25 from "path";
+import fs19 from "fs/promises";
+function setActiveResourcesDir(dir) {
+  if (dir === null) {
+    delete globalThis[ACTIVE_RESOURCES_DIR_KEY];
+  } else {
+    globalThis[ACTIVE_RESOURCES_DIR_KEY] = dir;
+  }
+}
+var ACTIVE_RESOURCES_DIR_KEY;
+var init_readResource = __esm({
+  "src/utils/readResource.ts"() {
+    "use strict";
+    ACTIVE_RESOURCES_DIR_KEY = /* @__PURE__ */ Symbol.for("faapi.resources.dir");
+  }
+});
+
 // src/runtime/createContext.ts
 function resolveRequestId(request) {
   const header = request.headers.get("x-request-id");
@@ -7996,9 +8020,9 @@ async function validateInput(schemaPath, method, inputType, input) {
 function mapZodIssues(error) {
   return error.issues.map((issue) => {
     const code = mapZodCode(issue);
-    const path34 = issue.path.map(String).join(".") || "";
+    const path35 = issue.path.map(String).join(".") || "";
     return {
-      path: path34,
+      path: path35,
       code,
       expected: issue.expected ?? mapExpectedFromMessage(issue.message),
       received: issue.received ?? mapReceivedFromMessage(issue.message),
@@ -8522,9 +8546,9 @@ var init_wsHandler = __esm({
 });
 
 // src/server/handleWsUpgrade.ts
-import fs19 from "fs";
+import fs20 from "fs";
 import { WebSocketServer, WebSocket } from "ws";
-import path25 from "path";
+import path26 from "path";
 function getPathname(req) {
   const url = req.url ?? "/";
   const idx = url.indexOf("?");
@@ -8535,7 +8559,7 @@ async function loadWsHandler(filePath, ctx, rootDir) {
     const dist = getDevDist();
     if (dist) {
       const sourcePath = prodPathToSourcePath(filePath, rootDir, dist);
-      if (sourcePath && fs19.existsSync(sourcePath)) {
+      if (sourcePath && fs20.existsSync(sourcePath)) {
         await ensureCompiled(sourcePath, rootDir, dist);
       }
     }
@@ -8677,7 +8701,7 @@ function attachWebSocket(options) {
     let upgraded = false;
     const finalHandler = async () => {
       const schemaPath = getRuntimeSchemaPath(route.filePath, dist, rootDir);
-      if (fs19.existsSync(schemaPath)) {
+      if (fs20.existsSync(schemaPath)) {
         if (isDevOnDemandEnabled()) {
           const devDist = getDevDist();
           if (devDist) {
@@ -8716,7 +8740,7 @@ function attachWebSocket(options) {
       }
       let handlers;
       try {
-        const absoluteFilePath = path25.resolve(rootDir, route.filePath);
+        const absoluteFilePath = path26.resolve(rootDir, route.filePath);
         handlers = await loadWsHandler(absoluteFilePath, ctx, rootDir);
       } catch (err) {
         const reason = err instanceof Error ? err.message : String(err);
@@ -8797,7 +8821,7 @@ import {
 import { createSecureServer as createHttp2SecureServer } from "http2";
 import { readFileSync } from "fs";
 import { Readable as Readable3 } from "stream";
-import path26 from "path";
+import path27 from "path";
 function toWebRequest(req, bodyLimit = DEFAULT_BODY_LIMIT, requestSignal) {
   const forwardedProto = req.headers["x-forwarded-proto"];
   const protocol = Array.isArray(forwardedProto) ? forwardedProto[0]?.split(",")[0]?.trim() ?? "http" : forwardedProto?.split(",")[0]?.trim() ?? "http";
@@ -9003,7 +9027,7 @@ function getRoutePaths(route, rootDir, dist) {
   let cached = routePathCache.get(route);
   if (!cached) {
     cached = {
-      absFilePath: path26.resolve(rootDir, route.filePath),
+      absFilePath: path27.resolve(rootDir, route.filePath),
       schemaPath: getRuntimeSchemaPath(route.filePath, dist, rootDir)
     };
     routePathCache.set(route, cached);
@@ -9258,8 +9282,15 @@ var init_startServer = __esm({
 });
 
 // src/task/taskWorker.ts
+import { existsSync as existsSync3 } from "fs";
 import { Worker } from "worker_threads";
-import { pathToFileURL as pathToFileURL2 } from "url";
+import { fileURLToPath, pathToFileURL as pathToFileURL2 } from "url";
+function resolveWorkerEntryUrl() {
+  if (workerEntryUrl) return workerEntryUrl;
+  const js = new URL("./workerEntry.js", import.meta.url);
+  workerEntryUrl = existsSync3(fileURLToPath(js)) ? js : new URL("./workerEntry.ts", import.meta.url);
+  return workerEntryUrl;
+}
 function safeConfig(config) {
   if (config === void 0 || config === null) return config;
   try {
@@ -9273,55 +9304,6 @@ function safeConfig(config) {
     return void 0;
   }
 }
-function buildWrapperSource(moduleUrl) {
-  return `
-import { parentPort } from 'node:worker_threads';
-import * as mod from '${moduleUrl}';
-
-${BUILD_VIEW_SOURCE}
-
-${SERIALIZE_ERROR_SOURCE}
-
-${BUILD_LOGGER_SOURCE}
-
-const run = mod.run;
-if (typeof run !== 'function') {
-  parentPort.postMessage({
-    type: 'error',
-    error: { name: 'Error', message: 'Task module has no run export', stack: undefined, props: {} },
-  });
-} else {
-  let controller = null;
-  parentPort.on('message', async (msg) => {
-    if (msg?.type === 'abort') {
-      controller?.abort(new Error(msg.reason));
-      return;
-    }
-    if (msg?.type !== 'run') return;
-    controller = new AbortController();
-    const { payload, taskCtx } = msg;
-    try {
-      const registries = buildRegistriesView(msg.registries);
-      const progress = (value) => parentPort.postMessage({ type: 'progress', value });
-      const taskLog = msg.log ? createTaskLogger(msg.log.level, msg.log.scope, msg.log.fields) : undefined;
-      const result = await run(payload, { ...taskCtx, signal: controller.signal, registries, progress, log: taskLog });
-      parentPort.postMessage({ type: 'done', result });
-    } catch (err) {
-      const serialized = serializeError(err);
-      try {
-        parentPort.postMessage({ type: 'error', error: serialized });
-      } catch (_) {
-        // props \u542B\u4E0D\u53EF\u514B\u9686\u503C\uFF08\u51FD\u6570\u7B49\uFF09\u65F6\u4E22\u5F03 props\uFF0C\u4FDD\u5E95 name/message/stack
-        parentPort.postMessage({
-          type: 'error',
-          error: { name: serialized.name, message: serialized.message, stack: serialized.stack, props: {} },
-        });
-      }
-    }
-  });
-}
-`;
-}
 function reviveError(payload) {
   const err = new Error(payload?.message ?? "task worker error");
   if (payload?.name !== void 0) err.name = payload.name;
@@ -9342,13 +9324,12 @@ async function runTaskInWorker(options) {
     );
   }
   const moduleUrl = pathToFileURL2(taskModulePath).href;
-  const wrapperUrl = new URL(
-    `data:text/javascript,${encodeURIComponent(buildWrapperSource(moduleUrl))}`
-  );
   return new Promise((resolve3, reject) => {
     let worker;
     try {
-      worker = new Worker(wrapperUrl);
+      worker = new Worker(resolveWorkerEntryUrl(), {
+        workerData: { moduleUrl, resourcesDir: taskCtx.resourcesDir }
+      });
     } catch (err) {
       reject(err);
       return;
@@ -9453,7 +9434,7 @@ async function runTaskInWorker(options) {
     }
   });
 }
-var KILL_GRACE_MS, TaskCancelledError, BUILD_VIEW_SOURCE, SERIALIZE_ERROR_SOURCE, BUILD_LOGGER_SOURCE;
+var workerEntryUrl, KILL_GRACE_MS, TaskCancelledError;
 var init_taskWorker = __esm({
   "src/task/taskWorker.ts"() {
     "use strict";
@@ -9464,109 +9445,11 @@ var init_taskWorker = __esm({
         this.name = "TaskCancelledError";
       }
     };
-    BUILD_VIEW_SOURCE = `
-function buildRegistriesView(snapshot) {
-  var agents = new Map(((snapshot && snapshot.agents) || []).map(function (a) { return [a.name, a]; }));
-  var tools = new Map(((snapshot && snapshot.tools) || []).map(function (t) { return [t.name, t]; }));
-  var skills = new Map(((snapshot && snapshot.skills) || []).map(function (s) { return [s.name, s]; }));
-  return {
-    agent: {
-      getAgent: function (name) { return agents.get(name); },
-      getAgentEntry: function (name) { return agents.get(name); },
-      listAgents: function () { return Array.from(agents.values()); },
-      asTool: function (name) {
-        var agent = agents.get(name);
-        if (!agent) return undefined;
-        return {
-          kind: 'agent',
-          name: 'agent.' + agent.name,
-          agentName: agent.name,
-          description: agent.description,
-          metadata: agent,
-        };
-      },
-      resolveAgentTools: function (name) {
-        var agent = agents.get(name);
-        var result = new Map();
-        if (agent && agent.tools) {
-          agent.tools.forEach(function (toolName) {
-            var resolved = tools.get(toolName);
-            if (resolved) result.set(resolved.name, resolved);
-          });
-        }
-        return Array.from(result.values());
-      },
-      resolveSubAgents: function (name) {
-        var agent = agents.get(name);
-        var result = [];
-        if (agent && agent.agents) {
-          agent.agents.forEach(function (subName) {
-            var sub = agents.get(subName);
-            if (sub) result.push(sub);
-          });
-        }
-        return result;
-      },
-    },
-    tool: {
-      get: function (name) { return tools.get(name); },
-      list: function () { return Array.from(tools.values()); },
-    },
-    skill: {
-      get: function (name) { return skills.get(name); },
-      list: function () { return Array.from(skills.values()); },
-    },
-  };
-}
-`;
-    SERIALIZE_ERROR_SOURCE = `
-function serializeError(err) {
-  if (err instanceof Error) {
-    var props = {};
-    var keys = Object.keys(err);
-    for (var i = 0; i < keys.length; i++) {
-      props[keys[i]] = err[keys[i]];
-    }
-    return { name: err.name, message: err.message, stack: err.stack, props: props };
-  }
-  return { name: 'Error', message: String(err), stack: undefined, props: {} };
-}
-`;
-    BUILD_LOGGER_SOURCE = `
-var LOG_RANK = { debug: 0, info: 1, warn: 2, error: 3 };
-function createTaskLogger(level, scope, fields) {
-  function make(suffix) {
-    function write(lvl, message, callFields) {
-      if (level !== undefined && LOG_RANK[lvl] < LOG_RANK[level]) return;
-      var entry = { level: lvl, message: message, time: new Date().toISOString() };
-      var fullScope = suffix === undefined ? scope : scope === undefined ? suffix : scope + ':' + suffix;
-      if (fullScope !== undefined) entry.scope = fullScope;
-      if (fields !== undefined || callFields !== undefined) {
-        entry.fields = Object.assign({}, fields, callFields);
-      }
-      try {
-        parentPort.postMessage({ type: 'log', entry: entry });
-      } catch (_) {
-        entry.fields = { warning: 'log fields not cloneable across worker boundary, dropped' };
-        parentPort.postMessage({ type: 'log', entry: entry });
-      }
-    }
-    return {
-      debug: function (m, f) { write('debug', m, f); },
-      info: function (m, f) { write('info', m, f); },
-      warn: function (m, f) { write('warn', m, f); },
-      error: function (m, f) { write('error', m, f); },
-      child: function (cs) { return make(suffix === undefined ? cs : suffix + ':' + cs); },
-    };
-  }
-  return make(undefined);
-}
-`;
   }
 });
 
 // src/task/taskQueue.ts
-import path27 from "path";
+import path28 from "path";
 function createTaskQueue(deps) {
   const { registry, rootDir, driver } = deps;
   const registriesView = deps.registries ?? createEmptyTaskRegistriesView();
@@ -9596,7 +9479,7 @@ function createTaskQueue(deps) {
   }
   const loadTaskModule = deps.loadTaskModule ?? (async (filePath) => await import(filePath));
   const loadPayloadSchema = deps.loadPayloadSchema ?? (async (filePath) => {
-    const zodPath = path27.join(path27.dirname(filePath), "zod.js");
+    const zodPath = path28.join(path28.dirname(filePath), "zod.js");
     try {
       const mod = await import(zodPath);
       const schemaKey = Object.keys(mod).find((k) => k.endsWith("Schema"));
@@ -9624,7 +9507,7 @@ function createTaskQueue(deps) {
       const meta = registry.get(name);
       schemaCache.set(
         name,
-        await loadPayloadSchema(path27.resolve(rootDir, meta.filePath)).catch(() => void 0)
+        await loadPayloadSchema(path28.resolve(rootDir, meta.filePath)).catch(() => void 0)
       );
     }
     const schema = schemaCache.get(name);
@@ -9660,7 +9543,7 @@ function createTaskQueue(deps) {
       let result;
       if (meta.timeoutMs !== void 0 && meta.timeoutMs > 0) {
         result = await (deps.runIsolated ?? runTaskInWorker)({
-          taskModulePath: path27.resolve(rootDir, meta.filePath),
+          taskModulePath: path28.resolve(rootDir, meta.filePath),
           payload: job.payload,
           taskCtx: {
             config: deps.config,
@@ -9686,7 +9569,7 @@ function createTaskQueue(deps) {
       } else {
         let mod = moduleCache2.get(job.name);
         if (!mod) {
-          mod = await loadTaskModule(path27.resolve(rootDir, meta.filePath));
+          mod = await loadTaskModule(path28.resolve(rootDir, meta.filePath));
           moduleCache2.set(job.name, mod);
         }
         if (typeof mod.run !== "function") {
@@ -9976,8 +9859,8 @@ var init_cronScheduler = __esm({
 });
 
 // src/cli/loadPlugins.ts
-import path28 from "path";
-import fs20 from "fs";
+import path29 from "path";
+import fs21 from "fs";
 import { pathToFileURL as pathToFileURL3 } from "url";
 async function loadPlugins(declarations, ctx, rootDir, dist) {
   const handlerWrappers = [];
@@ -10040,30 +9923,30 @@ async function loadPlugins(declarations, ctx, rootDir, dist) {
   return { handlerWrappers, upgradeWrappers, failures };
 }
 function resolveLocalPluginSource(specifier, baseDir) {
-  const base = path28.isAbsolute(specifier) ? specifier : path28.resolve(baseDir, specifier);
-  if ((TS_EXTS.test(base) || JS_EXTS.test(base)) && fs20.existsSync(base)) return base;
+  const base = path29.isAbsolute(specifier) ? specifier : path29.resolve(baseDir, specifier);
+  if ((TS_EXTS.test(base) || JS_EXTS.test(base)) && fs21.existsSync(base)) return base;
   for (const ext of [".ts", ".js"]) {
-    if (fs20.existsSync(base + ext)) return base + ext;
+    if (fs21.existsSync(base + ext)) return base + ext;
   }
   for (const indexExt of ["/index.ts", "/index.js"]) {
-    if (fs20.existsSync(base + indexExt)) return base + indexExt;
+    if (fs21.existsSync(base + indexExt)) return base + indexExt;
   }
   return null;
 }
 function mirrorProductPath(sourcePath, baseDir, distDir) {
-  let rel = path28.relative(baseDir, sourcePath).replace(/\\/g, "/");
+  let rel = path29.relative(baseDir, sourcePath).replace(/\\/g, "/");
   if (rel.startsWith("src/")) rel = rel.slice(4);
-  return path28.resolve(distDir, rel.replace(TS_EXTS, ".js"));
+  return path29.resolve(distDir, rel.replace(TS_EXTS, ".js"));
 }
 async function importPluginModule(specifier, baseDir, dist) {
   const isRelative = specifier.startsWith("./") || specifier.startsWith("../");
-  if (!isRelative && !path28.isAbsolute(specifier)) {
+  if (!isRelative && !path29.isAbsolute(specifier)) {
     return import(specifier);
   }
-  const distDir = dist ? path28.resolve(baseDir, dist) : null;
+  const distDir = dist ? path29.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 && fs21.existsSync(productPath) && (sourcePath === null || isProductFresh(sourcePath, productPath))) {
     return import(pathToFileURL3(productPath).href);
   }
   if (sourcePath && TS_EXTS.test(sourcePath)) {
@@ -10072,13 +9955,13 @@ async function importPluginModule(specifier, baseDir, dist) {
         `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 = path28.relative(baseDir, sourcePath).replace(/\\/g, "/");
+    const relFromRoot = path29.relative(baseDir, sourcePath).replace(/\\/g, "/");
     if (relFromRoot.startsWith("src/")) {
       await ensureCompiled(sourcePath, baseDir, dist);
     } else {
       await compileProjectModules([sourcePath], baseDir, dist);
     }
-    if (productPath && fs20.existsSync(productPath)) {
+    if (productPath && fs21.existsSync(productPath)) {
       return import(pathToFileURL3(productPath).href);
     }
   }
@@ -10090,7 +9973,7 @@ async function importPluginModule(specifier, baseDir, dist) {
     `${specifier}/index.ts`,
     `${specifier}.js`,
     `${specifier}/index.js`
-  ].map((c) => path28.isAbsolute(c) ? c : path28.join(baseDir, c));
+  ].map((c) => path29.isAbsolute(c) ? c : path29.join(baseDir, c));
   throw new Error(
     `Cannot find local plugin "${specifier}" (resolved from ${baseDir}). Expected one of:
   ${candidates.join("\n  ")}
@@ -10125,11 +10008,11 @@ var init_loadPlugins = __esm({
 });
 
 // src/cli/manifestLoader.ts
-import fs21 from "fs";
-import path29 from "path";
+import fs22 from "fs";
+import path30 from "path";
 async function loadAndHydrateTools(rootDir, dist, registries = defaultRegistries) {
-  const toolsPath = path29.resolve(rootDir, dist, TOOLS_FILE2);
-  if (!fs21.existsSync(toolsPath)) {
+  const toolsPath = path30.resolve(rootDir, dist, TOOLS_FILE2);
+  if (!fs22.existsSync(toolsPath)) {
     return [];
   }
   const serialized = await importWithCacheBust(toolsPath);
@@ -10138,8 +10021,8 @@ async function loadAndHydrateTools(rootDir, dist, registries = defaultRegistries
   return hydrated;
 }
 async function loadAndHydrateAgents(rootDir, dist, registries = defaultRegistries) {
-  const agentsPath = path29.resolve(rootDir, dist, AGENTS_FILE2);
-  if (!fs21.existsSync(agentsPath)) {
+  const agentsPath = path30.resolve(rootDir, dist, AGENTS_FILE2);
+  if (!fs22.existsSync(agentsPath)) {
     return [];
   }
   const serialized = await importWithCacheBust(agentsPath);
@@ -10154,8 +10037,8 @@ function getTaskDriverOptions(config) {
   return void 0;
 }
 async function loadAndHydrateTasks(rootDir, dist, registries = defaultRegistries) {
-  const tasksPath = path29.resolve(rootDir, dist, TASKS_FILE);
-  if (!fs21.existsSync(tasksPath)) {
+  const tasksPath = path30.resolve(rootDir, dist, TASKS_FILE);
+  if (!fs22.existsSync(tasksPath)) {
     return [];
   }
   const serialized = await importWithCacheBust(tasksPath);
@@ -10302,8 +10185,8 @@ var init_injectMock = __esm({
 });
 
 // src/cli/createAppCore.ts
-import fs22 from "fs";
-import path30 from "path";
+import fs23 from "fs";
+import path31 from "path";
 function isFaapiConfigKey(key) {
   return FAAPI_CONFIG_KEYS.has(key);
 }
@@ -10341,11 +10224,17 @@ function logStartupSummary(routes, wsRoutes, tools, agents, taskMetas, p) {
   }
 }
 async function createAppBase(options) {
+  if (getCurrentApp()) {
+    throw new Error(
+      "[faapi] createApp: an app is already alive in this process \u2014 faapi supports a single app per process. Close it first (`await app.close()`) or run the second app in a separate process."
+    );
+  }
   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)) {
+  setActiveResourcesDir(resourcesDir);
+  const routesPath = path31.resolve(rootDir, dist, ROUTES_FILE);
+  if (!fs23.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`
     );
@@ -10510,6 +10399,7 @@ async function createAppBase(options) {
       registries.task.clear();
       registries.agentHandle.clear();
       registries.taskHandle.clear();
+      setActiveResourcesDir(null);
       if (!server.listening) {
         app.server = null;
         if (getCurrentApp() === app) setCurrentApp(null);
@@ -10584,6 +10474,7 @@ var init_createAppCore = __esm({
     init_appSingleton();
     init_injectMock();
     init_copyResources();
+    init_readResource();
     init_manifestLoader();
     DEFAULT_DIST = "dist";
     DEFAULT_PORT = 3e3;
@@ -10609,7 +10500,7 @@ var init_createAppCore = __esm({
 });
 
 // src/cli/createDevApp.ts
-import path31 from "path";
+import path32 from "path";
 async function createDevApp(options) {
   const { app, ctx } = await createAppBase(options);
   const devApp = app;
@@ -10659,7 +10550,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(path32.resolve(ctx.rootDir, task.filePath), ctx.rootDir, ctx.dist);
     }
     await generateTaskArtifacts(tasks, ctx.rootDir, ctx.dist);
     ctx.taskQueue.invalidateModules();
@@ -10716,7 +10607,7 @@ __export(devCommand_exports, {
   generateTaskArtifactsForDev: () => generateTaskArtifactsForDev,
   generateToolArtifactsForDev: () => generateToolArtifactsForDev
 });
-import path32 from "path";
+import path33 from "path";
 async function devCommand(options) {
   const rootDir = process.cwd();
   if (!process.env.NODE_ENV) process.env.NODE_ENV = "development";
@@ -10740,7 +10631,7 @@ async function devCommand(options) {
   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(`  Copied src/resources \u2192 ${path33.resolve(rootDir, devDist, "resources")}`);
   console.log("- Starting dev app...");
   const app = await createDevApp({ rootDir, port: options?.port });
   await app.listen();
@@ -10749,7 +10640,7 @@ async function devCommand(options) {
 async function generateRouteArtifacts(rootDir, patterns, dist) {
   const { routes, wsRoutes } = await scanRoutes(rootDir, patterns, dist);
   const sorted = sortRoutes(routes);
-  const routesPath = path32.resolve(rootDir, dist, ROUTES_FILE2);
+  const routesPath = path33.resolve(rootDir, dist, ROUTES_FILE2);
   const serialized = serializeRoutes(sorted, wsRoutes, rootDir, dist);
   await writeRoutesModule(serialized, routesPath);
 }
@@ -10764,7 +10655,7 @@ async function generateAgentArtifactsForDev(rootDir, dist) {
 async function generateTaskArtifactsForDev(rootDir, dist) {
   const tasks = await scanTasks(rootDir, TASK_PATTERNS);
   for (const task of tasks) {
-    await ensureCompiled(path32.resolve(rootDir, task.filePath), rootDir, dist);
+    await ensureCompiled(path33.resolve(rootDir, task.filePath), rootDir, dist);
   }
   await generateTaskArtifacts(tasks, rootDir, dist);
 }
@@ -10813,15 +10704,15 @@ var buildCommand_exports = {};
 __export(buildCommand_exports, {
   buildCommand: () => buildCommand
 });
-import path33 from "path";
-import fs23 from "fs";
+import path34 from "path";
+import fs24 from "fs";
 async function buildCommand(options) {
   const rootDir = options?.rootDir ?? process.cwd();
   const outdir = options?.dist ?? DEFAULT_DIST2;
-  const absOut = path33.resolve(rootDir, outdir);
-  const realRoot = toRealPath(path33.resolve(rootDir));
+  const absOut = path34.resolve(rootDir, outdir);
+  const realRoot = toRealPath(path34.resolve(rootDir));
   if (isInsideDir(toRealPath(absOut), realRoot)) {
-    fs23.rmSync(absOut, { recursive: true, force: true });
+    fs24.rmSync(absOut, { recursive: true, force: true });
   } else {
     console.warn(
       `! Output directory "${outdir}" is outside the project root, skipping clean (stale artifacts may remain)`
@@ -10829,10 +10720,10 @@ async function buildCommand(options) {
   }
   await compileConfig({ rootDir, dist: outdir });
   const _config = await loadConfig(rootDir, outdir);
-  const pkgPath = path33.resolve(rootDir, "package.json");
-  if (fs23.existsSync(pkgPath)) {
+  const pkgPath = path34.resolve(rootDir, "package.json");
+  if (fs24.existsSync(pkgPath)) {
     try {
-      const pkg = JSON.parse(fs23.readFileSync(pkgPath, "utf-8"));
+      const pkg = JSON.parse(fs24.readFileSync(pkgPath, "utf-8"));
       if (pkg.type !== "module") {
         console.warn(
           '! package.json is missing "type": "module" \u2014 build output is ESM and `node dist/main` will fail without it'
@@ -10860,7 +10751,7 @@ async function buildCommand(options) {
   if (localPluginSources.length > 0) {
     console.log("\n[2.5/9] Compiling local plugins...");
     const outside = localPluginSources.filter((p) => {
-      const rel = path33.relative(rootDir, p).replace(/\\/g, "/");
+      const rel = path34.relative(rootDir, p).replace(/\\/g, "/");
       return !rel.startsWith("src/");
     });
     if (outside.length > 0) {
@@ -10875,9 +10766,9 @@ async function buildCommand(options) {
   reportRouteConflicts(sorted);
   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(`  Schema: zod.js files under ${path34.resolve(rootDir, outdir)}`);
   console.log("\n[5/9] Generating routes manifest...");
-  const routesPath = path33.resolve(rootDir, outdir, "faapi-routes.js");
+  const routesPath = path34.resolve(rootDir, outdir, "faapi-routes.js");
   const serialized = serializeRoutes(sorted, wsRoutes, rootDir, outdir);
   await writeRoutesModule(serialized, routesPath);
   console.log(`  Written to ${routesPath}`);
@@ -10885,24 +10776,24 @@ async function buildCommand(options) {
   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(`  Tool manifest: ${path34.resolve(rootDir, outdir, "faapi-tools.js")}`);
   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(`  Agent manifest: ${path34.resolve(rootDir, outdir, "faapi-agents.js")}`);
   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(`  Task manifest: ${path34.resolve(rootDir, outdir, "faapi-tasks.js")}`);
   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(`  Copied src/resources \u2192 ${path34.resolve(rootDir, outdir, "resources")}`);
   }
   console.log("\n[9/9] Generating entry file...");
-  const mainPath = path33.resolve(rootDir, outdir, "main.js");
+  const mainPath = path34.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
 import { createProdApp, loadEnv } from '@faapi/faapi';
@@ -10914,7 +10805,7 @@ loadEnv(process.cwd());
 const app = await createProdApp(${createProdAppArgs});
 await app.listen();
 `;
-  await fs23.promises.writeFile(mainPath, mainContent, "utf-8");
+  await fs24.promises.writeFile(mainPath, mainContent, "utf-8");
   console.log(`  Written to ${mainPath}`);
   console.log("\nfaapi build completed");
 }
@@ -10928,7 +10819,7 @@ function extractLocalPluginSources(declarations, rootDir) {
     else if (Array.isArray(decl)) specifier = decl[0];
     else if ("path" in decl) specifier = decl.path;
     if (!specifier) continue;
-    if (!specifier.startsWith("./") && !specifier.startsWith("../") && !path33.isAbsolute(specifier)) {
+    if (!specifier.startsWith("./") && !specifier.startsWith("../") && !path34.isAbsolute(specifier)) {
       continue;
     }
     const source = resolveLocalPluginSource(specifier, rootDir);