@swmansion/argent 0.29.1-next.21 → 0.29.1-next.23

package/dist/mcp-server.mjs

@@ -2990,7 +2990,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve9.call(this, root, ref);
+      let _sch = resolve10.call(this, root, ref);
       if (_sch === void 0) {
         const schema = (_a3 = root.localRefs) === null || _a3 === void 0 ? void 0 : _a3[ref];
         const { schemaId } = this.opts;
@@ -3017,7 +3017,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve9(root, ref) {
+    function resolve10(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -3235,8 +3235,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path16) {
-      let input = path16;
+    function removeDotSegments(path17) {
+      let input = path17;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -3488,8 +3488,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path16, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path16 && path16 !== "/" ? path16 : void 0;
+        const [path17, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path17 && path17 !== "/" ? path17 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -3648,7 +3648,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve9(baseURI, relativeURI, options) {
+    function resolve10(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const resolved = resolveComponent(parse3(baseURI, schemelessOptions), parse3(relativeURI, schemelessOptions), schemelessOptions, true);
       schemelessOptions.skipEscape = true;
@@ -3906,7 +3906,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize: normalize3,
-      resolve: resolve9,
+      resolve: resolve10,
       resolveComponent,
       equal,
       serialize,
@@ -6882,12 +6882,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f;
     };
-    function addFormats(ajv, list, fs11, exportName) {
+    function addFormats(ajv, list, fs12, exportName) {
       var _a3;
       var _b;
       (_a3 = (_b = ajv.opts.code).formats) !== null && _a3 !== void 0 ? _a3 : _b.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`;
       for (const f of list)
-        ajv.addFormat(f, fs11[f]);
+        ajv.addFormat(f, fs12[f]);
     }
     module.exports = exports = formatsPlugin;
     Object.defineProperty(exports, "__esModule", { value: true });
@@ -6972,17 +6972,17 @@ var require_visit = __commonJS({
     visit.BREAK = BREAK;
     visit.SKIP = SKIP;
     visit.REMOVE = REMOVE;
-    function visit_(key, node2, visitor, path16) {
-      const ctrl = callVisitor(key, node2, visitor, path16);
+    function visit_(key, node2, visitor, path17) {
+      const ctrl = callVisitor(key, node2, visitor, path17);
       if (identity.isNode(ctrl) || identity.isPair(ctrl)) {
-        replaceNode(key, path16, ctrl);
-        return visit_(key, ctrl, visitor, path16);
+        replaceNode(key, path17, ctrl);
+        return visit_(key, ctrl, visitor, path17);
       }
       if (typeof ctrl !== "symbol") {
         if (identity.isCollection(node2)) {
-          path16 = Object.freeze(path16.concat(node2));
+          path17 = Object.freeze(path17.concat(node2));
           for (let i = 0; i < node2.items.length; ++i) {
-            const ci = visit_(i, node2.items[i], visitor, path16);
+            const ci = visit_(i, node2.items[i], visitor, path17);
             if (typeof ci === "number")
               i = ci - 1;
             else if (ci === BREAK)
@@ -6993,13 +6993,13 @@ var require_visit = __commonJS({
             }
           }
         } else if (identity.isPair(node2)) {
-          path16 = Object.freeze(path16.concat(node2));
-          const ck = visit_("key", node2.key, visitor, path16);
+          path17 = Object.freeze(path17.concat(node2));
+          const ck = visit_("key", node2.key, visitor, path17);
           if (ck === BREAK)
             return BREAK;
           else if (ck === REMOVE)
             node2.key = null;
-          const cv = visit_("value", node2.value, visitor, path16);
+          const cv = visit_("value", node2.value, visitor, path17);
           if (cv === BREAK)
             return BREAK;
           else if (cv === REMOVE)
@@ -7020,17 +7020,17 @@ var require_visit = __commonJS({
     visitAsync.BREAK = BREAK;
     visitAsync.SKIP = SKIP;
     visitAsync.REMOVE = REMOVE;
-    async function visitAsync_(key, node2, visitor, path16) {
-      const ctrl = await callVisitor(key, node2, visitor, path16);
+    async function visitAsync_(key, node2, visitor, path17) {
+      const ctrl = await callVisitor(key, node2, visitor, path17);
       if (identity.isNode(ctrl) || identity.isPair(ctrl)) {
-        replaceNode(key, path16, ctrl);
-        return visitAsync_(key, ctrl, visitor, path16);
+        replaceNode(key, path17, ctrl);
+        return visitAsync_(key, ctrl, visitor, path17);
       }
       if (typeof ctrl !== "symbol") {
         if (identity.isCollection(node2)) {
-          path16 = Object.freeze(path16.concat(node2));
+          path17 = Object.freeze(path17.concat(node2));
           for (let i = 0; i < node2.items.length; ++i) {
-            const ci = await visitAsync_(i, node2.items[i], visitor, path16);
+            const ci = await visitAsync_(i, node2.items[i], visitor, path17);
             if (typeof ci === "number")
               i = ci - 1;
             else if (ci === BREAK)
@@ -7041,13 +7041,13 @@ var require_visit = __commonJS({
             }
           }
         } else if (identity.isPair(node2)) {
-          path16 = Object.freeze(path16.concat(node2));
-          const ck = await visitAsync_("key", node2.key, visitor, path16);
+          path17 = Object.freeze(path17.concat(node2));
+          const ck = await visitAsync_("key", node2.key, visitor, path17);
           if (ck === BREAK)
             return BREAK;
           else if (ck === REMOVE)
             node2.key = null;
-          const cv = await visitAsync_("value", node2.value, visitor, path16);
+          const cv = await visitAsync_("value", node2.value, visitor, path17);
           if (cv === BREAK)
             return BREAK;
           else if (cv === REMOVE)
@@ -7074,23 +7074,23 @@ var require_visit = __commonJS({
       }
       return visitor;
     }
-    function callVisitor(key, node2, visitor, path16) {
+    function callVisitor(key, node2, visitor, path17) {
       if (typeof visitor === "function")
-        return visitor(key, node2, path16);
+        return visitor(key, node2, path17);
       if (identity.isMap(node2))
-        return visitor.Map?.(key, node2, path16);
+        return visitor.Map?.(key, node2, path17);
       if (identity.isSeq(node2))
-        return visitor.Seq?.(key, node2, path16);
+        return visitor.Seq?.(key, node2, path17);
       if (identity.isPair(node2))
-        return visitor.Pair?.(key, node2, path16);
+        return visitor.Pair?.(key, node2, path17);
       if (identity.isScalar(node2))
-        return visitor.Scalar?.(key, node2, path16);
+        return visitor.Scalar?.(key, node2, path17);
       if (identity.isAlias(node2))
-        return visitor.Alias?.(key, node2, path16);
+        return visitor.Alias?.(key, node2, path17);
       return void 0;
     }
-    function replaceNode(key, path16, node2) {
-      const parent = path16[path16.length - 1];
+    function replaceNode(key, path17, node2) {
+      const parent = path17[path17.length - 1];
       if (identity.isCollection(parent)) {
         parent.items[key] = node2;
       } else if (identity.isPair(parent)) {
@@ -7702,10 +7702,10 @@ var require_Collection = __commonJS({
     var createNode = require_createNode();
     var identity = require_identity();
     var Node = require_Node();
-    function collectionFromPath(schema, path16, value) {
+    function collectionFromPath(schema, path17, value) {
       let v = value;
-      for (let i = path16.length - 1; i >= 0; --i) {
-        const k = path16[i];
+      for (let i = path17.length - 1; i >= 0; --i) {
+        const k = path17[i];
         if (typeof k === "number" && Number.isInteger(k) && k >= 0) {
           const a = [];
           a[k] = v;
@@ -7724,7 +7724,7 @@ var require_Collection = __commonJS({
         sourceObjects: /* @__PURE__ */ new Map()
       });
     }
-    var isEmptyPath = (path16) => path16 == null || typeof path16 === "object" && !!path16[Symbol.iterator]().next().done;
+    var isEmptyPath = (path17) => path17 == null || typeof path17 === "object" && !!path17[Symbol.iterator]().next().done;
     var Collection = class extends Node.NodeBase {
       constructor(type, schema) {
         super(type);
@@ -7754,11 +7754,11 @@ var require_Collection = __commonJS({
        * be a Pair instance or a `{ key, value }` object, which may not have a key
        * that already exists in the map.
        */
-      addIn(path16, value) {
-        if (isEmptyPath(path16))
+      addIn(path17, value) {
+        if (isEmptyPath(path17))
           this.add(value);
         else {
-          const [key, ...rest] = path16;
+          const [key, ...rest] = path17;
           const node2 = this.get(key, true);
           if (identity.isCollection(node2))
             node2.addIn(rest, value);
@@ -7772,8 +7772,8 @@ var require_Collection = __commonJS({
        * Removes a value from the collection.
        * @returns `true` if the item was found and removed.
        */
-      deleteIn(path16) {
-        const [key, ...rest] = path16;
+      deleteIn(path17) {
+        const [key, ...rest] = path17;
         if (rest.length === 0)
           return this.delete(key);
         const node2 = this.get(key, true);
@@ -7787,8 +7787,8 @@ var require_Collection = __commonJS({
        * scalar values from their surrounding node; to disable set `keepScalar` to
        * `true` (collections are always returned intact).
        */
-      getIn(path16, keepScalar) {
-        const [key, ...rest] = path16;
+      getIn(path17, keepScalar) {
+        const [key, ...rest] = path17;
         const node2 = this.get(key, true);
         if (rest.length === 0)
           return !keepScalar && identity.isScalar(node2) ? node2.value : node2;
@@ -7806,8 +7806,8 @@ var require_Collection = __commonJS({
       /**
        * Checks if the collection includes a value with the key `key`.
        */
-      hasIn(path16) {
-        const [key, ...rest] = path16;
+      hasIn(path17) {
+        const [key, ...rest] = path17;
         if (rest.length === 0)
           return this.has(key);
         const node2 = this.get(key, true);
@@ -7817,8 +7817,8 @@ var require_Collection = __commonJS({
        * Sets a value in this collection. For `!!set`, `value` needs to be a
        * boolean to add/remove the item from the set.
        */
-      setIn(path16, value) {
-        const [key, ...rest] = path16;
+      setIn(path17, value) {
+        const [key, ...rest] = path17;
         if (rest.length === 0) {
           this.set(key, value);
         } else {
@@ -10333,9 +10333,9 @@ var require_Document = __commonJS({
           this.contents.add(value);
       }
       /** Adds a value to the document. */
-      addIn(path16, value) {
+      addIn(path17, value) {
         if (assertCollection(this.contents))
-          this.contents.addIn(path16, value);
+          this.contents.addIn(path17, value);
       }
       /**
        * Create a new `Alias` node, ensuring that the target `node` has the required anchor.
@@ -10410,14 +10410,14 @@ var require_Document = __commonJS({
        * Removes a value from the document.
        * @returns `true` if the item was found and removed.
        */
-      deleteIn(path16) {
-        if (Collection.isEmptyPath(path16)) {
+      deleteIn(path17) {
+        if (Collection.isEmptyPath(path17)) {
           if (this.contents == null)
             return false;
           this.contents = null;
           return true;
         }
-        return assertCollection(this.contents) ? this.contents.deleteIn(path16) : false;
+        return assertCollection(this.contents) ? this.contents.deleteIn(path17) : false;
       }
       /**
        * Returns item at `key`, or `undefined` if not found. By default unwraps
@@ -10432,10 +10432,10 @@ var require_Document = __commonJS({
        * scalar values from their surrounding node; to disable set `keepScalar` to
        * `true` (collections are always returned intact).
        */
-      getIn(path16, keepScalar) {
-        if (Collection.isEmptyPath(path16))
+      getIn(path17, keepScalar) {
+        if (Collection.isEmptyPath(path17))
           return !keepScalar && identity.isScalar(this.contents) ? this.contents.value : this.contents;
-        return identity.isCollection(this.contents) ? this.contents.getIn(path16, keepScalar) : void 0;
+        return identity.isCollection(this.contents) ? this.contents.getIn(path17, keepScalar) : void 0;
       }
       /**
        * Checks if the document includes a value with the key `key`.
@@ -10446,10 +10446,10 @@ var require_Document = __commonJS({
       /**
        * Checks if the document includes a value at `path`.
        */
-      hasIn(path16) {
-        if (Collection.isEmptyPath(path16))
+      hasIn(path17) {
+        if (Collection.isEmptyPath(path17))
           return this.contents !== void 0;
-        return identity.isCollection(this.contents) ? this.contents.hasIn(path16) : false;
+        return identity.isCollection(this.contents) ? this.contents.hasIn(path17) : false;
       }
       /**
        * Sets a value in this document. For `!!set`, `value` needs to be a
@@ -10466,13 +10466,13 @@ var require_Document = __commonJS({
        * Sets a value in this document. For `!!set`, `value` needs to be a
        * boolean to add/remove the item from the set.
        */
-      setIn(path16, value) {
-        if (Collection.isEmptyPath(path16)) {
+      setIn(path17, value) {
+        if (Collection.isEmptyPath(path17)) {
           this.contents = value;
         } else if (this.contents == null) {
-          this.contents = Collection.collectionFromPath(this.schema, Array.from(path16), value);
+          this.contents = Collection.collectionFromPath(this.schema, Array.from(path17), value);
         } else if (assertCollection(this.contents)) {
-          this.contents.setIn(path16, value);
+          this.contents.setIn(path17, value);
         }
       }
       /**
@@ -12433,9 +12433,9 @@ var require_cst_visit = __commonJS({
     visit.BREAK = BREAK;
     visit.SKIP = SKIP;
     visit.REMOVE = REMOVE;
-    visit.itemAtPath = (cst, path16) => {
+    visit.itemAtPath = (cst, path17) => {
       let item = cst;
-      for (const [field, index] of path16) {
+      for (const [field, index] of path17) {
         const tok = item?.[field];
         if (tok && "items" in tok) {
           item = tok.items[index];
@@ -12444,23 +12444,23 @@ var require_cst_visit = __commonJS({
       }
       return item;
     };
-    visit.parentCollection = (cst, path16) => {
-      const parent = visit.itemAtPath(cst, path16.slice(0, -1));
-      const field = path16[path16.length - 1][0];
+    visit.parentCollection = (cst, path17) => {
+      const parent = visit.itemAtPath(cst, path17.slice(0, -1));
+      const field = path17[path17.length - 1][0];
       const coll = parent?.[field];
       if (coll && "items" in coll)
         return coll;
       throw new Error("Parent collection not found");
     };
-    function _visit(path16, item, visitor) {
-      let ctrl = visitor(item, path16);
+    function _visit(path17, item, visitor) {
+      let ctrl = visitor(item, path17);
       if (typeof ctrl === "symbol")
         return ctrl;
       for (const field of ["key", "value"]) {
         const token = item[field];
         if (token && "items" in token) {
           for (let i = 0; i < token.items.length; ++i) {
-            const ci = _visit(Object.freeze(path16.concat([[field, i]])), token.items[i], visitor);
+            const ci = _visit(Object.freeze(path17.concat([[field, i]])), token.items[i], visitor);
             if (typeof ci === "number")
               i = ci - 1;
             else if (ci === BREAK)
@@ -12471,10 +12471,10 @@ var require_cst_visit = __commonJS({
             }
           }
           if (typeof ctrl === "function" && field === "key")
-            ctrl = ctrl(item, path16);
+            ctrl = ctrl(item, path17);
         }
       }
-      return typeof ctrl === "function" ? ctrl(item, path16) : ctrl;
+      return typeof ctrl === "function" ? ctrl(item, path17) : ctrl;
     }
     exports.visit = visit;
   }
@@ -13776,14 +13776,14 @@ var require_parser = __commonJS({
             case "scalar":
             case "single-quoted-scalar":
             case "double-quoted-scalar": {
-              const fs11 = this.flowScalar(this.type);
+              const fs12 = this.flowScalar(this.type);
               if (atNextItem || it.value) {
-                map.items.push({ start, key: fs11, sep: [] });
+                map.items.push({ start, key: fs12, sep: [] });
                 this.onKeyLine = true;
               } else if (it.sep) {
-                this.stack.push(fs11);
+                this.stack.push(fs12);
               } else {
-                Object.assign(it, { key: fs11, sep: [] });
+                Object.assign(it, { key: fs12, sep: [] });
                 this.onKeyLine = true;
               }
               return;
@@ -13911,13 +13911,13 @@ var require_parser = __commonJS({
             case "scalar":
             case "single-quoted-scalar":
             case "double-quoted-scalar": {
-              const fs11 = this.flowScalar(this.type);
+              const fs12 = this.flowScalar(this.type);
               if (!it || it.value)
-                fc.items.push({ start: [], key: fs11, sep: [] });
+                fc.items.push({ start: [], key: fs12, sep: [] });
               else if (it.sep)
-                this.stack.push(fs11);
+                this.stack.push(fs12);
               else
-                Object.assign(it, { key: fs11, sep: [] });
+                Object.assign(it, { key: fs12, sep: [] });
               return;
             }
             case "flow-map-end":
@@ -14619,7 +14619,7 @@ var require_dist3 = __commonJS({
 
 // ../argent-mcp/src/mcp-server.ts
 import { appendFile, mkdir as mkdir5 } from "node:fs/promises";
-import { dirname as dirname9 } from "node:path";
+import { dirname as dirname10 } from "node:path";
 import { homedir as homedir5 } from "node:os";
 
 // ../../node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
@@ -14862,10 +14862,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path16) {
-  if (!path16)
+function getElementAtPath(obj, path17) {
+  if (!path17)
     return obj;
-  return path16.reduce((acc, key) => acc?.[key], obj);
+  return path17.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -15205,11 +15205,11 @@ function explicitlyAborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path16, issues) {
+function prefixIssues(path17, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path16);
+    iss.path.unshift(path17);
     return iss;
   });
 }
@@ -15667,16 +15667,16 @@ function flattenError(error2, mapper = (issue2) => issue2.message) {
 }
 function formatError(error2, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error3, path16 = []) => {
+  const processError = (error3, path17 = []) => {
     for (const issue2 of error3.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path16, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path17, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path16, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path17, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path16, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path17, ...issue2.path]);
       } else {
-        const fullpath = [...path16, ...issue2.path];
+        const fullpath = [...path17, ...issue2.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue2));
         } else {
@@ -17976,7 +17976,7 @@ var recursive = /* @__PURE__ */ new WeakMap();
 var NONE = 0;
 var ASSUMED = 1;
 var PROVEN = 2;
-function isRecursive(inst, stack, resolve9) {
+function isRecursive(inst, stack, resolve10) {
   const cached2 = recursive.get(inst);
   if (cached2 !== void 0)
     return cached2 ? PROVEN : NONE;
@@ -17986,7 +17986,7 @@ function isRecursive(inst, stack, resolve9) {
   let result = NONE;
   const check = (child) => {
     if (result !== PROVEN && child?._zod) {
-      const answer = isRecursive(child, stack, resolve9);
+      const answer = isRecursive(child, stack, resolve10);
       if (answer > result)
         result = answer;
     }
@@ -17997,7 +17997,7 @@ function isRecursive(inst, stack, resolve9) {
       const desc = Object.getOwnPropertyDescriptor(sh, key);
       if (spread && !desc.enumerable)
         continue;
-      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve9) : NONE;
+      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve10) : NONE;
       if (child > answer)
         answer = child;
     }
@@ -18061,7 +18061,7 @@ function isRecursive(inst, stack, resolve9) {
       break;
     // `$ZodLazy` caches its inner on the def, so a resolved edge is followed exactly
     case "lazy": {
-      const inner = def._cachedInner ?? (resolve9 ? inst._zod.innerType : void 0);
+      const inner = def._cachedInner ?? (resolve10 ? inst._zod.innerType : void 0);
       merge2(inner ? isRecursive(inner, stack, false) : ASSUMED);
       break;
     }
@@ -22639,12 +22639,12 @@ var StdioServerTransport = class {
     this.onclose?.();
   }
   send(message) {
-    return new Promise((resolve9) => {
+    return new Promise((resolve10) => {
       const json = serializeMessage(message);
       if (this._stdout.write(json)) {
-        resolve9();
+        resolve10();
       } else {
-        this._stdout.once("drain", resolve9);
+        this._stdout.once("drain", resolve10);
       }
     });
   }
@@ -23264,7 +23264,7 @@ var Protocol = class {
           return;
         }
         const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-        await new Promise((resolve9) => setTimeout(resolve9, pollInterval));
+        await new Promise((resolve10) => setTimeout(resolve10, pollInterval));
         options?.signal?.throwIfAborted();
       }
     } catch (error2) {
@@ -23281,7 +23281,7 @@ var Protocol = class {
    */
   request(request, resultSchema, options) {
     const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-    return new Promise((resolve9, reject) => {
+    return new Promise((resolve10, reject) => {
       const earlyReject = (error2) => {
         reject(error2);
       };
@@ -23359,7 +23359,7 @@ var Protocol = class {
           if (!parseResult.success) {
             reject(parseResult.error);
           } else {
-            resolve9(parseResult.data);
+            resolve10(parseResult.data);
           }
         } catch (error2) {
           reject(error2);
@@ -23621,12 +23621,12 @@ var Protocol = class {
       }
     } catch {
     }
-    return new Promise((resolve9, reject) => {
+    return new Promise((resolve10, reject) => {
       if (signal.aborted) {
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
         return;
       }
-      const timeoutId = setTimeout(resolve9, interval);
+      const timeoutId = setTimeout(resolve10, interval);
       signal.addEventListener("abort", () => {
         clearTimeout(timeoutId);
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -24442,7 +24442,7 @@ function generateToken() {
   return randomBytes(AUTH_TOKEN_BYTES).toString("hex");
 }
 function findFreePort() {
-  return new Promise((resolve9, reject) => {
+  return new Promise((resolve10, reject) => {
     const srv = net.createServer();
     srv.listen(0, "127.0.0.1", () => {
       const addr = srv.address();
@@ -24453,7 +24453,7 @@ function findFreePort() {
       const port = addr.port;
       srv.close((err) => {
         if (err) reject(err);
-        else resolve9(port);
+        else resolve10(port);
       });
     });
     srv.on("error", reject);
@@ -24551,7 +24551,7 @@ function killSpawnedChild(child, pid) {
   }
 }
 function spawnToolsServer(paths, port, options = {}) {
-  return new Promise((resolve9, reject) => {
+  return new Promise((resolve10, reject) => {
     let logFd;
     try {
       fs.mkdirSync(STATE_DIR, { recursive: true });
@@ -24597,7 +24597,7 @@ function spawnToolsServer(paths, port, options = {}) {
         rl.close();
         child.stdout?.resume();
         child.stdout?.unref?.();
-        settle2(() => resolve9({ port: actualPort, pid }));
+        settle2(() => resolve10({ port: actualPort, pid }));
       }
     });
     child.on("error", (err) => {
@@ -24892,10 +24892,11 @@ async function ensureToolsServer(paths) {
 }
 
 // ../argent-tools-client/src/tools-client.ts
-import * as path6 from "node:path";
+import * as path7 from "node:path";
 
 // ../registry/src/types.ts
 var LINKED_CALL_HEADER = "x-argent-linked";
+var E2E_DIR_CLIENT_HEADER = "x-argent-e2e-dir";
 
 // ../registry/src/artifacts.ts
 import { stat } from "node:fs/promises";
@@ -24933,19 +24934,95 @@ function toolStepFiles(specs, args) {
   }
   return files;
 }
-function isClientFileArgument({ spec, path: path16 }) {
-  return spec.kind === "file" && spec.path === `\${${spec.target}}` && path16.startsWith("/") && hasToolFileExtension(path16);
+function isClientFileArgument({ spec, path: path17 }) {
+  return spec.kind === "file" && spec.path === `\${${spec.target}}` && path17.startsWith("/") && hasToolFileExtension(path17);
 }
 
 // ../registry/src/flow-file-refs.ts
+import * as fs3 from "node:fs/promises";
+import * as path3 from "node:path";
+
+// ../registry/src/e2e-dirs.ts
 import * as fs2 from "node:fs/promises";
 import * as path2 from "node:path";
+var E2E_DIR = path2.join(".argent", "e2e");
+var LEGACY_E2E_DIRS = Object.freeze([path2.join(".argent", "flows")]);
+var E2E_DIRS = Object.freeze([E2E_DIR, ...LEGACY_E2E_DIRS]);
+function e2eDirFor(projectRoot) {
+  return path2.join(projectRoot, E2E_DIR);
+}
+function e2eDirsFor(projectRoot) {
+  return E2E_DIRS.map((dir) => path2.join(projectRoot, dir));
+}
+function e2eFileCandidates(projectRoot, name) {
+  return e2eDirsFor(projectRoot).map((dir) => path2.join(dir, `${name}.yaml`));
+}
+async function exists(file) {
+  return fs2.stat(file).then(
+    () => true,
+    () => false
+  );
+}
+async function pickE2eFile(candidates) {
+  for (let i = 0; i < candidates.length; i++) {
+    if (!await exists(candidates[i])) continue;
+    let shadowed;
+    for (const later of candidates.slice(i + 1)) {
+      if (await exists(later)) {
+        shadowed = later;
+        break;
+      }
+    }
+    return {
+      path: candidates[i],
+      exists: true,
+      legacy: i > 0,
+      ...shadowed === void 0 ? {} : { shadowed }
+    };
+  }
+  return { path: candidates[0], exists: false, legacy: false };
+}
+function e2eShadowWarning(used, shadowed) {
+  return `${shadowed} is not used: ${used} has the same name and is read first.`;
+}
+var E2E_DIR_NAMES = E2E_DIRS.map((dir) => path2.basename(dir));
+function e2eDirProject(dir) {
+  const trimmed = dir.length > 1 ? dir.replace(/[\\/]+$/, "") : dir;
+  const argent = path2.dirname(trimmed);
+  if (!E2E_DIR_NAMES.includes(path2.basename(trimmed)) || path2.basename(argent) !== ".argent") {
+    return null;
+  }
+  return path2.dirname(argent);
+}
+function e2eRunFallbackDirs(anchorDir, target) {
+  if (target.includes("/") || target.includes("\\")) return [];
+  const project = e2eDirProject(anchorDir);
+  if (project === null) return [];
+  const anchor2 = path2.resolve(anchorDir);
+  return e2eDirsFor(project).filter((dir) => path2.resolve(dir) !== anchor2);
+}
+
+// ../registry/src/tool-ids.ts
+var TOOL_ID_ALIASES = Object.freeze({
+  "flow-start-recording": "e2e-start-recording",
+  "flow-add-step": "e2e-add-step",
+  "flow-add-echo": "e2e-add-echo",
+  "flow-add-script": "e2e-add-script",
+  "flow-finish-recording": "e2e-finish-recording",
+  "flow-read-prerequisite": "e2e-read-prerequisite",
+  "flow-execute": "e2e-execute"
+});
+function canonicalToolId(id) {
+  return Object.hasOwn(TOOL_ID_ALIASES, id) ? TOOL_ID_ALIASES[id] : id;
+}
+
+// ../registry/src/flow-file-refs.ts
 async function canonicalFlowPath(p) {
   try {
-    return await fs2.realpath(p);
+    return await fs3.realpath(p);
   } catch {
     try {
-      return path2.join(await fs2.realpath(path2.dirname(p)), path2.basename(p));
+      return path3.join(await fs3.realpath(path3.dirname(p)), path3.basename(p));
     } catch {
       return p;
     }
@@ -24954,7 +25031,7 @@ async function canonicalFlowPath(p) {
 function completeRunExtension(value) {
   if (value.endsWith(".yaml")) return value;
   const candidate = `${value}.yaml`;
-  return FLOW_FILE_NAME_PATTERN.test(path2.posix.basename(candidate)) ? candidate : value;
+  return FLOW_FILE_NAME_PATTERN.test(path3.posix.basename(candidate)) ? candidate : value;
 }
 var MAX_RUN_DEPTH = 20;
 var MAX_BLOCK_NESTING = 64;
@@ -24973,16 +25050,16 @@ function collectFlowRequests(doc) {
     for (const step of steps) {
       if (!isRecord(step)) continue;
       const run = step.run;
-      if (typeof run === "string" && !run.includes("\\") && !path2.posix.isAbsolute(run) && !/^[A-Za-z]:/.test(run)) {
+      if (typeof run === "string" && !run.includes("\\") && !path3.posix.isAbsolute(run) && !/^[A-Za-z]:/.test(run)) {
         const target = completeRunExtension(run);
-        if (FLOW_FILE_NAME_PATTERN.test(path2.posix.basename(target))) runTargets.add(target);
+        if (FLOW_FILE_NAME_PATTERN.test(path3.posix.basename(target))) runTargets.add(target);
       }
       const snapshot = isRecord(step.snapshot) ? step.snapshot.name : step.snapshot;
       if (typeof snapshot === "string" && FLOW_NAME_PATTERN.test(snapshot)) snapshots.add(snapshot);
       if (typeof step.tool === "string") {
         const args = isRecord(step.args) ? step.args : {};
         toolSteps.push({ tool: step.tool, args });
-        const target = step.tool === "flow-execute" ? nestedFlowTarget(args) : void 0;
+        const target = canonicalToolId(step.tool) === "e2e-execute" ? nestedFlowTarget(args) : void 0;
         if (target !== void 0) nested.push({ target, args });
       }
       visit(step.steps, depth + 1);
@@ -24992,14 +25069,14 @@ function collectFlowRequests(doc) {
   return { runTargets: [...runTargets], snapshots: [...snapshots], toolSteps, nested };
 }
 function baselineKeyFor(canonicalPath, flowName) {
-  const stem = path2.basename(canonicalPath, ".yaml");
+  const stem = path3.basename(canonicalPath, ".yaml");
   return FLOW_NAME_PATTERN.test(stem) ? stem : flowName;
 }
 function flowMemberKey(anchorDir, target) {
   return `${anchorDir}\0${target}`;
 }
 async function classifyOnDiskSpelling(dir, base, addressable = FLOW_FILE_NAME_PATTERN) {
-  const entries = await fs2.readdir(dir).catch(() => null);
+  const entries = await fs3.readdir(dir).catch(() => null);
   if (entries === null || entries.includes(base)) return { state: "listed" };
   const actual = entries.find((entry) => entry.toLowerCase() === base.toLowerCase());
   if (actual === void 0) return { state: "absent" };
@@ -25011,19 +25088,15 @@ function nestedFlowTarget(args) {
   if (flowPath === void 0) {
     if (typeof name !== "string" || !FLOW_NAME_PATTERN.test(name)) return void 0;
     if (!isResolvedAbsolute(projectRoot)) return void 0;
-    return {
-      kind: "name",
-      projectRoot,
-      name,
-      path: path2.join(projectRoot, ".argent", "flows", `${name}.yaml`)
-    };
+    const paths = e2eFileCandidates(projectRoot, name);
+    return { kind: "name", projectRoot, name, path: paths[0], paths };
   }
   if (name !== void 0 || !isResolvedAbsolute(flowPath)) return void 0;
-  if (!FLOW_FILE_NAME_PATTERN.test(path2.basename(flowPath))) return void 0;
+  if (!FLOW_FILE_NAME_PATTERN.test(path3.basename(flowPath))) return void 0;
   return { kind: "flow_path", path: flowPath };
 }
 function isResolvedAbsolute(value) {
-  return typeof value === "string" && path2.isAbsolute(value) && !value.split(/[\\/]+/).includes("..");
+  return typeof value === "string" && path3.isAbsolute(value) && !value.split(/[\\/]+/).includes("..");
 }
 
 // ../registry/src/failure-codes.ts
@@ -25392,9 +25465,9 @@ var FAILURE_SPAWN_CODE_SET = new Set(FAILURE_SPAWN_CODES);
 import { randomUUID as randomUUID2 } from "node:crypto";
 import { AsyncLocalStorage } from "node:async_hooks";
 var resolvedDuringInvocation = new AsyncLocalStorage();
-function valueAtPath(root, path16) {
+function valueAtPath(root, path17) {
   let current = root;
-  for (const key of path16) {
+  for (const key of path17) {
     if (current === null || typeof current !== "object") return void 0;
     if (!Object.hasOwn(current, key)) return void 0;
     current = current[key];
@@ -25452,11 +25525,11 @@ function describeParamIssues(error2, params) {
 }
 
 // ../argent-tools-client/src/link-config.ts
-import * as path3 from "node:path";
+import * as path4 from "node:path";
 import { homedir as homedir2 } from "node:os";
 import { mkdir as mkdir2, writeFile as writeFile2, readFile as readFile2, unlink as unlink2, chmod as chmod2 } from "node:fs/promises";
-var LINK_DIR = path3.join(homedir2(), ".argent");
-var LINK_FILE = path3.join(LINK_DIR, "link.json");
+var LINK_DIR = path4.join(homedir2(), ".argent");
+var LINK_FILE = path4.join(LINK_DIR, "link.json");
 async function readLinkConfig() {
   try {
     const raw = await readFile2(LINK_FILE, "utf8");
@@ -25505,22 +25578,22 @@ import {
   realpath as realpath2,
   rename as rename2,
   rm as rm2,
-  stat as stat2,
+  stat as stat3,
   writeFile as writeFile3
 } from "node:fs/promises";
 import { constants, tmpdir } from "node:os";
-import * as path4 from "node:path";
+import * as path5 from "node:path";
 
 // ../archive/src/index.ts
 import { execFile } from "node:child_process";
 import { rm, readdir as readdir3 } from "node:fs/promises";
-import { basename as basename3, dirname as dirname3, join as join4, posix as posix2, resolve as resolve2, sep as sep2 } from "node:path";
+import { basename as basename4, dirname as dirname4, join as join5, posix as posix2, resolve as resolve3, sep as sep2 } from "node:path";
 import { promisify } from "node:util";
 var execFileAsync = promisify(execFile);
 var ArchiveError = class extends Error {
 };
 function createTarGzArgs(sourcePath, target) {
-  return ["-czf", target, "-C", dirname3(sourcePath), basename3(sourcePath)];
+  return ["-czf", target, "-C", dirname4(sourcePath), basename4(sourcePath)];
 }
 async function createTarGzFile(sourcePath, tarPath) {
   try {
@@ -25542,8 +25615,8 @@ function isSafeTarMember(memberPath, destDir) {
   if (relative2 === ".." || relative2.startsWith("../") || relative2.split("/").includes("..")) {
     return false;
   }
-  const root = resolve2(destDir);
-  const resolved = resolve2(destDir, relative2);
+  const root = resolve3(destDir);
+  const resolved = resolve3(destDir, relative2);
   return resolved === root || resolved.startsWith(root + sep2);
 }
 async function listTarMembers(tarPath) {
@@ -25597,7 +25670,7 @@ async function assertSafeArchive(tarPath, destDir) {
 async function resolveMember(destDir, expectedName) {
   const entries = await readdir3(destDir);
   if (entries.includes(expectedName)) {
-    return join4(destDir, expectedName);
+    return join5(destDir, expectedName);
   }
   const real = entries.filter((e) => !e.startsWith("._"));
   if (real.length !== 1) {
@@ -25605,7 +25678,7 @@ async function resolveMember(destDir, expectedName) {
       `Could not identify the extracted member (expected "${expectedName}", found ${real.length} entries).`
     );
   }
-  return join4(destDir, real[0]);
+  return join5(destDir, real[0]);
 }
 async function safeExtractTarGz(tarPath, destDir, expectedName) {
   await assertSafeArchive(tarPath, destDir);
@@ -25643,6 +25716,16 @@ function interpolatePath(template, args) {
   });
   return missing ? null : out;
 }
+async function specPath(spec, args) {
+  if (spec.kind !== "file" || !spec.paths?.length) return interpolatePath(spec.path, args);
+  const candidates = [];
+  for (const template of spec.paths) {
+    const filled = interpolatePath(template, args);
+    if (filled === null) return null;
+    candidates.push(filled);
+  }
+  return (await pickE2eFile(candidates)).path;
+}
 var pendingArchives = /* @__PURE__ */ new Set();
 var ARCHIVE_SIGNALS = ["SIGINT", "SIGTERM", "SIGHUP"];
 function removePendingArchives() {
@@ -25678,9 +25761,9 @@ function untrackArchive(archive) {
   process.removeListener("exit", removePendingArchives);
 }
 function sha256File(filePath) {
-  return new Promise((resolve9, reject) => {
+  return new Promise((resolve10, reject) => {
     const hash = createHash2("sha256");
-    createReadStream(filePath).on("data", (chunk) => hash.update(chunk)).on("end", () => resolve9(hash.digest("hex"))).on("error", reject);
+    createReadStream(filePath).on("data", (chunk) => hash.update(chunk)).on("end", () => resolve10(hash.digest("hex"))).on("error", reject);
   });
 }
 function toolServerError(text) {
@@ -25707,7 +25790,7 @@ function uploadFailure(url, res, text, bytes) {
   });
 }
 async function uploadTar(tarPath, endpoint, signal) {
-  const { size } = await stat2(tarPath);
+  const { size } = await stat3(tarPath);
   const init = {
     method: "POST",
     headers: {
@@ -25731,7 +25814,7 @@ async function uploadTar(tarPath, endpoint, signal) {
   return json.uploadId;
 }
 async function uploadFile(sourcePath, endpoint, signal) {
-  const tarPath = path4.join(tmpdir(), `argent-upload-${randomUUID3()}.tar.gz`);
+  const tarPath = path5.join(tmpdir(), `argent-upload-${randomUUID3()}.tar.gz`);
   trackArchive(tarPath);
   try {
     await createTarGzFile(await realpath2(sourcePath), tarPath);
@@ -25746,7 +25829,7 @@ async function uploadFile(sourcePath, endpoint, signal) {
 async function readFileInputWire(filePath, opts) {
   let st;
   try {
-    st = await stat2(filePath);
+    st = await stat3(filePath);
   } catch {
     return null;
   }
@@ -25774,7 +25857,7 @@ async function prepareFileInputs(specs, args, opts) {
   for (const spec of specs) {
     if (spec.skipWhenSet && record2[spec.skipWhenSet] !== void 0) continue;
     if (spec.target in record2 && typeof record2[spec.target] !== "string") continue;
-    const filePath = interpolatePath(spec.path, record2);
+    const filePath = await specPath(spec, record2);
     if (filePath === null) continue;
     if (spec.target in record2 && record2[spec.target] !== filePath) continue;
     const wire = { [FILE_INPUT_MARKER2]: true, path: filePath };
@@ -25792,13 +25875,13 @@ async function prepareFileInputs(specs, args, opts) {
       wire.members = await opts.collectStepMembers(record2, opts);
     }
     if (spec.kind === "tar-upload") {
-      const st = await stat2(filePath).catch(() => null);
+      const st = await stat3(filePath).catch(() => null);
       if (st) {
         wire.size = st.size;
         wire.mtimeMs = st.mtimeMs;
       }
       if (opts.uploadEndpoint && st) {
-        process.stderr.write(`Uploading ${path4.basename(filePath)} to the remote tool-server...
+        process.stderr.write(`Uploading ${path5.basename(filePath)} to the remote tool-server...
 `);
         Object.assign(wire, await uploadFile(filePath, opts.uploadEndpoint, opts.signal));
       }
@@ -25809,18 +25892,18 @@ async function prepareFileInputs(specs, args, opts) {
   return out ?? args;
 }
 function isAllowedClientFilePath(p) {
-  if (!path4.isAbsolute(p)) return false;
+  if (!path5.isAbsolute(p)) return false;
   const segments = p.split(/[\\/]+/);
   if (segments.includes("..")) return false;
   const file = segments[segments.length - 1] ?? "";
   if (!FLOW_FILE_NAME_PATTERN.test(file)) return false;
-  return segments[segments.length - 3] === ".argent" && segments[segments.length - 2] === "flows";
+  return e2eDirProject(segments.slice(0, -1).join("/")) !== null;
 }
 function isClientFileDirective2(value) {
   return !!value && typeof value === "object" && value[CLIENT_FILE_MARKER2] === true && typeof value.path === "string" && typeof value.content === "string";
 }
 async function replaceFile(target, bytes, mode) {
-  const temp = path4.join(path4.dirname(target), `.baseline-${randomUUID3()}.tmp`);
+  const temp = path5.join(path5.dirname(target), `.baseline-${randomUUID3()}.tmp`);
   try {
     await writeFile3(temp, bytes, { flag: "wx" });
     if (mode !== void 0) await chmod3(temp, mode & 511);
@@ -25831,27 +25914,27 @@ async function replaceFile(target, bytes, mode) {
   }
 }
 async function writeBaselineFile(file, bytes, allowedDirs) {
-  if (!path4.isAbsolute(file) || path4.normalize(file) !== file || file.split(/[\\/]/).includes("..") || !file.endsWith(".png") || !allowedDirs.includes(path4.dirname(file))) {
+  if (!path5.isAbsolute(file) || path5.normalize(file) !== file || file.split(/[\\/]/).includes("..") || !file.endsWith(".png") || !allowedDirs.includes(path5.dirname(file))) {
     return allowedDirs.length === 0 ? "this call writes no baselines" : `${file} is not a baseline of this call (${allowedDirs.map((d) => `${d}/<name>.png`).join(", ")})`;
   }
   if (bytes.length > MAX_CONTENT_BYTES) {
     return `${file}: the baseline is larger than the 32 MiB cap on a file this client writes`;
   }
-  const dir = path4.dirname(file);
+  const dir = path5.dirname(file);
   await mkdir3(dir, { recursive: true });
   const link = await lstat(file).catch(() => null);
   const real = link === null ? null : await realpath2(file).catch(() => null);
   if (link !== null && real === null) return `${file} is a symbolic link to a missing file`;
   if (real !== null) {
     if (!real.endsWith(".png")) return `${file} links to a file that is not a PNG file`;
-    if (path4.dirname(real) !== await realpath2(dir)) {
+    if (path5.dirname(real) !== await realpath2(dir)) {
       return `${file} links outside its baseline directory`;
     }
   }
-  const existing = real === null ? null : await stat2(real);
+  const existing = real === null ? null : await stat3(real);
   if (existing !== null && !existing.isFile()) return `${file} is not a regular file`;
   await replaceFile(
-    real ?? path4.join(await realpath2(dir), path4.basename(file)),
+    real ?? path5.join(await realpath2(dir), path5.basename(file)),
     bytes,
     existing?.mode
   );
@@ -25877,7 +25960,7 @@ async function applyClientFileDirectives(result, opts = {}) {
     if (isClientFileDirective2(value)) {
       if (!isAllowedClientFilePath(value.path)) return null;
       try {
-        await mkdir3(path4.dirname(value.path), { recursive: true });
+        await mkdir3(path5.dirname(value.path), { recursive: true });
         await writeFile3(value.path, value.content, "utf8");
         written.push(value.path);
         return value.path;
@@ -25905,12 +25988,14 @@ async function applyClientFileDirectives(result, opts = {}) {
 
 // ../argent-tools-client/src/flow-files.ts
 var import_yaml = __toESM(require_dist2(), 1);
-import { readdir as readdir4, readFile as readFile4, realpath as realpath3, stat as stat3 } from "node:fs/promises";
-import * as path5 from "node:path";
+import { readdir as readdir4, readFile as readFile4, realpath as realpath3, stat as stat4 } from "node:fs/promises";
+import * as path6 from "node:path";
 var INLINE_MEMBERS_BYTES = 256 * 1024;
-var FLOW_FILES_LOG_ENV = "ARGENT_FLOW_FILES_LOG";
+function filesLogEnabled() {
+  return (process.env.ARGENT_E2E_FILES_LOG ?? process.env.ARGENT_FLOW_FILES_LOG) === "1";
+}
 function isWithin(inner, outer) {
-  return inner === outer || inner.startsWith(outer.endsWith(path5.sep) ? outer : outer + path5.sep);
+  return inner === outer || inner.startsWith(outer.endsWith(path6.sep) ? outer : outer + path6.sep);
 }
 function printable(text) {
   return [...text].map(
@@ -25918,23 +26003,21 @@ function printable(text) {
   ).join("");
 }
 function isResolvedAbsolute2(value) {
-  return typeof value === "string" && path5.isAbsolute(value) && !value.split(/[\\/]+/).includes("..");
+  return typeof value === "string" && path6.isAbsolute(value) && !value.split(/[\\/]+/).includes("..");
 }
 function namesValidFlow(args) {
   const { project_root, flow_path, name } = args;
   if (!isResolvedAbsolute2(project_root)) return false;
   if (name === void 0) {
-    return isResolvedAbsolute2(flow_path) && FLOW_FILE_NAME_PATTERN.test(path5.basename(flow_path));
+    return isResolvedAbsolute2(flow_path) && FLOW_FILE_NAME_PATTERN.test(path6.basename(flow_path));
   }
   return flow_path === void 0 && typeof name === "string" && FLOW_NAME_PATTERN.test(name);
 }
 function savedFlowProject(file) {
-  if (!path5.isAbsolute(file)) return null;
-  const parts = file.split(path5.sep);
-  for (let i = parts.length - 3; i >= 0; i--) {
-    if (parts[i] === ".argent" && parts[i + 1] === "flows") {
-      return parts.slice(0, i).join(path5.sep) || path5.sep;
-    }
+  if (!path6.isAbsolute(file)) return null;
+  for (let dir = path6.dirname(file); dir !== path6.dirname(dir); dir = path6.dirname(dir)) {
+    const project = e2eDirProject(dir);
+    if (project !== null) return project;
   }
   return null;
 }
@@ -25947,11 +26030,11 @@ async function landing(spelled) {
     const canonical = await canonicalFlowPath(spelled);
     let at = spelled;
     for (; ; ) {
-      const parent = path5.dirname(at);
+      const parent = path6.dirname(at);
       if (parent === at) return { canonical, fence: spelled, ...failure2 };
       const real = await realpath3(parent).catch(() => null);
       if (real !== null) {
-        return { canonical, fence: path5.join(real, path5.basename(at)), ...failure2 };
+        return { canonical, fence: path6.join(real, path6.basename(at)), ...failure2 };
       }
       at = parent;
     }
@@ -25959,10 +26042,10 @@ async function landing(spelled) {
 }
 async function closureRoots(rootPath, rootCanonical, projectRoot) {
   const candidates = [];
-  if (typeof projectRoot === "string" && path5.isAbsolute(projectRoot)) {
-    candidates.push(projectRoot, path5.join(projectRoot, ".argent", "flows"));
+  if (typeof projectRoot === "string" && path6.isAbsolute(projectRoot)) {
+    candidates.push(projectRoot, ...e2eDirsFor(projectRoot));
   }
-  candidates.push(path5.dirname(rootPath), path5.dirname(rootCanonical));
+  candidates.push(path6.dirname(rootPath), path6.dirname(rootCanonical));
   for (const file of [rootPath, rootCanonical]) {
     const project = savedFlowProject(file);
     if (project !== null) candidates.push(project);
@@ -25975,11 +26058,11 @@ async function closureRoots(rootPath, rootCanonical, projectRoot) {
   return real.filter((root) => !real.some((other) => other !== root && isWithin(root, other)));
 }
 async function readFlowMember(anchorDir, target, roots, budget, opts) {
-  const spelled = anchorDir + path5.sep + target;
+  const spelled = anchorDir + path6.sep + target;
   const { canonical, fence, missing, error: error2 } = await landing(spelled);
   const spelling = await classifyOnDiskSpelling(
-    path5.dirname(spelled),
-    path5.posix.basename(target),
+    path6.dirname(spelled),
+    path6.posix.basename(target),
     FLOW_FILE_NAME_PATTERN
   );
   const member = {
@@ -25998,13 +26081,13 @@ async function readFlowMember(anchorDir, target, roots, budget, opts) {
   }
   if (error2 !== void 0) return refuse(error2);
   if (missing) return { member: { ...member, state: "missing" }, sent: "missing" };
-  const st = await stat3(canonical).catch((err) => err);
+  const st = await stat4(canonical).catch((err) => err);
   if (st instanceof Error) {
     if (st.code !== "ENOENT") return refuse(st.message);
     return { member: { ...member, state: "missing" }, sent: "missing" };
   }
   if (st.isDirectory()) return refuse("EISDIR: illegal operation on a directory, read");
-  if (!/\.ya?ml$/i.test(path5.basename(canonical))) {
+  if (!/\.ya?ml$/i.test(path6.basename(canonical))) {
     return refuse(`${target} links to a file that is not a YAML file`);
   }
   const sent = await sendBytes(member, canonical, budget, opts);
@@ -26023,7 +26106,7 @@ async function readToolMember(file, roots, budget, opts) {
   if (!hasToolFileExtension(canonical)) {
     return refuse(`${file} links to a file that is not one of ${TOOL_FILE_EXTENSIONS.join(", ")}`);
   }
-  const st = await stat3(canonical).catch((err) => err);
+  const st = await stat4(canonical).catch((err) => err);
   if (st instanceof Error) {
     if (st.code === "ENOENT" || st.code === "ENOTDIR") {
       return { member: { ...member, state: "missing" }, sent: "missing" };
@@ -26047,7 +26130,7 @@ async function baselineEntry(file, roots, forWrite) {
     };
   }
   if (error2 !== void 0) return { state: "refused", error: error2 };
-  const st = await stat3(canonical).catch((err) => err);
+  const st = await stat4(canonical).catch((err) => err);
   if (st instanceof Error) {
     if (st.code !== "ENOENT") return { state: "refused", error: st.message };
     return forWrite ? { state: "refused", error: `${file} is a symbolic link to a missing file` } : { state: "missing" };
@@ -26097,7 +26180,7 @@ function memberCollector(roots, opts) {
   const runs = /* @__PURE__ */ new Set();
   const baselineDirs = /* @__PURE__ */ new Map();
   const budget = { inline: 0 };
-  const logging = process.env[FLOW_FILES_LOG_ENV] === "1";
+  const logging = filesLogEnabled();
   const log = opts.log ?? ((line) => void process.stderr.write(`${line}
 `));
   const emit = (member, sent) => {
@@ -26105,18 +26188,19 @@ function memberCollector(roots, opts) {
     const subject = member.role === "flow" ? member.canonical : member.key;
     if (logging) log(printable(`[flow-files] ${member.role} ${subject}: ${sent}`));
   };
-  async function flow(anchorDir, target) {
+  async function flow(anchorDir, target, onlyPresent) {
     const key = flowMemberKey(anchorDir, target);
     const known = flows.get(key);
-    if (known !== void 0) return known;
+    if (known !== void 0) return onlyPresent && known.text === void 0 ? void 0 : known;
     const { member, text, sent } = await readFlowMember(anchorDir, target, roots, budget, opts);
+    if (onlyPresent && text === void 0) return void 0;
     const entry = { member, ...text === void 0 ? {} : { text } };
     flows.set(key, entry);
     emit(member, sent);
     return entry;
   }
   async function toolFiles(step) {
-    if (step.tool === "flow-execute") return;
+    if (canonicalToolId(step.tool) === "e2e-execute") return;
     for (const file of toolStepFiles(opts.toolFileInputs?.(step.tool), step.args)) {
       const { unwrapWhenSet } = file.spec;
       if (unwrapWhenSet !== void 0 && step.args[unwrapWhenSet] !== void 0) continue;
@@ -26126,11 +26210,31 @@ function memberCollector(roots, opts) {
       emit(read.member, read.sent);
     }
   }
+  async function savedTest(target) {
+    for (const candidate of target.paths) {
+      const found = await flow(path6.dirname(candidate), path6.basename(candidate), true);
+      if (found !== void 0) return found;
+    }
+    let first;
+    for (const candidate of target.paths) {
+      first ??= await flow(path6.dirname(candidate), path6.basename(candidate));
+    }
+    return first;
+  }
   async function nestedRun(target, hop, updates, platform) {
-    const { member, text } = await flow(path5.dirname(target.path), `${target.name}.yaml`);
+    const { member, text } = await savedTest(target);
     if (text === void 0 || hop >= MAX_RUN_DEPTH) return void 0;
     return { canonical: member.canonical, text, flowName: target.name, hop, updates, platform };
   }
+  async function runTarget(anchorDir, target) {
+    const found = await flow(anchorDir, target);
+    if (found.member.spelling?.state !== "absent") return found;
+    for (const dir of e2eRunFallbackDirs(anchorDir, target)) {
+      const other = await flow(dir, target, true);
+      if (other !== void 0) return other;
+    }
+    return found;
+  }
   async function walk(start) {
     const queue = [...start];
     for (let run = queue.shift(); run !== void 0; run = queue.shift()) {
@@ -26150,12 +26254,12 @@ function memberCollector(roots, opts) {
         const requests = collectFlowRequests(doc);
         for (const name of requests.snapshots) snapshots.add(name);
         for (const step of requests.toolSteps) await toolFiles(step);
-        const anchorDir = path5.dirname(file.canonical);
+        const anchorDir = path6.dirname(file.canonical);
         for (const target of requests.runTargets) {
           const key = flowMemberKey(anchorDir, target);
           if (visited.has(key)) continue;
           visited.add(key);
-          const { member, text } = await flow(anchorDir, target);
+          const { member, text } = await runTarget(anchorDir, target);
           if (text !== void 0 && file.hop + 1 < MAX_RUN_DEPTH) {
             files.push({ canonical: member.canonical, text, hop: file.hop + 1 });
           }
@@ -26172,8 +26276,8 @@ function memberCollector(roots, opts) {
         }
       }
       if (snapshots.size === 0) continue;
-      const dir = path5.join(
-        path5.dirname(run.canonical),
+      const dir = path6.join(
+        path6.dirname(run.canonical),
         "__baselines__",
         baselineKeyFor(run.canonical, run.flowName)
       );
@@ -26197,7 +26301,7 @@ function memberCollector(roots, opts) {
         if (!name.endsWith(".png")) continue;
         const compared = [...prefixes].some((prefix) => name.startsWith(prefix));
         if (!updates && !compared) continue;
-        const file = path5.join(dir, name);
+        const file = path6.join(dir, name);
         if (tools.has(file)) continue;
         const member = { role: "baseline", key: file, path: file };
         const entry = await baselineEntry(file, roots, updates && !compared);
@@ -26220,8 +26324,8 @@ async function collectFlowMembers(rootPath, rootBytes, args, opts) {
   if (!namesValidFlow(args)) return {};
   const canonical = await canonicalFlowPath(rootPath);
   const spelling = await classifyOnDiskSpelling(
-    path5.dirname(rootPath),
-    path5.basename(rootPath),
+    path6.dirname(rootPath),
+    path6.basename(rootPath),
     FLOW_FILE_NAME_PATTERN
   );
   const collector = memberCollector(
@@ -26232,7 +26336,7 @@ async function collectFlowMembers(rootPath, rootBytes, args, opts) {
     {
       canonical,
       text: rootBytes.toString("utf8"),
-      flowName: path5.basename(rootPath, ".yaml"),
+      flowName: path6.basename(rootPath, ".yaml"),
       hop: 0,
       updates: args.updateBaselines === true,
       platform: callPlatform(args)
@@ -26255,33 +26359,37 @@ function recordedStep(args) {
   if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return void 0;
   return { tool: command, args: parsed };
 }
-async function collectStepMembers(args, opts) {
+async function collectStepMembers(args, opts, recordingDirFor = e2eDirFor) {
   const { name, project_root: projectRoot } = args;
   const step = recordedStep(args);
-  if (typeof name !== "string" || !FLOW_NAME_PATTERN.test(name) || typeof projectRoot !== "string" || !path5.isAbsolute(projectRoot) || step === void 0) {
+  if (typeof name !== "string" || !FLOW_NAME_PATTERN.test(name) || typeof projectRoot !== "string" || !path6.isAbsolute(projectRoot) || step === void 0) {
     return [];
   }
-  const recording = path5.join(projectRoot, ".argent", "flows", `${name}.yaml`);
+  const recording = path6.join(recordingDirFor(projectRoot), `${name}.yaml`);
   const collector = memberCollector(
     await closureRoots(recording, (await landing(recording)).canonical, projectRoot),
     opts
   );
   await collector.toolFiles(step);
-  if (step.tool === "flow-execute") {
-    const self = await collector.flow(path5.dirname(recording), path5.basename(recording));
+  if (canonicalToolId(step.tool) === "e2e-execute") {
+    const self = await collector.flow(path6.dirname(recording), path6.basename(recording));
     let runArgs = step.args;
     const named = nestedFlowTarget(runArgs);
     if (named?.kind === "flow_path") {
-      const stem = path5.basename(named.path, ".yaml");
-      if (path5.resolve(path5.dirname(named.path)) === path5.resolve(path5.dirname(recording))) {
-        await collector.flow(path5.dirname(recording), path5.basename(named.path));
+      const stem = path6.basename(named.path, ".yaml");
+      const base = path6.basename(named.path);
+      const dir = path6.resolve(path6.dirname(named.path));
+      const recordingDir = path6.dirname(recording);
+      const dirs = [recordingDir, ...e2eRunFallbackDirs(recordingDir, base)];
+      if (dirs.some((d) => path6.resolve(d) === dir)) {
+        await collector.flow(path6.dirname(named.path), base);
         runArgs = { ...runArgs, name: stem };
         delete runArgs.flow_path;
       }
     }
     const target = nestedFlowTarget(runArgs);
     if (target?.kind === "name") {
-      await collector.flow(path5.dirname(self.member.canonical), `${target.name}.yaml`);
+      await collector.flow(path6.dirname(self.member.canonical), `${target.name}.yaml`);
       const run = await collector.nestedRun(
         target,
         0,
@@ -26294,6 +26402,43 @@ async function collectStepMembers(args, opts) {
   await collector.sendBaselines();
   return collector.members;
 }
+async function nameToE2ePathForOlderServer(tool, fileInputs, args) {
+  const id = canonicalToolId(tool);
+  if (id !== "e2e-execute" && id !== "e2e-read-prerequisite") return args;
+  const spec = fileInputs?.find((s) => s.target === "flow_file");
+  if (spec === void 0 || spec.kind !== "file" || spec.paths?.length) return args;
+  const target = nestedFlowTarget(args);
+  if (target?.kind !== "name") return args;
+  const picked = await pickE2eFile(target.paths);
+  if (!picked.exists || picked.legacy) return args;
+  const { name: _name, ...rest } = args;
+  return { ...rest, flow_path: picked.path };
+}
+async function stepForOlderServer(args, listedId) {
+  if (typeof args !== "object" || args === null || Array.isArray(args)) return args;
+  const record2 = args;
+  if (typeof record2.command !== "string") return args;
+  const command = listedId(record2.command) ?? record2.command;
+  const step = recordedStep({ ...record2, command });
+  const target = step && canonicalToolId(step.tool) === "e2e-execute" && nestedFlowTarget(step.args);
+  if (target && target.kind === "name") {
+    const picked = await pickE2eFile(target.paths);
+    if (picked.exists && !picked.legacy) {
+      throw new Error(
+        `Cannot record a nested ${record2.command} of "${target.name}": the tool-server runs an older argent that records and runs nested e2e tests only from .argent/flows/, and "${target.name}" is ${picked.path}. Upgrade the tool-server to record it, or run it with e2e-execute outside the recording.`
+      );
+    }
+  }
+  return command === record2.command ? args : { ...record2, command };
+}
+async function e2eShadowWarningFor(tool, args) {
+  const id = canonicalToolId(tool);
+  if (id !== "e2e-execute" && id !== "e2e-read-prerequisite") return void 0;
+  const target = nestedFlowTarget(args);
+  if (target?.kind !== "name") return void 0;
+  const picked = await pickE2eFile(target.paths);
+  return picked.shadowed === void 0 ? void 0 : e2eShadowWarning(picked.path, picked.shadowed);
+}
 
 // ../argent-tools-client/src/tools-client.ts
 function authHeaders2(token) {
@@ -26371,6 +26516,10 @@ function errorBodyMessage(body) {
   if (Array.isArray(body.issues) && typeof body.message === "string") return body.message;
   return body.error ?? body.message;
 }
+function findTool(tools, name) {
+  const id = canonicalToolId(name);
+  return tools.find((t) => t.name === name) ?? tools.find((t) => canonicalToolId(t.name) === id) ?? null;
+}
 function assertRequiredPresent(meta2, args) {
   const record2 = typeof args === "object" && args !== null ? args : {};
   const schema = meta2.inputSchema;
@@ -26446,26 +26595,33 @@ function createToolsClient(options = {}) {
     return json.tools;
   }
   async function fetchTool(name, opts) {
-    const tools = await fetchTools(opts);
-    return tools.find((t) => t.name === name) ?? null;
+    return findTool(await fetchTools(opts), name);
   }
   async function callTool(name, args, opts) {
     opts?.signal?.throwIfAborted();
     const { url, token, remote } = await route();
     let finalArgs = args;
     const tools = await fetchTools({ signal: opts?.signal });
-    const meta2 = tools.find((t) => t.name === name) ?? null;
+    const meta2 = findTool(tools, name);
+    const olderServer = meta2 !== null && !tools.some((t) => t.name === canonicalToolId(meta2.name));
+    if (meta2) {
+      finalArgs = await nameToE2ePathForOlderServer(meta2.name, meta2.fileInputs, args);
+    }
+    if (olderServer && canonicalToolId(meta2.name) === "e2e-add-step") {
+      finalArgs = await stepForOlderServer(finalArgs, (tool) => findTool(tools, tool)?.name);
+    }
+    const shadowWarning = await e2eShadowWarningFor(name, args);
     const baselineDirs = [];
     if (meta2?.fileInputs?.length) {
-      if (remote) assertRequiredPresent(meta2, args);
-      finalArgs = await prepareFileInputs(meta2.fileInputs, args ?? {}, {
+      if (remote) assertRequiredPresent(meta2, finalArgs);
+      finalArgs = await prepareFileInputs(meta2.fileInputs, finalArgs ?? {}, {
         includeContent: remote,
         uploadEndpoint: remote ? { url, token } : void 0,
         log: diagnose,
         baselineDirs,
         collectMembers: collectFlowMembers,
-        collectStepMembers,
-        toolFileInputs: (tool) => tools.find((t) => t.name === tool)?.fileInputs,
+        collectStepMembers: olderServer ? (record2, o) => collectStepMembers(record2, o, (root) => path7.join(root, LEGACY_E2E_DIRS[0])) : collectStepMembers,
+        toolFileInputs: (tool) => findTool(tools, tool)?.fileInputs,
         signal: opts?.signal
       });
     }
@@ -26474,19 +26630,23 @@ function createToolsClient(options = {}) {
       for (const { path: file, error: error2 } of applied.failed) {
         diagnose(`The baseline ${file} was not written on this client: ${error2}`);
       }
-      if (process.env.ARGENT_FLOW_FILES_LOG === "1") {
+      if (filesLogEnabled()) {
         for (const file of applied.written) {
-          if (baselineDirs.includes(path6.dirname(file))) {
+          if (baselineDirs.includes(path7.dirname(file))) {
             diagnose(`[flow-files] baseline ${file}: written`);
           }
         }
       }
-      return applied.result;
+      const result = applied.result;
+      if (shadowWarning === void 0 || typeof result !== "object" || result === null || Array.isArray(result) || typeof result.warning === "string") {
+        return result;
+      }
+      return { ...result, warning: shadowWarning };
     };
     const stream = opts?.onProgress !== void 0 || carriesMembers(finalArgs);
     const sentOnce = carriesUpload(finalArgs);
     const res = await doFetch(
-      `${url}/tools/${encodeURIComponent(name)}`,
+      `${url}/tools/${encodeURIComponent(meta2?.name ?? name)}`,
       {
         method: "POST",
         headers: {
@@ -26494,6 +26654,9 @@ function createToolsClient(options = {}) {
           // Tells the tool-server the call came over a link, a link to
           // 127.0.0.1 included, which nothing else in the request shows.
           ...remote ? { [LINKED_CALL_HEADER]: "1" } : {},
+          // Tells the tool-server this client writes recordings under
+          // `.argent/e2e/`; an older client writes only `.argent/flows/`.
+          [E2E_DIR_CLIENT_HEADER]: "1",
           // A proxy that compresses the stream holds each line until its buffer
           // fills. `identity` keeps the stream uncompressed end to end.
           ...stream ? { "Accept": "application/x-ndjson", "Accept-Encoding": "identity" } : {},
@@ -26551,43 +26714,43 @@ function createToolsClient(options = {}) {
 }
 
 // ../argent-tools-client/src/artifacts.ts
-import { copyFile, mkdir as mkdir4, readFile as readFile5, realpath as realpath4, rm as rm3, stat as stat4, writeFile as writeFile4 } from "node:fs/promises";
+import { copyFile, mkdir as mkdir4, readFile as readFile5, realpath as realpath4, rm as rm3, stat as stat5, writeFile as writeFile4 } from "node:fs/promises";
 import { constants as fsConstants } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
-import { basename as basename6, dirname as dirname8, extname as extname2, isAbsolute as isAbsolute6, join as join11, normalize as normalize2, resolve as resolve7, sep as sep4 } from "node:path";
+import { basename as basename7, dirname as dirname9, extname as extname2, isAbsolute as isAbsolute6, join as join13, normalize as normalize2, resolve as resolve8, sep as sep4 } from "node:path";
 import { createHash as createHash3 } from "node:crypto";
 
 // ../configuration-core/src/flags.ts
-import * as fs3 from "node:fs";
-import * as path7 from "node:path";
+import * as fs4 from "node:fs";
+import * as path8 from "node:path";
 import { homedir as homedir3 } from "node:os";
 var PROJECT_MARKERS = [".argent", ".git", "package.json"];
 function findProjectRoot(startDir) {
-  let current = path7.resolve(startDir);
+  let current = path8.resolve(startDir);
   while (true) {
     for (const marker of PROJECT_MARKERS) {
-      if (fs3.existsSync(path7.join(current, marker))) return current;
+      if (fs4.existsSync(path8.join(current, marker))) return current;
     }
-    const parent = path7.dirname(current);
+    const parent = path8.dirname(current);
     if (parent === current) return null;
     current = parent;
   }
 }
 function resolveProjectRoot(startDir) {
-  return findProjectRoot(startDir) ?? path7.resolve(startDir);
+  return findProjectRoot(startDir) ?? path8.resolve(startDir);
 }
 function getFlagsPath(scope, options = {}) {
   const home = options.homeDir ?? homedir3();
   if (scope === "global") {
-    return path7.join(home, ".argent", "flags.json");
+    return path8.join(home, ".argent", "flags.json");
   }
   const cwd = options.cwd ?? process.cwd();
-  return path7.join(resolveProjectRoot(cwd), ".argent", "flags.json");
+  return path8.join(resolveProjectRoot(cwd), ".argent", "flags.json");
 }
 function readFlagsFile(filePath) {
   let raw;
   try {
-    raw = fs3.readFileSync(filePath, "utf8");
+    raw = fs4.readFileSync(filePath, "utf8");
   } catch {
     return {};
   }
@@ -26619,7 +26782,7 @@ function isFlagEnabled(name, options = {}) {
 
 // ../configuration-core/src/paths.ts
 import * as os from "node:os";
-import * as path8 from "node:path";
+import * as path9 from "node:path";
 function nonEmpty(value) {
   if (value == void 0) return null;
   const trimmed = value.trim();
@@ -26630,26 +26793,26 @@ function resolveHomeDir(options = {}) {
   return process.platform === "win32" ? nonEmpty(process.env.USERPROFILE) ?? os.homedir() : nonEmpty(process.env.HOME) ?? os.homedir();
 }
 function argentHomeDir() {
-  return path8.join(resolveHomeDir(), ".argent");
+  return path9.join(resolveHomeDir(), ".argent");
 }
 function configDir(scope = "global", options = {}) {
   if (scope === "global") {
-    return path8.join(resolveHomeDir(options), ".argent");
+    return path9.join(resolveHomeDir(options), ".argent");
   }
   const cwd = options.cwd ?? process.cwd();
-  return path8.join(resolveProjectRoot(cwd), ".argent");
+  return path9.join(resolveProjectRoot(cwd), ".argent");
 }
 function configFilePath(scope = "global", options = {}) {
-  return path8.join(configDir(scope, options), "config.json");
+  return path9.join(configDir(scope, options), "config.json");
 }
 
 // ../configuration-core/src/config.ts
 import * as crypto from "node:crypto";
-import * as fs4 from "node:fs";
-import * as path9 from "node:path";
+import * as fs5 from "node:fs";
+import * as path10 from "node:path";
 function readConfigObject(scope = "global", options = {}) {
   try {
-    const raw = fs4.readFileSync(configFilePath(scope, options), "utf8");
+    const raw = fs5.readFileSync(configFilePath(scope, options), "utf8");
     const json = JSON.parse(raw);
     if (json && typeof json === "object" && !Array.isArray(json)) {
       return json;
@@ -26694,9 +26857,9 @@ function acquireConfigLock(finalPath) {
   const deadline = Date.now() + LOCK_MAX_WAIT_MS;
   for (; ; ) {
     try {
-      const fd = fs4.openSync(lockPath, "wx", 384);
+      const fd = fs5.openSync(lockPath, "wx", 384);
       try {
-        fs4.writeSync(fd, `${process.pid}
+        fs5.writeSync(fd, `${process.pid}
 `);
       } catch {
       }
@@ -26704,8 +26867,8 @@ function acquireConfigLock(finalPath) {
     } catch (err) {
       if (err.code !== "EEXIST") return null;
       try {
-        if (Date.now() - fs4.statSync(lockPath).mtimeMs > LOCK_STALE_MS2) {
-          fs4.unlinkSync(lockPath);
+        if (Date.now() - fs5.statSync(lockPath).mtimeMs > LOCK_STALE_MS2) {
+          fs5.unlinkSync(lockPath);
           continue;
         }
       } catch {
@@ -26717,35 +26880,35 @@ function acquireConfigLock(finalPath) {
 }
 function releaseConfigLock(lock) {
   try {
-    fs4.closeSync(lock.fd);
+    fs5.closeSync(lock.fd);
   } catch {
   }
   try {
-    fs4.unlinkSync(lock.lockPath);
+    fs5.unlinkSync(lock.lockPath);
   } catch {
   }
 }
 function updateConfig(mutate, scope = "global", options = {}) {
   const dir = configDir(scope, options);
-  fs4.mkdirSync(dir, { recursive: true });
+  fs5.mkdirSync(dir, { recursive: true });
   const finalPath = configFilePath(scope, options);
   const lock = acquireConfigLock(finalPath);
   try {
     const next = readConfigObject(scope, options);
     mutate(next);
-    const tmpPath = path9.join(dir, `.config.tmp.${process.pid}.${crypto.randomUUID()}`);
-    const fd = fs4.openSync(tmpPath, "wx", 384);
+    const tmpPath = path10.join(dir, `.config.tmp.${process.pid}.${crypto.randomUUID()}`);
+    const fd = fs5.openSync(tmpPath, "wx", 384);
     try {
-      fs4.writeSync(fd, JSON.stringify(next, null, 2) + "\n");
-      fs4.fsyncSync(fd);
+      fs5.writeSync(fd, JSON.stringify(next, null, 2) + "\n");
+      fs5.fsyncSync(fd);
     } finally {
-      fs4.closeSync(fd);
+      fs5.closeSync(fd);
     }
     try {
-      fs4.renameSync(tmpPath, finalPath);
+      fs5.renameSync(tmpPath, finalPath);
     } catch (err) {
       try {
-        fs4.unlinkSync(tmpPath);
+        fs5.unlinkSync(tmpPath);
       } catch {
       }
       throw err;
@@ -26757,8 +26920,8 @@ function updateConfig(mutate, scope = "global", options = {}) {
 
 // ../configuration-core/src/secrets.ts
 var import_dotenv = __toESM(require_dist3(), 1);
-import * as fs5 from "node:fs";
-import * as path10 from "node:path";
+import * as fs6 from "node:fs";
+import * as path11 from "node:path";
 
 // ../configuration-core/src/merge.ts
 function mergeRestrictive(local, global) {
@@ -26902,7 +27065,7 @@ var CONFIG_SCHEMA = [
   // nominal here — the project scope of a global-only key is never read.
   {
     key: "scripts.maxTimeoutMs",
-    description: `Upper bound, in milliseconds, on the time limit a flow \`script\` step may ask for (default 300000 \u2014 five minutes). Bounds how long one script can occupy the host. Values below ${MIN_SCRIPT_TIMEOUT_MS} ms are refused: the step starts a Node process before the script runs, so a smaller ceiling ends a script that did nothing wrong.`,
+    description: `Upper bound, in milliseconds, on the time limit an e2e test \`script\` step may ask for (default 300000 \u2014 five minutes). Bounds how long one script can occupy the host. Values below ${MIN_SCRIPT_TIMEOUT_MS} ms are refused: the step starts a Node process before the script runs, so a smaller ceiling ends a script that did nothing wrong.`,
     scopes: ["global"],
     parse: (raw) => {
       const value = asPositiveInteger(raw);
@@ -26915,7 +27078,7 @@ var CONFIG_SCHEMA = [
   },
   {
     key: "scripts.heapLimitMb",
-    description: `Old-space heap limit, in MiB, given to each flow \`script\` process (default 512). Values below ${MIN_SCRIPT_HEAP_LIMIT_MB} MiB are refused: that is already below what importing a real npm dependency needs, and under about 5 MiB the process dies inside V8's own startup before any script runs.`,
+    description: `Old-space heap limit, in MiB, given to each e2e test \`script\` process (default 512). Values below ${MIN_SCRIPT_HEAP_LIMIT_MB} MiB are refused: that is already below what importing a real npm dependency needs, and under about 5 MiB the process dies inside V8's own startup before any script runs.`,
     scopes: ["global"],
     parse: (raw) => {
       const value = asPositiveInteger(raw);
@@ -26932,7 +27095,7 @@ function getConfigDefinition(key, registry2 = CONFIG_SCHEMA) {
 }
 
 // ../configuration-core/src/config-access.ts
-import * as path11 from "node:path";
+import * as path12 from "node:path";
 function readScopeValue(def, scope, options) {
   if (!def.scopes.includes(scope)) return void 0;
   const raw = getAtPath(readConfigObject(scope, options), def.key);
@@ -26983,20 +27146,20 @@ function sanitizeSegment(segment) {
 function projectSlug() {
   const cwd = process.cwd();
   const hash = createHash3("sha1").update(cwd).digest("hex").slice(0, 6);
-  const name = sanitizeSegment(basename6(cwd)) || "root";
+  const name = sanitizeSegment(basename7(cwd)) || "root";
   return `${name}-${hash}`;
 }
 function artifactsRoot() {
-  return process.env.ARGENT_ARTIFACTS_DIR ?? join11(tmpdir2(), "argent-artifacts");
+  return process.env.ARGENT_ARTIFACTS_DIR ?? join13(tmpdir2(), "argent-artifacts");
 }
 function artifactDir(deviceId) {
   const parts = [artifactsRoot(), projectSlug(), sessionId()];
   if (deviceId) parts.push(sanitizeSegment(deviceId));
-  return join11(...parts);
+  return join13(...parts);
 }
 function durableBaseDir() {
   const projectRoot = findProjectRoot(process.cwd());
-  return projectRoot ?? dirname8(argentHomeDir());
+  return projectRoot ?? dirname9(argentHomeDir());
 }
 var ALLOWED_SAVE_DIRS = /* @__PURE__ */ new Set([normalize2(".argent/recordings")]);
 var RECORDINGS_SAVE_DIR = normalize2(".argent/recordings");
@@ -27010,9 +27173,9 @@ function configuredRecordingsDir() {
   if (typeof value !== "string") return null;
   const trimmed = value.trim();
   if (trimmed === "") return null;
-  const home = dirname8(argentHomeDir());
-  const expanded = trimmed === "~" ? home : trimmed.startsWith("~/") || trimmed.startsWith(`~${sep4}`) ? join11(home, trimmed.slice(2)) : trimmed;
-  return resolve7(durableBaseDir(), expanded);
+  const home = dirname9(argentHomeDir());
+  const expanded = trimmed === "~" ? home : trimmed.startsWith("~/") || trimmed.startsWith(`~${sep4}`) ? join13(home, trimmed.slice(2)) : trimmed;
+  return resolve8(durableBaseDir(), expanded);
 }
 var MAX_DURABLE_BYTES = 2 * 1024 * 1024 * 1024;
 async function readCapped(res, cap) {
@@ -27045,10 +27208,10 @@ async function writeDurableUnique(dir, filename, write) {
   const stem = filename.slice(0, filename.length - ext.length);
   for (let i = 1; i <= 1e3; i++) {
     const candidate = i === 1 ? filename : `${stem} (${i})${ext}`;
-    const path16 = join11(dir, candidate);
+    const path17 = join13(dir, candidate);
     try {
-      await write(path16);
-      return path16;
+      await write(path17);
+      return path17;
     } catch (err) {
       if (err?.code === "EEXIST") continue;
       throw err;
@@ -27068,21 +27231,21 @@ function durableSaveTarget(handle) {
     if (configured) {
       return {
         dir: configured,
-        path: join11(configured, sanitizeSegment(handle.filename)),
+        path: join13(configured, sanitizeSegment(handle.filename)),
         base: configured,
         rel: ""
       };
     }
   }
   const base = durableBaseDir();
-  const dir = join11(base, rel);
-  return { dir, path: join11(dir, sanitizeSegment(handle.filename)), base, rel };
+  const dir = join13(base, rel);
+  return { dir, path: join13(dir, sanitizeSegment(handle.filename)), base, rel };
 }
 async function confineToRealBase(dir, base, rel) {
   try {
     const realDir = await realpath4(dir);
     const realBase = await realpath4(base);
-    return realDir === join11(realBase, rel);
+    return realDir === join13(realBase, rel);
   } catch {
     return false;
   }
@@ -27090,7 +27253,7 @@ async function confineToRealBase(dir, base, rel) {
 async function resolveLocalFile(handle) {
   if (!handle.hostPath) return null;
   try {
-    const st = await stat4(handle.hostPath);
+    const st = await stat5(handle.hostPath);
     if (handle.archive) {
       return st.isDirectory() ? handle.hostPath : null;
     }
@@ -27105,7 +27268,7 @@ async function resolveLocalFile(handle) {
   }
 }
 async function downloadAndExtractArchive(handle, data, dir) {
-  const tarball = join11(dir, `${sanitizeSegment(handle.filename)}.tar.gz`);
+  const tarball = join13(dir, `${sanitizeSegment(handle.filename)}.tar.gz`);
   try {
     await writeFile4(tarball, data);
     return await safeExtractTarGz(tarball, dir, handle.filename);
@@ -27133,7 +27296,7 @@ async function materializeArtifacts(result, ctx) {
       const localPath = await resolveLocalFile(value);
       const saveTarget = durableSaveTarget(value);
       if (saveTarget) {
-        const filename = basename6(saveTarget.path);
+        const filename = basename7(saveTarget.path);
         try {
           await mkdir4(saveTarget.dir, { recursive: true });
           if (!await confineToRealBase(saveTarget.dir, saveTarget.base, saveTarget.rel)) {
@@ -27197,7 +27360,7 @@ async function materializeArtifacts(result, ctx) {
           return await downloadAndExtractArchive(value, data, dir);
         }
         if (value.size > 0 && data.length !== value.size) return null;
-        const downloadedPath = join11(dir, sanitizeSegment(value.filename));
+        const downloadedPath = join13(dir, sanitizeSegment(value.filename));
         await writeFile4(downloadedPath, data);
         if (value.mimeType.startsWith("image/")) {
           images.push({ localPath: downloadedPath, data, mimeType: value.mimeType });
@@ -27231,10 +27394,10 @@ function getDeviceIdFromArgs(args) {
 }
 
 // ../telemetry/src/debug.ts
-import * as fs6 from "node:fs";
+import * as fs7 from "node:fs";
 
 // ../telemetry/src/paths.ts
-import * as path12 from "node:path";
+import * as path13 from "node:path";
 
 // ../telemetry/src/events.ts
 var PLATFORMS = [
@@ -27459,6 +27622,7 @@ var ALLOWED = {
   "tool:invoke": {
     device_provider: DEVICE_PROVIDER,
     tool: TOOL_NAME,
+    alias_used: bool,
     tool_invocation_id: UUID,
     platform: PLATFORM,
     device_kind: DEVICE_KIND,
@@ -27467,6 +27631,7 @@ var ALLOWED = {
   "tool:complete": {
     device_provider: DEVICE_PROVIDER,
     tool: TOOL_NAME,
+    alias_used: bool,
     tool_invocation_id: UUID,
     platform: PLATFORM,
     device_kind: DEVICE_KIND,
@@ -27476,6 +27641,7 @@ var ALLOWED = {
   "tool:fail": {
     device_provider: DEVICE_PROVIDER,
     tool: TOOL_NAME,
+    alias_used: bool,
     tool_invocation_id: UUID,
     platform: PLATFORM,
     device_kind: DEVICE_KIND,
@@ -27494,6 +27660,7 @@ var ALLOWED = {
   },
   "cli:run_fail": {
     tool: TOOL_NAME,
+    alias_used: bool,
     duration_ms: DURATION_MS,
     ...FAILURE_SIGNAL
   },
@@ -27922,29 +28089,29 @@ var SESSION_ID2 = randomUUID5();
 
 // ../telemetry/src/identity.ts
 import * as crypto2 from "node:crypto";
-import * as fs7 from "node:fs";
-import * as path13 from "node:path";
+import * as fs8 from "node:fs";
+import * as path14 from "node:path";
 
 // ../telemetry/src/fingerprint.ts
 import { execFileSync as execFileSync2, spawn as spawn2 } from "node:child_process";
 
 // ../native-devtools-ios/src/index.ts
-import * as path14 from "node:path";
-import * as fs8 from "node:fs";
-var DYLIB_DIR = process.env.ARGENT_NATIVE_DEVTOOLS_DIR ?? path14.join(__dirname, "..", "dylibs");
-var BIN_DIR = process.env.ARGENT_SIMULATOR_SERVER_DIR ?? path14.join(__dirname, "..", "bin");
-var DYLIB_TCP_DIR = process.env.ARGENT_NATIVE_DEVTOOLS_TCP_DIR ?? path14.join(DYLIB_DIR, "tcp");
-var DYLIB_TVOS_DIR = path14.join(DYLIB_DIR, "tvos");
+import * as path15 from "node:path";
+import * as fs9 from "node:fs";
+var DYLIB_DIR = process.env.ARGENT_NATIVE_DEVTOOLS_DIR ?? path15.join(__dirname, "..", "dylibs");
+var BIN_DIR = process.env.ARGENT_SIMULATOR_SERVER_DIR ?? path15.join(__dirname, "..", "bin");
+var DYLIB_TCP_DIR = process.env.ARGENT_NATIVE_DEVTOOLS_TCP_DIR ?? path15.join(DYLIB_DIR, "tcp");
+var DYLIB_TVOS_DIR = path15.join(DYLIB_DIR, "tvos");
 
 // ../telemetry/src/consent.ts
-import * as fs9 from "node:fs";
+import * as fs10 from "node:fs";
 var cache = /* @__PURE__ */ new Map();
 var sessionOverride = null;
 function readConfigOverrideAt(filePath) {
   const miss = { mtimeMs: null, fingerprint: null, enabledOverride: null };
   let stats;
   try {
-    stats = fs9.lstatSync(filePath);
+    stats = fs10.lstatSync(filePath);
   } catch {
     cache.set(filePath, miss);
     return null;
@@ -27961,7 +28128,7 @@ function readConfigOverrideAt(filePath) {
   }
   let parsedEnabled = null;
   try {
-    const raw = fs9.readFileSync(filePath, "utf8");
+    const raw = fs10.readFileSync(filePath, "utf8");
     const json = JSON.parse(raw);
     if (json && typeof json === "object") {
       const t = json.telemetry;
@@ -28205,8 +28372,10 @@ async function flowRunToMcpContent(result, ctx) {
   }
   blocks.push({
     type: "text",
-    text: `Running flow "${result.flow}"${result.device ? ` on ${result.device}` : ""} (${result.steps.length} steps)`
+    text: `Running e2e test "${result.flow}"${result.device ? ` on ${result.device}` : ""} (${result.steps.length} steps)`
   });
+  if (typeof result.warning === "string")
+    blocks.push({ type: "text", text: `\u26A0 ${result.warning}` });
   for (let i = 0; i < result.steps.length; i++) {
     const step = result.steps[i];
     const num = step.index !== void 0 ? step.index + 1 : i + 1;
@@ -28235,9 +28404,9 @@ async function flowRunToMcpContent(result, ctx) {
     }
   }
   for (const write of result.baselineWrites ?? []) {
-    const { path: path16, error: error2 } = isRecord2(write) ? write : {};
-    if (typeof path16 === "string" && typeof error2 === "string") {
-      blocks.push({ type: "text", text: `\u2717 baseline not written: ${path16}: ${error2}` });
+    const { path: path17, error: error2 } = isRecord2(write) ? write : {};
+    if (typeof path17 === "string" && typeof error2 === "string") {
+      blocks.push({ type: "text", text: `\u2717 baseline not written: ${path17}: ${error2}` });
     }
   }
   if (result.ok !== void 0) {
@@ -28248,7 +28417,7 @@ async function flowRunToMcpContent(result, ctx) {
       text: `${result.ok ? "PASS" : "FAIL"} \u2014 ${result.passed ?? 0} passed, ${result.failed ?? 0} failed, ${result.errored ?? 0} errored, ${result.skipped ?? 0} skipped${note}${durationSuffix(result.durationMs)}`
     });
   } else {
-    blocks.push({ type: "text", text: `Flow "${result.flow}" complete.` });
+    blocks.push({ type: "text", text: `E2E test "${result.flow}" complete.` });
   }
   return blocks;
 }
@@ -28403,12 +28572,12 @@ function toMcpToolList(tools) {
 }
 
 // ../argent-mcp/src/installed-version.ts
-import * as fs10 from "node:fs";
-import * as path15 from "node:path";
+import * as fs11 from "node:fs";
+import * as path16 from "node:path";
 function getInstalledVersion() {
   try {
-    const pkgPath = path15.resolve(import.meta.dirname, "..", "package.json");
-    const pkg = JSON.parse(fs10.readFileSync(pkgPath, "utf8"));
+    const pkgPath = path16.resolve(import.meta.dirname, "..", "package.json");
+    const pkg = JSON.parse(fs11.readFileSync(pkgPath, "utf8"));
     return pkg.version ?? "unknown";
   } catch {
     return "unknown";
@@ -28552,7 +28721,7 @@ async function startMcpServer(options) {
   async function spyLog(entry) {
     try {
       if (!logDirReady) {
-        await mkdir5(dirname9(LOG_FILE2), { recursive: true });
+        await mkdir5(dirname10(LOG_FILE2), { recursive: true });
         logDirReady = true;
       }
       await appendFile(LOG_FILE2, JSON.stringify(entry) + "\n");
@@ -28613,7 +28782,7 @@ async function startMcpServer(options) {
         deviceId: getDeviceIdFromArgs(params.arguments)
       };
       let content;
-      if (params.name === "flow-execute" && result && typeof result === "object" && "flow" in result && "steps" in result) {
+      if (canonicalToolId(params.name) === "e2e-execute" && result && typeof result === "object" && "flow" in result && "steps" in result) {
         content = await flowRunToMcpContent(result, ctx);
       } else if (params.name === "screenshot-diff" && isScreenshotDiffResult(result)) {
         content = await screenshotDiffToMcpContent(result, ctx);