@swmansion/argent 0.15.1-next.7 → 0.15.1-next.9

package/README.md

@@ -12,7 +12,9 @@
 **[Argent](https://argent.swmansion.com)** is an **agentic toolkit** that gives your AI assistant direct access to iOS Simulators, Android emulators and physical devices, TVs (Apple TV, Android TV, Fire TV) and Electron/Chromium desktop and web apps. Ask it to tap a button, run a profiler or reproduce an issue manually - all from within your CLI, without switching context.
 
 ```bash
-npx @swmansion/argent init
+npx @swmansion/argent@latest init
+# or, in a pnpm project (where npm's devEngines check may refuse to run npx):
+pnpm dlx @swmansion/argent@latest init
 ```
 
 ## Supported platforms
@@ -98,7 +100,9 @@ Argent runs Android emulators on Linux but the default install can be slow if a
 From your project root:
 
 ```bash
-npx @swmansion/argent init
+npx @swmansion/argent@latest init
+# or, in a pnpm project (where npm's devEngines check may refuse to run npx):
+pnpm dlx @swmansion/argent@latest init
 ```
 
 This command triggers an installation wizard which:
@@ -121,9 +125,14 @@ teammate gets the same setup on `npm install` — no per-developer global instal
 `argent init` — choose the local mode:
 
 ```bash
-npx @swmansion/argent init --local
+npx @swmansion/argent@latest init --local
+# or, in a pnpm project:
+pnpm dlx @swmansion/argent@latest init --local
 ```
 
+> Note: in a freshly `pnpm init`-ed project, `npx` itself may refuse to run
+> (npm's `devEngines` check) — use the `pnpm dlx` form there.
+
 This adds `@swmansion/argent` to your project's `devDependencies` and writes MCP
 configs that launch the project-local copy (`node node_modules/@swmansion/argent/dist/cli.js mcp`).
 Commit `package.json` + your lockfile, the generated MCP config (`.mcp.json`,

package/dist/cli-cmds.mjs

@@ -6234,10 +6234,10 @@ var FAILURE_CODES = {
   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",
   DEBUGGER_CDP_RUNTIME_EXCEPTION: "DEBUGGER_CDP_RUNTIME_EXCEPTION",
   DEBUGGER_CDP_BINDING_TIMEOUT: "DEBUGGER_CDP_BINDING_TIMEOUT",
+  DEBUGGER_CDP_BINDING_UNAVAILABLE: "DEBUGGER_CDP_BINDING_UNAVAILABLE",
   DEBUGGER_CDP_PROTOCOL_ERROR: "DEBUGGER_CDP_PROTOCOL_ERROR",
   DEBUGGER_RELOAD_FAILED: "DEBUGGER_RELOAD_FAILED",
   JS_RUNTIME_CONSOLE_SERVER_BIND_FAILED: "JS_RUNTIME_CONSOLE_SERVER_BIND_FAILED",
@@ -6557,6 +6557,8 @@ var ALLOWED = {
     action: PACKAGE_ACTION,
     is_success: bool,
     duration_ms: DURATION_MS,
+    retry_count: COUNT,
+    last_attempt_duration_ms: DURATION_MS,
     ...FAILURE_SIGNAL
   },
   "installation:cli_update_start": {},

package/dist/installer.mjs

@@ -16141,10 +16141,10 @@ var FAILURE_CODES = {
   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",
   DEBUGGER_CDP_RUNTIME_EXCEPTION: "DEBUGGER_CDP_RUNTIME_EXCEPTION",
   DEBUGGER_CDP_BINDING_TIMEOUT: "DEBUGGER_CDP_BINDING_TIMEOUT",
+  DEBUGGER_CDP_BINDING_UNAVAILABLE: "DEBUGGER_CDP_BINDING_UNAVAILABLE",
   DEBUGGER_CDP_PROTOCOL_ERROR: "DEBUGGER_CDP_PROTOCOL_ERROR",
   DEBUGGER_RELOAD_FAILED: "DEBUGGER_RELOAD_FAILED",
   JS_RUNTIME_CONSOLE_SERVER_BIND_FAILED: "JS_RUNTIME_CONSOLE_SERVER_BIND_FAILED",
@@ -16464,6 +16464,8 @@ var ALLOWED = {
     action: PACKAGE_ACTION,
     is_success: bool,
     duration_ms: DURATION_MS,
+    retry_count: COUNT,
+    last_attempt_duration_ms: DURATION_MS,
     ...FAILURE_SIGNAL
   },
   "installation:cli_update_start": {},
@@ -20043,12 +20045,30 @@ function detectPackageManager() {
   if (agent.startsWith("bun")) return "bun";
   return "npm";
 }
+function asKnownPm(name) {
+  return name === "npm" || name === "yarn" || name === "pnpm" || name === "bun" ? name : null;
+}
 function pmFromPackageManagerField(dir) {
   try {
     const pkg = JSON.parse(fs8.readFileSync(path8.join(dir, "package.json"), "utf8"));
-    if (typeof pkg.packageManager !== "string") return null;
-    const name = pkg.packageManager.split("@")[0];
-    return name === "npm" || name === "yarn" || name === "pnpm" || name === "bun" ? name : null;
+    if (typeof pkg.packageManager === "string") {
+      return asKnownPm(pkg.packageManager.split("@")[0]);
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function pmFromDevEngines(dir) {
+  try {
+    const pkg = JSON.parse(fs8.readFileSync(path8.join(dir, "package.json"), "utf8"));
+    const devEnginesPm = pkg.devEngines?.packageManager;
+    const names = /* @__PURE__ */ new Set();
+    for (const entry of Array.isArray(devEnginesPm) ? devEnginesPm : [devEnginesPm]) {
+      const name = asKnownPm(entry?.name);
+      if (name) names.add(name);
+    }
+    return names.size === 1 ? [...names][0] : null;
   } catch {
     return null;
   }
@@ -20061,10 +20081,13 @@ function pmFromLockfile(dir) {
   if (has("package-lock.json") || has("npm-shrinkwrap.json")) return "npm";
   return null;
 }
+function pmFromWorkspaceMarker(dir) {
+  return fs8.existsSync(path8.join(dir, "pnpm-workspace.yaml")) ? "pnpm" : null;
+}
 function detectProjectPackageManager(projectRoot) {
   let dir = path8.resolve(projectRoot);
   for (; ; ) {
-    const pm = pmFromPackageManagerField(dir) ?? pmFromLockfile(dir);
+    const pm = pmFromPackageManagerField(dir) ?? pmFromLockfile(dir) ?? pmFromDevEngines(dir) ?? pmFromWorkspaceMarker(dir);
     if (pm) return pm;
     if (fs8.existsSync(path8.join(dir, ".git"))) break;
     const parent = path8.dirname(dir);
@@ -20726,10 +20749,291 @@ function writeTomlOrRemove(filePath, data) {
   }
   writeToml(filePath, data);
 }
+function dirHasEditorEvidence(dir, looksArgentOnly) {
+  return dirExists(dir) && !looksArgentOnly(dir);
+}
+function fileHasEditorEvidence(filePath, looksArgentOnly) {
+  return fs13.existsSync(filePath) && !looksArgentOnly(filePath);
+}
+function parseJsoncStrict(filePath) {
+  let raw;
+  try {
+    raw = fs13.readFileSync(filePath, "utf8");
+  } catch {
+    return null;
+  }
+  if (raw.charCodeAt(0) === 65279) raw = raw.slice(1);
+  const errors = [];
+  const parsed = parse3(raw, errors, { allowTrailingComma: true });
+  if (errors.length > 0 || parsed === null || typeof parsed !== "object" || Array.isArray(parsed))
+    return null;
+  return parsed;
+}
+function parseTomlStrict(filePath) {
+  try {
+    return parse(fs13.readFileSync(filePath, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function parseYamlStrict(filePath) {
+  try {
+    const parsed = (0, import_yaml2.parse)(fs13.readFileSync(filePath, "utf8"));
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) return null;
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function jsonLooksArgentServerOnly(filePath, containerKey) {
+  const config = parseJsoncStrict(filePath);
+  if (config === null) return false;
+  const keys = Object.keys(config);
+  if (keys.length !== 1 || keys[0] !== containerKey) return false;
+  const servers = config[containerKey] ?? {};
+  const serverKeys = Object.keys(servers);
+  return serverKeys.length === 1 && serverKeys[0] === MCP_SERVER_KEY;
+}
+var bundledManagedNamesCache = null;
+function bundledManagedNames(kind) {
+  if (!bundledManagedNamesCache) bundledManagedNamesCache = /* @__PURE__ */ new Map();
+  const cached2 = bundledManagedNamesCache.get(kind);
+  if (cached2) return cached2;
+  let names;
+  try {
+    names = new Set(fs13.readdirSync(kind === "rules" ? RULES_DIR : AGENTS_DIR));
+  } catch {
+    names = /* @__PURE__ */ new Set();
+  }
+  bundledManagedNamesCache.set(kind, names);
+  return names;
+}
+function managedDirLooksArgentOnly(dir, kind) {
+  let entries;
+  try {
+    entries = fs13.readdirSync(dir);
+  } catch {
+    return false;
+  }
+  if (entries.length === 0) return false;
+  if (kind === "skills") return entries.every((name) => name.startsWith(ARGENT_SKILL_PREFIX));
+  const bundled = bundledManagedNames(kind);
+  return entries.every((name) => bundled.has(name));
+}
+function cursorDirLooksArgentOnly(dir) {
+  let entries;
+  try {
+    entries = fs13.readdirSync(dir);
+  } catch {
+    return false;
+  }
+  if (entries.length === 0) return false;
+  return entries.every((entry) => {
+    const full = path13.join(dir, entry);
+    if (entry === "mcp.json") {
+      return jsonLooksArgentServerOnly(full, "mcpServers");
+    }
+    if (entry === "permissions.json") {
+      const config = parseJsoncStrict(full);
+      if (config === null) return false;
+      const keys = Object.keys(config);
+      if (keys.length !== 1 || keys[0] !== "mcpAllowlist") return false;
+      const list = config.mcpAllowlist;
+      return Array.isArray(list) && list.length > 0 && list.every((rule) => rule === CURSOR_ALLOWLIST_PATTERN);
+    }
+    if (entry === "rules" || entry === "agents" || entry === "skills") {
+      return managedDirLooksArgentOnly(full, entry);
+    }
+    return false;
+  });
+}
+function claudeSettingsLooksArgentOnly(filePath) {
+  const config = parseJsoncStrict(filePath);
+  if (config === null) return false;
+  const keys = Object.keys(config);
+  if (keys.length !== 1 || keys[0] !== "permissions") return false;
+  const permissions = config.permissions;
+  if (!isRecord(permissions)) return false;
+  const permKeys = Object.keys(permissions);
+  if (permKeys.length !== 1 || permKeys[0] !== "allow") return false;
+  const allow = permissions.allow;
+  return Array.isArray(allow) && allow.length > 0 && allow.every((rule) => rule === PERMISSION_RULE);
+}
+function claudeDirLooksArgentOnly(dir) {
+  let entries;
+  try {
+    entries = fs13.readdirSync(dir);
+  } catch {
+    return false;
+  }
+  if (entries.length === 0) return false;
+  return entries.every((entry) => {
+    const full = path13.join(dir, entry);
+    if (entry === "settings.json") return claudeSettingsLooksArgentOnly(full);
+    if (entry === "rules" || entry === "agents" || entry === "skills") {
+      return managedDirLooksArgentOnly(full, entry);
+    }
+    return false;
+  });
+}
+function vscodeDirLooksArgentOnly(dir) {
+  let entries;
+  try {
+    entries = fs13.readdirSync(dir);
+  } catch {
+    return false;
+  }
+  if (entries.length === 0) return false;
+  return entries.every(
+    (entry) => entry === "mcp.json" && jsonLooksArgentServerOnly(path13.join(dir, entry), "servers")
+  );
+}
+function windsurfDirLooksArgentOnly(dir) {
+  let entries;
+  try {
+    entries = fs13.readdirSync(dir);
+  } catch {
+    return false;
+  }
+  if (entries.length === 0) return false;
+  return entries.every(
+    (entry) => entry === "mcp_config.json" && jsonLooksArgentServerOnly(path13.join(dir, entry), "mcpServers")
+  );
+}
+function zedSettingsLooksArgentOnly(filePath) {
+  const config = parseJsoncStrict(filePath);
+  if (config === null) return false;
+  const keys = Object.keys(config);
+  if (keys.length === 0) return false;
+  return keys.every((key) => {
+    if (key === "context_servers") {
+      const servers = config.context_servers;
+      if (!isRecord(servers)) return false;
+      const serverKeys = Object.keys(servers);
+      return serverKeys.length === 1 && serverKeys[0] === MCP_SERVER_KEY;
+    }
+    if (key === "agent") {
+      const agent = config.agent;
+      if (!isRecord(agent)) return false;
+      const agentKeys = Object.keys(agent);
+      if (agentKeys.length !== 1 || agentKeys[0] !== "tool_permissions") return false;
+      const perms = agent.tool_permissions;
+      if (!isRecord(perms)) return false;
+      const permKeys = Object.keys(perms);
+      return permKeys.length === 1 && permKeys[0] === "default" && (perms.default === "allow" || perms.default === "confirm");
+    }
+    return false;
+  });
+}
+function zedDirLooksArgentOnly(dir) {
+  let entries;
+  try {
+    entries = fs13.readdirSync(dir);
+  } catch {
+    return false;
+  }
+  if (entries.length === 0) return false;
+  return entries.every(
+    (entry) => entry === "settings.json" && zedSettingsLooksArgentOnly(path13.join(dir, entry))
+  );
+}
+function geminiDirLooksArgentOnly(dir) {
+  let entries;
+  try {
+    entries = fs13.readdirSync(dir);
+  } catch {
+    return false;
+  }
+  if (entries.length === 0) return false;
+  return entries.every((entry) => {
+    const full = path13.join(dir, entry);
+    if (entry === "settings.json") return jsonLooksArgentServerOnly(full, "mcpServers");
+    if (entry === "rules" || entry === "agents") return managedDirLooksArgentOnly(full, entry);
+    return false;
+  });
+}
+function hermesConfigLooksArgentOnly(filePath) {
+  const config = parseYamlStrict(filePath);
+  if (config === null) return false;
+  const keys = Object.keys(config);
+  if (keys.length !== 1 || keys[0] !== "mcp_servers") return false;
+  const servers = config.mcp_servers;
+  if (!isRecord(servers)) return false;
+  const serverKeys = Object.keys(servers);
+  return serverKeys.length === 1 && serverKeys[0] === MCP_SERVER_KEY;
+}
+function hermesDirLooksArgentOnly(dir) {
+  let entries;
+  try {
+    entries = fs13.readdirSync(dir);
+  } catch {
+    return false;
+  }
+  if (entries.length === 0) return false;
+  return entries.every(
+    (entry) => entry === "config.yaml" && hermesConfigLooksArgentOnly(path13.join(dir, entry))
+  );
+}
+function kiroDirLooksArgentOnly(dir) {
+  let entries;
+  try {
+    entries = fs13.readdirSync(dir);
+  } catch {
+    return false;
+  }
+  if (entries.length === 0) return false;
+  return entries.every((entry) => {
+    if (entry !== "settings") return false;
+    const settingsDir = path13.join(dir, entry);
+    let settingsEntries;
+    try {
+      settingsEntries = fs13.readdirSync(settingsDir);
+    } catch {
+      return false;
+    }
+    if (settingsEntries.length === 0) return false;
+    return settingsEntries.every(
+      (name) => name === "mcp.json" && jsonLooksArgentServerOnly(path13.join(settingsDir, name), "mcpServers")
+    );
+  });
+}
+function codexDirLooksArgentOnly(dir) {
+  let entries;
+  try {
+    entries = fs13.readdirSync(dir);
+  } catch {
+    return false;
+  }
+  if (entries.length === 0) return false;
+  return entries.every((entry) => {
+    const full = path13.join(dir, entry);
+    if (entry === "config.toml") {
+      const config = parseTomlStrict(full);
+      if (config === null) return false;
+      const configEntries = Object.entries(config);
+      if (configEntries.length === 0) return false;
+      return configEntries.every(([key, value]) => {
+        if (key === "mcp_servers") {
+          const servers = value ?? {};
+          const serverKeys = Object.keys(servers);
+          return serverKeys.length === 1 && serverKeys[0] === MCP_SERVER_KEY;
+        }
+        if (key === "developer_instructions") {
+          return typeof value === "string" && removeArgentSection(value) === "";
+        }
+        return false;
+      });
+    }
+    if (entry === "rules" || entry === "agents" || entry === "skills") {
+      return managedDirLooksArgentOnly(full, entry);
+    }
+    return false;
+  });
+}
 var cursorAdapter = {
   name: "Cursor",
   detect() {
-    return dirExists(path13.join(homedir4(), ".cursor")) || dirExists(path13.join(process.cwd(), ".cursor"));
+    return dirHasEditorEvidence(path13.join(homedir4(), ".cursor"), cursorDirLooksArgentOnly) || dirHasEditorEvidence(path13.join(process.cwd(), ".cursor"), cursorDirLooksArgentOnly);
   },
   projectPath(root) {
     return path13.join(root, ".cursor", "mcp.json");
@@ -20833,7 +21137,8 @@ function claudeDisabledListFinding(settingsPath, label, projectConfined) {
 var claudeAdapter = {
   name: "Claude Code",
   detect() {
-    return fs13.existsSync(path13.join(process.cwd(), ".mcp.json")) || fs13.existsSync(path13.join(homedir4(), ".claude.json")) || dirExists(path13.join(process.cwd(), ".claude")) || dirExists(path13.join(homedir4(), ".claude"));
+    const mcpJsonArgentOnly = (p) => jsonLooksArgentServerOnly(p, "mcpServers");
+    return fileHasEditorEvidence(path13.join(process.cwd(), ".mcp.json"), mcpJsonArgentOnly) || fileHasEditorEvidence(path13.join(homedir4(), ".claude.json"), mcpJsonArgentOnly) || dirHasEditorEvidence(path13.join(process.cwd(), ".claude"), claudeDirLooksArgentOnly) || dirHasEditorEvidence(path13.join(homedir4(), ".claude"), claudeDirLooksArgentOnly);
   },
   projectPath(root) {
     return path13.join(root, ".mcp.json");
@@ -20941,7 +21246,7 @@ var claudeAdapter = {
 var vscodeAdapter = {
   name: "VS Code",
   detect() {
-    return dirExists(path13.join(process.cwd(), ".vscode")) || dirExists(path13.join(homedir4(), ".vscode"));
+    return dirHasEditorEvidence(path13.join(process.cwd(), ".vscode"), vscodeDirLooksArgentOnly) || dirExists(path13.join(homedir4(), ".vscode"));
   },
   projectPath(root) {
     return path13.join(root, ".vscode", "mcp.json");
@@ -21024,7 +21329,10 @@ function vscodeUserDirs() {
 var windsurfAdapter = {
   name: "Windsurf",
   detect() {
-    return dirExists(path13.join(homedir4(), ".codeium", "windsurf"));
+    return dirHasEditorEvidence(
+      path13.join(homedir4(), ".codeium", "windsurf"),
+      windsurfDirLooksArgentOnly
+    );
   },
   projectPath() {
     return null;
@@ -21084,7 +21392,7 @@ var windsurfAdapter = {
 var zedAdapter = {
   name: "Zed",
   detect() {
-    return dirExists(path13.join(homedir4(), ".config", "zed"));
+    return dirHasEditorEvidence(path13.join(homedir4(), ".config", "zed"), zedDirLooksArgentOnly);
   },
   projectPath(root) {
     return path13.join(root, ".zed", "settings.json");
@@ -21142,7 +21450,7 @@ var zedAdapter = {
 var geminiAdapter = {
   name: "Gemini",
   detect() {
-    return dirExists(path13.join(homedir4(), ".gemini")) || dirExists(path13.join(process.cwd(), ".gemini"));
+    return dirHasEditorEvidence(path13.join(homedir4(), ".gemini"), geminiDirLooksArgentOnly) || dirHasEditorEvidence(path13.join(process.cwd(), ".gemini"), geminiDirLooksArgentOnly);
   },
   projectPath(root) {
     return path13.join(root, ".gemini", "settings.json");
@@ -21207,7 +21515,7 @@ var CODEX_FILENAME = ".codex";
 var codexAdapter = {
   name: "Codex",
   detect() {
-    return dirExists(path13.join(homedir4(), CODEX_FILENAME)) || dirExists(path13.join(process.cwd(), CODEX_FILENAME));
+    return dirHasEditorEvidence(path13.join(homedir4(), CODEX_FILENAME), codexDirLooksArgentOnly) || dirHasEditorEvidence(path13.join(process.cwd(), CODEX_FILENAME), codexDirLooksArgentOnly);
   },
   projectPath(root) {
     return path13.join(root, CODEX_FILENAME, "config.toml");
@@ -21285,7 +21593,7 @@ var codexAdapter = {
 var hermesAdapter = {
   name: "Hermes",
   detect() {
-    return dirExists(path13.join(homedir4(), ".hermes"));
+    return dirHasEditorEvidence(path13.join(homedir4(), ".hermes"), hermesDirLooksArgentOnly);
   },
   projectPath() {
     return null;
@@ -21409,7 +21717,7 @@ var KIRO_AUTO_APPROVE_ALL = ["*"];
 var kiroAdapter = {
   name: "Kiro",
   detect() {
-    return dirExists(path13.join(homedir4(), ".kiro")) || dirExists(path13.join(process.cwd(), ".kiro"));
+    return dirHasEditorEvidence(path13.join(homedir4(), ".kiro"), kiroDirLooksArgentOnly) || dirHasEditorEvidence(path13.join(process.cwd(), ".kiro"), kiroDirLooksArgentOnly);
   },
   projectPath(root) {
     return path13.join(root, ".kiro", "settings", "mcp.json");
@@ -21773,16 +22081,19 @@ async function resolveTelemetryConsent(opts) {
 }
 
 // ../argent-installer/src/init-args.ts
-function extractFlag(args, flag) {
-  const idx = args.indexOf(flag);
-  if (idx === -1 || idx + 1 >= args.length) return null;
-  return args[idx + 1];
-}
 function parseInitArgs(args) {
+  let fromTar = null;
+  for (let i2 = 0; i2 < args.length; i2++) {
+    const arg = args[i2];
+    if (arg === "--from" || arg.startsWith("--from=")) {
+      const value = arg === "--from" ? i2 + 1 < args.length ? args[++i2] : "" : arg.slice(7);
+      if (value !== "" && fromTar === null) fromTar = value;
+    }
+  }
   return {
     nonInteractive: args.includes("--yes") || args.includes("-y"),
     noTelemetry: args.includes("--no-telemetry"),
-    fromTar: extractFlag(args, "--from"),
+    fromTar,
     wantsLocal: args.includes("--local"),
     wantsGlobal: args.includes("--global")
   };
@@ -21875,12 +22186,13 @@ var InitTelemetry = class {
       });
     });
   }
-  async trackPackageAction(action, startedAt, isSuccess, failureSignal2) {
+  async trackPackageAction(action, startedAt, isSuccess, failureSignal2, attemptInfo) {
     track("installation:package_action", {
       trigger: "init",
       action,
       is_success: isSuccess,
       duration_ms: performance.now() - startedAt,
+      ...attemptInfo ?? {},
       ...failureSignal2 ?? {}
     });
   }
@@ -21930,6 +22242,16 @@ function execShellCommandSync(cmd, opts = {}) {
     ...opts.env ? { env: opts.env } : {}
   });
 }
+var ShellCommandError = class extends Error {
+  constructor(message, exitCode, signal) {
+    super(message);
+    this.exitCode = exitCode;
+    this.signal = signal;
+    this.name = "ShellCommandError";
+  }
+  exitCode;
+  signal;
+};
 function runShellCommand(cmd, opts = {}) {
   return new Promise((resolve10, reject) => {
     const child = spawn2(cmd.bin, cmd.args, {
@@ -21941,9 +22263,16 @@ function runShellCommand(cmd, opts = {}) {
     child.stderr?.on("data", (chunk) => {
       stderr += chunk.toString();
     });
-    child.on("close", (code) => {
+    child.on("close", (code, signal) => {
       if (code === 0) resolve10();
-      else reject(new Error(stderr.trim() || `Command exited with code ${code}`));
+      else
+        reject(
+          new ShellCommandError(
+            stderr.trim() || (signal !== null ? `Command terminated by signal ${signal}` : `Command exited with code ${code}`),
+            code,
+            signal
+          )
+        );
     });
     child.on("error", reject);
   });
@@ -22104,17 +22433,52 @@ async function installLocally(opts) {
     materializeOnly ? `Installing project dependencies to materialize ${PACKAGE_NAME} (${pm})...` : `Adding ${PACKAGE_NAME} to devDependencies (${pm})...`
   );
   const startedAt = performance.now();
-  const { landed, exitError: installError } = await runTrustingDisk(
+  const attempt = () => runTrustingDisk(
     () => runShellCommand(cmd, { cwd: projectRoot }),
     () => isLocallyInstalled(projectRoot) || isYarnPnp(projectRoot)
   );
+  let lastAttemptStartedAt = performance.now();
+  let retryCount = 0;
+  let { landed, exitError: installError } = await attempt();
+  const isMissingBinaryError = (err) => err !== null && (err.code === "ENOENT" || process.platform === "win32" && err instanceof ShellCommandError && err.exitCode === 9009);
+  const missingBinary = !landed && isMissingBinaryError(installError);
+  const wasInterrupted = (err) => err instanceof ShellCommandError && (err.signal !== null || err.exitCode === null);
+  const interrupted = !landed && wasInterrupted(installError);
+  if (!landed && installError && !missingBinary && !interrupted) {
+    spinner2.message(`${pm} failed \u2014 retrying once...`);
+    retryCount = 1;
+    lastAttemptStartedAt = performance.now();
+    ({ landed, exitError: installError } = await attempt());
+  }
+  const attemptTelemetry = () => ({
+    retry_count: retryCount,
+    last_attempt_duration_ms: performance.now() - lastAttemptStartedAt
+  });
   if (!landed) {
-    spinner2.stop(import_picocolors3.default.red("Local install failed."));
-    log.error(
-      installError ? `${installError}` : `The install reported success but ${import_picocolors3.default.cyan(PACKAGE_NAME)} is not in node_modules.`
+    spinner2.stop(import_picocolors3.default.red(interrupted ? "Local install interrupted." : "Local install failed."));
+    if (missingBinary) {
+      log.error(
+        `This project uses ${import_picocolors3.default.cyan(pm)}, but the ${import_picocolors3.default.cyan(pm)} command was not found on PATH.`
+      );
+      log.info(
+        `Install ${import_picocolors3.default.cyan(pm)} first` + (pm === "pnpm" || pm === "yarn" ? ` (e.g. ${import_picocolors3.default.cyan(`corepack enable ${pm}`)}, or see the ${pm} install docs)` : "") + `, then re-run ${import_picocolors3.default.cyan("argent init --local")}.`
+      );
+    } else if (interrupted) {
+      log.error(`The ${import_picocolors3.default.cyan(pm)} install was interrupted before it finished.`);
+      log.info(`Re-run ${import_picocolors3.default.cyan("argent init --local")} to try again.`);
+    } else {
+      log.error(
+        installError ? `${installError}` : `The install reported success but ${import_picocolors3.default.cyan(PACKAGE_NAME)} is not in node_modules.`
+      );
+      log.info(`Install manually with: ${import_picocolors3.default.cyan(`cd ${projectRoot} && ${cmdStr}`)}`);
+    }
+    await tel.trackPackageAction(
+      "fresh_install",
+      startedAt,
+      false,
+      INSTALL_LOCAL_PACKAGE_FAILED,
+      attemptTelemetry()
     );
-    log.info(`Install manually with: ${import_picocolors3.default.cyan(`cd ${projectRoot} && ${cmdStr}`)}`);
-    await tel.trackPackageAction("fresh_install", startedAt, false, INSTALL_LOCAL_PACKAGE_FAILED);
     await tel.finalize(INSTALL_LOCAL_PACKAGE_FAILED);
     process.exit(1);
   }
@@ -22133,7 +22497,7 @@ async function installLocally(opts) {
       );
     }
   }
-  await tel.trackPackageAction("fresh_install", startedAt, true);
+  await tel.trackPackageAction("fresh_install", startedAt, true, void 0, attemptTelemetry());
 }
 async function runGlobal(opts) {
   const { fromTar, nonInteractive, tel } = opts;
@@ -22279,6 +22643,12 @@ async function runGlobal(opts) {
 
 // ../argent-installer/src/init-adapters.ts
 var import_picocolors4 = __toESM(require_picocolors(), 1);
+function previouslyConfiguredAdapters(eligible, installMode) {
+  const wantedScope = installMode === "local" ? "project" : "global";
+  const scopes = findConfiguredAdapterScopes(eligible, process.cwd());
+  const configured = new Set(scopes.filter((s) => s.scope === wantedScope).map((s) => s.adapter));
+  return eligible.filter((a3) => configured.has(a3));
+}
 async function chooseAdapters(opts) {
   let eligible = ALL_ADAPTERS;
   if (opts.installMode === "local") {
@@ -22294,12 +22664,16 @@ async function chooseAdapters(opts) {
   }
   const detected = detectAdapters().filter((a3) => eligible.includes(a3));
   const detectedNames = detected.map((a3) => a3.name);
+  const previouslyConfigured = previouslyConfiguredAdapters(eligible, opts.installMode);
+  const previouslyConfiguredNames = previouslyConfigured.map((a3) => a3.name);
+  const preselected = [...detected, ...previouslyConfigured.filter((a3) => !detected.includes(a3))];
   if (opts.nonInteractive) {
-    return { selected: detected.length > 0 ? detected : eligible, detected };
+    return { selected: preselected.length > 0 ? preselected : eligible, detected };
   }
   const choices = eligible.map((a3) => {
     const parts = [];
     if (detectedNames.includes(a3.name)) parts.push("detected");
+    else if (previouslyConfiguredNames.includes(a3.name)) parts.push("already configured");
     const hasProject = a3.projectPath(process.cwd()) != null;
     const hasGlobal = a3.globalPath() != null;
     if (!hasProject && hasGlobal) {
@@ -22317,7 +22691,7 @@ async function chooseAdapters(opts) {
   const selected = await multiselect({
     message: "Which editors should Argent be configured for?",
     options: choices,
-    initialValues: detected,
+    initialValues: preselected,
     required: true
   });
   if (isCancel(selected)) throw new InitCancelled("editors");
@@ -22876,7 +23250,11 @@ async function init2(args) {
     note(mcpLines.join("\n"), "MCP Configuration");
     const staleCleanup = await cleanupStaleMcpConfigs({
       writtenAdapters,
-      detectedAdapters: detected,
+      // Sweep EVERY adapter, not just the detected set: the sweep is fully
+      // gated on an existing argent entry (getArgentEntry), and the stale
+      // entries most worth pruning live in argent-only dirs (~/.cursor,
+      // ~/.codex) that detection now deliberately ignores.
+      detectedAdapters: ALL_ADAPTERS,
       installMode: tel.installMode,
       scope: normalizedScope,
       effectiveRoot,

package/dist/mcp-server.mjs

@@ -17660,10 +17660,10 @@ var FAILURE_CODES = {
   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",
   DEBUGGER_CDP_RUNTIME_EXCEPTION: "DEBUGGER_CDP_RUNTIME_EXCEPTION",
   DEBUGGER_CDP_BINDING_TIMEOUT: "DEBUGGER_CDP_BINDING_TIMEOUT",
+  DEBUGGER_CDP_BINDING_UNAVAILABLE: "DEBUGGER_CDP_BINDING_UNAVAILABLE",
   DEBUGGER_CDP_PROTOCOL_ERROR: "DEBUGGER_CDP_PROTOCOL_ERROR",
   DEBUGGER_RELOAD_FAILED: "DEBUGGER_RELOAD_FAILED",
   JS_RUNTIME_CONSOLE_SERVER_BIND_FAILED: "JS_RUNTIME_CONSOLE_SERVER_BIND_FAILED",
@@ -18004,6 +18004,8 @@ var ALLOWED = {
     action: PACKAGE_ACTION,
     is_success: bool,
     duration_ms: DURATION_MS,
+    retry_count: COUNT,
+    last_attempt_duration_ms: DURATION_MS,
     ...FAILURE_SIGNAL
   },
   "installation:cli_update_start": {},

package/dist/tool-server.cjs

@@ -314,10 +314,10 @@ var init_failure_codes = __esm({
       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",
       DEBUGGER_CDP_RUNTIME_EXCEPTION: "DEBUGGER_CDP_RUNTIME_EXCEPTION",
       DEBUGGER_CDP_BINDING_TIMEOUT: "DEBUGGER_CDP_BINDING_TIMEOUT",
+      DEBUGGER_CDP_BINDING_UNAVAILABLE: "DEBUGGER_CDP_BINDING_UNAVAILABLE",
       DEBUGGER_CDP_PROTOCOL_ERROR: "DEBUGGER_CDP_PROTOCOL_ERROR",
       DEBUGGER_RELOAD_FAILED: "DEBUGGER_RELOAD_FAILED",
       JS_RUNTIME_CONSOLE_SERVER_BIND_FAILED: "JS_RUNTIME_CONSOLE_SERVER_BIND_FAILED",
@@ -103836,6 +103836,8 @@ var ALLOWED = {
     action: PACKAGE_ACTION,
     is_success: bool,
     duration_ms: DURATION_MS,
+    retry_count: COUNT,
+    last_attempt_duration_ms: DURATION_MS,
     ...FAILURE_SIGNAL2
   },
   "installation:cli_update_start": {},
@@ -114407,6 +114409,8 @@ var CDPClient = class {
   nextId = 1;
   pending = /* @__PURE__ */ new Map();
   pendingBindings = /* @__PURE__ */ new Map();
+  /** Set by addBinding when the runtime ACKs the command but installs nothing. */
+  bindingUnavailable = false;
   scripts = /* @__PURE__ */ new Map();
   enabledDomains = /* @__PURE__ */ new Set();
   wsUrl;
@@ -114539,6 +114543,8 @@ var CDPClient = class {
   }
   async addBinding(name) {
     await this.send("Runtime.addBinding", { name });
+    const probe3 = await this.evaluate(`typeof ${name}`).catch(() => void 0);
+    this.bindingUnavailable = probe3 === "undefined";
   }
   /**
    * Inject a script that will push a result via the binding using a unique requestId.
@@ -114547,6 +114553,19 @@ var CDPClient = class {
   evaluateWithBinding(expression, requestId, options) {
     const id = requestId ?? crypto3.randomUUID();
     const timeout = options?.timeout ?? DEFAULT_TIMEOUT_MS2;
+    if (this.bindingUnavailable) {
+      return Promise.reject(
+        new FailureError(
+          "This JS runtime acknowledges Runtime.addBinding but never installs the binding (legacy Hermes, React Native <= 0.72), so it cannot deliver a result over the binding channel. Tools that read the React tree this way are unavailable here; use `describe` to read on-screen structure.",
+          {
+            error_code: FAILURE_CODES.DEBUGGER_CDP_BINDING_UNAVAILABLE,
+            failure_stage: "debugger_cdp_binding",
+            failure_area: "tool_server",
+            error_kind: "unsupported"
+          }
+        )
+      );
+    }
     return new Promise((resolve7, reject) => {
       const timer = setTimeout(() => {
         this.pendingBindings.delete(id);
@@ -121983,12 +122002,14 @@ init_src();
 
 // ../tool-server/src/utils/debugger/discovery.ts
 init_src();
+var DECOY_VM = "don't use";
 async function discoverMetro(port) {
-  const statusRes = await fetch(`http://localhost:${port}/status`);
-  const statusText = await statusRes.text();
-  if (!statusText.includes("packager-status:running")) {
+  let statusRes;
+  try {
+    statusRes = await fetch(`http://localhost:${port}/status`);
+  } catch (err) {
     throw new FailureError(
-      `Metro at port ${port} is not running (got: ${statusText.slice(0, 100)})`,
+      `Metro at port ${port} is not running (got: ${err instanceof Error ? err.message : String(err)})`,
       {
         error_code: FAILURE_CODES.DEBUGGER_METRO_NOT_RUNNING,
         failure_stage: "debugger_discover_metro_status",
@@ -121997,21 +122018,25 @@ async function discoverMetro(port) {
       }
     );
   }
-  const projectRoot = statusRes.headers.get("X-React-Native-Project-Root") ?? "";
-  if (!projectRoot) {
+  const statusText = await statusRes.text();
+  if (!statusText.includes("packager-status:running")) {
     throw new FailureError(
-      `Metro at port ${port} did not return X-React-Native-Project-Root header`,
+      `Metro at port ${port} is not running (got: ${statusText.slice(0, 100)})`,
       {
-        error_code: FAILURE_CODES.DEBUGGER_METRO_PROJECT_ROOT_MISSING,
-        failure_stage: "debugger_discover_metro_project_root",
+        error_code: FAILURE_CODES.DEBUGGER_METRO_NOT_RUNNING,
+        failure_stage: "debugger_discover_metro_status",
         failure_area: "tool_server",
         error_kind: "network"
       }
     );
   }
+  const projectRoot = statusRes.headers.get("X-React-Native-Project-Root") ?? "";
   const listRes = await fetch(`http://localhost:${port}/json/list`);
-  const targets = await listRes.json();
-  if (!targets?.length) {
+  const parsed = await listRes.json().catch(() => null);
+  const targets = (Array.isArray(parsed) ? parsed : []).filter(
+    (t) => t?.vm !== DECOY_VM
+  );
+  if (!targets.length) {
     throw new FailureError(
       `Metro at port ${port} has no CDP targets \u2014 is a React Native app connected?`,
       {
@@ -122026,8 +122051,19 @@ async function discoverMetro(port) {
 }
 
 // ../tool-server/src/utils/debugger/target-selection.ts
+function deviceKey(target) {
+  const logicalId = target.reactNative?.logicalDeviceId;
+  if (logicalId) return logicalId;
+  try {
+    const device = new URL(target.webSocketDebuggerUrl).searchParams.get("device");
+    if (device) return `device=${device}`;
+  } catch {
+  }
+  return target.deviceName;
+}
 function selectTarget(targets, port, options) {
-  let candidates = targets;
+  const pool = targets;
+  let candidates = pool;
   if (typeof options?.deviceId === "string" && options.deviceId) {
     const deviceId = options.deviceId;
     const filtered = candidates.filter((t) => t.reactNative?.logicalDeviceId === deviceId);
@@ -122035,16 +122071,21 @@ function selectTarget(targets, port, options) {
       candidates = filtered;
     } else {
       const distinctDevices = /* @__PURE__ */ new Map();
-      for (const t of targets) {
-        const id = t.reactNative?.logicalDeviceId;
-        if (id !== void 0 && id !== "" && !distinctDevices.has(id)) {
-          distinctDevices.set(id, t.deviceName);
+      for (const t of pool) {
+        const key = deviceKey(t);
+        if (key && !distinctDevices.has(key)) {
+          distinctDevices.set(key, {
+            name: t.deviceName,
+            logicalId: t.reactNative?.logicalDeviceId
+          });
         }
       }
       if (distinctDevices.size > 1) {
-        const listed = [...distinctDevices.entries()].map(([id, name]) => name ? `${name} (${id})` : id).join(", ");
+        const listed = [...distinctDevices.values()].map(
+          (d) => d.logicalId ? `${d.name ?? "unknown"} (${d.logicalId})` : `${d.name ?? "unknown"} (legacy inspector \u2014 no logicalDeviceId)`
+        ).join(", ");
         throw new Error(
-          `No debugger target matches device_id "${deviceId}". ${distinctDevices.size} devices are connected to Metro on port ${port}: ${listed}. Pass the logicalDeviceId (in parentheses) of the desired device as device_id (the logicalDeviceId returned by debugger-connect).`
+          `No debugger target matches device_id "${deviceId}". ${distinctDevices.size} devices are connected to Metro on port ${port}: ${listed}. Re-target with the logicalDeviceId in parentheses \u2014 that is what debugger-connect returns and what subsequent debugger-* calls must pass. A legacy-inspector device (RN 0.72 / Vega) reports none and cannot be singled out of a shared Metro: give it its own Metro port.`
         );
       }
     }
@@ -122185,6 +122226,7 @@ function parseNode(line) {
 // ../tool-server/src/utils/debugger/source-resolver.ts
 var ALLOWED_SOURCE_EXTENSIONS = /* @__PURE__ */ new Set([".js", ".jsx", ".ts", ".tsx", ".mjs", ".cjs"]);
 function isInsideProject(absFile, projectRoot) {
+  if (!projectRoot) return false;
   const resolvedRoot = path17.resolve(projectRoot);
   const resolvedFile = path17.resolve(absFile);
   const rel = path17.relative(resolvedRoot, resolvedFile);
@@ -122227,7 +122269,7 @@ function createSourceResolver(port, projectRoot) {
       const frame = data.stack?.[0];
       if (!frame?.file) return null;
       if (/^https?:\/\//.test(frame.file)) return null;
-      const relFile = frame.file.replace(projectRoot + "/", "").replace(/^\/+/, "");
+      const relFile = projectRoot ? frame.file.replace(projectRoot + "/", "").replace(/^\/+/, "") : frame.file;
       return {
         file: relFile,
         line: frame.lineNumber ?? 0,
@@ -122246,6 +122288,7 @@ function createSourceResolver(port, projectRoot) {
     },
     symbolicate: symbolicateFrame,
     async readSourceFragment(location, contextLines = 3) {
+      if (!projectRoot) return null;
       try {
         const absPath = path17.isAbsolute(location.file) ? path17.resolve(location.file) : path17.resolve(projectRoot, location.file);
         const realRoot = await fs18.realpath(projectRoot);
@@ -133797,7 +133840,8 @@ var DEBUGGER_TOOL_CAPABILITY = {
   apple: { simulator: true, device: true },
   appleRemote: { simulator: true },
   android: { emulator: true, device: true, unknown: true },
-  chromium: { app: true }
+  chromium: { app: true },
+  vega: { vvd: true }
 };
 var RN_ONLY_TOOL_CAPABILITY = {
   apple: { simulator: true, device: true },
@@ -133816,14 +133860,14 @@ function debuggerServiceRef(params) {
 var zodSchema29 = external_exports.object({
   port: external_exports.coerce.number().default(8081).describe("Metro server port (ignored for Chromium \u2014 its CDP port is encoded in device_id)"),
   device_id: external_exports.string().describe(
-    "Device id: iOS simulator UDID, Android logicalDeviceId returned by Metro, or Chromium device id (chromium-cdp-<port>) from list-devices. The returned logicalDeviceId must be forwarded as device_id to all subsequent debugger-* calls to pin them to this device."
+    "Device id: iOS simulator UDID, Android logicalDeviceId returned by Metro, Vega serial (amazon-...), or Chromium device id (chromium-cdp-<port>) from list-devices. When a logicalDeviceId is returned, forward it as device_id to all subsequent debugger-* calls to pin them to this device; when none is returned (Vega), keep passing the id you connected with."
   )
 });
 var debuggerConnectTool = {
   id: "debugger-connect",
   description: `Connect to a JS runtime CDP debugger.
-iOS / Android: connects to Metro's CDP endpoint on the given port. Chromium: re-uses the page CDP session opened by boot-device \u2014 port is ignored.
-Returns connection info including port, projectRoot (empty on Chromium), deviceName, appName, logicalDeviceId, and isNewDebugger. If already connected, returns the existing connection.
+iOS / Android / Vega: connects to Metro's CDP endpoint on the given port. Chromium: re-uses the page CDP session opened by boot-device \u2014 port is ignored.
+Returns connection info including port, projectRoot (empty on Chromium and on legacy Metro, e.g. Vega), deviceName, appName, logicalDeviceId (absent on Vega), and isNewDebugger. If already connected, returns the existing connection.
 Use when starting a debug session or before calling other debugger-* tools. Fails if the runtime is unreachable (Metro down, or Chromium CDP terminated).`,
   zodSchema: zodSchema29,
   capability: DEBUGGER_TOOL_CAPABILITY,
@@ -133849,13 +133893,13 @@ init_zod();
 var zodSchema30 = external_exports.object({
   port: external_exports.coerce.number().default(8081).describe("Metro server port (ignored for Chromium)"),
   device_id: external_exports.string().describe(
-    "Device id from debugger-connect (iOS simulator UDID, Android logicalDeviceId, or Chromium device id)."
+    "Device id from debugger-connect (iOS simulator UDID, Android logicalDeviceId, Vega serial, or Chromium device id)."
   )
 });
 var debuggerStatusTool = {
   id: "debugger-status",
   description: `Get JS runtime debugger connection status and diagnostic info.
-Use when you need to verify connectivity before using other debugger tools. Returns port, projectRoot (empty on Chromium), deviceName, appName, logicalDeviceId, connected flag, loadedScripts count, and sourceMapReady (always true \u2014 waits for pending source maps before returning; no-op on Chromium). Fails if the runtime is unreachable.`,
+Use when you need to verify connectivity before using other debugger tools. Returns port, projectRoot (empty on Chromium and on legacy Metro, e.g. Vega), deviceName, appName, logicalDeviceId (absent on Vega), isNewDebugger (false on the legacy inspector), connected flag, loadedScripts count, and sourceMapReady (always true \u2014 waits for pending source maps before returning; no-op on Chromium). Fails if the runtime is unreachable.`,
   zodSchema: zodSchema30,
   capability: DEBUGGER_TOOL_CAPABILITY,
   services: (params) => ({
@@ -133884,13 +133928,13 @@ init_zod();
 var zodSchema31 = external_exports.object({
   port: external_exports.coerce.number().default(8081).describe("Metro server port (ignored for Chromium)"),
   device_id: external_exports.string().describe(
-    "Device id from debugger-connect (iOS simulator UDID, Android logicalDeviceId, or Chromium device id)."
+    "Device id from debugger-connect (iOS simulator UDID, Android logicalDeviceId, Vega serial, or Chromium device id)."
   ),
   expression: external_exports.string().describe("JavaScript expression to evaluate in the app runtime")
 });
 var debuggerEvaluateTool = {
   id: "debugger-evaluate",
-  description: `Execute arbitrary JavaScript in the app's JS runtime via CDP \u2014 Hermes on iOS / Android, V8 on Chromium.
+  description: `Execute arbitrary JavaScript in the app's JS runtime via CDP \u2014 Hermes on iOS / Android / Vega, V8 on Chromium.
 Returns the evaluation result as a JSON-serializable value, along with deviceName, appName, and logicalDeviceId for context. Use when you need to read app state, call app functions, or test logic at runtime. The result is serialized by value, so cyclic objects (many RN runtime values \u2014 fiber nodes, navigation refs, global \u2014 are cyclic) fail with a serialization error rather than returning silently. Fails if the expression throws or the runtime is not connected.`,
   zodSchema: zodSchema31,
   capability: DEBUGGER_TOOL_CAPABILITY,
@@ -135374,13 +135418,13 @@ init_zod();
 var zodSchema35 = external_exports.object({
   port: external_exports.coerce.number().default(8081).describe("Metro server port (ignored for Chromium)"),
   device_id: external_exports.string().describe(
-    "Device id from debugger-connect (iOS simulator UDID, Android logicalDeviceId, or Chromium device id)."
+    "Device id from debugger-connect (iOS simulator UDID, Android logicalDeviceId, Vega serial, or Chromium device id)."
   )
 });
 var debuggerLogRegistryTool = {
   id: "debugger-log-registry",
   description: `Get a summary of all console logs captured from the app's JS runtime.
-Returns the log file path, entry counts by level, and message clusters (grouped by similarity). Works against Hermes (iOS / Android) and V8 (Chromium).
+Returns the log file path, entry counts by level, and message clusters (grouped by similarity). Works against Hermes (iOS / Android / Vega) and V8 (Chromium).
 Use when investigating warnings, errors, or unexpected output \u2014 call this first for an overview, then read the returned file for details. Returns empty stats if no log data has been captured yet.`,
   zodSchema: zodSchema35,
   capability: DEBUGGER_TOOL_CAPABILITY,
@@ -135472,7 +135516,7 @@ var networkLogsTool = {
   description: `Retrieve captured network (HTTP) requests from the running app.
 Returns a paginated list of requests with method, URL, status, resource type, size, and duration.
 Each entry includes a requestId that can be passed to view-network-request-details for full details.
-On React Native (iOS/Android) interception is injected into the JS runtime \u2014 it captures fetch() calls. On Chromium it reads the browser's native CDP Network domain (the active tab; all request types).
+On React Native (iOS / Android / Vega) interception is injected into the JS runtime \u2014 it captures fetch() calls. On Chromium it reads the browser's native CDP Network domain (the active tab; all request types).
 Use when inspecting outbound HTTP traffic or debugging API calls in the running app.
 Fails if the app is not connected (RN) or the device is not reachable (Chromium).`,
   zodSchema: zodSchema36,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swmansion/argent",
-  "version": "0.15.1-next.7",
+  "version": "0.15.1-next.9",
   "description": "MCP server for iOS Simulator and Android Emulator control",
   "license": "Apache-2.0",
   "repository": {

package/rules/argent.md

@@ -32,7 +32,7 @@ If argent IS available, ignore the rest of this block and follow this rule norma
 
 If argent is ABSENT, treat it as an expected state, not an error to retry. Do not call `mcp__argent__*` tools, do not run `argent` commands, and do not attempt any argent workflow. Tell the user once, and ask if you should continue without argent:
 
-> Argent isn't installed in this environment. To enable the mobile/Chromium tooling this repo is configured for, run `npx @swmansion/argent init -y` (or `npm i -g @swmansion/argent && argent init -y`).
+> Argent isn't installed in this environment. To enable the mobile/Chromium tooling this repo is configured for, run `npx @swmansion/argent@latest init -y` (or `npm i -g @swmansion/argent@latest && argent init -y`).
 > </availability_check>
 
 <tapping_rule>
@@ -119,7 +119,7 @@ Prompt keywords: permission, grant, deny, revoke, reset permission, privacy, cam
 
 TV INTERACTION (APPLE TV / ANDROID TV / FIRE TV)
 Skill: `argent-tv-interact`
-When: Any TV target — a `list-devices` entry with `runtimeKind: "tv"` (Apple TV simulator or Android TV emulator) or `platform:"vega"` / `kind:"vvd"` (Amazon Fire TV / VVD), or the user mentions Apple TV / tvOS / Android TV / leanback / Vega / Fire TV. A TV UI is focus-driven, not touch-driven: drive it with `describe` (read focus) + `tv-remote` (D-pad presses) + `keyboard` (type); `gesture-*` tools do NOT apply. Covers booting the target, app lifecycle, focus navigation, typing, screenshots, and (Vega) VVD lifecycle + Fast Refresh.
+When: Any TV target — a `list-devices` entry with `runtimeKind: "tv"` (Apple TV simulator or Android TV emulator) or `platform:"vega"` / `kind:"vvd"` (Amazon Fire TV / VVD), or the user mentions Apple TV / tvOS / Android TV / leanback / Vega / Fire TV. A TV UI is focus-driven, not touch-driven: drive it with `describe` (read focus) + `tv-remote` (D-pad presses) + `keyboard` (type); `gesture-*` tools do NOT apply. Covers booting the target, app lifecycle, focus navigation, typing, screenshots, and (Vega) VVD lifecycle + Fast Refresh + JS-runtime debugging (evaluate, console logs, network inspector).
 Prompt keywords: apple tv, tvos, android tv, leanback, vega, fire tv, vvd, d-pad
 
 SCREENSHOT DIFF & VISUAL REGRESSION

package/skills/argent-metro-debugger/SKILL.md

@@ -1,12 +1,14 @@
 ---
 name: argent-metro-debugger
-description: Debug a JS runtime via CDP using argent debugger tools. Primary path is React Native via Metro (iOS / Android); a subset of the tools (debugger-connect, debugger-status, debugger-evaluate, debugger-log-registry) also drive a Chromium (CDP) app's renderer (an Electron app, or any Chromium browser exposing CDP) through the same surface. Use when connecting to the runtime, inspecting React components, reading console logs, or evaluating JavaScript.
+description: Debug a JS runtime via CDP using argent debugger tools. Primary path is React Native via Metro (iOS / Android / Vega); a subset of the tools (debugger-connect, debugger-status, debugger-evaluate, debugger-log-registry) also drive a Chromium (CDP) app's renderer (an Electron app, or any Chromium browser exposing CDP) through the same surface. Use when connecting to the runtime, inspecting React components, reading console logs, or evaluating JavaScript.
 ---
 
 ## 1. Prerequisites
 
 For **React Native (iOS / Android)**: requires **Metro dev server running** (default `localhost:8081`) and **a React Native app connected to Metro** (at least one CDP target). Verify via `debugger-status`.
 
+For **Vega (Fire TV)**: requires a **Debug `.vpkg`** (a Release build never attaches) and **Metro reachable from the device** (`vega device start-port-forwarding --port 8081 --forward false`). Verify via `debugger-status`. `debugger-component-tree`, `debugger-inspect-element`, `debugger-reload-metro` and the `react-profiler-*` / `profiler-*` tools are unavailable there — see the `argent-tv-interact` skill.
+
 For **Chromium (CDP)**: requires a Chromium/CDP app already available — an Electron app booted via `boot-device` with `electronAppPath`, or any Chromium browser exposing a CDP port (auto-discovered by `list-devices` on `9222` / `ARGENT_CHROMIUM_PORTS`). The debugger re-uses the page CDP session — `port` is ignored, `device_id` is the `chromium-cdp-<port>` value from `list-devices` / `boot-device`. Only `debugger-connect`, `debugger-status`, `debugger-evaluate`, `debugger-log-registry`, `view-network-logs`, and `view-network-request-details` work on Chromium (the latter two read the browser's native CDP Network recording for the active tab instead of the Metro-injected `fetch` interceptor); `debugger-component-tree`, `debugger-reload-metro`, `debugger-inspect-element`, and the `react-profiler-*` / `profiler-*` tools are RN-only and reject Chromium at the capability gate with `Tool 'X' is not supported on chromium app`.
 
 ### Android: reverse port for Metro
@@ -21,16 +23,16 @@ adb -s <serial> reverse tcp:8081 tcp:8081
 
 ## 2. Tool Overview
 
-All tools accept `port` (default 8081) AND `device_id` (the iOS Simulator UDID or Android serial, a.k.a. `logicalDeviceId` — the CDP-reported id that matches the device). Always make sure you target the correct app on the correct device.
+All tools accept `port` (default 8081) AND `device_id` (the iOS Simulator UDID, Android serial, or Vega serial — a.k.a. `logicalDeviceId`, the CDP-reported id that matches the device). Vega's legacy inspector reports no `logicalDeviceId`, so there keep passing the serial. Always make sure you target the correct app on the correct device.
 
 One Metro port can serve multiple connected devices (e.g. two simulators on `localhost:8081`, or an iOS simulator alongside an Android emulator with `adb reverse` set up). `device_id` pins every debugger/network/profiler call to a specific device so sessions do not collide.
 
 ### Connect & diagnostics
 
-| Tool               | Purpose                                                                                                                                                                                                                                                                                            |
-| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `debugger-connect` | Connect to the JS runtime's CDP (Metro on iOS / Android; the page CDP session on Chromium). Returns port, projectRoot (empty on Chromium), deviceName, appName, `logicalDeviceId`, isNewDebugger, connected. The returned `logicalDeviceId` is the `device_id` for every subsequent debugger call. |
-| `debugger-status`  | Like connect + loadedScripts, enabledDomains, sourceMapReady (no-op on Chromium). **Use to diagnose.**                                                                                                                                                                                             |
+| Tool               | Purpose                                                                                                                                                                                                                                                                                                                                                                |
+| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `debugger-connect` | Connect to the JS runtime's CDP (Metro on iOS / Android / Vega; the page CDP session on Chromium). Returns port, projectRoot (empty on Chromium and on legacy Metro, e.g. Vega), deviceName, appName, `logicalDeviceId` (absent on Vega), isNewDebugger, connected. When a `logicalDeviceId` comes back, use it as the `device_id` for every subsequent debugger call. |
+| `debugger-status`  | Like connect + loadedScripts, enabledDomains, sourceMapReady (no-op on Chromium). **Use to diagnose.**                                                                                                                                                                                                                                                                 |
 
 ### Reload & recovery
 

package/skills/argent-metro-debugger/references/failure-scenarios.md

@@ -2,9 +2,9 @@
 
 When a debugger tool fails, use **`debugger-status`** first to diagnose. Then match the error or situation below and act as specified. Do not retry the same failing tool repeatedly without following the recovery steps.
 
-| Scenario                           | Error or situation                                                                         | What to do                                                                                                                                                                                                                                                                                                                                                      |
-| ---------------------------------- | ------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **Metro not running**              | Error contains: `Metro at port 8081 is not running (got: ...)`                             | **Start Metro yourself** unless the user asked you not to: scan the workspace configuration and run the appropriate command to start Metro in the background (by default `npx react-native start` or `npx expo start`). Wait for Metro to be ready, then retry `debugger-connect` or `debugger-status`. If you cannot determine the project root, ask the user. |
-| **Metro not standard**             | Error contains: `Metro at port 8081 did not return X-React-Native-Project-Root header`     | Something on that port is not the standard React Native Metro server. Try starting Metro yourself from the app's project root using the command resolution above. If you cannot determine the correct root or the problem persists, inform the user what you found and what you tried.                                                                          |
-| **App not connected**              | Error contains: `Metro at port 8081 has no CDP targets — is a React Native app connected?` | 1) Confirm the app is running on the device. 2) Use `restart-app` with the app's device id and bundleId to relaunch so it connects to Metro. 3) Wait a few seconds for the bundle to load. 4) Retry `debugger-status`. Do **not** use `debugger-reload-metro` to fix this — it also requires at least one target.                                               |
-| **Was connected, then tool fails** | Any debugger tool fails with a connection or disconnect error after it was working         | The app may have crashed or been closed. Use `restart-app` to relaunch the app, then call `debugger-connect` again to pick up the fresh `logicalDeviceId` (may change for booted-fresh simulators), and use that new `device_id` on all subsequent calls.                                                                                                       |
+| Scenario                           | Error or situation                                                                         | What to do                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| ---------------------------------- | ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Metro not running**              | Error contains: `Metro at port 8081 is not running (got: ...)`                             | **Start Metro yourself** unless the user asked you not to: scan the workspace configuration and run the appropriate command to start Metro in the background (by default `npx react-native start` or `npx expo start`). Wait for Metro to be ready, then retry `debugger-connect` or `debugger-status`. If you cannot determine the project root, ask the user. A non-Metro server occupying the port lands here too — the `got:` text shows what answered. |
+| **No source locations**            | `projectRoot` is `""` and source lookups report no file:line                               | Not a failure. Legacy Metro (RN 0.72 and older, e.g. Vega) sends no `X-React-Native-Project-Root` header, so paths cannot be resolved against a project root. `debugger-evaluate`, console logs and the network inspector work regardless — do not restart Metro to "fix" it.                                                                                                                                                                               |
+| **App not connected**              | Error contains: `Metro at port 8081 has no CDP targets — is a React Native app connected?` | 1) Confirm the app is running on the device. 2) Use `restart-app` with the app's device id and bundleId to relaunch so it connects to Metro. 3) Wait a few seconds for the bundle to load. 4) Retry `debugger-status`. Do **not** use `debugger-reload-metro` to fix this — it also requires at least one target.                                                                                                                                           |
+| **Was connected, then tool fails** | Any debugger tool fails with a connection or disconnect error after it was working         | The app may have crashed or been closed. Use `restart-app` to relaunch the app, then call `debugger-connect` again to pick up the fresh `logicalDeviceId` (may change for booted-fresh simulators), and use that new `device_id` on all subsequent calls.                                                                                                                                                                                                   |

package/skills/argent-tv-interact/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: argent-tv-interact
-description: Control and inspect TV apps via argent — Apple TV (tvOS), Android TV (leanback), and Amazon Fire TV (Vega). Boot the target, read focus, navigate with the D-pad remote, type, and screenshot. Use when a task targets a TV (runtimeKind "tv", or platform "vega"), or mentions Apple TV / tvOS / Android TV / leanback / Vega / Fire TV / VVD.
+description: Control and inspect TV apps via argent — Apple TV (tvOS), Android TV (leanback), and Amazon Fire TV (Vega). Boot the target, read focus, navigate with the D-pad remote, type, screenshot, and on Vega debug the JS runtime (evaluate, console logs, network inspector). Use when a task targets a TV (runtimeKind "tv", or platform "vega"), or mentions Apple TV / tvOS / Android TV / leanback / Vega / Fire TV / VVD.
 ---
 
 # Argent TV (Apple TV + Android TV + Fire TV)
@@ -58,3 +58,13 @@ Needs a Debug build + Metro running. argent only _connects_ to Metro — start M
 
 - **Apple TV / Android TV:** use the dev-build deep-links above; `npm start` for Metro.
 - **Vega:** build/install a Debug `.vpkg` (`vega device install-app -p <path>`), `npm start`, `vega device start-port-forwarding --port 8081 --forward false`, then `vega device launch-app -a <appId>`. Confirm `http://localhost:8081/json/list` shows a `Hermes React Native` target; `.tsx` edits then hot-reload.
+
+## Debugging the JS runtime (Vega)
+
+Once that same Debug build + Metro setup is in place, the JS-runtime tools work on a Vega VVD: `debugger-connect`, `debugger-status`, `debugger-evaluate`, `debugger-log-registry` (console logs), `view-network-logs`, and `view-network-request-details`. See the `argent-metro-debugger` skill.
+
+Vega's React Native forks RN 0.72 and serves the legacy Hermes inspector, so three things differ from iOS / Android:
+
+- `debugger-component-tree`, `debugger-inspect-element`, `debugger-reload-metro` and the `react-profiler-*` / `profiler-*` tools are **not supported**. Component-tree and inspect-element are hard-blocked: they need `Runtime.addBinding`, which this Hermes acknowledges but never installs. The rest are simply unverified on the legacy inspector. Use `describe` for on-screen structure; with both component tools gated off, component `file:line` tracing has no path on Vega.
+- `debugger-status` reports `isNewDebugger: false`.
+- `projectRoot` is empty (RN 0.72's Metro sends no project-root header), so lookups that resolve paths against the project root return no location.