@exodus/xqa 1.10.0 → 1.12.0

package/dist/xqa.cjs

@@ -1194,8 +1194,8 @@ var require_command = __commonJS({
   "../../node_modules/.pnpm/commander@14.0.3/node_modules/commander/lib/command.js"(exports2) {
     var EventEmitter = require("node:events").EventEmitter;
     var childProcess = require("node:child_process");
-    var path23 = require("node:path");
-    var fs3 = require("node:fs");
+    var path24 = require("node:path");
+    var fs4 = require("node:fs");
     var process6 = require("node:process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -1621,9 +1621,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (fn) {
           this._exitCallback = fn;
         } else {
-          this._exitCallback = (err19) => {
-            if (err19.code !== "commander.executeSubCommandAsync") {
-              throw err19;
+          this._exitCallback = (err20) => {
+            if (err20.code !== "commander.executeSubCommandAsync") {
+              throw err20;
             } else {
             }
           };
@@ -1699,12 +1699,12 @@ Expecting one of '${allowedValues.join("', '")}'`);
       _callParseArg(target, value, previous, invalidArgumentMessage) {
         try {
           return target.parseArg(value, previous);
-        } catch (err19) {
-          if (err19.code === "commander.invalidArgument") {
-            const message = `${invalidArgumentMessage} ${err19.message}`;
-            this.error(message, { exitCode: err19.exitCode, code: err19.code });
+        } catch (err20) {
+          if (err20.code === "commander.invalidArgument") {
+            const message = `${invalidArgumentMessage} ${err20.message}`;
+            this.error(message, { exitCode: err20.exitCode, code: err20.code });
           }
-          throw err19;
+          throw err20;
         }
       }
       /**
@@ -2189,7 +2189,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} subcommandName
        */
       _checkForMissingExecutable(executableFile, executableDir, subcommandName) {
-        if (fs3.existsSync(executableFile)) return;
+        if (fs4.existsSync(executableFile)) return;
         const executableDirMessage = executableDir ? `searched for local subcommand relative to directory '${executableDir}'` : "no directory for search for local subcommand, use .executableDir() to supply a custom directory";
         const executableMissing = `'${executableFile}' does not exist
  - if '${subcommandName}' is not meant to be an executable command, remove description parameter from '.command()' and use '.description()' instead
@@ -2207,11 +2207,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path23.resolve(baseDir, baseName);
-          if (fs3.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path23.extname(baseName))) return void 0;
+          const localBin = path24.resolve(baseDir, baseName);
+          if (fs4.existsSync(localBin)) return localBin;
+          if (sourceExt.includes(path24.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
-            (ext) => fs3.existsSync(`${localBin}${ext}`)
+            (ext) => fs4.existsSync(`${localBin}${ext}`)
           );
           if (foundExt) return `${localBin}${foundExt}`;
           return void 0;
@@ -2223,21 +2223,21 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs3.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs4.realpathSync(this._scriptPath);
           } catch {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path23.resolve(
-            path23.dirname(resolvedScriptPath),
+          executableDir = path24.resolve(
+            path24.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path23.basename(
+            const legacyName = path24.basename(
               this._scriptPath,
-              path23.extname(this._scriptPath)
+              path24.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -2248,7 +2248,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path23.extname(executableFile));
+        launchWithNode = sourceExt.includes(path24.extname(executableFile));
         let proc;
         if (process6.platform !== "win32") {
           if (launchWithNode) {
@@ -2293,14 +2293,14 @@ Expecting one of '${allowedValues.join("', '")}'`);
             );
           }
         });
-        proc.on("error", (err19) => {
-          if (err19.code === "ENOENT") {
+        proc.on("error", (err20) => {
+          if (err20.code === "ENOENT") {
             this._checkForMissingExecutable(
               executableFile,
               executableDir,
               subcommand._name
             );
-          } else if (err19.code === "EACCES") {
+          } else if (err20.code === "EACCES") {
             throw new Error(`'${executableFile}' not executable`);
           }
           if (!exitCallback) {
@@ -2311,7 +2311,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
               "commander.executeSubCommandAsync",
               "(error)"
             );
-            wrappedError.nestedError = err19;
+            wrappedError.nestedError = err20;
             exitCallback(wrappedError);
           }
         });
@@ -3163,7 +3163,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path23.basename(filename, path23.extname(filename));
+        this._name = path24.basename(filename, path24.extname(filename));
         return this;
       }
       /**
@@ -3177,9 +3177,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path24) {
-        if (path24 === void 0) return this._executableDir;
-        this._executableDir = path24;
+      executableDir(path25) {
+        if (path25 === void 0) return this._executableDir;
+        this._executableDir = path25;
         return this;
       }
       /**
@@ -3539,11 +3539,11 @@ var require_index_cjs = __commonJS({
         try {
           step(g3[n3](v2));
         } catch (e3) {
-          settle(q4[0][3], e3);
+          settle2(q4[0][3], e3);
         }
       }
       function step(r3) {
-        r3.value instanceof __await2 ? Promise.resolve(r3.value.v).then(fulfill, reject) : settle(q4[0][2], r3);
+        r3.value instanceof __await2 ? Promise.resolve(r3.value.v).then(fulfill, reject) : settle2(q4[0][2], r3);
       }
       function fulfill(value) {
         resume("next", value);
@@ -3551,7 +3551,7 @@ var require_index_cjs = __commonJS({
       function reject(value) {
         resume("throw", value);
       }
-      function settle(f6, v2) {
+      function settle2(f6, v2) {
         if (f6(v2), q4.shift(), q4.length) resume(q4[0][0], q4[0][1]);
       }
     }
@@ -3577,17 +3577,17 @@ var require_index_cjs = __commonJS({
       function verb(n3) {
         i3[n3] = o3[n3] && function(v2) {
           return new Promise(function(resolve, reject) {
-            v2 = o3[n3](v2), settle(resolve, reject, v2.done, v2.value);
+            v2 = o3[n3](v2), settle2(resolve, reject, v2.done, v2.value);
           });
         };
       }
-      function settle(resolve, reject, d, v2) {
+      function settle2(resolve, reject, d, v2) {
         Promise.resolve(v2).then(function(v3) {
           resolve({ value: v3, done: d });
         }, reject);
       }
     }
-    var ResultAsync12 = class _ResultAsync {
+    var ResultAsync14 = class _ResultAsync {
       constructor(res) {
         this._promise = res;
       }
@@ -3688,8 +3688,8 @@ var require_index_cjs = __commonJS({
           return new Ok(res.value);
         })));
       }
-      match(ok20, _err) {
-        return this._promise.then((res) => res.match(ok20, _err));
+      match(ok24, _err) {
+        return this._promise.then((res) => res.match(ok24, _err));
       }
       unwrapOr(t) {
         return this._promise.then((res) => res.unwrapOr(t));
@@ -3726,19 +3726,19 @@ var require_index_cjs = __commonJS({
       }
     };
     function okAsync8(value) {
-      return new ResultAsync12(Promise.resolve(new Ok(value)));
+      return new ResultAsync14(Promise.resolve(new Ok(value)));
     }
-    function errAsync8(err20) {
-      return new ResultAsync12(Promise.resolve(new Err(err20)));
+    function errAsync8(err21) {
+      return new ResultAsync14(Promise.resolve(new Err(err21)));
     }
-    var fromPromise = ResultAsync12.fromPromise;
-    var fromSafePromise2 = ResultAsync12.fromSafePromise;
-    var fromAsyncThrowable10 = ResultAsync12.fromThrowable;
+    var fromPromise = ResultAsync14.fromPromise;
+    var fromSafePromise2 = ResultAsync14.fromSafePromise;
+    var fromAsyncThrowable10 = ResultAsync14.fromThrowable;
     var combineResultList = (resultList) => {
-      let acc = ok19([]);
+      let acc = ok21([]);
       for (const result of resultList) {
         if (result.isErr()) {
-          acc = err19(result.error);
+          acc = err20(result.error);
           break;
         } else {
           acc.map((list) => list.push(result.value));
@@ -3746,30 +3746,30 @@ var require_index_cjs = __commonJS({
       }
       return acc;
     };
-    var combineResultAsyncList = (asyncResultList) => ResultAsync12.fromSafePromise(Promise.all(asyncResultList)).andThen(combineResultList);
+    var combineResultAsyncList = (asyncResultList) => ResultAsync14.fromSafePromise(Promise.all(asyncResultList)).andThen(combineResultList);
     var combineResultListWithAllErrors = (resultList) => {
-      let acc = ok19([]);
+      let acc = ok21([]);
       for (const result of resultList) {
         if (result.isErr() && acc.isErr()) {
           acc.error.push(result.error);
         } else if (result.isErr() && acc.isOk()) {
-          acc = err19([result.error]);
+          acc = err20([result.error]);
         } else if (result.isOk() && acc.isOk()) {
           acc.value.push(result.value);
         }
       }
       return acc;
     };
-    var combineResultAsyncListWithAllErrors = (asyncResultList) => ResultAsync12.fromSafePromise(Promise.all(asyncResultList)).andThen(combineResultListWithAllErrors);
+    var combineResultAsyncListWithAllErrors = (asyncResultList) => ResultAsync14.fromSafePromise(Promise.all(asyncResultList)).andThen(combineResultListWithAllErrors);
     exports2.Result = void 0;
     (function(Result3) {
       function fromThrowable16(fn, errorFn) {
         return (...args) => {
           try {
             const result = fn(...args);
-            return ok19(result);
+            return ok21(result);
           } catch (e3) {
-            return err19(errorFn ? errorFn(e3) : e3);
+            return err20(errorFn ? errorFn(e3) : e3);
           }
         };
       }
@@ -3783,16 +3783,16 @@ var require_index_cjs = __commonJS({
       }
       Result3.combineWithAllErrors = combineWithAllErrors;
     })(exports2.Result || (exports2.Result = {}));
-    function ok19(value) {
+    function ok21(value) {
       return new Ok(value);
     }
-    function err19(err20) {
-      return new Err(err20);
+    function err20(err21) {
+      return new Err(err21);
     }
     function safeTry(body) {
       const n3 = body().next();
       if (n3 instanceof Promise) {
-        return new ResultAsync12(n3.then((r3) => r3.value));
+        return new ResultAsync14(n3.then((r3) => r3.value));
       }
       return n3.value;
     }
@@ -3807,11 +3807,11 @@ var require_index_cjs = __commonJS({
         return !this.isOk();
       }
       map(f6) {
-        return ok19(f6(this.value));
+        return ok21(f6(this.value));
       }
       // eslint-disable-next-line @typescript-eslint/no-unused-vars
       mapErr(_f) {
-        return ok19(this.value);
+        return ok21(this.value);
       }
       // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
       andThen(f6) {
@@ -3826,14 +3826,14 @@ var require_index_cjs = __commonJS({
           f6(this.value);
         } catch (e3) {
         }
-        return ok19(this.value);
+        return ok21(this.value);
       }
       orTee(_f) {
-        return ok19(this.value);
+        return ok21(this.value);
       }
       // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
       orElse(_f) {
-        return ok19(this.value);
+        return ok21(this.value);
       }
       asyncAndThen(f6) {
         return f6(this.value);
@@ -3843,15 +3843,15 @@ var require_index_cjs = __commonJS({
         return f6(this.value).map(() => this.value);
       }
       asyncMap(f6) {
-        return ResultAsync12.fromSafePromise(f6(this.value));
+        return ResultAsync14.fromSafePromise(f6(this.value));
       }
       // eslint-disable-next-line @typescript-eslint/no-unused-vars
       unwrapOr(_v) {
         return this.value;
       }
       // eslint-disable-next-line @typescript-eslint/no-unused-vars
-      match(ok20, _err) {
-        return ok20(this.value);
+      match(ok24, _err) {
+        return ok24(this.value);
       }
       safeUnwrap() {
         const value = this.value;
@@ -3882,27 +3882,27 @@ var require_index_cjs = __commonJS({
       }
       // eslint-disable-next-line @typescript-eslint/no-unused-vars
       map(_f) {
-        return err19(this.error);
+        return err20(this.error);
       }
       mapErr(f6) {
-        return err19(f6(this.error));
+        return err20(f6(this.error));
       }
       andThrough(_f) {
-        return err19(this.error);
+        return err20(this.error);
       }
       andTee(_f) {
-        return err19(this.error);
+        return err20(this.error);
       }
       orTee(f6) {
         try {
           f6(this.error);
         } catch (e3) {
         }
-        return err19(this.error);
+        return err20(this.error);
       }
       // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
       andThen(_f) {
-        return err19(this.error);
+        return err20(this.error);
       }
       // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
       orElse(f6) {
@@ -3922,13 +3922,13 @@ var require_index_cjs = __commonJS({
       unwrapOr(v2) {
         return v2;
       }
-      match(_ok, err20) {
-        return err20(this.error);
+      match(_ok, err21) {
+        return err21(this.error);
       }
       safeUnwrap() {
         const error48 = this.error;
         return (function* () {
-          yield err19(error48);
+          yield err20(error48);
           throw new Error("Do not use this generator out of `safeTry`");
         })();
       }
@@ -3947,14 +3947,14 @@ var require_index_cjs = __commonJS({
     var fromThrowable15 = exports2.Result.fromThrowable;
     exports2.Err = Err;
     exports2.Ok = Ok;
-    exports2.ResultAsync = ResultAsync12;
-    exports2.err = err19;
+    exports2.ResultAsync = ResultAsync14;
+    exports2.err = err20;
     exports2.errAsync = errAsync8;
     exports2.fromAsyncThrowable = fromAsyncThrowable10;
     exports2.fromPromise = fromPromise;
     exports2.fromSafePromise = fromSafePromise2;
     exports2.fromThrowable = fromThrowable15;
-    exports2.ok = ok19;
+    exports2.ok = ok21;
     exports2.okAsync = okAsync8;
     exports2.safeTry = safeTry;
   }
@@ -5052,15 +5052,15 @@ var require_route = __commonJS({
       };
     }
     function wrapConversion(toModel, graph) {
-      const path23 = [graph[toModel].parent, toModel];
+      const path24 = [graph[toModel].parent, toModel];
       let fn = conversions[graph[toModel].parent][toModel];
       let cur = graph[toModel].parent;
       while (graph[cur].parent) {
-        path23.unshift(graph[cur].parent);
+        path24.unshift(graph[cur].parent);
         fn = link(conversions[graph[cur].parent][cur], fn);
         cur = graph[cur].parent;
       }
-      fn.conversion = path23;
+      fn.conversion = path24;
       return fn;
     }
     module2.exports = function(fromModel) {
@@ -11116,13 +11116,13 @@ var require_lib2 = __commonJS({
     exports2.analyse = analyse;
     var detectFile = (filepath, opts = {}) => new Promise((resolve, reject) => {
       let fd;
-      const fs3 = (0, node_1.default)();
-      const handler = (err19, buffer) => {
+      const fs4 = (0, node_1.default)();
+      const handler = (err20, buffer) => {
         if (fd) {
-          fs3.closeSync(fd);
+          fs4.closeSync(fd);
         }
-        if (err19) {
-          reject(err19);
+        if (err20) {
+          reject(err20);
         } else if (buffer) {
           resolve((0, exports2.detect)(buffer));
         } else {
@@ -11131,11 +11131,11 @@ var require_lib2 = __commonJS({
       };
       const sampleSize = (opts === null || opts === void 0 ? void 0 : opts.sampleSize) || 0;
       if (sampleSize > 0) {
-        fd = fs3.openSync(filepath, "r");
+        fd = fs4.openSync(filepath, "r");
         let sample = Buffer.allocUnsafe(sampleSize);
-        fs3.read(fd, sample, 0, sampleSize, opts.offset, (err19, bytesRead) => {
-          if (err19) {
-            handler(err19, null);
+        fs4.read(fd, sample, 0, sampleSize, opts.offset, (err20, bytesRead) => {
+          if (err20) {
+            handler(err20, null);
           } else {
             if (bytesRead < sampleSize) {
               sample = sample.subarray(0, bytesRead);
@@ -11145,22 +11145,22 @@ var require_lib2 = __commonJS({
         });
         return;
       }
-      fs3.readFile(filepath, handler);
+      fs4.readFile(filepath, handler);
     });
     exports2.detectFile = detectFile;
     var detectFileSync = (filepath, opts = {}) => {
-      const fs3 = (0, node_1.default)();
+      const fs4 = (0, node_1.default)();
       if (opts && opts.sampleSize) {
-        const fd = fs3.openSync(filepath, "r");
+        const fd = fs4.openSync(filepath, "r");
         let sample = Buffer.allocUnsafe(opts.sampleSize);
-        const bytesRead = fs3.readSync(fd, sample, 0, opts.sampleSize, opts.offset);
+        const bytesRead = fs4.readSync(fd, sample, 0, opts.sampleSize, opts.offset);
         if (bytesRead < opts.sampleSize) {
           sample = sample.subarray(0, bytesRead);
         }
-        fs3.closeSync(fd);
+        fs4.closeSync(fd);
         return (0, exports2.detect)(sample);
       }
-      return (0, exports2.detect)(fs3.readFileSync(filepath));
+      return (0, exports2.detect)(fs4.readFileSync(filepath));
     };
     exports2.detectFileSync = detectFileSync;
     exports2.default = {
@@ -15025,8 +15025,8 @@ var require_package = __commonJS({
 // ../../node_modules/.pnpm/dotenv@16.6.1/node_modules/dotenv/lib/main.js
 var require_main = __commonJS({
   "../../node_modules/.pnpm/dotenv@16.6.1/node_modules/dotenv/lib/main.js"(exports2, module2) {
-    var fs3 = require("fs");
-    var path23 = require("path");
+    var fs4 = require("fs");
+    var path24 = require("path");
     var os4 = require("os");
     var crypto = require("crypto");
     var packageJson = require_package();
@@ -15057,9 +15057,9 @@ var require_main = __commonJS({
       options.path = vaultPath;
       const result = DotenvModule.configDotenv(options);
       if (!result.parsed) {
-        const err19 = new Error(`MISSING_DATA: Cannot parse ${vaultPath} for an unknown reason`);
-        err19.code = "MISSING_DATA";
-        throw err19;
+        const err20 = new Error(`MISSING_DATA: Cannot parse ${vaultPath} for an unknown reason`);
+        err20.code = "MISSING_DATA";
+        throw err20;
       }
       const keys = _dotenvKey(options).split(",");
       const length = keys.length;
@@ -15102,30 +15102,30 @@ var require_main = __commonJS({
         uri = new URL(dotenvKey);
       } catch (error48) {
         if (error48.code === "ERR_INVALID_URL") {
-          const err19 = new Error("INVALID_DOTENV_KEY: Wrong format. Must be in valid uri format like dotenv://:key_1234@dotenvx.com/vault/.env.vault?environment=development");
-          err19.code = "INVALID_DOTENV_KEY";
-          throw err19;
+          const err20 = new Error("INVALID_DOTENV_KEY: Wrong format. Must be in valid uri format like dotenv://:key_1234@dotenvx.com/vault/.env.vault?environment=development");
+          err20.code = "INVALID_DOTENV_KEY";
+          throw err20;
         }
         throw error48;
       }
       const key = uri.password;
       if (!key) {
-        const err19 = new Error("INVALID_DOTENV_KEY: Missing key part");
-        err19.code = "INVALID_DOTENV_KEY";
-        throw err19;
+        const err20 = new Error("INVALID_DOTENV_KEY: Missing key part");
+        err20.code = "INVALID_DOTENV_KEY";
+        throw err20;
       }
       const environment = uri.searchParams.get("environment");
       if (!environment) {
-        const err19 = new Error("INVALID_DOTENV_KEY: Missing environment part");
-        err19.code = "INVALID_DOTENV_KEY";
-        throw err19;
+        const err20 = new Error("INVALID_DOTENV_KEY: Missing environment part");
+        err20.code = "INVALID_DOTENV_KEY";
+        throw err20;
       }
       const environmentKey = `DOTENV_VAULT_${environment.toUpperCase()}`;
       const ciphertext = result.parsed[environmentKey];
       if (!ciphertext) {
-        const err19 = new Error(`NOT_FOUND_DOTENV_ENVIRONMENT: Cannot locate environment ${environmentKey} in your .env.vault file.`);
-        err19.code = "NOT_FOUND_DOTENV_ENVIRONMENT";
-        throw err19;
+        const err20 = new Error(`NOT_FOUND_DOTENV_ENVIRONMENT: Cannot locate environment ${environmentKey} in your .env.vault file.`);
+        err20.code = "NOT_FOUND_DOTENV_ENVIRONMENT";
+        throw err20;
       }
       return { ciphertext, key };
     }
@@ -15134,7 +15134,7 @@ var require_main = __commonJS({
       if (options && options.path && options.path.length > 0) {
         if (Array.isArray(options.path)) {
           for (const filepath of options.path) {
-            if (fs3.existsSync(filepath)) {
+            if (fs4.existsSync(filepath)) {
               possibleVaultPath = filepath.endsWith(".vault") ? filepath : `${filepath}.vault`;
             }
           }
@@ -15142,15 +15142,15 @@ var require_main = __commonJS({
           possibleVaultPath = options.path.endsWith(".vault") ? options.path : `${options.path}.vault`;
         }
       } else {
-        possibleVaultPath = path23.resolve(process.cwd(), ".env.vault");
+        possibleVaultPath = path24.resolve(process.cwd(), ".env.vault");
       }
-      if (fs3.existsSync(possibleVaultPath)) {
+      if (fs4.existsSync(possibleVaultPath)) {
         return possibleVaultPath;
       }
       return null;
     }
     function _resolveHome(envPath) {
-      return envPath[0] === "~" ? path23.join(os4.homedir(), envPath.slice(1)) : envPath;
+      return envPath[0] === "~" ? path24.join(os4.homedir(), envPath.slice(1)) : envPath;
     }
     function _configVault(options) {
       const debug = Boolean(options && options.debug);
@@ -15167,7 +15167,7 @@ var require_main = __commonJS({
       return { parsed };
     }
     function configDotenv(options) {
-      const dotenvPath = path23.resolve(process.cwd(), ".env");
+      const dotenvPath = path24.resolve(process.cwd(), ".env");
       let encoding = "utf8";
       const debug = Boolean(options && options.debug);
       const quiet = options && "quiet" in options ? options.quiet : true;
@@ -15191,13 +15191,13 @@ var require_main = __commonJS({
       }
       let lastError;
       const parsedAll = {};
-      for (const path24 of optionPaths) {
+      for (const path25 of optionPaths) {
         try {
-          const parsed = DotenvModule.parse(fs3.readFileSync(path24, { encoding }));
+          const parsed = DotenvModule.parse(fs4.readFileSync(path25, { encoding }));
           DotenvModule.populate(parsedAll, parsed, options);
         } catch (e3) {
           if (debug) {
-            _debug(`Failed to load ${path24} ${e3.message}`);
+            _debug(`Failed to load ${path25} ${e3.message}`);
           }
           lastError = e3;
         }
@@ -15212,7 +15212,7 @@ var require_main = __commonJS({
         const shortPaths = [];
         for (const filePath of optionPaths) {
           try {
-            const relative = path23.relative(process.cwd(), filePath);
+            const relative = path24.relative(process.cwd(), filePath);
             shortPaths.push(relative);
           } catch (e3) {
             if (debug) {
@@ -15255,13 +15255,13 @@ var require_main = __commonJS({
         const invalidKeyLength = error48.message === "Invalid key length";
         const decryptionFailed = error48.message === "Unsupported state or unable to authenticate data";
         if (isRange || invalidKeyLength) {
-          const err19 = new Error("INVALID_DOTENV_KEY: It must be 64 characters long (or more)");
-          err19.code = "INVALID_DOTENV_KEY";
-          throw err19;
+          const err20 = new Error("INVALID_DOTENV_KEY: It must be 64 characters long (or more)");
+          err20.code = "INVALID_DOTENV_KEY";
+          throw err20;
         } else if (decryptionFailed) {
-          const err19 = new Error("DECRYPTION_FAILED: Please check your DOTENV_KEY");
-          err19.code = "DECRYPTION_FAILED";
-          throw err19;
+          const err20 = new Error("DECRYPTION_FAILED: Please check your DOTENV_KEY");
+          err20.code = "DECRYPTION_FAILED";
+          throw err20;
         } else {
           throw error48;
         }
@@ -15271,9 +15271,9 @@ var require_main = __commonJS({
       const debug = Boolean(options && options.debug);
       const override = Boolean(options && options.override);
       if (typeof parsed !== "object") {
-        const err19 = new Error("OBJECT_REQUIRED: Please check the processEnv argument being passed to populate");
-        err19.code = "OBJECT_REQUIRED";
-        throw err19;
+        const err20 = new Error("OBJECT_REQUIRED: Please check the processEnv argument being passed to populate");
+        err20.code = "OBJECT_REQUIRED";
+        throw err20;
       }
       for (const key of Object.keys(parsed)) {
         if (Object.prototype.hasOwnProperty.call(processEnv, key)) {
@@ -15384,7 +15384,7 @@ var require_path = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.convertPosixPathToPattern = exports2.convertWindowsPathToPattern = exports2.convertPathToPattern = exports2.escapePosixPath = exports2.escapeWindowsPath = exports2.escape = exports2.removeLeadingDotSegment = exports2.makeAbsolute = exports2.unixify = void 0;
     var os4 = require("os");
-    var path23 = require("path");
+    var path24 = require("path");
     var IS_WINDOWS_PLATFORM = os4.platform() === "win32";
     var LEADING_DOT_SEGMENT_CHARACTERS_COUNT = 2;
     var POSIX_UNESCAPED_GLOB_SYMBOLS_RE = /(\\?)([()*?[\]{|}]|^!|[!+@](?=\()|\\(?![!()*+?@[\]{|}]))/g;
@@ -15396,7 +15396,7 @@ var require_path = __commonJS({
     }
     exports2.unixify = unixify;
     function makeAbsolute(cwd, filepath) {
-      return path23.resolve(cwd, filepath);
+      return path24.resolve(cwd, filepath);
     }
     exports2.makeAbsolute = makeAbsolute;
     function removeLeadingDotSegment(entry) {
@@ -16693,7 +16693,7 @@ var require_braces = __commonJS({
 var require_constants2 = __commonJS({
   "../../node_modules/.pnpm/picomatch@2.3.2/node_modules/picomatch/lib/constants.js"(exports2, module2) {
     "use strict";
-    var path23 = require("path");
+    var path24 = require("path");
     var WIN_SLASH = "\\\\/";
     var WIN_NO_SLASH = `[^${WIN_SLASH}]`;
     var DEFAULT_MAX_EXTGLOB_RECURSION = 0;
@@ -16867,7 +16867,7 @@ var require_constants2 = __commonJS({
       /* | */
       CHAR_ZERO_WIDTH_NOBREAK_SPACE: 65279,
       /* \uFEFF */
-      SEP: path23.sep,
+      SEP: path24.sep,
       /**
        * Create EXTGLOB_CHARS
        */
@@ -16894,7 +16894,7 @@ var require_constants2 = __commonJS({
 var require_utils3 = __commonJS({
   "../../node_modules/.pnpm/picomatch@2.3.2/node_modules/picomatch/lib/utils.js"(exports2) {
     "use strict";
-    var path23 = require("path");
+    var path24 = require("path");
     var win32 = process.platform === "win32";
     var {
       REGEX_BACKSLASH,
@@ -16923,7 +16923,7 @@ var require_utils3 = __commonJS({
       if (options && typeof options.windows === "boolean") {
         return options.windows;
       }
-      return win32 === true || path23.sep === "\\";
+      return win32 === true || path24.sep === "\\";
     };
     exports2.escapeLast = (input, char, lastIdx) => {
       const idx = input.lastIndexOf(char, lastIdx);
@@ -18287,7 +18287,7 @@ var require_parse2 = __commonJS({
 var require_picomatch = __commonJS({
   "../../node_modules/.pnpm/picomatch@2.3.2/node_modules/picomatch/lib/picomatch.js"(exports2, module2) {
     "use strict";
-    var path23 = require("path");
+    var path24 = require("path");
     var scan = require_scan();
     var parse3 = require_parse2();
     var utils = require_utils3();
@@ -18372,7 +18372,7 @@ var require_picomatch = __commonJS({
     };
     picomatch.matchBase = (input, glob, options, posix = utils.isWindows(options)) => {
       const regex = glob instanceof RegExp ? glob : picomatch.makeRe(glob, options);
-      return regex.test(path23.basename(input));
+      return regex.test(path24.basename(input));
     };
     picomatch.isMatch = (str2, patterns, options) => picomatch(patterns, options)(str2);
     picomatch.parse = (pattern, options) => {
@@ -18414,8 +18414,8 @@ var require_picomatch = __commonJS({
       try {
         const opts = options || {};
         return new RegExp(source, opts.flags || (opts.nocase ? "i" : ""));
-      } catch (err19) {
-        if (options && options.debug === true) throw err19;
+      } catch (err20) {
+        if (options && options.debug === true) throw err20;
         return /$^/;
       }
     };
@@ -18599,7 +18599,7 @@ var require_pattern = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.isAbsolute = exports2.partitionAbsoluteAndRelative = exports2.removeDuplicateSlashes = exports2.matchAny = exports2.convertPatternsToRe = exports2.makeRe = exports2.getPatternParts = exports2.expandBraceExpansion = exports2.expandPatternsWithBraceExpansion = exports2.isAffectDepthOfReadingPattern = exports2.endsWithSlashGlobStar = exports2.hasGlobStar = exports2.getBaseDirectory = exports2.isPatternRelatedToParentDirectory = exports2.getPatternsOutsideCurrentDirectory = exports2.getPatternsInsideCurrentDirectory = exports2.getPositivePatterns = exports2.getNegativePatterns = exports2.isPositivePattern = exports2.isNegativePattern = exports2.convertToNegativePattern = exports2.convertToPositivePattern = exports2.isDynamicPattern = exports2.isStaticPattern = void 0;
-    var path23 = require("path");
+    var path24 = require("path");
     var globParent = require_glob_parent();
     var micromatch = require_micromatch();
     var GLOBSTAR = "**";
@@ -18694,7 +18694,7 @@ var require_pattern = __commonJS({
     }
     exports2.endsWithSlashGlobStar = endsWithSlashGlobStar;
     function isAffectDepthOfReadingPattern(pattern) {
-      const basename = path23.basename(pattern);
+      const basename = path24.basename(pattern);
       return endsWithSlashGlobStar(pattern) || isStaticPattern(basename);
     }
     exports2.isAffectDepthOfReadingPattern = isAffectDepthOfReadingPattern;
@@ -18752,7 +18752,7 @@ var require_pattern = __commonJS({
     }
     exports2.partitionAbsoluteAndRelative = partitionAbsoluteAndRelative;
     function isAbsolute(pattern) {
-      return path23.isAbsolute(pattern);
+      return path24.isAbsolute(pattern);
     }
     exports2.isAbsolute = isAbsolute;
   }
@@ -18822,8 +18822,8 @@ var require_merge2 = __commonJS({
             }
             next();
           }
-          function onerror(err19) {
-            mergedStream.emit("error", err19);
+          function onerror(err20) {
+            mergedStream.emit("error", err20);
           }
           if (stream._readableState.endEmitted) {
             return next();
@@ -18927,10 +18927,10 @@ var require_utils4 = __commonJS({
     exports2.array = array2;
     var errno = require_errno();
     exports2.errno = errno;
-    var fs3 = require_fs();
-    exports2.fs = fs3;
-    var path23 = require_path();
-    exports2.path = path23;
+    var fs4 = require_fs();
+    exports2.fs = fs4;
+    var path24 = require_path();
+    exports2.path = path24;
     var pattern = require_pattern();
     exports2.pattern = pattern;
     var stream = require_stream();
@@ -19042,8 +19042,8 @@ var require_async = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.read = void 0;
-    function read(path23, settings, callback) {
-      settings.fs.lstat(path23, (lstatError, lstat) => {
+    function read(path24, settings, callback) {
+      settings.fs.lstat(path24, (lstatError, lstat) => {
         if (lstatError !== null) {
           callFailureCallback(callback, lstatError);
           return;
@@ -19052,7 +19052,7 @@ var require_async = __commonJS({
           callSuccessCallback(callback, lstat);
           return;
         }
-        settings.fs.stat(path23, (statError, stat2) => {
+        settings.fs.stat(path24, (statError, stat2) => {
           if (statError !== null) {
             if (settings.throwErrorOnBrokenSymbolicLink) {
               callFailureCallback(callback, statError);
@@ -19084,13 +19084,13 @@ var require_sync = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.read = void 0;
-    function read(path23, settings) {
-      const lstat = settings.fs.lstatSync(path23);
+    function read(path24, settings) {
+      const lstat = settings.fs.lstatSync(path24);
       if (!lstat.isSymbolicLink() || !settings.followSymbolicLink) {
         return lstat;
       }
       try {
-        const stat2 = settings.fs.statSync(path23);
+        const stat2 = settings.fs.statSync(path24);
         if (settings.markSymbolicLink) {
           stat2.isSymbolicLink = () => true;
         }
@@ -19112,12 +19112,12 @@ var require_fs2 = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.createFileSystemAdapter = exports2.FILE_SYSTEM_ADAPTER = void 0;
-    var fs3 = require("fs");
+    var fs4 = require("fs");
     exports2.FILE_SYSTEM_ADAPTER = {
-      lstat: fs3.lstat,
-      stat: fs3.stat,
-      lstatSync: fs3.lstatSync,
-      statSync: fs3.statSync
+      lstat: fs4.lstat,
+      stat: fs4.stat,
+      lstatSync: fs4.lstatSync,
+      statSync: fs4.statSync
     };
     function createFileSystemAdapter(fsMethods) {
       if (fsMethods === void 0) {
@@ -19134,12 +19134,12 @@ var require_settings = __commonJS({
   "../../node_modules/.pnpm/@nodelib+fs.stat@2.0.5/node_modules/@nodelib/fs.stat/out/settings.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    var fs3 = require_fs2();
+    var fs4 = require_fs2();
     var Settings = class {
       constructor(_options = {}) {
         this._options = _options;
         this.followSymbolicLink = this._getValue(this._options.followSymbolicLink, true);
-        this.fs = fs3.createFileSystemAdapter(this._options.fs);
+        this.fs = fs4.createFileSystemAdapter(this._options.fs);
         this.markSymbolicLink = this._getValue(this._options.markSymbolicLink, false);
         this.throwErrorOnBrokenSymbolicLink = this._getValue(this._options.throwErrorOnBrokenSymbolicLink, true);
       }
@@ -19161,17 +19161,17 @@ var require_out = __commonJS({
     var sync = require_sync();
     var settings_1 = require_settings();
     exports2.Settings = settings_1.default;
-    function stat2(path23, optionsOrSettingsOrCallback, callback) {
+    function stat2(path24, optionsOrSettingsOrCallback, callback) {
       if (typeof optionsOrSettingsOrCallback === "function") {
-        async.read(path23, getSettings(), optionsOrSettingsOrCallback);
+        async.read(path24, getSettings(), optionsOrSettingsOrCallback);
         return;
       }
-      async.read(path23, getSettings(optionsOrSettingsOrCallback), callback);
+      async.read(path24, getSettings(optionsOrSettingsOrCallback), callback);
     }
     exports2.stat = stat2;
-    function statSync2(path23, optionsOrSettings) {
+    function statSync2(path24, optionsOrSettings) {
       const settings = getSettings(optionsOrSettings);
-      return sync.read(path23, settings);
+      return sync.read(path24, settings);
     }
     exports2.statSync = statSync2;
     function getSettings(settingsOrOptions = {}) {
@@ -19187,8 +19187,8 @@ var require_out = __commonJS({
 var require_queue_microtask = __commonJS({
   "../../node_modules/.pnpm/queue-microtask@1.2.3/node_modules/queue-microtask/index.js"(exports2, module2) {
     var promise2;
-    module2.exports = typeof queueMicrotask === "function" ? queueMicrotask.bind(typeof window !== "undefined" ? window : global) : (cb2) => (promise2 || (promise2 = Promise.resolve())).then(cb2).catch((err19) => setTimeout(() => {
-      throw err19;
+    module2.exports = typeof queueMicrotask === "function" ? queueMicrotask.bind(typeof window !== "undefined" ? window : global) : (cb2) => (promise2 || (promise2 = Promise.resolve())).then(cb2).catch((err20) => setTimeout(() => {
+      throw err20;
     }, 0));
   }
 });
@@ -19209,32 +19209,32 @@ var require_run_parallel = __commonJS({
         results = {};
         pending = keys.length;
       }
-      function done(err19) {
+      function done(err20) {
         function end() {
-          if (cb2) cb2(err19, results);
+          if (cb2) cb2(err20, results);
           cb2 = null;
         }
         if (isSync) queueMicrotask2(end);
         else end();
       }
-      function each(i3, err19, result) {
+      function each(i3, err20, result) {
         results[i3] = result;
-        if (--pending === 0 || err19) {
-          done(err19);
+        if (--pending === 0 || err20) {
+          done(err20);
         }
       }
       if (!pending) {
         done(null);
       } else if (keys) {
         keys.forEach(function(key) {
-          tasks[key](function(err19, result) {
-            each(key, err19, result);
+          tasks[key](function(err20, result) {
+            each(key, err20, result);
           });
         });
       } else {
         tasks.forEach(function(task, i3) {
-          task(function(err19, result) {
-            each(i3, err19, result);
+          task(function(err20, result) {
+            each(i3, err20, result);
           });
         });
       }
@@ -19294,8 +19294,8 @@ var require_utils5 = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.fs = void 0;
-    var fs3 = require_fs3();
-    exports2.fs = fs3;
+    var fs4 = require_fs3();
+    exports2.fs = fs4;
   }
 });
 
@@ -19387,16 +19387,16 @@ var require_async2 = __commonJS({
           return;
         }
         const tasks = names.map((name) => {
-          const path23 = common3.joinPathSegments(directory, name, settings.pathSegmentSeparator);
+          const path24 = common3.joinPathSegments(directory, name, settings.pathSegmentSeparator);
           return (done) => {
-            fsStat.stat(path23, settings.fsStatSettings, (error48, stats) => {
+            fsStat.stat(path24, settings.fsStatSettings, (error48, stats) => {
               if (error48 !== null) {
                 done(error48);
                 return;
               }
               const entry = {
                 name,
-                path: path23,
+                path: path24,
                 dirent: utils.fs.createDirentFromStats(name, stats)
               };
               if (settings.stats) {
@@ -19490,14 +19490,14 @@ var require_fs4 = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.createFileSystemAdapter = exports2.FILE_SYSTEM_ADAPTER = void 0;
-    var fs3 = require("fs");
+    var fs4 = require("fs");
     exports2.FILE_SYSTEM_ADAPTER = {
-      lstat: fs3.lstat,
-      stat: fs3.stat,
-      lstatSync: fs3.lstatSync,
-      statSync: fs3.statSync,
-      readdir: fs3.readdir,
-      readdirSync: fs3.readdirSync
+      lstat: fs4.lstat,
+      stat: fs4.stat,
+      lstatSync: fs4.lstatSync,
+      statSync: fs4.statSync,
+      readdir: fs4.readdir,
+      readdirSync: fs4.readdirSync
     };
     function createFileSystemAdapter(fsMethods) {
       if (fsMethods === void 0) {
@@ -19514,15 +19514,15 @@ var require_settings2 = __commonJS({
   "../../node_modules/.pnpm/@nodelib+fs.scandir@2.1.5/node_modules/@nodelib/fs.scandir/out/settings.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    var path23 = require("path");
+    var path24 = require("path");
     var fsStat = require_out();
-    var fs3 = require_fs4();
+    var fs4 = require_fs4();
     var Settings = class {
       constructor(_options = {}) {
         this._options = _options;
         this.followSymbolicLinks = this._getValue(this._options.followSymbolicLinks, false);
-        this.fs = fs3.createFileSystemAdapter(this._options.fs);
-        this.pathSegmentSeparator = this._getValue(this._options.pathSegmentSeparator, path23.sep);
+        this.fs = fs4.createFileSystemAdapter(this._options.fs);
+        this.pathSegmentSeparator = this._getValue(this._options.pathSegmentSeparator, path24.sep);
         this.stats = this._getValue(this._options.stats, false);
         this.throwErrorOnBrokenSymbolicLink = this._getValue(this._options.throwErrorOnBrokenSymbolicLink, true);
         this.fsStatSettings = new fsStat.Settings({
@@ -19549,17 +19549,17 @@ var require_out2 = __commonJS({
     var sync = require_sync2();
     var settings_1 = require_settings2();
     exports2.Settings = settings_1.default;
-    function scandir(path23, optionsOrSettingsOrCallback, callback) {
+    function scandir(path24, optionsOrSettingsOrCallback, callback) {
       if (typeof optionsOrSettingsOrCallback === "function") {
-        async.read(path23, getSettings(), optionsOrSettingsOrCallback);
+        async.read(path24, getSettings(), optionsOrSettingsOrCallback);
         return;
       }
-      async.read(path23, getSettings(optionsOrSettingsOrCallback), callback);
+      async.read(path24, getSettings(optionsOrSettingsOrCallback), callback);
     }
     exports2.scandir = scandir;
-    function scandirSync(path23, optionsOrSettings) {
+    function scandirSync(path24, optionsOrSettings) {
       const settings = getSettings(optionsOrSettings);
-      return sync.read(path23, settings);
+      return sync.read(path24, settings);
     }
     exports2.scandirSync = scandirSync;
     function getSettings(settingsOrOptions = {}) {
@@ -19623,8 +19623,8 @@ var require_queue = __commonJS({
       var errorHandler = null;
       var self2 = {
         push,
-        drain: noop2,
-        saturated: noop2,
+        drain: noop3,
+        saturated: noop3,
         pause,
         paused: false,
         get concurrency() {
@@ -19647,7 +19647,7 @@ var require_queue = __commonJS({
         length,
         getQueue,
         unshift,
-        empty: noop2,
+        empty: noop3,
         kill,
         killAndDrain,
         error: error48,
@@ -19699,7 +19699,7 @@ var require_queue = __commonJS({
         current.context = context;
         current.release = release;
         current.value = value;
-        current.callback = done || noop2;
+        current.callback = done || noop3;
         current.errorHandler = errorHandler;
         if (_running >= _concurrency || self2.paused) {
           if (queueTail) {
@@ -19720,7 +19720,7 @@ var require_queue = __commonJS({
         current.context = context;
         current.release = release;
         current.value = value;
-        current.callback = done || noop2;
+        current.callback = done || noop3;
         current.errorHandler = errorHandler;
         if (_running >= _concurrency || self2.paused) {
           if (queueHead) {
@@ -19762,13 +19762,13 @@ var require_queue = __commonJS({
       function kill() {
         queueHead = null;
         queueTail = null;
-        self2.drain = noop2;
+        self2.drain = noop3;
       }
       function killAndDrain() {
         queueHead = null;
         queueTail = null;
         self2.drain();
-        self2.drain = noop2;
+        self2.drain = noop3;
       }
       function abort() {
         var current = queueHead;
@@ -19781,7 +19781,7 @@ var require_queue = __commonJS({
           var val = current.value;
           var context2 = current.context;
           current.value = null;
-          current.callback = noop2;
+          current.callback = noop3;
           current.errorHandler = null;
           if (errorHandler2) {
             errorHandler2(new Error("abort"), val);
@@ -19790,32 +19790,32 @@ var require_queue = __commonJS({
           current.release(current);
           current = next;
         }
-        self2.drain = noop2;
+        self2.drain = noop3;
       }
       function error48(handler) {
         errorHandler = handler;
       }
     }
-    function noop2() {
+    function noop3() {
     }
     function Task3() {
       this.value = null;
-      this.callback = noop2;
+      this.callback = noop3;
       this.next = null;
-      this.release = noop2;
+      this.release = noop3;
       this.context = null;
       this.errorHandler = null;
       var self2 = this;
-      this.worked = function worked(err19, result) {
+      this.worked = function worked(err20, result) {
         var callback = self2.callback;
         var errorHandler = self2.errorHandler;
         var val = self2.value;
         self2.value = null;
-        self2.callback = noop2;
+        self2.callback = noop3;
         if (self2.errorHandler) {
-          errorHandler(err19, val);
+          errorHandler(err20, val);
         }
-        callback.call(self2.context, err19, result);
+        callback.call(self2.context, err20, result);
         self2.release(self2);
       };
     }
@@ -19839,28 +19839,28 @@ var require_queue = __commonJS({
       return queue;
       function push(value) {
         var p = new Promise(function(resolve, reject) {
-          pushCb(value, function(err19, result) {
-            if (err19) {
-              reject(err19);
+          pushCb(value, function(err20, result) {
+            if (err20) {
+              reject(err20);
               return;
             }
             resolve(result);
           });
         });
-        p.catch(noop2);
+        p.catch(noop3);
         return p;
       }
       function unshift(value) {
         var p = new Promise(function(resolve, reject) {
-          unshiftCb(value, function(err19, result) {
-            if (err19) {
-              reject(err19);
+          unshiftCb(value, function(err20, result) {
+            if (err20) {
+              reject(err20);
               return;
             }
             resolve(result);
           });
         });
-        p.catch(noop2);
+        p.catch(noop3);
         return p;
       }
       function drained() {
@@ -20206,7 +20206,7 @@ var require_settings3 = __commonJS({
   "../../node_modules/.pnpm/@nodelib+fs.walk@1.2.8/node_modules/@nodelib/fs.walk/out/settings.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    var path23 = require("path");
+    var path24 = require("path");
     var fsScandir = require_out2();
     var Settings = class {
       constructor(_options = {}) {
@@ -20216,7 +20216,7 @@ var require_settings3 = __commonJS({
         this.deepFilter = this._getValue(this._options.deepFilter, null);
         this.entryFilter = this._getValue(this._options.entryFilter, null);
         this.errorFilter = this._getValue(this._options.errorFilter, null);
-        this.pathSegmentSeparator = this._getValue(this._options.pathSegmentSeparator, path23.sep);
+        this.pathSegmentSeparator = this._getValue(this._options.pathSegmentSeparator, path24.sep);
         this.fsScandirSettings = new fsScandir.Settings({
           followSymbolicLinks: this._options.followSymbolicLinks,
           fs: this._options.fs,
@@ -20278,7 +20278,7 @@ var require_reader2 = __commonJS({
   "../../node_modules/.pnpm/fast-glob@3.3.3/node_modules/fast-glob/out/readers/reader.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    var path23 = require("path");
+    var path24 = require("path");
     var fsStat = require_out();
     var utils = require_utils4();
     var Reader = class {
@@ -20291,7 +20291,7 @@ var require_reader2 = __commonJS({
         });
       }
       _getFullEntryPath(filepath) {
-        return path23.resolve(this._settings.cwd, filepath);
+        return path24.resolve(this._settings.cwd, filepath);
       }
       _makeEntry(stats, pattern) {
         const entry = {
@@ -20707,7 +20707,7 @@ var require_provider = __commonJS({
   "../../node_modules/.pnpm/fast-glob@3.3.3/node_modules/fast-glob/out/providers/provider.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    var path23 = require("path");
+    var path24 = require("path");
     var deep_1 = require_deep();
     var entry_1 = require_entry();
     var error_1 = require_error2();
@@ -20721,7 +20721,7 @@ var require_provider = __commonJS({
         this.entryTransformer = new entry_2.default(this._settings);
       }
       _getRootDirectory(task) {
-        return path23.resolve(this._settings.cwd, task.base);
+        return path24.resolve(this._settings.cwd, task.base);
       }
       _getReaderOptions(task) {
         const basePath = task.base === "." ? "" : task.base;
@@ -20902,16 +20902,16 @@ var require_settings4 = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.DEFAULT_FILE_SYSTEM_ADAPTER = void 0;
-    var fs3 = require("fs");
+    var fs4 = require("fs");
     var os4 = require("os");
     var CPU_COUNT = Math.max(os4.cpus().length, 1);
     exports2.DEFAULT_FILE_SYSTEM_ADAPTER = {
-      lstat: fs3.lstat,
-      lstatSync: fs3.lstatSync,
-      stat: fs3.stat,
-      statSync: fs3.statSync,
-      readdir: fs3.readdir,
-      readdirSync: fs3.readdirSync
+      lstat: fs4.lstat,
+      lstatSync: fs4.lstatSync,
+      stat: fs4.stat,
+      statSync: fs4.statSync,
+      readdir: fs4.readdir,
+      readdirSync: fs4.readdirSync
     };
     var Settings = class {
       constructor(_options = {}) {
@@ -24368,9 +24368,9 @@ var tq = k((oq) => {
 });
 var sq = k((aq) => {
   Object.defineProperty(aq, "__esModule", { value: true });
-  var ok19 = Q$(), tk = { keyword: "not", schemaType: ["object", "boolean"], trackErrors: true, code($) {
+  var ok21 = Q$(), tk = { keyword: "not", schemaType: ["object", "boolean"], trackErrors: true, code($) {
     let { gen: X, schema: J, it: Q } = $;
-    if ((0, ok19.alwaysValidSchema)(Q, J)) {
+    if ((0, ok21.alwaysValidSchema)(Q, J)) {
       $.fail();
       return;
     }
@@ -38981,10 +38981,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema2) {
   return mergeDefs(schema2._zod.def);
 }
-function getElementAtPath(obj, path23) {
-  if (!path23)
+function getElementAtPath(obj, path24) {
+  if (!path24)
     return obj;
-  return path23.reduce((acc, key) => acc?.[key], obj);
+  return path24.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -39367,11 +39367,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path23, issues) {
+function prefixIssues(path24, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path23);
+    iss.path.unshift(path24);
     return iss;
   });
 }
@@ -39554,7 +39554,7 @@ function formatError(error48, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error48, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error49, path23 = []) => {
+  const processError = (error49, path24 = []) => {
     var _a3, _b2;
     for (const issue2 of error49.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
@@ -39564,7 +39564,7 @@ function treeifyError(error48, mapper = (issue2) => issue2.message) {
       } else if (issue2.code === "invalid_element") {
         processError({ issues: issue2.issues }, issue2.path);
       } else {
-        const fullpath = [...path23, ...issue2.path];
+        const fullpath = [...path24, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -39596,8 +39596,8 @@ function treeifyError(error48, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path23 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path23) {
+  const path24 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path24) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -51574,13 +51574,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path23 = ref.slice(1).split("/").filter(Boolean);
-  if (path23.length === 0) {
+  const path24 = ref.slice(1).split("/").filter(Boolean);
+  if (path24.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path23[0] === defsKey) {
-    const key = path23[1];
+  if (path24[0] === defsKey) {
+    const key = path24[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -52604,16 +52604,21 @@ function captureScreenshot(udid = "booted") {
   );
 }
 function createScreenshotTool(udid = "booted") {
-  return _x("screenshot", "Take a screenshot of the current screen.", {}, async () => {
-    const result = await captureScreenshot(udid);
-    if (result.isErr()) {
-      return {
-        content: [{ type: "text", text: String(result.error.cause) }],
-        isError: true
-      };
+  return _x(
+    "screenshot",
+    "Capture a screenshot of the current screen. Use for passive visual verification \u2014 confirming a screen transition occurred, loading finished, or an expected visual outcome is present \u2014 when you do not need element labels, tap coordinates, or accessibility attributes. Does not return a <screen_id>; cannot be used for stuck-loop detection or element-targeted assertions. Do not call this immediately before or after `view_ui` for the same state.",
+    {},
+    async () => {
+      const result = await captureScreenshot(udid);
+      if (result.isErr()) {
+        return {
+          content: [{ type: "text", text: String(result.error.cause) }],
+          isError: true
+        };
+      }
+      return { content: [{ type: "image", data: result.value, mimeType: "image/png" }] };
     }
-    return { content: [{ type: "image", data: result.value, mimeType: "image/png" }] };
-  });
+  );
 }
 var screenshotTool = createScreenshotTool();
 var MIN_WAIT_SECONDS = 1;
@@ -54738,15 +54743,15 @@ async function makeRequest(url2, fetchOptions, fetchFn = fetch) {
   return response;
 }
 function handleResponseError(e3, url2) {
-  let err19 = e3;
-  if (err19.name === "AbortError") {
-    err19 = new GoogleGenerativeAIAbortError(`Request aborted when fetching ${url2.toString()}: ${e3.message}`);
-    err19.stack = e3.stack;
+  let err20 = e3;
+  if (err20.name === "AbortError") {
+    err20 = new GoogleGenerativeAIAbortError(`Request aborted when fetching ${url2.toString()}: ${e3.message}`);
+    err20.stack = e3.stack;
   } else if (!(e3 instanceof GoogleGenerativeAIFetchError || e3 instanceof GoogleGenerativeAIRequestInputError)) {
-    err19 = new GoogleGenerativeAIError(`Error fetching from ${url2.toString()}: ${e3.message}`);
-    err19.stack = e3.stack;
+    err20 = new GoogleGenerativeAIError(`Error fetching from ${url2.toString()}: ${e3.message}`);
+    err20.stack = e3.stack;
   }
-  throw err19;
+  throw err20;
 }
 async function handleResponseNotOk(response, url2) {
   let message = "";
@@ -54912,11 +54917,11 @@ function __asyncGenerator(thisArg, _arguments, generator) {
     try {
       step(g3[n3](v2));
     } catch (e3) {
-      settle(q4[0][3], e3);
+      settle2(q4[0][3], e3);
     }
   }
   function step(r3) {
-    r3.value instanceof __await ? Promise.resolve(r3.value.v).then(fulfill, reject) : settle(q4[0][2], r3);
+    r3.value instanceof __await ? Promise.resolve(r3.value.v).then(fulfill, reject) : settle2(q4[0][2], r3);
   }
   function fulfill(value) {
     resume("next", value);
@@ -54924,7 +54929,7 @@ function __asyncGenerator(thisArg, _arguments, generator) {
   function reject(value) {
     resume("throw", value);
   }
-  function settle(f6, v2) {
+  function settle2(f6, v2) {
     if (f6(v2), q4.shift(), q4.length) resume(q4[0][0], q4[0][1]);
   }
 }
@@ -54993,14 +54998,14 @@ function getResponseStream(inputStream) {
           }
           return pump();
         }).catch((e3) => {
-          let err19 = e3;
-          err19.stack = e3.stack;
-          if (err19.name === "AbortError") {
-            err19 = new GoogleGenerativeAIAbortError("Request aborted when reading from the stream");
+          let err20 = e3;
+          err20.stack = e3.stack;
+          if (err20.name === "AbortError") {
+            err20 = new GoogleGenerativeAIAbortError("Request aborted when reading from the stream");
           } else {
-            err19 = new GoogleGenerativeAIError("Error reading from the stream");
+            err20 = new GoogleGenerativeAIError("Error reading from the stream");
           }
-          throw err19;
+          throw err20;
         });
       }
     }
@@ -55596,15 +55601,15 @@ async function makeRequest2(url2, fetchOptions, fetchFn = fetch) {
   return response;
 }
 function handleResponseError2(e3, url2) {
-  let err19 = e3;
-  if (err19.name === "AbortError") {
-    err19 = new GoogleGenerativeAIAbortError2(`Request aborted when fetching ${url2.toString()}: ${e3.message}`);
-    err19.stack = e3.stack;
+  let err20 = e3;
+  if (err20.name === "AbortError") {
+    err20 = new GoogleGenerativeAIAbortError2(`Request aborted when fetching ${url2.toString()}: ${e3.message}`);
+    err20.stack = e3.stack;
   } else if (!(e3 instanceof GoogleGenerativeAIFetchError2 || e3 instanceof GoogleGenerativeAIRequestInputError2)) {
-    err19 = new GoogleGenerativeAIError2(`Error fetching from ${url2.toString()}: ${e3.message}`);
-    err19.stack = e3.stack;
+    err20 = new GoogleGenerativeAIError2(`Error fetching from ${url2.toString()}: ${e3.message}`);
+    err20.stack = e3.stack;
   }
-  throw err19;
+  throw err20;
 }
 async function handleResponseNotOk2(response, url2) {
   let message = "";
@@ -55643,8 +55648,8 @@ var ServerRequestUrl = class {
     this.apiKey = apiKey;
     this.requestOptions = requestOptions;
   }
-  appendPath(path23) {
-    this._url.pathname = this._url.pathname + `/${path23}`;
+  appendPath(path24) {
+    this._url.pathname = this._url.pathname + `/${path24}`;
   }
   appendParam(key, value) {
     this._url.searchParams.append(key, value);
@@ -56200,34 +56205,34 @@ var uuid42 = function() {
 };
 
 // ../../node_modules/.pnpm/@anthropic-ai+sdk@0.87.0_zod@4.3.6/node_modules/@anthropic-ai/sdk/internal/errors.mjs
-function isAbortError(err19) {
-  return typeof err19 === "object" && err19 !== null && // Spec-compliant fetch implementations
-  ("name" in err19 && err19.name === "AbortError" || // Expo fetch
-  "message" in err19 && String(err19.message).includes("FetchRequestCanceledException"));
-}
-var castToError = (err19) => {
-  if (err19 instanceof Error)
-    return err19;
-  if (typeof err19 === "object" && err19 !== null) {
+function isAbortError(err20) {
+  return typeof err20 === "object" && err20 !== null && // Spec-compliant fetch implementations
+  ("name" in err20 && err20.name === "AbortError" || // Expo fetch
+  "message" in err20 && String(err20.message).includes("FetchRequestCanceledException"));
+}
+var castToError = (err20) => {
+  if (err20 instanceof Error)
+    return err20;
+  if (typeof err20 === "object" && err20 !== null) {
     try {
-      if (Object.prototype.toString.call(err19) === "[object Error]") {
-        const error48 = new Error(err19.message, err19.cause ? { cause: err19.cause } : {});
-        if (err19.stack)
-          error48.stack = err19.stack;
-        if (err19.cause && !error48.cause)
-          error48.cause = err19.cause;
-        if (err19.name)
-          error48.name = err19.name;
+      if (Object.prototype.toString.call(err20) === "[object Error]") {
+        const error48 = new Error(err20.message, err20.cause ? { cause: err20.cause } : {});
+        if (err20.stack)
+          error48.stack = err20.stack;
+        if (err20.cause && !error48.cause)
+          error48.cause = err20.cause;
+        if (err20.name)
+          error48.name = err20.name;
         return error48;
       }
     } catch {
     }
     try {
-      return new Error(JSON.stringify(err19));
+      return new Error(JSON.stringify(err20));
     } catch {
     }
   }
-  return new Error(err19);
+  return new Error(err20);
 };
 
 // ../../node_modules/.pnpm/@anthropic-ai+sdk@0.87.0_zod@4.3.6/node_modules/@anthropic-ai/sdk/core/error.mjs
@@ -56357,7 +56362,7 @@ var validatePositiveInteger = (name, n3) => {
 var safeJSON = (text) => {
   try {
     return JSON.parse(text);
-  } catch (err19) {
+  } catch (err20) {
     return void 0;
   }
 };
@@ -56921,8 +56926,8 @@ var Stream = class _Stream {
             return ctrl.close();
           const bytes = encodeUTF8(JSON.stringify(value) + "\n");
           ctrl.enqueue(bytes);
-        } catch (err19) {
-          ctrl.error(err19);
+        } catch (err20) {
+          ctrl.error(err20);
         }
       },
       async cancel() {
@@ -57470,12 +57475,12 @@ function encodeURIPath(str2) {
   return str2.replace(/[^A-Za-z0-9\-._~!$&'()*+,;=:@]+/g, encodeURIComponent);
 }
 var EMPTY = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.create(null));
-var createPathTagFunction = (pathEncoder = encodeURIPath) => function path23(statics, ...params) {
+var createPathTagFunction = (pathEncoder = encodeURIPath) => function path24(statics, ...params) {
   if (statics.length === 1)
     return statics[0];
   let postPath = false;
   const invalidSegments = [];
-  const path24 = statics.reduce((previousValue, currentValue, index) => {
+  const path25 = statics.reduce((previousValue, currentValue, index) => {
     if (/[?#]/.test(currentValue)) {
       postPath = true;
     }
@@ -57492,7 +57497,7 @@ var createPathTagFunction = (pathEncoder = encodeURIPath) => function path23(sta
     }
     return previousValue + currentValue + (index === params.length ? "" : encoded);
   }, "");
-  const pathOnly = path24.split(/[?#]/, 1)[0];
+  const pathOnly = path25.split(/[?#]/, 1)[0];
   const invalidSegmentPattern = /(?<=^|\/)(?:\.|%2e){1,2}(?=\/|$)/gi;
   let match;
   while ((match = invalidSegmentPattern.exec(pathOnly)) !== null) {
@@ -57513,10 +57518,10 @@ var createPathTagFunction = (pathEncoder = encodeURIPath) => function path23(sta
     }, "");
     throw new AnthropicError(`Path parameters result in path with invalid segments:
 ${invalidSegments.map((e3) => e3.error).join("\n")}
-${path24}
+${path25}
 ${underline}`);
   }
-  return path24;
+  return path25;
 };
 var path4 = /* @__PURE__ */ createPathTagFunction(encodeURIPath);
 
@@ -58829,8 +58834,8 @@ var BetaMessageStream = class _BetaMessageStream {
               if (jsonBuf) {
                 try {
                   newContent.input = partialParse(jsonBuf);
-                } catch (err19) {
-                  const error48 = new AnthropicError(`Unable to parse tool parameter JSON from model. Please retry your request or adjust your prompt. Error: ${err19}. JSON: ${jsonBuf}`);
+                } catch (err20) {
+                  const error48 = new AnthropicError(`Unable to parse tool parameter JSON from model. Please retry your request or adjust your prompt. Error: ${err20}. JSON: ${jsonBuf}`);
                   __classPrivateFieldGet(this, _BetaMessageStream_handleError, "f").call(this, error48);
                 }
               }
@@ -58892,17 +58897,17 @@ var BetaMessageStream = class _BetaMessageStream {
       }
       readQueue.length = 0;
     });
-    this.on("abort", (err19) => {
+    this.on("abort", (err20) => {
       done = true;
       for (const reader of readQueue) {
-        reader.reject(err19);
+        reader.reject(err20);
       }
       readQueue.length = 0;
     });
-    this.on("error", (err19) => {
+    this.on("error", (err20) => {
       done = true;
       for (const reader of readQueue) {
-        reader.reject(err19);
+        reader.reject(err20);
       }
       readQueue.length = 0;
     });
@@ -61145,17 +61150,17 @@ var MessageStream = class _MessageStream {
       }
       readQueue.length = 0;
     });
-    this.on("abort", (err19) => {
+    this.on("abort", (err20) => {
       done = true;
       for (const reader of readQueue) {
-        reader.reject(err19);
+        reader.reject(err20);
       }
       readQueue.length = 0;
     });
-    this.on("error", (err19) => {
+    this.on("error", (err20) => {
       done = true;
       for (const reader of readQueue) {
-        reader.reject(err19);
+        reader.reject(err20);
       }
       readQueue.length = 0;
     });
@@ -61604,9 +61609,9 @@ var BaseAnthropic = class {
   makeStatusError(status, error48, message, headers) {
     return APIError.generate(status, error48, message, headers);
   }
-  buildURL(path23, query, defaultBaseURL) {
+  buildURL(path24, query, defaultBaseURL) {
     const baseURL = !__classPrivateFieldGet(this, _BaseAnthropic_instances, "m", _BaseAnthropic_baseURLOverridden).call(this) && defaultBaseURL || this.baseURL;
-    const url2 = isAbsoluteURL(path23) ? new URL(path23) : new URL(baseURL + (baseURL.endsWith("/") && path23.startsWith("/") ? path23.slice(1) : path23));
+    const url2 = isAbsoluteURL(path24) ? new URL(path24) : new URL(baseURL + (baseURL.endsWith("/") && path24.startsWith("/") ? path24.slice(1) : path24));
     const defaultQuery = this.defaultQuery();
     const pathQuery = Object.fromEntries(url2.searchParams);
     if (!isEmptyObj(defaultQuery) || !isEmptyObj(pathQuery)) {
@@ -61638,24 +61643,24 @@ var BaseAnthropic = class {
    */
   async prepareRequest(request, { url: url2, options }) {
   }
-  get(path23, opts) {
-    return this.methodRequest("get", path23, opts);
+  get(path24, opts) {
+    return this.methodRequest("get", path24, opts);
   }
-  post(path23, opts) {
-    return this.methodRequest("post", path23, opts);
+  post(path24, opts) {
+    return this.methodRequest("post", path24, opts);
   }
-  patch(path23, opts) {
-    return this.methodRequest("patch", path23, opts);
+  patch(path24, opts) {
+    return this.methodRequest("patch", path24, opts);
   }
-  put(path23, opts) {
-    return this.methodRequest("put", path23, opts);
+  put(path24, opts) {
+    return this.methodRequest("put", path24, opts);
   }
-  delete(path23, opts) {
-    return this.methodRequest("delete", path23, opts);
+  delete(path24, opts) {
+    return this.methodRequest("delete", path24, opts);
   }
-  methodRequest(method, path23, opts) {
+  methodRequest(method, path24, opts) {
     return this.request(Promise.resolve(opts).then((opts2) => {
-      return { method, path: path23, ...opts2 };
+      return { method, path: path24, ...opts2 };
     }));
   }
   request(options, remainingRetries = null) {
@@ -61735,7 +61740,7 @@ var BaseAnthropic = class {
       }
       const retryMessage = shouldRetry ? `error; no more retries left` : `error; not retryable`;
       loggerFor(this).info(`${responseInfo} - ${retryMessage}`);
-      const errText = await response.text().catch((err20) => castToError(err20).message);
+      const errText = await response.text().catch((err21) => castToError(err21).message);
       const errJSON = safeJSON(errText);
       const errMessage = errJSON ? void 0 : errText;
       loggerFor(this).debug(`[${requestLogID}] response error (${retryMessage})`, formatRequestDetails({
@@ -61746,8 +61751,8 @@ var BaseAnthropic = class {
         message: errMessage,
         durationMs: Date.now() - startTime
       }));
-      const err19 = this.makeStatusError(response.status, errJSON, errMessage, response.headers);
-      throw err19;
+      const err20 = this.makeStatusError(response.status, errJSON, errMessage, response.headers);
+      throw err20;
     }
     loggerFor(this).info(responseInfo);
     loggerFor(this).debug(`[${requestLogID}] response start`, formatRequestDetails({
@@ -61759,8 +61764,8 @@ var BaseAnthropic = class {
     }));
     return { response, options, controller: controller2, requestLogID, retryOfRequestLogID, startTime };
   }
-  getAPIList(path23, Page2, opts) {
-    return this.requestAPIList(Page2, opts && "then" in opts ? opts.then((opts2) => ({ method: "get", path: path23, ...opts2 })) : { method: "get", path: path23, ...opts });
+  getAPIList(path24, Page2, opts) {
+    return this.requestAPIList(Page2, opts && "then" in opts ? opts.then((opts2) => ({ method: "get", path: path24, ...opts2 })) : { method: "get", path: path24, ...opts });
   }
   requestAPIList(Page2, options) {
     const request = this.makeRequest(options, null, void 0);
@@ -61848,8 +61853,8 @@ var BaseAnthropic = class {
   }
   async buildRequest(inputOptions, { retryCount = 0 } = {}) {
     const options = { ...inputOptions };
-    const { method, path: path23, query, defaultBaseURL } = options;
-    const url2 = this.buildURL(path23, query, defaultBaseURL);
+    const { method, path: path24, query, defaultBaseURL } = options;
+    const url2 = this.buildURL(path24, query, defaultBaseURL);
     if ("timeout" in options)
       validatePositiveInteger("timeout", options.timeout);
     options.timeout = options.timeout ?? this.timeout;
@@ -62224,7 +62229,7 @@ async function runFfmpeg(arguments_) {
 }
 function spawnRecorder(outputPath) {
   const safeMkdirSync = (0, import_neverthrow15.fromThrowable)(import_node_fs.mkdirSync, (cause) => cause);
-  const safeSpawn = (0, import_neverthrow15.fromThrowable)(
+  const safeSpawn2 = (0, import_neverthrow15.fromThrowable)(
     (command, arguments_) => (0, import_node_child_process3.spawn)(command, arguments_),
     (cause) => cause
   );
@@ -62232,7 +62237,7 @@ function spawnRecorder(outputPath) {
   if (mkdirResult.isErr()) {
     return mkdirResult.error;
   }
-  const spawnResult = safeSpawn("xcrun", [
+  const spawnResult = safeSpawn2("xcrun", [
     "simctl",
     "io",
     "booted",
@@ -62309,9 +62314,11 @@ function speedUpVideo({
   );
 }
 var VIEW_UI_TOOL_NAME = "mcp__mobile-ios__view_ui";
-var VIEW_UI_DESCRIPTION = `Capture the current screen state: accessibility snapshot (element list with positions) and screenshot. Call this after every action to observe the result.
+var VIEW_UI_DESCRIPTION = `Capture current screen state: accessibility tree (element labels, positions, attributes) and screenshot in one call. Use when you need to tap an element, assert element presence or labels, check attributes, or track screen identity via <screen_id>.
+
+The result begins with a <screen_id> tag containing the current screen identifier. Use this to detect screen changes and track navigation history.
 
-The result begins with a <screen_id> tag containing the current screen identifier. Use this to track which screen you are on.
+Do not call \`screenshot\` immediately before or after this tool for the same state \u2014 this tool already includes the screenshot.
 
 IMPORTANT: Snapshot coordinates and screenshot pixels are in the same logical point space. Do not apply any scaling factor (no 2x retina adjustment).`;
 function deriveScreenLabel(tree, stepIndex) {
@@ -62636,32 +62643,11 @@ function spawnDetached(options) {
     off: child.off.bind(child)
   };
 }
-var cachedAllTools;
-async function fetchAllTools() {
-  if (cachedAllTools !== void 0) {
-    return cachedAllTools;
-  }
-  const probe = Qs({ prompt: "", options: { settingSources: ["user"] } });
-  for await (const message of probe) {
-    if (message.type === "system" && message.subtype === "init") {
-      probe.close();
-      cachedAllTools = message.tools;
-      return cachedAllTools;
-    }
-  }
-  return [];
-}
-async function resolveDisallowedTools(allowedTools) {
-  const allTools = await fetchAllTools();
-  const allowedSet = new Set(allowedTools);
-  return allTools.filter((tool2) => !allowedSet.has(tool2));
-}
 function buildQueryOptions({
   config: config3,
   outputTools,
   mobileIosServer,
-  allowedTools,
-  disallowedTools
+  allowedTools
 }) {
   const base = {
     mcpServers: {
@@ -62670,8 +62656,9 @@ function buildQueryOptions({
       output: outputTools.server
     },
     allowedTools,
-    disallowedTools,
-    settingSources: ["user"],
+    tools: [],
+    permissionMode: "bypassPermissions",
+    allowDangerouslySkipPermissions: true,
     spawnClaudeCodeProcess: spawnDetached,
     ...config3.cwd ? { cwd: config3.cwd } : {}
   };
@@ -62722,14 +62709,13 @@ function buildMobileIosServer(config3, state) {
   });
   return createMobileIosServer(config3.udid ?? "booted", [viewUiTool]);
 }
-async function setupQuery(config3, outputTools) {
+function setupQuery(config3, outputTools) {
   const allowedTools = [
     ...config3.allowedTools ?? [],
     ...outputTools.allowedToolNames,
     VIEW_UI_TOOL_NAME,
     WAIT_SECONDS_TOOL_NAME
-  ];
-  const disallowedTools = await resolveDisallowedTools(allowedTools);
+  ].filter((tool2) => typeof tool2 === "string");
   const inputQueue = new MessageQueue();
   const state = buildAgentState({ config: config3, outputTools, inputQueue });
   const mobileIosServer = buildMobileIosServer(config3, state);
@@ -62737,8 +62723,7 @@ async function setupQuery(config3, outputTools) {
     config: config3,
     outputTools,
     mobileIosServer,
-    allowedTools,
-    disallowedTools
+    allowedTools
   });
   return { inputQueue, state, options, linkedController };
 }
@@ -62854,16 +62839,16 @@ function startQueryTimers(config3, context) {
     inputQueue.close();
   };
 }
-function awaitMessagesAndResolve({ queryRunner, state }, { cleanup: cleanup2, getOutput }) {
+function awaitMessagesAndResolve({ queryRunner, state }, { cleanup: cleanup3, getOutput }) {
   const messagesPromise = processMessages(queryRunner, state);
   return import_neverthrow16.ResultAsync.fromPromise(messagesPromise, String).andThen((innerResult) => {
-    cleanup2();
+    cleanup3();
     if (innerResult.isErr()) {
       return (0, import_neverthrow16.err)(innerResult.error);
     }
     return (0, import_neverthrow16.ok)(getOutput());
   }).orElse((sdkError) => {
-    cleanup2();
+    cleanup3();
     if (!state.timedOut.value && !state.aborted.value) {
       return (0, import_neverthrow16.err)(sdkError);
     }
@@ -62886,21 +62871,19 @@ function executeQuery({
     return (0, import_neverthrow16.errAsync)(queryRunnerResult.error);
   }
   const queryRunner = queryRunnerResult.value;
-  const cleanup2 = startQueryTimers(config3, { state, queryRunner, inputQueue, linkedController });
+  const cleanup3 = startQueryTimers(config3, { state, queryRunner, inputQueue, linkedController });
   const getOutput = () => ({
     findings: (outputTools.getOutput()?.findings ?? []).map(
       (raw) => stampExplorerAgent(raw)
     ),
     snapshots: state.snapshots
   });
-  return awaitMessagesAndResolve({ queryRunner, state }, { cleanup: cleanup2, getOutput });
+  return awaitMessagesAndResolve({ queryRunner, state }, { cleanup: cleanup3, getOutput });
 }
 function runQuery(prompt, config3) {
   const outputTools = createOutputTool({ findings: external_exports.array(EXPLORER_FINDING_SCHEMA) });
-  const setupPromise = setupQuery(config3, outputTools);
-  return import_neverthrow16.ResultAsync.fromPromise(setupPromise, String).andThen(
-    (setup) => executeQuery({ prompt, config: config3, outputTools, setup })
-  );
+  const setup = setupQuery(config3, outputTools);
+  return executeQuery({ prompt, config: config3, outputTools, setup });
 }
 function collectAgentOutput(prompt, config3) {
   return runQuery(prompt, config3).mapErr((cause) => ({ type: "QUERY_FAILED", cause }));
@@ -62952,6 +62935,12 @@ function startAndRun(params) {
     }).andThen((result) => applySpeedUpVariants({ result, params, toRecordingError }));
   });
 }
+var TOOL_SELECTION_SECTION = `## Tool Selection
+
+- \`view_ui\` \u2014 returns accessibility tree (element labels, positions, attributes) AND screenshot; use when you need to tap, assert element presence, or read labels
+- \`screenshot\` \u2014 returns screenshot only; use for passive visual verification (confirm transition occurred, loading finished, outcome visible) when you do not need element data
+- Never call \`screenshot\` immediately before or after \`view_ui\` for the same state \u2014 \`view_ui\` already includes the screenshot
+- \`screenshot\` calls do not emit a \`<screen_id>\` and do not advance the stuck-loop counter; if screen identity tracking matters, use \`view_ui\``;
 var DEV_ENVIRONMENT_SECTION = `## Environment
 
 This is a development build. Debug overlays and internal messages are expected artifacts \u2014 do not report them as findings.`;
@@ -62964,9 +62953,9 @@ At every reasoning step, maintain a mental ledger:
 
 Consult the ledger before every action. Always prefer navigating to a QUEUE screen over a VISITED one.`;
 var SESSION_START_RULE = `Before taking any other action \u2014 including initializing the Working State ledger or emitting findings \u2014 call \`view_ui\` once to observe the starting screen`;
-var BACK_NAV_RULE = `After navigating forward to any new screen: tap back, call \`view_ui\`, confirm you returned to the expected parent in PATH \u2014 if not, emit a \`back-nav-failure\` finding, then navigate forward again to continue`;
-var STUCK_LOOP_RULE = `Stuck loop: emit a \`stuck-loop\` finding when any of these occur: (1) \`view_ui\` returns the same screen state 3 or more consecutive steps, (2) the same element has been tapped more than twice with no screen change, (3) PATH shows the same screen at two non-adjacent positions \u2014 before emitting, try one alternative action (scroll, long-press, swipe) to rule out a gesture mismatch`;
-var LOADING_STATE_RULE = `Transient loading state: when \`view_ui\` reveals spinners, skeleton screens, progress bars, "Loading..." text, or placeholder content NOT described in spec or app context, wait and retry \`view_ui\` up to 3 times before treating screen as final \u2014 if loading persists after 3 retries, proceed with what is visible; if spec or app context explicitly describes a loading screen as a step, do not retry \u2014 inspect and assert normally`;
+var BACK_NAV_RULE = `After navigating forward to any new screen: tap back, then confirm you returned to the expected parent in PATH \u2014 use \`screenshot\` if the parent screen is visually unambiguous, \`view_ui\` if you need element labels or coordinates to verify or to act next \u2014 if confirmation fails, emit a \`back-nav-failure\` finding, then navigate forward again to continue`;
+var STUCK_LOOP_RULE = `Stuck loop: emit a \`stuck-loop\` finding when any of these occur: (1) \`view_ui\` returns the same \`<screen_id>\` across 3 or more consecutive \`view_ui\` calls, (2) the same element has been tapped more than twice with no screen change confirmed by \`view_ui\`, (3) PATH shows the same screen at two non-adjacent positions \u2014 before emitting, try one alternative action (scroll, long-press, swipe) to rule out a gesture mismatch \u2014 note: \`screenshot\`-only calls do not update the stuck-loop counter; only \`view_ui\` calls count`;
+var LOADING_STATE_RULE = `Transient loading state: when the screen shows spinners, skeleton screens, progress bars, "Loading..." text, or placeholder content NOT described in spec or app context \u2014 use \`screenshot\` to poll for resolution (up to 3 retries); switch to \`view_ui\` only on the final check or when you need element data to act \u2014 if loading persists after 3 retries, proceed with what is visible; if spec or app context explicitly describes a loading screen as a step, do not retry \u2014 call \`view_ui\` and assert normally`;
 var EXPECTED_CONTENT_MISSING_RULE = `Expected content missing: when \`view_ui\` shows no loading indicator yet omits an element named or strongly implied by spec or app context \u2014 and its absence is not semantically consistent with the current screen \u2014 call \`wait_seconds\` with 2\u20135 seconds and retry \`view_ui\` up to 2 times; if element remains absent, emit a \`missing-content\` finding stating what was expected and what was observed`;
 var CLIPPED_ELEMENT_RULE = `Never tap an element tagged \`[clipped-top]\`, \`[clipped-bottom]\`, \`[clipped-left]\`, or \`[clipped-right]\` \u2014 scroll to fully reveal it first, then re-call \`view_ui\` before tapping`;
 var WHAT_TO_TEST_SECTION = `## What to Test
@@ -63009,7 +62998,7 @@ Each step has this shape:
   <intent> [\u2192 <outcome>] [hint: <advisory>]
 
 - The intent phrase is your goal. Achieve it by any reasonable UI path.
-- If an outcome state is present, it is your verification target. After acting, call \`view_ui\` and confirm the outcome is met before marking the step complete. If no outcome is given, proceed when the action succeeds.
+- If an outcome state is present, it is your verification target. After acting, confirm the outcome is met before marking the step complete \u2014 use \`screenshot\` when the outcome is purely visual (screen transition visible, element gone, content appeared); use \`view_ui\` when the outcome requires asserting element labels, attributes, or coordinates. If no outcome is given, proceed when the action succeeds.
 - A hint is advisory only. Prefer an element matching the hint, but if no literal match exists, use intent and visual context to select the best candidate. Never fail a step solely because a hint label is absent.
 - Infer element role (primary action, secondary action, dismissal) from visual hierarchy, position, and hint text. Authors do not specify role.
 - If no element satisfies the intent after exhausting visible UI, emit a \`spec-deviation\` finding and halt that step.`;
@@ -63042,14 +63031,15 @@ ${initialState2}` : void 0,
 var SPEC_RULES_SECTION = `## Rules
 
 - ${SESSION_START_RULE}
-- ALWAYS call \`view_ui\` after every action before deciding what to do next \u2014 it is your only way to observe the screen
+- After any action, observe the screen before deciding next step \u2014 use \`screenshot\` when confirming a purely visual outcome (transition occurred, element disappeared, content appeared, loading finished); use \`view_ui\` when you need element labels, tap coordinates, or accessibility attributes
+- Never call both \`screenshot\` and \`view_ui\` back-to-back for the same observation \u2014 \`view_ui\` includes a screenshot; if you need both tree and image, one \`view_ui\` call suffices
 - ${BACK_NAV_RULE}
 - Before selecting any action, prefer navigating to a QUEUE screen over re-exploring a VISITED one
 - ${STUCK_LOOP_RULE}
 - ${LOADING_STATE_RULE}
 - ${EXPECTED_CONTENT_MISSING_RULE}
 - ${CLIPPED_ELEMENT_RULE}
-- Each item in \`**Assertions**\` is a mandatory pass/fail check \u2014 verify using \`view_ui\`; if the accessibility tree cannot confirm, emit a \`spec-deviation\` finding based on what is observable
+- Each item in \`**Assertions**\` is a mandatory pass/fail check \u2014 verify using \`view_ui\` when the assertion targets an element attribute, label, or presence in the tree; use \`screenshot\` when the assertion is purely visual; if neither can confirm, emit a \`spec-deviation\` finding based on what is observable
 - Flag crash dialogs, unexpected system errors, or navigation failures that occur as a direct result of executing a spec step; if you observe a visibly broken element in passing while navigating, note it without interacting with it`;
 function buildSpecModeBody({
   specContent,
@@ -63062,6 +63052,8 @@ Verify app against specs below.
 
 ${contextBlock}
 
+${TOOL_SELECTION_SECTION}
+
 ${SPEC_RULES_SECTION}
 
 ## Execution Strategy
@@ -63101,10 +63093,13 @@ ${DEV_ENVIRONMENT_SECTION}` : "";
 
 ${contextBlock}
 
+${TOOL_SELECTION_SECTION}
+
 ## Rules
 
 - ${SESSION_START_RULE}
-- ALWAYS call \`view_ui\` after every action before deciding what to do next \u2014 it is your only way to observe the screen
+- After any action, observe the screen before deciding next step \u2014 use \`screenshot\` when confirming a purely visual outcome (transition occurred, element disappeared, content appeared, loading finished); use \`view_ui\` when you need element labels, tap coordinates, or accessibility attributes
+- Never call both \`screenshot\` and \`view_ui\` back-to-back for the same observation \u2014 \`view_ui\` includes a screenshot; if you need both tree and image, one \`view_ui\` call suffices
 - ${BACK_NAV_RULE}
 - Before selecting any action, prefer navigating to a QUEUE screen over re-exploring a VISITED one
 - ${STUCK_LOOP_RULE}
@@ -64445,7 +64440,7 @@ var directiveHandlers = {
     }
     try {
       prefix = decodeURIComponent(prefix);
-    } catch (err19) {
+    } catch (err20) {
       throwError(state, "tag prefix is malformed: " + prefix);
     }
     state.tagMap[handle] = prefix;
@@ -65126,7 +65121,7 @@ function readTagProperty(state) {
   }
   try {
     tagName = decodeURIComponent(tagName);
-  } catch (err19) {
+  } catch (err20) {
     throwError(state, "tag name is malformed: " + tagName);
   }
   if (isVerbatim) {
@@ -69394,7 +69389,7 @@ function createPrompt(view) {
         effectScheduler.clearAll();
         throw error48;
       }).finally(() => {
-        cleanups.forEach((cleanup2) => cleanup2());
+        cleanups.forEach((cleanup3) => cleanup3());
         screen.done({ clearContent: Boolean(context.clearPromptOnDone) });
         output.end();
       }).then(() => promise2), { cancel });
@@ -69654,9 +69649,9 @@ var RemoveFileError = class extends Error {
 // ../../node_modules/.pnpm/@inquirer+external-editor@1.0.3_@types+node@22.19.15/node_modules/@inquirer/external-editor/dist/esm/index.js
 function editAsync(text = "", callback, fileOptions) {
   const editor = new ExternalEditor(text, fileOptions);
-  editor.runAsync((err19, result) => {
-    if (err19) {
-      setImmediate(callback, err19, void 0);
+  editor.runAsync((err20, result) => {
+    if (err20) {
+      setImmediate(callback, err20, void 0);
     } else {
       try {
         editor.cleanup();
@@ -71753,8 +71748,8 @@ function getErrorMap2() {
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path23, errorMaps, issueData } = params;
-  const fullPath = [...path23, ...issueData.path || []];
+  const { data, path: path24, errorMaps, issueData } = params;
+  const fullPath = [...path24, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -71870,11 +71865,11 @@ var errorUtil;
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path23, key) {
+  constructor(parent, value, path24, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path23;
+    this._path = path24;
     this._key = key;
   }
   get path() {
@@ -72013,8 +72008,8 @@ var ZodType2 = class {
         } : {
           issues: ctx.common.issues
         };
-      } catch (err19) {
-        if (err19?.message?.toLowerCase()?.includes("encountered")) {
+      } catch (err20) {
+        if (err20?.message?.toLowerCase()?.includes("encountered")) {
           this["~standard"].async = true;
         }
         ctx.common = {
@@ -75462,34 +75457,23 @@ function findXqaDirectory(startDirectory) {
 }
 
 // src/suite/commands/run-command.ts
-var import_promises20 = __toESM(require("node:fs/promises"), 1);
-var import_node_path22 = __toESM(require("node:path"), 1);
+var import_promises21 = __toESM(require("node:fs/promises"), 1);
+var import_node_path23 = __toESM(require("node:path"), 1);
 var import_fast_glob = __toESM(require_out4(), 1);
-var import_neverthrow52 = __toESM(require_index_cjs(), 1);
-
-// src/suite/core/run-id.ts
-var RUN_ID_PAD_LENGTH2 = 4;
-function toNumeric(name) {
-  const parsed = Number(name);
-  return Number.isInteger(parsed) && parsed > 0 ? parsed : void 0;
-}
-function highestNumeric(directories) {
-  let highest = 0;
-  for (const name of directories) {
-    const numeric = toNumeric(name);
-    if (numeric !== void 0 && numeric > highest) {
-      highest = numeric;
-    }
-  }
-  return highest;
-}
-function computeNextRunId(existingDirectories) {
-  return String(highestNumeric(existingDirectories) + 1).padStart(RUN_ID_PAD_LENGTH2, "0");
-}
+var import_neverthrow55 = __toESM(require_index_cjs(), 1);
 
 // src/suite/core/suite-config-parser.ts
 var import_neverthrow48 = __toESM(require_index_cjs(), 1);
 var import_neverthrow49 = __toESM(require_index_cjs(), 1);
+var RESERVED_HOOK_ENV_KEYS = [
+  "XQA_SIM_UDID",
+  "XQA_ITEM_ID",
+  "XQA_ITEM_TYPE",
+  "XQA_ITEM_NAME",
+  "XQA_SPEC_PATH",
+  "XQA_SUITE"
+];
+var reservedKeySet = new Set(RESERVED_HOOK_ENV_KEYS);
 var freestyleEntrySchema = external_exports2.object({
   prompt: external_exports2.string().optional(),
   timeoutSeconds: external_exports2.number().int().positive()
@@ -75504,9 +75488,33 @@ var freestyleSchema = external_exports2.union([external_exports2.number().int().
   }
   return value;
 });
+var hookConfigSchema = external_exports2.object({
+  script: external_exports2.string().min(1),
+  env: external_exports2.record(external_exports2.string(), external_exports2.string()).optional(),
+  timeoutSeconds: external_exports2.number().int().positive().optional()
+}).superRefine((data, context) => {
+  if (data.env === void 0) {
+    return;
+  }
+  for (const key of Object.keys(data.env)) {
+    if (reservedKeySet.has(key)) {
+      context.addIssue({
+        code: external_exports2.ZodIssueCode.custom,
+        path: ["env", key],
+        message: `Reserved xqa-owned key: ${key}`
+      });
+    }
+  }
+});
+var suiteHooksSchema = external_exports2.object({
+  beforeEach: hookConfigSchema.optional()
+});
 var suiteConfigSchema = external_exports2.object({
-  specs: external_exports2.array(external_exports2.string()).nonempty(),
-  freestyle: freestyleSchema
+  specs: external_exports2.array(external_exports2.string()).default([]),
+  freestyle: freestyleSchema,
+  hooks: suiteHooksSchema.optional()
+}).refine((data) => data.specs.length > 0 || data.freestyle.length > 0, {
+  message: "Suite must declare at least one spec or freestyle entry"
 });
 var safeJsonParse4 = (0, import_neverthrow48.fromThrowable)(
   JSON.parse,
@@ -75515,13 +75523,47 @@ var safeJsonParse4 = (0, import_neverthrow48.fromThrowable)(
     cause
   })
 );
+function buildHookConfig(parsed) {
+  const { script, env: env2, timeoutSeconds } = parsed;
+  if (env2 !== void 0 && timeoutSeconds !== void 0) {
+    return { script, env: env2, timeoutSeconds };
+  }
+  if (env2 !== void 0) {
+    return { script, env: env2 };
+  }
+  if (timeoutSeconds !== void 0) {
+    return { script, timeoutSeconds };
+  }
+  return { script };
+}
+function normalizeHooks(hooks) {
+  if (hooks === void 0) {
+    return void 0;
+  }
+  const { beforeEach } = hooks;
+  if (beforeEach === void 0) {
+    return {};
+  }
+  return { beforeEach: buildHookConfig(beforeEach) };
+}
 function parseSuiteConfig(raw) {
   return safeJsonParse4(raw).andThen((data) => {
     const parsed = suiteConfigSchema.safeParse(data);
     if (!parsed.success) {
       return (0, import_neverthrow49.err)({ type: "INVALID_SUITE_CONFIG", cause: parsed.error });
     }
-    return (0, import_neverthrow49.ok)({ specs: parsed.data.specs, freestyle: parsed.data.freestyle });
+    const hooks = normalizeHooks(parsed.data.hooks);
+    if (hooks === void 0) {
+      return (0, import_neverthrow49.ok)({
+        specs: parsed.data.specs,
+        freestyle: parsed.data.freestyle
+      });
+    }
+    return (0, import_neverthrow49.ok)({
+      specs: parsed.data.specs,
+      freestyle: parsed.data.freestyle,
+      hooks
+    });
   });
 }
 
@@ -75534,17 +75576,6 @@ function buildSuiteFindings(input) {
   return base;
 }
 
-// src/suite/core/suite-id.ts
-function slugify2(glob) {
-  return glob.replaceAll(/[^a-zA-Z0-9]+/g, "-").replaceAll(/-+/g, "-").replaceAll(/^-|-$/g, "");
-}
-function deriveSuiteId(input) {
-  if (input.mode === "suite") {
-    return input.name;
-  }
-  return input.globs.toSorted().map((glob) => slugify2(glob)).join("+");
-}
-
 // src/suite/core/work-item-builder.ts
 var DEFAULT_FREESTYLE_TIMEOUT_SECONDS = 300;
 function deriveSpecName(filePath) {
@@ -75612,7 +75643,29 @@ function writeSuiteFindings(findings, options) {
 }
 
 // src/suite/shell/worker-pool.ts
-var import_neverthrow51 = __toESM(require_index_cjs(), 1);
+var import_neverthrow53 = __toESM(require_index_cjs(), 1);
+
+// src/suite/core/priority-queue.ts
+var PriorityQueue = class {
+  entries = [];
+  get size() {
+    return this.entries.length;
+  }
+  get isEmpty() {
+    return this.entries.length === 0;
+  }
+  enqueue(item, priority) {
+    const insertIndex = this.entries.findIndex((entry) => entry.priority > priority);
+    if (insertIndex === -1) {
+      this.entries.push({ item, priority });
+    } else {
+      this.entries.splice(insertIndex, 0, { item, priority });
+    }
+  }
+  dequeue() {
+    return this.entries.shift()?.item;
+  }
+};
 
 // src/suite/shell/item-result-builder.ts
 function getErrorMessage(cause) {
@@ -75686,33 +75739,7 @@ function buildAbortedItem(item, simulatorUdid) {
   };
 }
 
-// src/suite/core/priority-queue.ts
-var PriorityQueue = class {
-  entries = [];
-  get size() {
-    return this.entries.length;
-  }
-  get isEmpty() {
-    return this.entries.length === 0;
-  }
-  enqueue(item, priority) {
-    const insertIndex = this.entries.findIndex((entry) => entry.priority > priority);
-    if (insertIndex === -1) {
-      this.entries.push({ item, priority });
-    } else {
-      this.entries.splice(insertIndex, 0, { item, priority });
-    }
-  }
-  dequeue() {
-    return this.entries.shift()?.item;
-  }
-};
-
-// src/suite/shell/worker-pool.ts
-var CONSECUTIVE_FAILURES_THRESHOLD = 2;
-function isTimeoutError(error48) {
-  return error48.type.toUpperCase().includes("TIMEOUT");
-}
+// src/suite/shell/item-result-recorder.ts
 function buildNotifyBase(itemContext) {
   return {
     itemId: itemContext.item.id,
@@ -75721,6 +75748,9 @@ function buildNotifyBase(itemContext) {
     at: Date.now()
   };
 }
+function isTimeoutError(error48) {
+  return error48.type.toUpperCase().includes("TIMEOUT");
+}
 function notifyItemResult(context, observer) {
   const base = buildNotifyBase(context.itemContext);
   if (context.result.isOk()) {
@@ -75741,12 +75771,12 @@ function notifyItemResult(context, observer) {
     error: getErrorMessage(context.result.error.cause)
   });
 }
-function recordItemResult(context, workerContext) {
+function recordItemResult(input) {
+  const { context, results, observer } = input;
   const { itemContext, result } = context;
-  const { results, config: config3 } = workerContext;
   if (result.isOk()) {
     results.push(buildCompletedItem(itemContext, result.value));
-    notifyItemResult(context, config3.observer);
+    notifyItemResult(context, observer);
     return 0;
   }
   if (isTimeoutError(result.error)) {
@@ -75754,9 +75784,202 @@ function recordItemResult(context, workerContext) {
   } else {
     results.push(buildFailedItem(itemContext, getErrorMessage(result.error.cause)));
   }
-  notifyItemResult(context, config3.observer);
+  notifyItemResult(context, observer);
+  return 1;
+}
+
+// src/suite/shell/hook-failure-recorder.ts
+function formatHookError(error48) {
+  switch (error48.type) {
+    case "HOOK_SPAWN_FAILED": {
+      return `Hook spawn failed: ${getErrorMessage(error48.cause)}`;
+    }
+    case "HOOK_EXIT_NONZERO": {
+      return `Hook exited with code ${String(error48.code)}: ${error48.stderr.trim()}`;
+    }
+    case "HOOK_TIMEOUT": {
+      return `Hook timed out after ${String(error48.timeoutMs)}ms`;
+    }
+    case "HOOK_ABORTED": {
+      return "Hook aborted";
+    }
+  }
+}
+function emitHookTimeout(input) {
+  const base = buildNotifyBase(input.itemContext);
+  input.results.push(buildTimedOutItem(input.itemContext));
+  const event = { type: "ITEM_TIMEOUT", ...base };
+  input.observer(event);
+}
+function emitHookFailed(input, message) {
+  const base = buildNotifyBase(input.itemContext);
+  input.results.push(buildFailedItem(input.itemContext, message));
+  const event = { type: "ITEM_FAILED", ...base, error: message };
+  input.observer(event);
+}
+function recordHookFailure(input) {
+  if (input.error.type === "HOOK_TIMEOUT") {
+    emitHookTimeout(input);
+    return 1;
+  }
+  emitHookFailed(input, formatHookError(input.error));
   return 1;
 }
+
+// src/suite/shell/hook-invoker.ts
+var import_neverthrow52 = __toESM(require_index_cjs(), 1);
+
+// src/suite/core/hook-env-builder.ts
+function buildReservedKeys(input) {
+  const { item, simulatorUdid, suiteName } = input;
+  const base = {
+    XQA_SIM_UDID: simulatorUdid,
+    XQA_ITEM_ID: item.id,
+    XQA_ITEM_TYPE: item.type,
+    XQA_ITEM_NAME: item.name,
+    XQA_SUITE: suiteName
+  };
+  if (item.type === "spec") {
+    return { ...base, XQA_SPEC_PATH: item.specPath };
+  }
+  return base;
+}
+function buildHookEnv(input) {
+  const reserved = buildReservedKeys(input);
+  if (input.suiteEnv === void 0) {
+    return reserved;
+  }
+  return { ...input.suiteEnv, ...reserved };
+}
+
+// src/suite/shell/hook-runner.ts
+var import_node_child_process7 = require("node:child_process");
+var import_neverthrow51 = __toESM(require_index_cjs(), 1);
+var noop2 = () => void 0;
+function cleanup2(context) {
+  clearTimeout(context.timeoutHandle);
+  context.signal.removeEventListener("abort", context.onAbort);
+}
+function settle(context, outcome) {
+  if (context.settled.value) {
+    return;
+  }
+  context.settled.value = true;
+  cleanup2(context);
+  context.deferred.resolve(outcome);
+}
+function makeDeferred() {
+  const raw = Promise.withResolvers();
+  return { promise: raw.promise, resolve: raw.resolve };
+}
+function collectStderr(child, stderrReference) {
+  if (child.stderr === null) {
+    return;
+  }
+  child.stderr.on("data", (chunk) => {
+    stderrReference.value += chunk.toString();
+  });
+}
+function buildOnAbort(context) {
+  return () => {
+    context.child.kill("SIGTERM");
+    settle(context, (0, import_neverthrow51.err)({ type: "HOOK_ABORTED" }));
+  };
+}
+function attachChildListeners(context) {
+  const { child, stderrReference } = context;
+  child.on("error", (cause) => {
+    settle(context, (0, import_neverthrow51.err)({ type: "HOOK_SPAWN_FAILED", cause }));
+  });
+  child.on("exit", (code) => {
+    if (code === 0) {
+      settle(context, (0, import_neverthrow51.ok)());
+      return;
+    }
+    settle(
+      context,
+      (0, import_neverthrow51.err)({
+        type: "HOOK_EXIT_NONZERO",
+        code: code ?? -1,
+        stderr: stderrReference.value
+      })
+    );
+  });
+}
+function attachTimeout(context, timeoutMs) {
+  clearTimeout(context.timeoutHandle);
+  context.timeoutHandle = setTimeout(() => {
+    context.child.kill("SIGTERM");
+    settle(context, (0, import_neverthrow51.err)({ type: "HOOK_TIMEOUT", timeoutMs }));
+  }, timeoutMs);
+}
+function buildContext2(options) {
+  const { script, cwd, env: env2, baseEnv, nodeExecPath } = options;
+  const deferred = makeDeferred();
+  const stderrReference = { value: "" };
+  const child = (0, import_node_child_process7.spawn)(nodeExecPath, [script], {
+    cwd,
+    env: { ...baseEnv, ...env2 },
+    stdio: ["ignore", "inherit", "pipe"]
+  });
+  collectStderr(child, stderrReference);
+  return {
+    child,
+    signal: options.signal,
+    timeoutHandle: setTimeout(noop2, 0),
+    onAbort: noop2,
+    deferred,
+    stderrReference,
+    settled: { value: false }
+  };
+}
+async function spawnHook(options) {
+  const context = buildContext2(options);
+  attachTimeout(context, options.timeoutMs);
+  context.onAbort = buildOnAbort(context);
+  if (options.signal.aborted) {
+    context.onAbort();
+    return context.deferred.promise;
+  }
+  options.signal.addEventListener("abort", context.onAbort, { once: true });
+  attachChildListeners(context);
+  return context.deferred.promise;
+}
+var safeSpawn = import_neverthrow51.ResultAsync.fromThrowable(
+  spawnHook,
+  (cause) => ({ type: "HOOK_SPAWN_FAILED", cause })
+);
+function runHook(options) {
+  return safeSpawn(options).andThen((outcome) => outcome);
+}
+
+// src/suite/shell/hook-invoker.ts
+var DEFAULT_HOOK_TIMEOUT_SECONDS = 120;
+var MS_PER_SECOND5 = 1e3;
+async function invokeHook(input) {
+  const { hook, item, simulatorUdid, suiteName, hookCwd, hookBaseEnv, hookNodeExecPath, signal } = input;
+  const env2 = buildHookEnv({ item, simulatorUdid, suiteName, suiteEnv: hook.env });
+  const timeoutSeconds = hook.timeoutSeconds ?? DEFAULT_HOOK_TIMEOUT_SECONDS;
+  return runHook({
+    script: hook.script,
+    cwd: hookCwd,
+    env: env2,
+    baseEnv: hookBaseEnv,
+    nodeExecPath: hookNodeExecPath,
+    timeoutMs: timeoutSeconds * MS_PER_SECOND5,
+    signal
+  });
+}
+async function maybeInvokeHook(input) {
+  const { hook } = input;
+  if (hook === void 0) {
+    return (0, import_neverthrow52.ok)();
+  }
+  return invokeHook({ ...input, hook });
+}
+
+// src/suite/shell/worker-pool.ts
+var CONSECUTIVE_FAILURES_THRESHOLD = 2;
 function buildExecuteOptions(workerContext, item) {
   const { simulatorUdid, config: config3 } = workerContext;
   const base = { item, simulatorUdid, signal: config3.signal };
@@ -75766,21 +75989,70 @@ function buildExecuteOptions(workerContext, item) {
   }
   return base;
 }
-async function processItem(workerContext, item) {
-  const { simulatorUdid, config: config3 } = workerContext;
-  const startedAt = (/* @__PURE__ */ new Date()).toISOString();
-  const startMs = Date.now();
-  config3.observer({
+function buildHookInvokeInput(workerContext, item) {
+  const { config: config3, simulatorUdid } = workerContext;
+  return {
+    hook: config3.hook,
+    item,
+    simulatorUdid,
+    suiteName: config3.suiteName,
+    hookCwd: config3.hookCwd,
+    hookBaseEnv: config3.hookBaseEnv,
+    hookNodeExecPath: config3.hookNodeExecPath,
+    signal: config3.signal
+  };
+}
+function emitItemStarted(state) {
+  const { workerContext, item, startMs } = state;
+  workerContext.config.observer({
     type: "ITEM_STARTED",
     itemId: item.id,
     itemName: item.name,
-    simulatorUdid,
+    simulatorUdid: workerContext.simulatorUdid,
     at: startMs
   });
-  const result = await config3.executeItem(buildExecuteOptions(workerContext, item));
+}
+async function runAndRecordItem(state) {
+  const { workerContext, item, startedAt, startMs } = state;
+  const { simulatorUdid } = workerContext;
+  const result = await workerContext.config.executeItem(buildExecuteOptions(workerContext, item));
   const durationMs = Date.now() - startMs;
   const itemContext = { item, simulatorUdid, startedAt, durationMs };
-  return recordItemResult({ itemContext, result }, workerContext);
+  return recordItemResult({
+    context: { itemContext, result },
+    results: workerContext.results,
+    observer: workerContext.config.observer
+  });
+}
+function handleHookFailure(state, error48) {
+  const { workerContext, item, startedAt, startMs } = state;
+  const durationMs = Date.now() - startMs;
+  const itemContext = {
+    item,
+    simulatorUdid: workerContext.simulatorUdid,
+    startedAt,
+    durationMs
+  };
+  return recordHookFailure({
+    itemContext,
+    error: error48,
+    results: workerContext.results,
+    observer: workerContext.config.observer
+  });
+}
+async function processItem(workerContext, item) {
+  const state = {
+    workerContext,
+    item,
+    startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    startMs: Date.now()
+  };
+  emitItemStarted(state);
+  const hookOutcome = await maybeInvokeHook(buildHookInvokeInput(workerContext, item));
+  if (hookOutcome.isErr()) {
+    return handleHookFailure(state, hookOutcome.error);
+  }
+  return runAndRecordItem(state);
 }
 async function runWorker(workerContext) {
   const { simulatorUdid, queue, config: config3 } = workerContext;
@@ -75840,7 +76112,7 @@ function runWorkerPool(config3) {
   const queue = setupQueue(config3);
   const results = [];
   const suiteStartMs = Date.now();
-  const safeRun = import_neverthrow51.ResultAsync.fromThrowable(
+  const safeRun = import_neverthrow53.ResultAsync.fromThrowable(
     async () => runAllWorkers({ config: config3, queue, results, suiteStartMs }),
     (cause) => ({ type: "WORKER_POOL_FAILED", cause })
   );
@@ -75925,30 +76197,88 @@ function makeExecuteItem(context) {
   };
 }
 
-// src/suite/commands/run-command.ts
+// src/suite/commands/suite-run-context.ts
+var import_promises20 = __toESM(require("node:fs/promises"), 1);
+var import_node_path22 = __toESM(require("node:path"), 1);
+var import_neverthrow54 = __toESM(require_index_cjs(), 1);
+
+// src/suite/core/run-id.ts
+var RUN_ID_PAD_LENGTH2 = 4;
+function toNumeric(name) {
+  const parsed = Number(name);
+  return Number.isInteger(parsed) && parsed > 0 ? parsed : void 0;
+}
+function highestNumeric(directories) {
+  let highest = 0;
+  for (const name of directories) {
+    const numeric = toNumeric(name);
+    if (numeric !== void 0 && numeric > highest) {
+      highest = numeric;
+    }
+  }
+  return highest;
+}
+function computeNextRunId(existingDirectories) {
+  return String(highestNumeric(existingDirectories) + 1).padStart(RUN_ID_PAD_LENGTH2, "0");
+}
+
+// src/suite/core/suite-id.ts
+function slugify2(glob) {
+  return glob.replaceAll(/[^a-zA-Z0-9]+/g, "-").replaceAll(/-+/g, "-").replaceAll(/^-|-$/g, "");
+}
+function deriveSuiteId(input) {
+  if (input.mode === "suite") {
+    return input.name;
+  }
+  return input.globs.toSorted().map((glob) => slugify2(glob)).join("+");
+}
+
+// src/suite/commands/suite-run-context.ts
 var ISO_DATE_LENGTH3 = 10;
-var safeReaddir2 = import_neverthrow52.ResultAsync.fromThrowable(
+var safeReaddir2 = import_neverthrow54.ResultAsync.fromThrowable(
   async (directoryPath) => {
     const entries = await import_promises20.default.readdir(directoryPath, { withFileTypes: true });
     return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
   },
   () => "READDIR_FAILED"
 );
-var safeReadFile5 = import_neverthrow52.ResultAsync.fromThrowable(
-  async (filePath) => import_promises20.default.readFile(filePath, "utf8"),
-  () => "READ_FAILED"
-);
 async function listRunDirectories(input) {
   const { outputDirectory, suiteId, date: date5 } = input;
   const directoryPath = import_node_path22.default.join(outputDirectory, "suite", suiteId, date5);
   const result = await safeReaddir2(directoryPath);
   return result.unwrapOr([]);
 }
+function deriveSuiteIdFromMode(mode) {
+  if (mode.type === "suite") {
+    return deriveSuiteId({ mode: "suite", name: mode.name });
+  }
+  return deriveSuiteId({ mode: "spec", globs: mode.globs });
+}
+async function buildSuiteRunContext(input) {
+  const suiteId = deriveSuiteIdFromMode(input.mode);
+  const date5 = (/* @__PURE__ */ new Date()).toISOString().slice(0, ISO_DATE_LENGTH3);
+  const outputDirectory = import_node_path22.default.join(input.xqaDirectory, "output");
+  const existingDirectories = await listRunDirectories({ outputDirectory, suiteId, date: date5 });
+  const runId = computeNextRunId(existingDirectories);
+  const context = {
+    config: input.config,
+    xqaDirectory: input.xqaDirectory,
+    runId,
+    date: date5
+  };
+  return { suiteId, date: date5, outputDirectory, runId, context };
+}
+
+// src/suite/commands/run-command.ts
+var safeReadFile5 = import_neverthrow55.ResultAsync.fromThrowable(
+  async (filePath) => import_promises21.default.readFile(filePath, "utf8"),
+  () => "READ_FAILED"
+);
 async function resolveGlobs(input) {
   return (0, import_fast_glob.default)(input.globs, { cwd: input.cwd, absolute: true });
 }
 async function loadSuiteConfig(xqaDirectory, name) {
-  const suitePath = import_node_path22.default.join(xqaDirectory, "suites", `${name}.suite.json`);
+  const suitePath = import_node_path23.default.join(xqaDirectory, "suites", `${name}.suite.json`);
   const contentResult = await safeReadFile5(suitePath);
   if (contentResult.isErr()) {
     return;
@@ -75966,12 +76296,15 @@ async function resolveSuiteModeItems(input) {
 `);
     return;
   }
-  const specPaths = await resolveGlobs({ globs: suiteConfig.specs, cwd: input.xqaDirectory });
-  if (specPaths.length === 0) {
+  const specPaths = suiteConfig.specs.length > 0 ? await resolveGlobs({ globs: suiteConfig.specs, cwd: input.xqaDirectory }) : [];
+  if (specPaths.length === 0 && suiteConfig.freestyle.length === 0) {
     process.stderr.write("No spec files matched\n");
     return;
   }
-  return [...buildSpecItems(specPaths), ...buildFreestyleItems(suiteConfig.freestyle)];
+  return {
+    items: [...buildSpecItems(specPaths), ...buildFreestyleItems(suiteConfig.freestyle)],
+    hook: suiteConfig.hooks?.beforeEach
+  };
 }
 async function resolveSpecModeItems(input) {
   const specPaths = await resolveGlobs({ globs: input.mode.globs, cwd: input.xqaDirectory });
@@ -75979,7 +76312,7 @@ async function resolveSpecModeItems(input) {
     process.stderr.write("No spec files matched\n");
     return;
   }
-  return buildSpecItems(specPaths);
+  return { items: buildSpecItems(specPaths), hook: void 0 };
 }
 async function resolveWorkItems(input) {
   if (input.mode.type === "suite") {
@@ -75987,12 +76320,6 @@ async function resolveWorkItems(input) {
   }
   return resolveSpecModeItems({ ...input, mode: input.mode });
 }
-function deriveSuiteIdFromMode(mode) {
-  if (mode.type === "suite") {
-    return deriveSuiteId({ mode: "suite", name: mode.name });
-  }
-  return deriveSuiteId({ mode: "spec", globs: mode.globs });
-}
 async function discoverSimulators() {
   const result = await discoverBootedSimulators();
   if (result.isErr()) {
@@ -76006,25 +76333,34 @@ async function discoverSimulators() {
   }
   return { simulators: result.value, exitCode: 0 };
 }
-async function runPool(input) {
-  const { context, items, simulatorUdids, debug, signal } = input;
-  const display = createSuiteDisplay();
+function buildPoolConfig(input, display) {
+  const { context, items, simulatorUdids, debug, signal, suiteName, hookCwd } = input;
   const debugLogger = createDebugLogger({ enabled: debug });
   const baseObserver = (event) => {
     display.onEvent(event);
   };
   const observer = debugLogger.wrapSuiteHandler(baseObserver);
-  const buildItemHandler = (itemId) => debugLogger.wrapAgentHandler((event) => {
+  const onEvent = (itemId) => debugLogger.wrapAgentHandler((event) => {
     display.onEvent({ ...event, itemId });
   }, itemId);
-  const poolResult = await runWorkerPool({
+  return {
     items,
     simulatorUdids,
     observer,
-    onEvent: buildItemHandler,
+    onEvent,
     executeItem: makeExecuteItem(context),
-    signal
-  });
+    signal,
+    suiteName,
+    hookCwd,
+    hookBaseEnv: process.env,
+    hookNodeExecPath: process.execPath
+  };
+}
+async function runPool(input) {
+  const { hook } = input;
+  const display = createSuiteDisplay();
+  const poolConfig = buildPoolConfig(input, display);
+  const poolResult = hook === void 0 ? await runWorkerPool(poolConfig) : await runWorkerPool({ ...poolConfig, hook });
   display.cleanup();
   return poolResult;
 }
@@ -76045,29 +76381,21 @@ async function writeAndReport(input) {
   const hasFindings = items.some((item) => item.findings.length > 0);
   return hasFindings ? 1 : 0;
 }
-async function buildSuiteRunContext(input) {
-  const suiteId = deriveSuiteIdFromMode(input.mode);
-  const date5 = (/* @__PURE__ */ new Date()).toISOString().slice(0, ISO_DATE_LENGTH3);
-  const outputDirectory = import_node_path22.default.join(input.xqaDirectory, "output");
-  const existingDirectories = await listRunDirectories({ outputDirectory, suiteId, date: date5 });
-  const runId = computeNextRunId(existingDirectories);
-  const context = {
-    config: input.config,
-    xqaDirectory: input.xqaDirectory,
-    runId,
-    date: date5
+function derivePoolInput(input, context) {
+  const suiteName = input.mode.type === "suite" ? input.mode.name : "specs";
+  return {
+    context,
+    items: input.items,
+    simulatorUdids: input.simulatorUdids,
+    debug: input.debug,
+    signal: input.signal,
+    suiteName,
+    hook: input.hook,
+    hookCwd: input.xqaDirectory
   };
-  return { suiteId, date: date5, outputDirectory, runId, context };
 }
 async function executePool(input, runContext) {
-  const { items, simulatorUdids, debug, signal } = input;
-  return runPool({
-    context: runContext.context,
-    items,
-    simulatorUdids,
-    debug,
-    signal
-  });
+  return runPool(derivePoolInput(input, runContext.context));
 }
 async function runSuite(input) {
   const runContext = await buildSuiteRunContext(input);
@@ -76091,8 +76419,8 @@ async function runSuiteCommand(input) {
   if (preflightExit !== void 0) {
     return preflightExit;
   }
-  const items = await resolveWorkItems(input);
-  if (items === void 0) {
+  const resolved = await resolveWorkItems(input);
+  if (resolved === void 0) {
     return 1;
   }
   const simulatorResolution = await discoverSimulators();
@@ -76106,8 +76434,9 @@ async function runSuiteCommand(input) {
   }
   return runSuite({
     ...input,
-    items,
-    simulatorUdids: simulators.map((sim) => sim.udid)
+    items: resolved.items,
+    simulatorUdids: simulators.map((sim) => sim.udid),
+    hook: resolved.hook
   });
 }
 
@@ -76129,7 +76458,7 @@ function resolveXqaDirectory() {
   return result.value;
 }
 var program2 = new Command();
-program2.name("xqa").description("AI-powered QA agent CLI").version(`${"1.10.0"}${false ? ` (dev build +${"e25bb70"})` : ""}`);
+program2.name("xqa").description("AI-powered QA agent CLI").version(`${"1.12.0"}${false ? ` (dev build +${"3c4f23d"})` : ""}`);
 program2.command("init").description("Initialize a new xqa project in the current directory").action(() => {
   runInitCommand();
 });