@swmansion/argent 0.27.1-next.21 → 0.27.1-next.22

package/dist/cli-cmds.mjs

@@ -9363,6 +9363,35 @@ var FLOW_NAME_CHARSET = "[A-Za-z0-9_-]+";
 var FLOW_NAME_PATTERN = new RegExp(`^${FLOW_NAME_CHARSET}$`);
 var FLOW_FILE_NAME_PATTERN = new RegExp(`^${FLOW_NAME_CHARSET}\\.yaml$`);
 var SCRIPT_FILE_NAME_PATTERN = new RegExp(`^${FLOW_NAME_CHARSET}\\.mjs$`);
+function interpolateFileInputPath(template, args) {
+  let missing = false;
+  const out = template.replace(/\$\{([A-Za-z0-9_]+)\}/g, (_m, name) => {
+    const v = args[name];
+    if (typeof v !== "string" || v.length === 0) {
+      missing = true;
+      return "";
+    }
+    return v;
+  });
+  return missing ? null : out;
+}
+var TOOL_FILE_EXTENSIONS = [".png", ".yaml"];
+function hasToolFileExtension(file2) {
+  const name = file2.toLowerCase();
+  return TOOL_FILE_EXTENSIONS.some((extension) => name.endsWith(extension));
+}
+function toolStepFiles(specs, args) {
+  const files = [];
+  for (const spec of specs ?? []) {
+    if (spec.skipWhenSet !== void 0 && args[spec.skipWhenSet] !== void 0) continue;
+    const filled = interpolateFileInputPath(spec.path, args);
+    if (filled !== null) files.push({ spec, path: filled });
+  }
+  return files;
+}
+function isClientFileArgument({ spec, path: path23 }) {
+  return spec.kind === "file" && spec.path === `\${${spec.target}}` && path23.startsWith("/") && hasToolFileExtension(path23);
+}
 
 // ../registry/src/flow-file-refs.ts
 import * as fs2 from "node:fs/promises";
@@ -9391,6 +9420,7 @@ function isRecord(value) {
 function collectFlowRequests(doc) {
   const runTargets = /* @__PURE__ */ new Set();
   const snapshots = /* @__PURE__ */ new Set();
+  const toolSteps = [];
   const seen = /* @__PURE__ */ new Set();
   const visit = (steps, depth) => {
     if (!Array.isArray(steps) || depth > MAX_BLOCK_NESTING || seen.has(steps)) return;
@@ -9404,11 +9434,14 @@ function collectFlowRequests(doc) {
       }
       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") {
+        toolSteps.push({ tool: step.tool, args: isRecord(step.args) ? step.args : {} });
+      }
       visit(step.steps, depth + 1);
     }
   };
   if (isRecord(doc)) visit(doc.steps, 0);
-  return { runTargets: [...runTargets], snapshots: [...snapshots] };
+  return { runTargets: [...runTargets], snapshots: [...snapshots], toolSteps };
 }
 function baselineKeyFor(canonicalPath, flowName) {
   const stem = path2.basename(canonicalPath, ".yaml");
@@ -24978,6 +25011,29 @@ async function readFlowMember(anchorDir, target, roots, budget, opts) {
   const sent = await sendBytes(member, canonical, budget, opts);
   return { ...sent, text: sent.bytes?.toString("utf8") };
 }
+async function readToolMember(file2, roots, budget, opts) {
+  const member = { role: "tool", key: file2, path: file2 };
+  const refuse = (reason) => ({
+    member: { ...member, state: "refused", error: reason },
+    sent: `refused (${reason})`
+  });
+  const { canonical } = await landing(file2);
+  if (!roots.some((root) => isWithin(canonical, root))) {
+    return refuse(`${file2} is outside every root this client serves (${roots.join(", ")})`);
+  }
+  if (!hasToolFileExtension(canonical)) {
+    return refuse(`${file2} links to a file that is not one of ${TOOL_FILE_EXTENSIONS.join(", ")}`);
+  }
+  const st = await stat3(canonical).catch((err) => err);
+  if (st instanceof Error) {
+    if (st.code === "ENOENT" || st.code === "ENOTDIR") {
+      return { member: { ...member, state: "missing" }, sent: "missing" };
+    }
+    return refuse(st.message);
+  }
+  if (st.isDirectory()) return refuse("EISDIR: illegal operation on a directory, read");
+  return sendBytes(member, canonical, budget, opts);
+}
 function callPlatform(args) {
   if (typeof args.device === "string" && args.device.startsWith("chromium-cdp-")) return "chromium";
   if (typeof args.platform !== "string") return void 0;
@@ -25032,7 +25088,7 @@ async function sendBytes(member, real, budget, opts) {
     bytes
   };
 }
-async function collectBaselineMembers(canonical, flowName, snapshots, args, roots, budget, opts, emit) {
+async function collectBaselineMembers(canonical, flowName, snapshots, args, roots, budget, opts, sent, emit) {
   const dir = path5.join(
     path5.dirname(canonical),
     "__baselines__",
@@ -25051,6 +25107,7 @@ async function collectBaselineMembers(canonical, flowName, snapshots, args, root
     if (!name.endsWith(".png")) continue;
     if (!updates && !prefixes.some((prefix) => name.startsWith(prefix))) continue;
     const file2 = path5.join(dir, name);
+    if (sent.has(file2)) continue;
     const member = { role: "baseline", key: file2, path: file2 };
     const entry = await baselineEntry(file2, roots, updates);
     if (entry.state === "refused") {
@@ -25060,8 +25117,8 @@ async function collectBaselineMembers(canonical, flowName, snapshots, args, root
     } else if (updates) {
       emit({ ...member, state: "listed" }, "listed");
     } else {
-      const sent = await sendBytes(member, entry.real, budget, opts);
-      emit(sent.member, sent.sent);
+      const sent2 = await sendBytes(member, entry.real, budget, opts);
+      emit(sent2.member, sent2.sent);
     }
   }
 }
@@ -25096,6 +25153,17 @@ async function collectFlowMembers(rootPath, rootBytes, args, opts) {
     }
     const requests = collectFlowRequests(doc);
     for (const name of requests.snapshots) snapshots.add(name);
+    for (const step of requests.toolSteps) {
+      if (step.tool === "flow-execute") continue;
+      for (const file3 of toolStepFiles(opts.toolFileInputs?.(step.tool), step.args)) {
+        const { unwrapWhenSet } = file3.spec;
+        if (unwrapWhenSet !== void 0 && step.args[unwrapWhenSet] !== void 0) continue;
+        if (!isClientFileArgument(file3) || seen.has(file3.path)) continue;
+        seen.add(file3.path);
+        const read = await readToolMember(file3.path, roots, budget, opts);
+        emit(read.member, read.sent);
+      }
+    }
     const anchorDir = path5.dirname(file2.canonical);
     for (const target of requests.runTargets) {
       const key = flowMemberKey(anchorDir, target);
@@ -25118,6 +25186,7 @@ async function collectFlowMembers(rootPath, rootBytes, args, opts) {
       roots,
       budget,
       opts,
+      seen,
       emit
     );
   }
@@ -25282,7 +25351,8 @@ function createToolsClient(options = {}) {
     opts?.signal?.throwIfAborted();
     const { url: url2, token, remote } = await route();
     let finalArgs = args;
-    const meta3 = await fetchTool(name, { signal: opts?.signal });
+    const tools2 = await fetchTools({ signal: opts?.signal });
+    const meta3 = tools2.find((t2) => t2.name === name) ?? null;
     const baselineDirs = [];
     if (meta3?.fileInputs?.length) {
       if (remote) assertRequiredPresent(meta3, args);
@@ -25292,6 +25362,7 @@ function createToolsClient(options = {}) {
         log: diagnose,
         baselineDirs,
         collectMembers: collectFlowMembers,
+        toolFileInputs: (tool) => tools2.find((t2) => t2.name === tool)?.fileInputs,
         signal: opts?.signal
       });
     }
@@ -29877,7 +29948,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID2 = randomUUID5();
 function readCliVersion() {
   if (true) {
-    return "0.27.1-next.21";
+    return "0.27.1-next.22";
   }
   return "0.0.0";
 }
@@ -31231,11 +31302,15 @@ counts the remaining flows skipped.
 The CLI sends a run to its tool-server: the local one that starts
 automatically, or the one that \`argent link\` or ARGENT_TOOLS_URL names. Over
 a link, the CLI uploads the flow file, the run: fragments that it reaches and
-the snapshot baselines that the run compares. The CLI writes the new baselines
-that the run returns. The tool-server rejects the flow before the first step
-when the flow or a fragment has one of these steps:
-  - script:
-  - a tool: step that takes a file or records a flow
+the snapshot baselines that the run compares. It also uploads each .png or
+.yaml file that a tool: step takes as a file argument by an absolute path. The
+CLI writes the new baselines that the run returns. The tool-server rejects the
+flow before the first step when the flow or a fragment has one of these steps:
+  - a script: step
+  - a tool: step that runs or records a flow
+  - a tool: step that takes a directory, an app or an output directory
+  - a tool: step whose tool builds a file path from several arguments
+  - a tool: step that names a relative path or a file other than .png or .yaml
 Without a link, all step kinds run.
 
 Subcommands:

package/dist/client.js

@@ -8566,6 +8566,35 @@ var FLOW_NAME_CHARSET = "[A-Za-z0-9_-]+";
 var FLOW_NAME_PATTERN = new RegExp(`^${FLOW_NAME_CHARSET}$`);
 var FLOW_FILE_NAME_PATTERN = new RegExp(`^${FLOW_NAME_CHARSET}\\.yaml$`);
 var SCRIPT_FILE_NAME_PATTERN = new RegExp(`^${FLOW_NAME_CHARSET}\\.mjs$`);
+function interpolateFileInputPath(template, args) {
+  let missing = false;
+  const out = template.replace(/\$\{([A-Za-z0-9_]+)\}/g, (_m, name) => {
+    const v = args[name];
+    if (typeof v !== "string" || v.length === 0) {
+      missing = true;
+      return "";
+    }
+    return v;
+  });
+  return missing ? null : out;
+}
+var TOOL_FILE_EXTENSIONS = [".png", ".yaml"];
+function hasToolFileExtension(file) {
+  const name = file.toLowerCase();
+  return TOOL_FILE_EXTENSIONS.some((extension) => name.endsWith(extension));
+}
+function toolStepFiles(specs, args) {
+  const files = [];
+  for (const spec of specs ?? []) {
+    if (spec.skipWhenSet !== void 0 && args[spec.skipWhenSet] !== void 0) continue;
+    const filled = interpolateFileInputPath(spec.path, args);
+    if (filled !== null) files.push({ spec, path: filled });
+  }
+  return files;
+}
+function isClientFileArgument({ spec, path: path12 }) {
+  return spec.kind === "file" && spec.path === `\${${spec.target}}` && path12.startsWith("/") && hasToolFileExtension(path12);
+}
 
 // ../registry/src/flow-file-refs.ts
 import * as fs5 from "node:fs/promises";
@@ -8594,6 +8623,7 @@ function isRecord(value) {
 function collectFlowRequests(doc) {
   const runTargets = /* @__PURE__ */ new Set();
   const snapshots = /* @__PURE__ */ new Set();
+  const toolSteps = [];
   const seen = /* @__PURE__ */ new Set();
   const visit = (steps, depth) => {
     if (!Array.isArray(steps) || depth > MAX_BLOCK_NESTING || seen.has(steps)) return;
@@ -8607,11 +8637,14 @@ function collectFlowRequests(doc) {
       }
       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") {
+        toolSteps.push({ tool: step.tool, args: isRecord(step.args) ? step.args : {} });
+      }
       visit(step.steps, depth + 1);
     }
   };
   if (isRecord(doc)) visit(doc.steps, 0);
-  return { runTargets: [...runTargets], snapshots: [...snapshots] };
+  return { runTargets: [...runTargets], snapshots: [...snapshots], toolSteps };
 }
 function baselineKeyFor(canonicalPath, flowName) {
   const stem = path7.basename(canonicalPath, ".yaml");
@@ -9562,6 +9595,29 @@ async function readFlowMember(anchorDir, target, roots, budget, opts) {
   const sent = await sendBytes(member, canonical, budget, opts);
   return { ...sent, text: sent.bytes?.toString("utf8") };
 }
+async function readToolMember(file, roots, budget, opts) {
+  const member = { role: "tool", key: file, path: file };
+  const refuse = (reason) => ({
+    member: { ...member, state: "refused", error: reason },
+    sent: `refused (${reason})`
+  });
+  const { canonical } = await landing(file);
+  if (!roots.some((root) => isWithin(canonical, root))) {
+    return refuse(`${file} is outside every root this client serves (${roots.join(", ")})`);
+  }
+  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);
+  if (st instanceof Error) {
+    if (st.code === "ENOENT" || st.code === "ENOTDIR") {
+      return { member: { ...member, state: "missing" }, sent: "missing" };
+    }
+    return refuse(st.message);
+  }
+  if (st.isDirectory()) return refuse("EISDIR: illegal operation on a directory, read");
+  return sendBytes(member, canonical, budget, opts);
+}
 function callPlatform(args) {
   if (typeof args.device === "string" && args.device.startsWith("chromium-cdp-")) return "chromium";
   if (typeof args.platform !== "string") return void 0;
@@ -9616,7 +9672,7 @@ async function sendBytes(member, real, budget, opts) {
     bytes
   };
 }
-async function collectBaselineMembers(canonical, flowName, snapshots, args, roots, budget, opts, emit) {
+async function collectBaselineMembers(canonical, flowName, snapshots, args, roots, budget, opts, sent, emit) {
   const dir = path10.join(
     path10.dirname(canonical),
     "__baselines__",
@@ -9635,6 +9691,7 @@ async function collectBaselineMembers(canonical, flowName, snapshots, args, root
     if (!name.endsWith(".png")) continue;
     if (!updates && !prefixes.some((prefix) => name.startsWith(prefix))) continue;
     const file = path10.join(dir, name);
+    if (sent.has(file)) continue;
     const member = { role: "baseline", key: file, path: file };
     const entry = await baselineEntry(file, roots, updates);
     if (entry.state === "refused") {
@@ -9644,8 +9701,8 @@ async function collectBaselineMembers(canonical, flowName, snapshots, args, root
     } else if (updates) {
       emit({ ...member, state: "listed" }, "listed");
     } else {
-      const sent = await sendBytes(member, entry.real, budget, opts);
-      emit(sent.member, sent.sent);
+      const sent2 = await sendBytes(member, entry.real, budget, opts);
+      emit(sent2.member, sent2.sent);
     }
   }
 }
@@ -9680,6 +9737,17 @@ async function collectFlowMembers(rootPath, rootBytes, args, opts) {
     }
     const requests = collectFlowRequests(doc);
     for (const name of requests.snapshots) snapshots.add(name);
+    for (const step of requests.toolSteps) {
+      if (step.tool === "flow-execute") continue;
+      for (const file2 of toolStepFiles(opts.toolFileInputs?.(step.tool), step.args)) {
+        const { unwrapWhenSet } = file2.spec;
+        if (unwrapWhenSet !== void 0 && step.args[unwrapWhenSet] !== void 0) continue;
+        if (!isClientFileArgument(file2) || seen.has(file2.path)) continue;
+        seen.add(file2.path);
+        const read = await readToolMember(file2.path, roots, budget, opts);
+        emit(read.member, read.sent);
+      }
+    }
     const anchorDir = path10.dirname(file.canonical);
     for (const target of requests.runTargets) {
       const key = flowMemberKey(anchorDir, target);
@@ -9702,6 +9770,7 @@ async function collectFlowMembers(rootPath, rootBytes, args, opts) {
       roots,
       budget,
       opts,
+      seen,
       emit
     );
   }
@@ -9866,7 +9935,8 @@ function createToolsClient(options = {}) {
     opts?.signal?.throwIfAborted();
     const { url, token, remote } = await route();
     let finalArgs = args;
-    const meta = await fetchTool(name, { signal: opts?.signal });
+    const tools = await fetchTools({ signal: opts?.signal });
+    const meta = tools.find((t) => t.name === name) ?? null;
     const baselineDirs = [];
     if (meta?.fileInputs?.length) {
       if (remote) assertRequiredPresent(meta, args);
@@ -9876,6 +9946,7 @@ function createToolsClient(options = {}) {
         log: diagnose,
         baselineDirs,
         collectMembers: collectFlowMembers,
+        toolFileInputs: (tool) => tools.find((t) => t.name === tool)?.fileInputs,
         signal: opts?.signal
       });
     }

package/dist/installer.mjs

@@ -16736,7 +16736,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID = randomUUID4();
 function readCliVersion() {
   if (true) {
-    return "0.27.1-next.21";
+    return "0.27.1-next.22";
   }
   return "0.0.0";
 }

package/dist/mcp-server.mjs

@@ -23601,6 +23601,35 @@ var FLOW_NAME_CHARSET = "[A-Za-z0-9_-]+";
 var FLOW_NAME_PATTERN = new RegExp(`^${FLOW_NAME_CHARSET}$`);
 var FLOW_FILE_NAME_PATTERN = new RegExp(`^${FLOW_NAME_CHARSET}\\.yaml$`);
 var SCRIPT_FILE_NAME_PATTERN = new RegExp(`^${FLOW_NAME_CHARSET}\\.mjs$`);
+function interpolateFileInputPath(template, args) {
+  let missing = false;
+  const out = template.replace(/\$\{([A-Za-z0-9_]+)\}/g, (_m, name) => {
+    const v = args[name];
+    if (typeof v !== "string" || v.length === 0) {
+      missing = true;
+      return "";
+    }
+    return v;
+  });
+  return missing ? null : out;
+}
+var TOOL_FILE_EXTENSIONS = [".png", ".yaml"];
+function hasToolFileExtension(file) {
+  const name = file.toLowerCase();
+  return TOOL_FILE_EXTENSIONS.some((extension) => name.endsWith(extension));
+}
+function toolStepFiles(specs, args) {
+  const files = [];
+  for (const spec of specs ?? []) {
+    if (spec.skipWhenSet !== void 0 && args[spec.skipWhenSet] !== void 0) continue;
+    const filled = interpolateFileInputPath(spec.path, args);
+    if (filled !== null) files.push({ spec, path: filled });
+  }
+  return files;
+}
+function isClientFileArgument({ spec, path: path15 }) {
+  return spec.kind === "file" && spec.path === `\${${spec.target}}` && path15.startsWith("/") && hasToolFileExtension(path15);
+}
 
 // ../registry/src/flow-file-refs.ts
 import * as fs2 from "node:fs/promises";
@@ -23629,6 +23658,7 @@ function isRecord(value) {
 function collectFlowRequests(doc) {
   const runTargets = /* @__PURE__ */ new Set();
   const snapshots = /* @__PURE__ */ new Set();
+  const toolSteps = [];
   const seen = /* @__PURE__ */ new Set();
   const visit = (steps, depth) => {
     if (!Array.isArray(steps) || depth > MAX_BLOCK_NESTING || seen.has(steps)) return;
@@ -23642,11 +23672,14 @@ function collectFlowRequests(doc) {
       }
       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") {
+        toolSteps.push({ tool: step.tool, args: isRecord(step.args) ? step.args : {} });
+      }
       visit(step.steps, depth + 1);
     }
   };
   if (isRecord(doc)) visit(doc.steps, 0);
-  return { runTargets: [...runTargets], snapshots: [...snapshots] };
+  return { runTargets: [...runTargets], snapshots: [...snapshots], toolSteps };
 }
 function baselineKeyFor(canonicalPath, flowName) {
   const stem = path2.basename(canonicalPath, ".yaml");
@@ -24636,6 +24669,29 @@ async function readFlowMember(anchorDir, target, roots, budget, opts) {
   const sent = await sendBytes(member, canonical, budget, opts);
   return { ...sent, text: sent.bytes?.toString("utf8") };
 }
+async function readToolMember(file, roots, budget, opts) {
+  const member = { role: "tool", key: file, path: file };
+  const refuse = (reason) => ({
+    member: { ...member, state: "refused", error: reason },
+    sent: `refused (${reason})`
+  });
+  const { canonical } = await landing(file);
+  if (!roots.some((root) => isWithin(canonical, root))) {
+    return refuse(`${file} is outside every root this client serves (${roots.join(", ")})`);
+  }
+  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);
+  if (st instanceof Error) {
+    if (st.code === "ENOENT" || st.code === "ENOTDIR") {
+      return { member: { ...member, state: "missing" }, sent: "missing" };
+    }
+    return refuse(st.message);
+  }
+  if (st.isDirectory()) return refuse("EISDIR: illegal operation on a directory, read");
+  return sendBytes(member, canonical, budget, opts);
+}
 function callPlatform(args) {
   if (typeof args.device === "string" && args.device.startsWith("chromium-cdp-")) return "chromium";
   if (typeof args.platform !== "string") return void 0;
@@ -24690,7 +24746,7 @@ async function sendBytes(member, real, budget, opts) {
     bytes
   };
 }
-async function collectBaselineMembers(canonical, flowName, snapshots, args, roots, budget, opts, emit) {
+async function collectBaselineMembers(canonical, flowName, snapshots, args, roots, budget, opts, sent, emit) {
   const dir = path5.join(
     path5.dirname(canonical),
     "__baselines__",
@@ -24709,6 +24765,7 @@ async function collectBaselineMembers(canonical, flowName, snapshots, args, root
     if (!name.endsWith(".png")) continue;
     if (!updates && !prefixes.some((prefix) => name.startsWith(prefix))) continue;
     const file = path5.join(dir, name);
+    if (sent.has(file)) continue;
     const member = { role: "baseline", key: file, path: file };
     const entry = await baselineEntry(file, roots, updates);
     if (entry.state === "refused") {
@@ -24718,8 +24775,8 @@ async function collectBaselineMembers(canonical, flowName, snapshots, args, root
     } else if (updates) {
       emit({ ...member, state: "listed" }, "listed");
     } else {
-      const sent = await sendBytes(member, entry.real, budget, opts);
-      emit(sent.member, sent.sent);
+      const sent2 = await sendBytes(member, entry.real, budget, opts);
+      emit(sent2.member, sent2.sent);
     }
   }
 }
@@ -24754,6 +24811,17 @@ async function collectFlowMembers(rootPath, rootBytes, args, opts) {
     }
     const requests = collectFlowRequests(doc);
     for (const name of requests.snapshots) snapshots.add(name);
+    for (const step of requests.toolSteps) {
+      if (step.tool === "flow-execute") continue;
+      for (const file2 of toolStepFiles(opts.toolFileInputs?.(step.tool), step.args)) {
+        const { unwrapWhenSet } = file2.spec;
+        if (unwrapWhenSet !== void 0 && step.args[unwrapWhenSet] !== void 0) continue;
+        if (!isClientFileArgument(file2) || seen.has(file2.path)) continue;
+        seen.add(file2.path);
+        const read = await readToolMember(file2.path, roots, budget, opts);
+        emit(read.member, read.sent);
+      }
+    }
     const anchorDir = path5.dirname(file.canonical);
     for (const target of requests.runTargets) {
       const key = flowMemberKey(anchorDir, target);
@@ -24776,6 +24844,7 @@ async function collectFlowMembers(rootPath, rootBytes, args, opts) {
       roots,
       budget,
       opts,
+      seen,
       emit
     );
   }
@@ -24940,7 +25009,8 @@ function createToolsClient(options = {}) {
     opts?.signal?.throwIfAborted();
     const { url, token, remote } = await route();
     let finalArgs = args;
-    const meta2 = await fetchTool(name, { signal: opts?.signal });
+    const tools = await fetchTools({ signal: opts?.signal });
+    const meta2 = tools.find((t) => t.name === name) ?? null;
     const baselineDirs = [];
     if (meta2?.fileInputs?.length) {
       if (remote) assertRequiredPresent(meta2, args);
@@ -24950,6 +25020,7 @@ function createToolsClient(options = {}) {
         log: diagnose,
         baselineDirs,
         collectMembers: collectFlowMembers,
+        toolFileInputs: (tool) => tools.find((t) => t.name === tool)?.fileInputs,
         signal: opts?.signal
       });
     }

package/dist/tool-args.generated.d.ts

@@ -225,7 +225,7 @@ export interface ArgentToolArgs {
         project_root: string;
         /** Path to the flow .yaml as readable by the tool-server. Internal — the argent client derives it from project_root and name automatically; leave unset. */
         flow_file?: string;
-        /** Omit when name is set. Absolute path to a flow .yaml on the client. Over a link (argent link or ARGENT_TOOLS_URL), the argent client uploads the file, its run: fragments and the snapshot baselines that the run compares, and the tool-server runs those copies. Keep run: fragments under project_root or beside the flow file. With updateBaselines, the client writes the new baselines when the run ends. Over a link, the flow and its fragments must not have script: steps, or tool: steps that take a file or record a flow. Without a link, the tool-server reads the files in place and all step kinds run. */
+        /** Omit when name is set. Absolute path to a flow .yaml on the client. Over a link (argent link or ARGENT_TOOLS_URL), the argent client uploads the file, its run: fragments and the snapshot baselines that the run compares, and the tool-server runs those copies. Keep run: fragments under project_root or beside the flow file. With updateBaselines, the client writes the new baselines when the run ends. The client also uploads each absolute .png or .yaml path that a tool: step takes as a file argument, when the file is under project_root or beside the flow file. Over a link, the flow and its fragments must not have: script: steps; tool: steps that run or record a flow; tool: steps that take a directory, an app or an output directory; tool: steps whose tool builds a file path from several arguments; tool: steps that name a relative path or a file other than .png or .yaml. Without a link, the tool-server reads the files in place and all step kinds run. */
         flow_path?: string;
         /** Device id to run against (iOS UDID, Android/Vega serial, Chromium id) — the id list-devices reports. Auto-detected when omitted, but only when exactly one booted device matches (optionally narrowed by `platform`); with several booted the run fails and lists them, so pass this explicitly whenever more than one device is up. */
         device?: string;