@swmansion/argent 0.11.0 → 0.12.0

package/dist/mcp-server.mjs

@@ -6,7 +6,11 @@ var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __commonJS = (cb, mod) => function __require() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  try {
+    return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  } catch (e) {
+    throw mod = 0, e;
+  }
 };
 var __export = (target, all) => {
   for (var name in all)
@@ -2980,7 +2984,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve2.call(this, root, ref);
+      let _sch = resolve3.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;
@@ -3007,7 +3011,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve2(root, ref) {
+    function resolve3(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -3225,8 +3229,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path4) {
-      let input = path4;
+    function removeDotSegments(path6) {
+      let input = path6;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -3478,8 +3482,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path4, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path4 && path4 !== "/" ? path4 : void 0;
+        const [path6, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path6 && path6 !== "/" ? path6 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -3638,7 +3642,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve2(baseURI, relativeURI, options) {
+    function resolve3(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;
@@ -3896,7 +3900,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize,
-      resolve: resolve2,
+      resolve: resolve3,
       resolveComponent,
       equal,
       serialize,
@@ -6872,12 +6876,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f;
     };
-    function addFormats(ajv, list, fs3, exportName) {
+    function addFormats(ajv, list, fs4, 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, fs3[f]);
+        ajv.addFormat(f, fs4[f]);
     }
     module.exports = exports = formatsPlugin;
     Object.defineProperty(exports, "__esModule", { value: true });
@@ -6886,8 +6890,8 @@ var require_dist = __commonJS({
 });
 
 // ../argent-mcp/src/mcp-server.ts
-import { appendFile, mkdir as mkdir4 } from "node:fs/promises";
-import { dirname as dirname2 } from "node:path";
+import { appendFile, mkdir as mkdir5 } from "node:fs/promises";
+import { dirname as dirname3 } from "node:path";
 import { homedir as homedir4 } from "node:os";
 
 // ../../node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
@@ -7133,10 +7137,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path4) {
-  if (!path4)
+function getElementAtPath(obj, path6) {
+  if (!path6)
     return obj;
-  return path4.reduce((acc, key) => acc?.[key], obj);
+  return path6.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -7545,11 +7549,11 @@ function explicitlyAborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path4, issues) {
+function prefixIssues(path6, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path4);
+    iss.path.unshift(path6);
     return iss;
   });
 }
@@ -7696,16 +7700,16 @@ function flattenError(error2, mapper = (issue2) => issue2.message) {
 }
 function formatError(error2, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error3, path4 = []) => {
+  const processError = (error3, path6 = []) => {
     for (const issue2 of error3.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path4, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path6, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path4, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path6, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path4, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path6, ...issue2.path]);
       } else {
-        const fullpath = [...path4, ...issue2.path];
+        const fullpath = [...path6, ...issue2.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue2));
         } else {
@@ -13697,12 +13701,12 @@ var StdioServerTransport = class {
     this.onclose?.();
   }
   send(message) {
-    return new Promise((resolve2) => {
+    return new Promise((resolve3) => {
       const json = serializeMessage(message);
       if (this._stdout.write(json)) {
-        resolve2();
+        resolve3();
       } else {
-        this._stdout.once("drain", resolve2);
+        this._stdout.once("drain", resolve3);
       }
     });
   }
@@ -14300,7 +14304,7 @@ var Protocol = class {
           return;
         }
         const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-        await new Promise((resolve2) => setTimeout(resolve2, pollInterval));
+        await new Promise((resolve3) => setTimeout(resolve3, pollInterval));
         options?.signal?.throwIfAborted();
       }
     } catch (error2) {
@@ -14317,7 +14321,7 @@ var Protocol = class {
    */
   request(request, resultSchema, options) {
     const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-    return new Promise((resolve2, reject) => {
+    return new Promise((resolve3, reject) => {
       const earlyReject = (error2) => {
         reject(error2);
       };
@@ -14395,7 +14399,7 @@ var Protocol = class {
           if (!parseResult.success) {
             reject(parseResult.error);
           } else {
-            resolve2(parseResult.data);
+            resolve3(parseResult.data);
           }
         } catch (error2) {
           reject(error2);
@@ -14656,12 +14660,12 @@ var Protocol = class {
       }
     } catch {
     }
-    return new Promise((resolve2, reject) => {
+    return new Promise((resolve3, reject) => {
       if (signal.aborted) {
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
         return;
       }
-      const timeoutId = setTimeout(resolve2, interval);
+      const timeoutId = setTimeout(resolve3, interval);
       signal.addEventListener("abort", () => {
         clearTimeout(timeoutId);
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -15483,7 +15487,7 @@ function generateToken() {
   return randomBytes(AUTH_TOKEN_BYTES).toString("hex");
 }
 function findFreePort() {
-  return new Promise((resolve2, reject) => {
+  return new Promise((resolve3, reject) => {
     const srv = net.createServer();
     srv.listen(0, "127.0.0.1", () => {
       const addr = srv.address();
@@ -15494,7 +15498,7 @@ function findFreePort() {
       const port = addr.port;
       srv.close((err) => {
         if (err) reject(err);
-        else resolve2(port);
+        else resolve3(port);
       });
     });
     srv.on("error", reject);
@@ -15536,7 +15540,7 @@ async function isToolsServerHealthy(port, host = "127.0.0.1", timeoutMs = 2e3, t
   }
 }
 function spawnToolsServer(paths, port, options = {}) {
-  return new Promise((resolve2, reject) => {
+  return new Promise((resolve3, reject) => {
     let logFd;
     try {
       fs.mkdirSync(STATE_DIR, { recursive: true });
@@ -15568,7 +15572,7 @@ function spawnToolsServer(paths, port, options = {}) {
         const actualPort = parseInt(match[1], 10);
         rl.close();
         child.stdout?.resume();
-        settle(() => resolve2({ port: actualPort, pid }));
+        settle(() => resolve3({ port: actualPort, pid }));
       }
     });
     child.on("error", (err) => {
@@ -15699,8 +15703,100 @@ async function isRemoteRouted() {
   return url !== null;
 }
 
+// ../argent-tools-client/src/file-inputs.ts
+import { mkdir as mkdir3, stat, writeFile as writeFile3 } from "node:fs/promises";
+import { readFile as readFile3 } from "node:fs/promises";
+import * as path3 from "node:path";
+var FILE_INPUT_MARKER = "__argentFileInput";
+var CLIENT_FILE_MARKER = "__argentClientFile";
+var MAX_CONTENT_BYTES = 32 * 1024 * 1024;
+function interpolatePath(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;
+}
+async function prepareFileInputs(specs, args, opts) {
+  if (!specs || specs.length === 0 || typeof args !== "object" || args === null) {
+    return args;
+  }
+  const record2 = args;
+  let out = null;
+  for (const spec of specs) {
+    if (spec.target in record2 && typeof record2[spec.target] !== "string") continue;
+    const filePath = interpolatePath(spec.path, record2);
+    if (filePath === null) continue;
+    if (spec.target in record2 && record2[spec.target] !== filePath) continue;
+    const wire = { [FILE_INPUT_MARKER]: true, path: filePath };
+    if (spec.kind === "file") {
+      try {
+        const st = await stat(filePath);
+        if (st.isFile()) {
+          wire.size = st.size;
+          wire.mtimeMs = st.mtimeMs;
+          if (opts.includeContent && st.size <= MAX_CONTENT_BYTES) {
+            wire.content = (await readFile3(filePath)).toString("base64");
+          } else if (opts.includeContent) {
+            wire.contentOmitted = "size-limit";
+          }
+        }
+      } catch {
+      }
+    }
+    out = out ?? { ...record2 };
+    out[spec.target] = wire;
+  }
+  return out ?? args;
+}
+function isAllowedClientFilePath(p) {
+  if (!path3.isAbsolute(p)) return false;
+  const segments = p.split(/[\\/]+/);
+  if (segments.includes("..")) return false;
+  const file = segments[segments.length - 1] ?? "";
+  if (!/^[A-Za-z0-9_-]+\.yaml$/.test(file)) return false;
+  return segments[segments.length - 3] === ".argent" && segments[segments.length - 2] === "flows";
+}
+function isClientFileDirective(value) {
+  return !!value && typeof value === "object" && value[CLIENT_FILE_MARKER] === true && typeof value.path === "string" && typeof value.content === "string";
+}
+async function applyClientFileDirectives(result) {
+  const written = [];
+  async function walk(value) {
+    if (isClientFileDirective(value)) {
+      if (!isAllowedClientFilePath(value.path)) return null;
+      try {
+        await mkdir3(path3.dirname(value.path), { recursive: true });
+        await writeFile3(value.path, value.content, "utf8");
+        written.push(value.path);
+        return value.path;
+      } catch {
+        return null;
+      }
+    }
+    if (Array.isArray(value)) {
+      return Promise.all(value.map(walk));
+    }
+    if (value && typeof value === "object") {
+      const out = {};
+      for (const [k, v] of Object.entries(value)) {
+        out[k] = await walk(v);
+      }
+      return out;
+    }
+    return value;
+  }
+  const rewritten = await walk(result);
+  return { result: rewritten, written };
+}
+
 // ../argent-tools-client/src/artifacts.ts
-import { mkdir as mkdir3, readFile as readFile3, rm, stat, writeFile as writeFile3 } from "node:fs/promises";
+import { mkdir as mkdir4, readFile as readFile4, rm, stat as stat2, writeFile as writeFile4 } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { basename, join as join3 } from "node:path";
 import { createHash } from "node:crypto";
@@ -15739,7 +15835,7 @@ function artifactDir(deviceId) {
 async function resolveLocalFile(handle) {
   if (!handle.hostPath) return null;
   try {
-    const st = await stat(handle.hostPath);
+    const st = await stat2(handle.hostPath);
     if (handle.archive) {
       return st.isDirectory() ? handle.hostPath : null;
     }
@@ -15756,7 +15852,7 @@ async function resolveLocalFile(handle) {
 async function downloadAndExtractArchive(handle, data, dir) {
   const tarball = join3(dir, `${sanitizeSegment(handle.filename)}.tar.gz`);
   try {
-    await writeFile3(tarball, data);
+    await writeFile4(tarball, data);
     await execFileAsync("tar", ["-xzf", tarball, "-C", dir]);
     return join3(dir, handle.filename);
   } catch {
@@ -15774,7 +15870,7 @@ async function materializeArtifacts(result, ctx) {
   let dirReady = false;
   async function ensureDir() {
     if (!dirReady) {
-      await mkdir3(dir, { recursive: true });
+      await mkdir4(dir, { recursive: true });
       dirReady = true;
     }
   }
@@ -15783,7 +15879,7 @@ async function materializeArtifacts(result, ctx) {
       const localPath = await resolveLocalFile(value);
       if (localPath) {
         if (value.mimeType.startsWith("image/")) {
-          images.push({ localPath, data: await readFile3(localPath), mimeType: value.mimeType });
+          images.push({ localPath, data: await readFile4(localPath), mimeType: value.mimeType });
         }
         return localPath;
       }
@@ -15799,7 +15895,7 @@ async function materializeArtifacts(result, ctx) {
         }
         if (value.size > 0 && data.length !== value.size) return null;
         const downloadedPath = join3(dir, sanitizeSegment(value.filename));
-        await writeFile3(downloadedPath, data);
+        await writeFile4(downloadedPath, data);
         if (value.mimeType.startsWith("image/")) {
           images.push({ localPath: downloadedPath, data, mimeType: value.mimeType });
         }
@@ -15832,7 +15928,7 @@ function getDeviceIdFromArgs(args) {
 }
 
 // ../argent-mcp/src/content.ts
-import { readFile as readFile4 } from "node:fs/promises";
+import { readFile as readFile5 } from "node:fs/promises";
 var PNG_SIGNATURE = Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]);
 function imageBlock(data, mimeType) {
   return { type: "image", data: data.toString("base64"), mimeType };
@@ -15898,15 +15994,34 @@ function isScreenshotDiffResult(value) {
   if (!isRecord(value)) return false;
   return typeof value.summary === "string";
 }
-async function screenshotDiffToMcpContent(result) {
+async function screenshotDiffToMcpContent(result, ctx) {
   const blocks = [];
-  if (typeof result.contextDiffPath === "string") {
-    const buf = await readFile4(result.contextDiffPath);
-    blocks.push({
-      type: "image",
-      data: buf.toString("base64"),
-      mimeType: "image/png"
-    });
+  let contextDiffPath = result.contextDiffPath;
+  let materializedImages = [];
+  if (ctx) {
+    const { result: rewritten, images } = await materializeArtifacts(result, ctx);
+    contextDiffPath = rewritten.contextDiffPath;
+    materializedImages = images;
+  }
+  if (typeof contextDiffPath === "string") {
+    const fromMaterializer = materializedImages.find((img) => img.localPath === contextDiffPath);
+    if (fromMaterializer) {
+      blocks.push({
+        type: "image",
+        data: fromMaterializer.data.toString("base64"),
+        mimeType: fromMaterializer.mimeType
+      });
+    } else {
+      try {
+        const buf = await readFile5(contextDiffPath);
+        blocks.push({
+          type: "image",
+          data: buf.toString("base64"),
+          mimeType: "image/png"
+        });
+      } catch {
+      }
+    }
   }
   blocks.push({ type: "text", text: result.summary });
   return blocks;
@@ -15945,17 +16060,17 @@ async function flowRunToMcpContent(result, ctx) {
 
 // ../configuration-core/src/flags.ts
 import * as fs2 from "node:fs";
-import * as path3 from "node:path";
+import * as path4 from "node:path";
 import { homedir as homedir3 } from "node:os";
 var PROJECT_MARKERS = [".argent", ".git", "package.json"];
 function resolveProjectRoot(startDir) {
-  const initial = path3.resolve(startDir);
+  const initial = path4.resolve(startDir);
   let current = initial;
   while (true) {
     for (const marker of PROJECT_MARKERS) {
-      if (fs2.existsSync(path3.join(current, marker))) return current;
+      if (fs2.existsSync(path4.join(current, marker))) return current;
     }
-    const parent = path3.dirname(current);
+    const parent = path4.dirname(current);
     if (parent === current) return initial;
     current = parent;
   }
@@ -15963,10 +16078,10 @@ function resolveProjectRoot(startDir) {
 function getFlagsPath(scope, options = {}) {
   const home = options.homeDir ?? homedir3();
   if (scope === "global") {
-    return path3.join(home, ".argent", "flags.json");
+    return path4.join(home, ".argent", "flags.json");
   }
   const cwd = options.cwd ?? process.cwd();
-  return path3.join(resolveProjectRoot(cwd), ".argent", "flags.json");
+  return path4.join(resolveProjectRoot(cwd), ".argent", "flags.json");
 }
 function readFlagsFile(filePath) {
   let raw;
@@ -16005,6 +16120,8 @@ function isFlagEnabled(name, options = {}) {
 var AUTO_SCREENSHOT_TOOLS = /* @__PURE__ */ new Set([
   "gesture-tap",
   "gesture-swipe",
+  "gesture-scroll",
+  "gesture-drag",
   "gesture-custom",
   "gesture-pinch",
   "gesture-rotate",
@@ -16022,6 +16139,8 @@ var AUTO_SCREENSHOT_DELAY_MS_BY_TOOL = {
   "restart-app": 3e3,
   "open-url": 2e3,
   "gesture-swipe": 1500,
+  "gesture-scroll": 1500,
+  "gesture-drag": 1500,
   "gesture-custom": 1500,
   "gesture-tap": 1500,
   "gesture-pinch": 1500,
@@ -16074,6 +16193,19 @@ function toMcpTool(t) {
   };
 }
 
+// ../argent-mcp/src/installed-version.ts
+import * as fs3 from "node:fs";
+import * as path5 from "node:path";
+function getInstalledVersion() {
+  try {
+    const pkgPath = path5.resolve(import.meta.dirname, "..", "package.json");
+    const pkg = JSON.parse(fs3.readFileSync(pkgPath, "utf8"));
+    return pkg.version ?? "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+
 // ../argent-mcp/src/mcp-server.ts
 var MAX_RETRIES = 4;
 var EXP_BACKOFF_BASE = 250;
@@ -16144,7 +16276,7 @@ async function startMcpServer(options) {
   async function spyLog(entry) {
     try {
       if (!logDirReady) {
-        await mkdir4(dirname2(LOG_FILE2), { recursive: true });
+        await mkdir5(dirname3(LOG_FILE2), { recursive: true });
         logDirReady = true;
       }
       await appendFile(LOG_FILE2, JSON.stringify(entry) + "\n");
@@ -16161,23 +16293,33 @@ async function startMcpServer(options) {
   async function callTool(name, args) {
     const tools = await fetchTools();
     const meta2 = tools.find((t) => t.name === name);
+    let finalArgs = args;
+    if (meta2?.fileInputs?.length) {
+      finalArgs = await prepareFileInputs(meta2.fileInputs, args ?? {}, {
+        // `resolved` is the startup routing decision that picked TOOLS_URL —
+        // an external target means this process may not share the server's
+        // filesystem, so file bytes must ride along.
+        includeContent: resolved.url !== null
+      });
+    }
     const res = await fetchWithReconnect(() => `${TOOLS_URL}/tools/${name}`, reconnect, {
       init: {
         method: "POST",
         headers: { "Content-Type": "application/json", ...authHeader() },
-        body: JSON.stringify(args ?? {})
+        body: JSON.stringify(finalArgs ?? {})
       },
       fetchTimeoutMs: meta2?.longRunning ? null : FETCH_TIMEOUT_MS
     });
     const json = await res.json();
     if (!res.ok) throw new Error(json.error ?? json.message ?? res.statusText);
-    return { result: json.data, outputHint: meta2?.outputHint, note: json.note };
+    const { result: data } = await applyClientFileDirectives(json.data);
+    return { result: data, outputHint: meta2?.outputHint, note: json.note };
   }
   const server = new Server(
-    { name: "argent", version: "0.5.3" },
+    { name: "argent", version: getInstalledVersion() },
     {
       capabilities: { tools: {} },
-      instructions: "Argent \u2014 iOS Simulator and Android Emulator control for interacting, testing, profiling and debugging mobile applications. Always use discovery tools (describe / debugger-component-tree / screenshot) before tapping \u2014 never guess coordinates. On session end: call stop-all-simulator-servers and perform any necessary cleanup. Full guidance is in the argent rule loaded from .claude/rules/argent.md."
+      instructions: "Argent \u2014 iOS Simulator, Android Emulator, and Chromium app control for interacting, testing, profiling and debugging mobile and Chromium applications. Always use discovery tools (describe / debugger-component-tree / screenshot) before tapping \u2014 never guess coordinates. On session end: call stop-all-simulator-servers and perform any necessary cleanup. Full guidance is in the argent rule loaded from .claude/rules/argent.md."
     }
   );
   server.setRequestHandler(ListToolsRequestSchema, async () => {
@@ -16224,7 +16366,7 @@ async function startMcpServer(options) {
       if (params.name === "flow-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);
+        content = await screenshotDiffToMcpContent(result, ctx);
       } else {
         content = await toMcpContent(result, outputHint, ctx, params.arguments);
       }