@swmansion/argent 0.14.1-next.2 → 0.14.1-next.21

package/dist/mcp-server.mjs

@@ -1,4 +1,4 @@
-import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
+import { createRequire as __createRequire } from 'node:module'; import { fileURLToPath as __fileURLToPath } from 'node:url'; import { dirname as __pathDirname } from 'node:path'; const require = __createRequire(import.meta.url); const __filename = __fileURLToPath(import.meta.url); const __dirname = __pathDirname(__filename);
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -2984,7 +2984,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve3.call(this, root, ref);
+      let _sch = resolve4.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;
@@ -3011,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 resolve3(root, ref) {
+    function resolve4(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -3229,8 +3229,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path10) {
-      let input = path10;
+    function removeDotSegments(path11) {
+      let input = path11;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -3482,8 +3482,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path10, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path10 && path10 !== "/" ? path10 : void 0;
+        const [path11, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path11 && path11 !== "/" ? path11 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -3642,55 +3642,55 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve3(baseURI, relativeURI, options) {
+    function resolve4(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;
       return serialize(resolved, schemelessOptions);
     }
-    function resolveComponent(base, relative, options, skipNormalization) {
+    function resolveComponent(base, relative2, options, skipNormalization) {
       const target = {};
       if (!skipNormalization) {
         base = parse3(serialize(base, options), options);
-        relative = parse3(serialize(relative, options), options);
+        relative2 = parse3(serialize(relative2, options), options);
       }
       options = options || {};
-      if (!options.tolerant && relative.scheme) {
-        target.scheme = relative.scheme;
-        target.userinfo = relative.userinfo;
-        target.host = relative.host;
-        target.port = relative.port;
-        target.path = removeDotSegments(relative.path || "");
-        target.query = relative.query;
+      if (!options.tolerant && relative2.scheme) {
+        target.scheme = relative2.scheme;
+        target.userinfo = relative2.userinfo;
+        target.host = relative2.host;
+        target.port = relative2.port;
+        target.path = removeDotSegments(relative2.path || "");
+        target.query = relative2.query;
       } else {
-        if (relative.userinfo !== void 0 || relative.host !== void 0 || relative.port !== void 0) {
-          target.userinfo = relative.userinfo;
-          target.host = relative.host;
-          target.port = relative.port;
-          target.path = removeDotSegments(relative.path || "");
-          target.query = relative.query;
+        if (relative2.userinfo !== void 0 || relative2.host !== void 0 || relative2.port !== void 0) {
+          target.userinfo = relative2.userinfo;
+          target.host = relative2.host;
+          target.port = relative2.port;
+          target.path = removeDotSegments(relative2.path || "");
+          target.query = relative2.query;
         } else {
-          if (!relative.path) {
+          if (!relative2.path) {
             target.path = base.path;
-            if (relative.query !== void 0) {
-              target.query = relative.query;
+            if (relative2.query !== void 0) {
+              target.query = relative2.query;
             } else {
               target.query = base.query;
             }
           } else {
-            if (relative.path[0] === "/") {
-              target.path = removeDotSegments(relative.path);
+            if (relative2.path[0] === "/") {
+              target.path = removeDotSegments(relative2.path);
             } else {
               if ((base.userinfo !== void 0 || base.host !== void 0 || base.port !== void 0) && !base.path) {
-                target.path = "/" + relative.path;
+                target.path = "/" + relative2.path;
               } else if (!base.path) {
-                target.path = relative.path;
+                target.path = relative2.path;
               } else {
-                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative.path;
+                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative2.path;
               }
               target.path = removeDotSegments(target.path);
             }
-            target.query = relative.query;
+            target.query = relative2.query;
           }
           target.userinfo = base.userinfo;
           target.host = base.host;
@@ -3698,7 +3698,7 @@ var require_fast_uri = __commonJS({
         }
         target.scheme = base.scheme;
       }
-      target.fragment = relative.fragment;
+      target.fragment = relative2.fragment;
       return target;
     }
     function equal(uriA, uriB, options) {
@@ -3900,7 +3900,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize,
-      resolve: resolve3,
+      resolve: resolve4,
       resolveComponent,
       equal,
       serialize,
@@ -6876,12 +6876,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f;
     };
-    function addFormats(ajv, list, fs8, exportName) {
+    function addFormats(ajv, list, fs9, 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, fs8[f]);
+        ajv.addFormat(f, fs9[f]);
     }
     module.exports = exports = formatsPlugin;
     Object.defineProperty(exports, "__esModule", { value: true });
@@ -6891,7 +6891,7 @@ var require_dist = __commonJS({
 
 // ../argent-mcp/src/mcp-server.ts
 import { appendFile, mkdir as mkdir5 } from "node:fs/promises";
-import { dirname as dirname3 } from "node:path";
+import { dirname as dirname4 } from "node:path";
 import { homedir as homedir5 } from "node:os";
 
 // ../../node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
@@ -7137,10 +7137,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path10) {
-  if (!path10)
+function getElementAtPath(obj, path11) {
+  if (!path11)
     return obj;
-  return path10.reduce((acc, key) => acc?.[key], obj);
+  return path11.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -7549,11 +7549,11 @@ function explicitlyAborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path10, issues) {
+function prefixIssues(path11, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path10);
+    iss.path.unshift(path11);
     return iss;
   });
 }
@@ -7700,16 +7700,16 @@ function flattenError(error2, mapper = (issue2) => issue2.message) {
 }
 function formatError(error2, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error3, path10 = []) => {
+  const processError = (error3, path11 = []) => {
     for (const issue2 of error3.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path10, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path11, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path10, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path11, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path10, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path11, ...issue2.path]);
       } else {
-        const fullpath = [...path10, ...issue2.path];
+        const fullpath = [...path11, ...issue2.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue2));
         } else {
@@ -13701,12 +13701,12 @@ var StdioServerTransport = class {
     this.onclose?.();
   }
   send(message) {
-    return new Promise((resolve3) => {
+    return new Promise((resolve4) => {
       const json = serializeMessage(message);
       if (this._stdout.write(json)) {
-        resolve3();
+        resolve4();
       } else {
-        this._stdout.once("drain", resolve3);
+        this._stdout.once("drain", resolve4);
       }
     });
   }
@@ -14304,7 +14304,7 @@ var Protocol = class {
           return;
         }
         const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-        await new Promise((resolve3) => setTimeout(resolve3, pollInterval));
+        await new Promise((resolve4) => setTimeout(resolve4, pollInterval));
         options?.signal?.throwIfAborted();
       }
     } catch (error2) {
@@ -14321,7 +14321,7 @@ var Protocol = class {
    */
   request(request, resultSchema, options) {
     const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-    return new Promise((resolve3, reject) => {
+    return new Promise((resolve4, reject) => {
       const earlyReject = (error2) => {
         reject(error2);
       };
@@ -14399,7 +14399,7 @@ var Protocol = class {
           if (!parseResult.success) {
             reject(parseResult.error);
           } else {
-            resolve3(parseResult.data);
+            resolve4(parseResult.data);
           }
         } catch (error2) {
           reject(error2);
@@ -14660,12 +14660,12 @@ var Protocol = class {
       }
     } catch {
     }
-    return new Promise((resolve3, reject) => {
+    return new Promise((resolve4, reject) => {
       if (signal.aborted) {
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
         return;
       }
-      const timeoutId = setTimeout(resolve3, interval);
+      const timeoutId = setTimeout(resolve4, interval);
       signal.addEventListener("abort", () => {
         clearTimeout(timeoutId);
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -15461,8 +15461,8 @@ import * as path from "node:path";
 import * as readline from "node:readline";
 import { homedir } from "node:os";
 import { spawn, execFileSync } from "node:child_process";
-import { randomBytes } from "node:crypto";
-import { mkdir, writeFile, readFile, unlink, rename, chmod } from "node:fs/promises";
+import { createHash, randomBytes } from "node:crypto";
+import { mkdir, writeFile, readFile, readdir, unlink, rename, chmod } from "node:fs/promises";
 var STATE_DIR = path.join(homedir(), ".argent");
 var STATE_FILE = path.join(STATE_DIR, "tool-server.json");
 var LOG_FILE = path.join(STATE_DIR, "tool-server.log");
@@ -15482,13 +15482,15 @@ function buildToolsServerEnv(paths, port, baseEnv = process.env, options = {}) {
     env.ARGENT_IDLE_TIMEOUT_MINUTES = String(options.idleTimeoutMinutes);
   }
   if (options.token) env[AUTH_TOKEN_ENV] = options.token;
+  if (paths.installKind) env.ARGENT_INSTALL_KIND = paths.installKind;
+  if (paths.installProjectRoot) env.ARGENT_PROJECT_ROOT = paths.installProjectRoot;
   return env;
 }
 function generateToken() {
   return randomBytes(AUTH_TOKEN_BYTES).toString("hex");
 }
 function findFreePort() {
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve4, reject) => {
     const srv = net.createServer();
     srv.listen(0, "127.0.0.1", () => {
       const addr = srv.address();
@@ -15499,12 +15501,55 @@ function findFreePort() {
       const port = addr.port;
       srv.close((err) => {
         if (err) reject(err);
-        else resolve3(port);
+        else resolve4(port);
       });
     });
     srv.on("error", reject);
   });
 }
+function isVersionNewer(a, b) {
+  const parse3 = (v) => {
+    const [core = "", ...preParts] = v.split("+")[0].split("-");
+    const nums = core.split(".").map((n) => Number.parseInt(n, 10));
+    if (nums.length === 0 || nums.some((n) => Number.isNaN(n))) return null;
+    return { nums, pre: preParts.length > 0 ? preParts.join("-").split(".") : [] };
+  };
+  const pa = parse3(a);
+  const pb = parse3(b);
+  if (!pa || !pb) return false;
+  for (let i = 0; i < 3; i++) {
+    const x = pa.nums[i] ?? 0;
+    const y = pb.nums[i] ?? 0;
+    if (x !== y) return x > y;
+  }
+  if (pa.pre.length === 0 && pb.pre.length === 0) return false;
+  if (pa.pre.length === 0) return true;
+  if (pb.pre.length === 0) return false;
+  for (let i = 0; i < Math.max(pa.pre.length, pb.pre.length); i++) {
+    const x = pa.pre[i];
+    const y = pb.pre[i];
+    if (x === void 0) return false;
+    if (y === void 0) return true;
+    if (x === y) continue;
+    const xn = /^\d+$/.test(x) ? Number.parseInt(x, 10) : null;
+    const yn = /^\d+$/.test(y) ? Number.parseInt(y, 10) : null;
+    if (xn !== null && yn !== null) return xn > yn;
+    if (xn !== null) return false;
+    if (yn !== null) return true;
+    return x > y;
+  }
+  return false;
+}
+function readBundlePackageVersion(bundlePath) {
+  try {
+    const pkg = JSON.parse(
+      fs.readFileSync(path.join(path.dirname(bundlePath), "..", "package.json"), "utf8")
+    );
+    return typeof pkg.version === "string" ? pkg.version : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function isProcessAlive(pid) {
   try {
     process.kill(pid, 0);
@@ -15554,7 +15599,7 @@ function killSpawnedChild(child, pid) {
   }
 }
 function spawnToolsServer(paths, port, options = {}) {
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve4, reject) => {
     let logFd;
     try {
       fs.mkdirSync(STATE_DIR, { recursive: true });
@@ -15590,7 +15635,8 @@ function spawnToolsServer(paths, port, options = {}) {
         const actualPort = parseInt(match[1], 10);
         rl.close();
         child.stdout?.resume();
-        settle(() => resolve3({ port: actualPort, pid }));
+        child.stdout?.unref?.();
+        settle(() => resolve4({ port: actualPort, pid }));
       }
     });
     child.on("error", (err) => {
@@ -15608,39 +15654,83 @@ function spawnToolsServer(paths, port, options = {}) {
     rl.on("close", () => clearTimeout(timer));
   });
 }
-async function readToolsServerState() {
+function stateFileForBundle(bundlePath) {
+  const key = createHash("sha256").update(bundlePath).digest("hex").slice(0, 12);
+  return path.join(STATE_DIR, `tool-server-${key}.json`);
+}
+async function readStateFile(file) {
   try {
-    const raw = await readFile(STATE_FILE, "utf8");
+    const raw = await readFile(file, "utf8");
     return JSON.parse(raw);
   } catch {
     return null;
   }
 }
+async function readToolsServerState(bundlePath) {
+  if (bundlePath === void 0) return readStateFile(STATE_FILE);
+  const own = await readStateFile(stateFileForBundle(bundlePath));
+  if (own) return own;
+  const legacy = await readStateFile(STATE_FILE);
+  return legacy && legacy.bundlePath === bundlePath ? legacy : null;
+}
 async function writeToolsServerState(state) {
+  const target = stateFileForBundle(state.bundlePath);
   await mkdir(STATE_DIR, { recursive: true });
-  const tmp = `${STATE_FILE}.${process.pid}.tmp`;
+  const tmp = `${target}.${process.pid}.tmp`;
   try {
     await writeFile(tmp, JSON.stringify(state, null, 2) + "\n", {
       encoding: "utf8",
       mode: 384
     });
     await chmod(tmp, 384);
-    await rename(tmp, STATE_FILE);
+    await rename(tmp, target);
   } catch (err) {
     await unlink(tmp).catch(() => {
     });
     throw err;
   }
 }
-async function clearToolsServerState() {
+async function clearToolsServerState(bundlePath) {
+  const files = [STATE_FILE];
+  if (bundlePath !== void 0) {
+    files[0] = stateFileForBundle(bundlePath);
+    const legacy = await readStateFile(STATE_FILE);
+    if (legacy && legacy.bundlePath === bundlePath) files.push(STATE_FILE);
+  }
+  for (const file of files) {
+    try {
+      await unlink(file);
+    } catch {
+    }
+  }
+}
+var STATE_FILE_RE = /^tool-server(-[0-9a-f]{12})?\.json$/;
+async function readAllToolsServerStates() {
+  let names;
   try {
-    await unlink(STATE_FILE);
+    names = await readdir(STATE_DIR);
   } catch {
+    return [];
+  }
+  const out = [];
+  for (const name of names) {
+    if (!STATE_FILE_RE.test(name)) continue;
+    const file = path.join(STATE_DIR, name);
+    const state = await readStateFile(file);
+    if (state) out.push({ file, state });
+  }
+  return out;
+}
+async function sweepDeadStateFiles() {
+  for (const { file } of await readAllToolsServerStates()) {
+    if (file === STATE_FILE) continue;
+    const fresh = await readStateFile(file);
+    if (fresh && !isProcessAlive(fresh.pid)) await unlink(file).catch(() => {
+    });
   }
 }
 var readState = readToolsServerState;
 var writeState = writeToolsServerState;
-var clearState = clearToolsServerState;
 var SIGTERM_GRACE_MS = 6e3;
 var SIGKILL_GRACE_MS = 1e3;
 var KILL_POLL_MS = 100;
@@ -15678,8 +15768,8 @@ function processCommandMatches(pid, marker) {
       stdio: ["ignore", "pipe", "ignore"]
     }).trim();
     if (!cmd) return false;
-    const argv = cmd.split(/\s+/);
-    return argv.includes(marker) && argv.includes("start");
+    const escaped = marker.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    return new RegExp(`(?:^|\\s)${escaped} start(?:\\s|$)`).test(cmd);
   } catch {
     return false;
   }
@@ -15743,25 +15833,45 @@ async function acquireSpawnLock() {
     }
   }
 }
-async function reusableHandle(state) {
+async function reusableHandle(state, wantBundlePath, wantVersion) {
   if (!state || !isProcessAlive(state.pid)) return null;
+  if (wantBundlePath !== void 0 && state.bundlePath !== wantBundlePath) return null;
+  if (wantBundlePath !== void 0 && state.version !== void 0) {
+    const diskVersion = readBundlePackageVersion(wantBundlePath);
+    if (diskVersion !== void 0) {
+      if (diskVersion !== state.version) return null;
+    } else if (wantVersion !== void 0 && state.version !== wantVersion && isVersionNewer(wantVersion, state.version)) {
+      return null;
+    }
+  }
   const host = state.host ?? "127.0.0.1";
   const healthy = await isToolsServerHealthy(state.port, host, 2e3, state.token);
   if (!healthy) return null;
   return { url: formatUrl(healthCheckHost(host), state.port), token: state.token ?? "" };
 }
 async function ensureToolsServer(paths) {
-  const fast = await reusableHandle(await readState());
+  const fast = await reusableHandle(
+    await readState(paths.bundlePath),
+    paths.bundlePath,
+    paths.version
+  );
   if (fast) return fast;
   const lock = await acquireSpawnLock();
   try {
-    const state = await readState();
-    const reuse = await reusableHandle(state);
+    const state = await readState(paths.bundlePath);
+    const reuse = await reusableHandle(state, paths.bundlePath, paths.version);
     if (reuse) return reuse;
-    if (state && state.managed === "autospawn" && isProcessAlive(state.pid) && processCommandMatches(state.pid, state.bundlePath)) {
+    if (state && state.managed === "autospawn" && state.bundlePath === paths.bundlePath && isProcessAlive(state.pid) && processCommandMatches(state.pid, state.bundlePath)) {
       await terminatePid(state.pid, () => processCommandMatches(state.pid, state.bundlePath));
     }
-    await clearState();
+    await clearToolsServerState(paths.bundlePath);
+    await sweepDeadStateFiles();
+    if (!fs.existsSync(paths.bundlePath)) {
+      throw new Error(
+        `The argent install serving this session is gone from disk (${paths.bundlePath}) \u2014 it was likely updated or removed. Restart the editor's MCP connection to reconnect.`
+      );
+    }
+    const diskVersion = readBundlePackageVersion(paths.bundlePath) ?? paths.version;
     const token = generateToken();
     const port = await findFreePort();
     const { port: actualPort, pid } = await spawnToolsServer(paths, port, {
@@ -15773,6 +15883,7 @@ async function ensureToolsServer(paths) {
       pid,
       startedAt: (/* @__PURE__ */ new Date()).toISOString(),
       bundlePath: paths.bundlePath,
+      version: diskVersion,
       host: "127.0.0.1",
       token,
       managed: "autospawn"
@@ -15926,7 +16037,7 @@ async function applyClientFileDirectives(result) {
 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";
+import { createHash as createHash2 } from "node:crypto";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 var execFileAsync = promisify(execFile);
@@ -15947,7 +16058,7 @@ function sanitizeSegment(segment) {
 }
 function projectSlug() {
   const cwd = process.cwd();
-  const hash = createHash("sha1").update(cwd).digest("hex").slice(0, 6);
+  const hash = createHash2("sha1").update(cwd).digest("hex").slice(0, 6);
   const name = sanitizeSegment(basename(cwd)) || "root";
   return `${name}-${hash}`;
 }
@@ -17298,6 +17409,9 @@ var FAILURE_CODES = {
   TOOLSERVER_UNHANDLED_REJECTION: "TOOLSERVER_UNHANDLED_REJECTION",
   TOOLSERVER_UNCAUGHT_EXCEPTION: "TOOLSERVER_UNCAUGHT_EXCEPTION",
   INSTALL_GLOBAL_PACKAGE_FAILED: "INSTALL_GLOBAL_PACKAGE_FAILED",
+  INSTALL_LOCAL_PACKAGE_FAILED: "INSTALL_LOCAL_PACKAGE_FAILED",
+  INSTALL_LOCAL_PRECONDITION_FAILED: "INSTALL_LOCAL_PRECONDITION_FAILED",
+  INSTALL_MODE_FLAG_CONFLICT: "INSTALL_MODE_FLAG_CONFLICT",
   INSTALL_FROM_TAR_PACKAGE_FAILED: "INSTALL_FROM_TAR_PACKAGE_FAILED",
   INSTALL_INIT_TRIGGERED_UPDATE_FAILED: "INSTALL_INIT_TRIGGERED_UPDATE_FAILED",
   INSTALL_SKILLS_REFRESH_FAILED: "INSTALL_SKILLS_REFRESH_FAILED",
@@ -17313,6 +17427,14 @@ var FAILURE_CODES = {
   UNINSTALL_UNCLASSIFIED_FAILED: "UNINSTALL_UNCLASSIFIED_FAILED",
   VEGA_CLI_COMMAND_FAILED: "VEGA_CLI_COMMAND_FAILED",
   VEGA_INPUT_UNAVAILABLE: "VEGA_INPUT_UNAVAILABLE",
+  VEGA_DEVICE_NOT_FOUND: "VEGA_DEVICE_NOT_FOUND",
+  VEGA_DEVICE_NOT_REGISTERED: "VEGA_DEVICE_NOT_REGISTERED",
+  VEGA_MULTIPLE_DEVICES: "VEGA_MULTIPLE_DEVICES",
+  VEGA_BOOT_TIMEOUT: "VEGA_BOOT_TIMEOUT",
+  VEGA_IMAGE_NOT_FOUND: "VEGA_IMAGE_NOT_FOUND",
+  VEGA_ALREADY_RUNNING: "VEGA_ALREADY_RUNNING",
+  VEGA_SCREENSHOT_FAILED: "VEGA_SCREENSHOT_FAILED",
+  VEGA_TEXT_INVALID: "VEGA_TEXT_INVALID",
   ANDROID_ADB_NOT_FOUND: "ANDROID_ADB_NOT_FOUND",
   ANDROID_EMULATOR_NOT_FOUND: "ANDROID_EMULATOR_NOT_FOUND",
   ANDROID_ADB_COMMAND_FAILED: "ANDROID_ADB_COMMAND_FAILED",
@@ -17325,6 +17447,7 @@ var FAILURE_CODES = {
   SIMULATOR_NON_JSON_RESPONSE: "SIMULATOR_NON_JSON_RESPONSE",
   SIMULATOR_HTTP_ERROR_RESPONSE: "SIMULATOR_HTTP_ERROR_RESPONSE",
   SIMULATOR_MISSING_RESPONSE_FIELDS: "SIMULATOR_MISSING_RESPONSE_FIELDS",
+  SIMULATOR_SCREENSHOT_FAILED: "SIMULATOR_SCREENSHOT_FAILED",
   SIMULATOR_SERVER_FACTORY_OPTIONS_MISSING: "SIMULATOR_SERVER_FACTORY_OPTIONS_MISSING",
   SIMULATOR_SERVER_DEVICE_ID_INVALID: "SIMULATOR_SERVER_DEVICE_ID_INVALID",
   SIMULATOR_SERVER_READY_EXITED: "SIMULATOR_SERVER_READY_EXITED",
@@ -17378,6 +17501,7 @@ var FAILURE_CODES = {
   ANDROID_SCREEN_SIZE_PARSE_FAILED: "ANDROID_SCREEN_SIZE_PARSE_FAILED",
   ANDROID_SCREEN_SIZE_NON_POSITIVE: "ANDROID_SCREEN_SIZE_NON_POSITIVE",
   ANDROID_UIAUTOMATOR_PARSE_FAILED: "ANDROID_UIAUTOMATOR_PARSE_FAILED",
+  ANDROID_UIAUTOMATOR_CAPTURE_FAILED: "ANDROID_UIAUTOMATOR_CAPTURE_FAILED",
   DEBUGGER_METRO_NOT_RUNNING: "DEBUGGER_METRO_NOT_RUNNING",
   DEBUGGER_METRO_PROJECT_ROOT_MISSING: "DEBUGGER_METRO_PROJECT_ROOT_MISSING",
   DEBUGGER_METRO_NO_TARGETS: "DEBUGGER_METRO_NO_TARGETS",
@@ -17422,8 +17546,19 @@ var FAILURE_CODES = {
   NATIVE_PROFILER_XCTRACE_READY_EXITED: "NATIVE_PROFILER_XCTRACE_READY_EXITED",
   NATIVE_PROFILER_XCTRACE_PROCESS_ERROR: "NATIVE_PROFILER_XCTRACE_PROCESS_ERROR",
   NATIVE_PROFILER_XCTRACE_READY_TIMEOUT: "NATIVE_PROFILER_XCTRACE_READY_TIMEOUT",
+  NATIVE_PROFILER_TRACE_TEMPLATE_MISSING: "NATIVE_PROFILER_TRACE_TEMPLATE_MISSING",
   NATIVE_PROFILER_NO_ACTIVE_SESSION: "NATIVE_PROFILER_NO_ACTIVE_SESSION",
+  NATIVE_PROFILER_APP_PROCESS_NOT_FOUND: "NATIVE_PROFILER_APP_PROCESS_NOT_FOUND",
+  NATIVE_PROFILER_NO_EXPORTED_TRACE: "NATIVE_PROFILER_NO_EXPORTED_TRACE",
+  // Android perfetto start-failure modes — mirror the iOS xctrace set so a
+  // failed recording start is classified rather than falling through to the
+  // generic tool-execution bucket.
+  NATIVE_PROFILER_PERFETTO_PROCESS_ERROR: "NATIVE_PROFILER_PERFETTO_PROCESS_ERROR",
+  NATIVE_PROFILER_PERFETTO_READY_TIMEOUT: "NATIVE_PROFILER_PERFETTO_READY_TIMEOUT",
+  NATIVE_PROFILER_PERFETTO_READY_EXITED: "NATIVE_PROFILER_PERFETTO_READY_EXITED",
   FLOW_PROJECT_ROOT_REQUIRED: "FLOW_PROJECT_ROOT_REQUIRED",
+  FLOW_PROJECT_ROOT_INVALID: "FLOW_PROJECT_ROOT_INVALID",
+  FLOW_NAME_INVALID: "FLOW_NAME_INVALID",
   FLOW_NO_ACTIVE_RECORDING: "FLOW_NO_ACTIVE_RECORDING",
   FLOW_FILE_INVALID: "FLOW_FILE_INVALID",
   FLOW_ENTRY_UNRECOGNIZED: "FLOW_ENTRY_UNRECOGNIZED",
@@ -17431,6 +17566,27 @@ var FAILURE_CODES = {
   PROFILER_QUERY_REQUIRED_PARAM_MISSING: "PROFILER_QUERY_REQUIRED_PARAM_MISSING",
   PROFILER_DATA_NOT_LOADED: "PROFILER_DATA_NOT_LOADED",
   PROFILER_NATIVE_TRACE_MISSING: "PROFILER_NATIVE_TRACE_MISSING",
+  PROFILER_NATIVE_METADATA_MISSING: "PROFILER_NATIVE_METADATA_MISSING",
+  PROFILER_NATIVE_METADATA_INVALID: "PROFILER_NATIVE_METADATA_INVALID",
+  CHROMIUM_CDP_UNREACHABLE: "CHROMIUM_CDP_UNREACHABLE",
+  CHROMIUM_CDP_NO_PAGE_TARGET: "CHROMIUM_CDP_NO_PAGE_TARGET",
+  CHROMIUM_CDP_INVALID_RESPONSE: "CHROMIUM_CDP_INVALID_RESPONSE",
+  CHROMIUM_DEVICE_ID_INVALID: "CHROMIUM_DEVICE_ID_INVALID",
+  CHROMIUM_PARAM_INVALID: "CHROMIUM_PARAM_INVALID",
+  CHROMIUM_INPUT_INVALID: "CHROMIUM_INPUT_INVALID",
+  CHROMIUM_VIEWPORT_READ_FAILED: "CHROMIUM_VIEWPORT_READ_FAILED",
+  CHROMIUM_SCREENSHOT_FAILED: "CHROMIUM_SCREENSHOT_FAILED",
+  CHROMIUM_STORAGE_EVAL_FAILED: "CHROMIUM_STORAGE_EVAL_FAILED",
+  CHROMIUM_TAB_NOT_FOUND: "CHROMIUM_TAB_NOT_FOUND",
+  CHROMIUM_TAB_OPEN_FAILED: "CHROMIUM_TAB_OPEN_FAILED",
+  CHROMIUM_DESCRIBE_FAILED: "CHROMIUM_DESCRIBE_FAILED",
+  CHROMIUM_ELECTRON_APP_PATH_INVALID: "CHROMIUM_ELECTRON_APP_PATH_INVALID",
+  CHROMIUM_ELECTRON_SPAWN_FAILED: "CHROMIUM_ELECTRON_SPAWN_FAILED",
+  CHROMIUM_ELECTRON_CDP_TIMEOUT: "CHROMIUM_ELECTRON_CDP_TIMEOUT",
+  CHROMIUM_ELECTRON_EXITED_BEFORE_READY: "CHROMIUM_ELECTRON_EXITED_BEFORE_READY",
+  KEYBOARD_KEY_UNSUPPORTED: "KEYBOARD_KEY_UNSUPPORTED",
+  KEYBOARD_CHARACTER_UNSUPPORTED: "KEYBOARD_CHARACTER_UNSUPPORTED",
+  SCREENSHOT_DIFF_INPUT_INVALID: "SCREENSHOT_DIFF_INPUT_INVALID",
   BOOT_DEVICE_TARGET_SELECTION_INVALID: "BOOT_DEVICE_TARGET_SELECTION_INVALID",
   BOOT_IOS_UNSUPPORTED_HOST: "BOOT_IOS_UNSUPPORTED_HOST",
   BOOT_ANDROID_NO_AVDS: "BOOT_ANDROID_NO_AVDS",
@@ -17469,6 +17625,7 @@ var FAILURE_COMMANDS = [
   "ax_service",
   "simulator_server",
   "cdp",
+  "electron",
   "npm",
   "npx",
   "unknown"
@@ -17502,7 +17659,15 @@ var FAILURE_SPAWN_CODE_SET = new Set(FAILURE_SPAWN_CODES);
 import { randomUUID as randomUUID2 } from "node:crypto";
 
 // ../telemetry/src/events.ts
-var PLATFORMS = ["ios", "ios-remote", "android", "chromium", "vega"];
+var PLATFORMS = [
+  "ios",
+  "ios-remote",
+  "android",
+  "chromium",
+  "vega",
+  "tvos",
+  "android-tv"
+];
 
 // ../telemetry/src/ai-identity.ts
 var AI_CLIENTS = [
@@ -17589,6 +17754,7 @@ var FAILURE_SIGNAL_NAME = oneOf(FAILURE_SIGNAL_NAMES);
 var FAILURE_SPAWN_CODE = oneOf(FAILURE_SPAWN_CODES);
 var NETWORK_FAILURE = oneOf(NETWORK_FAILURES);
 var AI_CLIENT = oneOf(AI_CLIENTS);
+var INSTALL_MODE = oneOf(["global", "local"]);
 var AI_TELEMETRY = {
   ai_client: AI_CLIENT
 };
@@ -17612,10 +17778,21 @@ var ALLOWED = {
     duration_ms: DURATION_MS,
     is_success: bool,
     editors_configured_count: COUNT,
+    install_mode: INSTALL_MODE,
     ...FAILURE_SIGNAL
   },
   "installation:cli_init_cancel": {
-    step: oneOf(["global_install", "editors", "scope", "skills", "allowlist"])
+    step: oneOf([
+      "global_install",
+      "editors",
+      "scope",
+      "skills",
+      "allowlist",
+      "install_mode"
+    ])
+  },
+  "installation:install_mode_decision": {
+    install_mode: INSTALL_MODE
   },
   "installation:global_install_decision": {
     // `from_tar` is intentionally absent; the installer skips that dev path.
@@ -17629,11 +17806,16 @@ var ALLOWED = {
   "installation:editors_select": {
     editors: arrayOf(ADAPTER_NAME),
     detected_editor_count: COUNT,
-    scope: oneOf(["local", "global", "custom"])
+    scope: oneOf(["local", "global", "custom"]),
+    install_mode: INSTALL_MODE
   },
   "installation:allowlist_decision": {
     is_enabled: bool
   },
+  "installation:stale_config_cleanup": {
+    removed_count: COUNT,
+    warned_count: COUNT
+  },
   "installation:skill_install": {
     method: oneOf(["default", "interactive", "manual"]),
     is_online: bool,
@@ -17657,16 +17839,19 @@ var ALLOWED = {
   },
   "installation:cli_update_start": {},
   "installation:cli_update_complete": {
-    duration_ms: DURATION_MS
+    duration_ms: DURATION_MS,
+    install_mode: INSTALL_MODE
   },
   "installation:cli_update_fail": {
     duration_ms: DURATION_MS,
+    install_mode: INSTALL_MODE,
     ...FAILURE_SIGNAL
   },
   "installation:cli_uninstall_start": {},
   "installation:cli_uninstall_complete": {
     has_pruned_content: bool,
     has_uninstalled_package: bool,
+    install_mode: INSTALL_MODE,
     ...FAILURE_SIGNAL
   },
   "tool:invoke": {
@@ -18249,14 +18434,25 @@ function updateConfig(mutate) {
   }
 }
 
-// ../telemetry/src/consent.ts
+// ../telemetry/src/fingerprint.ts
+import { execFileSync as execFileSync2, spawn as spawn2 } from "node:child_process";
+
+// ../native-devtools-ios/src/index.ts
+import * as path9 from "node:path";
 import * as fs5 from "node:fs";
+var DYLIB_DIR = process.env.ARGENT_NATIVE_DEVTOOLS_DIR ?? path9.join(__dirname, "..", "dylibs");
+var BIN_DIR = process.env.ARGENT_SIMULATOR_SERVER_DIR ?? path9.join(__dirname, "..", "bin");
+var DYLIB_TCP_DIR = process.env.ARGENT_NATIVE_DEVTOOLS_TCP_DIR ?? path9.join(DYLIB_DIR, "tcp");
+var DYLIB_TVOS_DIR = path9.join(DYLIB_DIR, "tvos");
+
+// ../telemetry/src/consent.ts
+import * as fs6 from "node:fs";
 var cache = { current: null };
 var sessionOverride = null;
 function readConfigOverride() {
   let stats;
   try {
-    stats = fs5.lstatSync(configFilePath());
+    stats = fs6.lstatSync(configFilePath());
   } catch (err) {
     if (err.code === "ENOENT") {
       cache.current = { mtimeMs: null, fingerprint: null, enabledOverride: null };
@@ -18276,7 +18472,7 @@ function readConfigOverride() {
   }
   let parsedEnabled = null;
   try {
-    const raw = fs5.readFileSync(configFilePath(), "utf8");
+    const raw = fs6.readFileSync(configFilePath(), "utf8");
     const json = JSON.parse(raw);
     if (json && typeof json === "object") {
       const t = json.telemetry;
@@ -18330,14 +18526,14 @@ function isEnabled(env = process.env) {
 }
 
 // ../telemetry/src/debug.ts
-import * as fs6 from "node:fs";
+import * as fs7 from "node:fs";
 
 // ../telemetry/src/notice.ts
 var TELEMETRY_OPT_OUT_COMMAND = "argent telemetry disable";
 var TELEMETRY_DETAILS_URL = "https://swmansion.com/legal/argent/privacy-notice/";
 var FIRST_RUN_NOTICE_BODY_LINES = [
-  "Argent collects anonymous usage data to help us improve the tool. We never",
-  "collect your source code, file paths, tool inputs, or error contents."
+  "Argent collects usage data to help us improve the tool.",
+  "We never collect your source code, file paths, tool inputs, or error contents."
 ];
 var FIRST_RUN_NOTICE = [
   ...FIRST_RUN_NOTICE_BODY_LINES,
@@ -18577,12 +18773,12 @@ function toMcpTool(t) {
 }
 
 // ../argent-mcp/src/installed-version.ts
-import * as fs7 from "node:fs";
-import * as path9 from "node:path";
+import * as fs8 from "node:fs";
+import * as path10 from "node:path";
 function getInstalledVersion() {
   try {
-    const pkgPath = path9.resolve(import.meta.dirname, "..", "package.json");
-    const pkg = JSON.parse(fs7.readFileSync(pkgPath, "utf8"));
+    const pkgPath = path10.resolve(import.meta.dirname, "..", "package.json");
+    const pkg = JSON.parse(fs8.readFileSync(pkgPath, "utf8"));
     return pkg.version ?? "unknown";
   } catch {
     return "unknown";
@@ -18671,7 +18867,7 @@ async function startMcpServer(options) {
   async function spyLog(entry) {
     try {
       if (!logDirReady) {
-        await mkdir5(dirname3(LOG_FILE2), { recursive: true });
+        await mkdir5(dirname4(LOG_FILE2), { recursive: true });
         logDirReady = true;
       }
       await appendFile(LOG_FILE2, JSON.stringify(entry) + "\n");
@@ -18767,8 +18963,21 @@ async function startMcpServer(options) {
       }
       const udid = getUdidFromArgs(params.arguments);
       if (autoScreenshotOn && udid && shouldAutoScreenshot(params.name)) {
-        const delayMs = getAutoScreenshotDelayMs(params.name);
-        if (delayMs > 0) await new Promise((r) => setTimeout(r, delayMs));
+        const maxWaitMs = getAutoScreenshotDelayMs(params.name);
+        if (maxWaitMs > 0) {
+          try {
+            const idle = await callTool("await-screen-idle", { udid, timeoutMs: maxWaitMs });
+            await spyLog({
+              ts: (/* @__PURE__ */ new Date()).toISOString(),
+              event: "auto_screenshot_readiness",
+              name: params.name,
+              maxWaitMs,
+              ...idle.result
+            });
+          } catch {
+            await new Promise((r) => setTimeout(r, maxWaitMs));
+          }
+        }
         try {
           const screenshotResult = await callTool("screenshot", { udid });
           const screenshotContent = await toMcpContent(screenshotResult.result, "image", {