@swmansion/argent 0.32.1-next.18 → 0.32.1-next.19

package/dist/mcp-server.mjs

@@ -29170,6 +29170,78 @@ function toMcpToolList(tools, options = {}) {
   return tools.filter((t) => !t.hideFromMcp).map((t) => toMcpTool(t, options));
 }
 
+// ../argent-mcp/src/list-devices-text.ts
+var RUNTIME_PREFIX = "com.apple.CoreSimulator.SimRuntime.";
+var STOPPED_SIMULATORS_HEADER = "iOS simulators that are shut down, one per line (platform, udid, name, runtime, state, tags); start one with boot-device:";
+function isRecord3(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function shortRuntime(runtime) {
+  if (!runtime.startsWith(RUNTIME_PREFIX)) return runtime;
+  const rest = runtime.slice(RUNTIME_PREFIX.length);
+  const match = /^([A-Za-z]+)-(\d+(?:-\d+)*)$/.exec(rest);
+  return match ? `${match[1]} ${match[2].replace(/-/g, ".")}` : rest;
+}
+function cleanEntry(device) {
+  const out = {};
+  for (const [key, value] of Object.entries(device)) {
+    if (value === null || value === void 0) continue;
+    if (key === "isEmulator") continue;
+    if (key === "runtimeKind" && value === "mobile") continue;
+    out[key] = key === "runtime" && typeof value === "string" ? shortRuntime(value) : value;
+  }
+  return out;
+}
+function isStoppedSimulator(device) {
+  if (device.platform !== "ios" && device.platform !== "ios-remote") return false;
+  if ("kind" in device || "external" in device) return false;
+  return typeof device.udid === "string" && device.state === "Shutdown";
+}
+var ONE_LINE_FIELDS = /* @__PURE__ */ new Set(["platform", "udid", "name", "runtime", "state"]);
+function quoteIfNeeded(value) {
+  return value === "" || /[\s"\\]/.test(value) ? JSON.stringify(value) : value;
+}
+function stoppedSimulatorLine(device) {
+  const d = cleanEntry(device);
+  const name = typeof d.name === "string" ? d.name : "";
+  const parts = [String(d.platform), String(d.udid), JSON.stringify(name)];
+  if (typeof d.runtime === "string") parts.push(d.runtime);
+  if (typeof d.state === "string") parts.push(quoteIfNeeded(d.state));
+  for (const [key, value] of Object.entries(d)) {
+    if (ONE_LINE_FIELDS.has(key)) continue;
+    if (value === true) parts.push(key);
+    else if (typeof value === "string" || typeof value === "number")
+      parts.push(`${key}=${quoteIfNeeded(String(value))}`);
+    else parts.push(`${key}=${JSON.stringify(value)}`);
+  }
+  return parts.join(" ");
+}
+function listDevicesText(result) {
+  if (!isRecord3(result) || !Array.isArray(result.devices)) return void 0;
+  if (!result.devices.every(isRecord3)) return void 0;
+  const devices = result.devices;
+  const listed = [];
+  const stopped = [];
+  for (const device of devices) {
+    if (isStoppedSimulator(device)) stopped.push(stoppedSimulatorLine(device));
+    else listed.push(JSON.stringify(cleanEntry(device)));
+  }
+  const rest = [];
+  for (const [key, value] of Object.entries(result)) {
+    if (key === "devices") continue;
+    rest.push(`${JSON.stringify(key)}:${JSON.stringify(value)}`);
+  }
+  const devicesPart = listed.length > 0 ? `[
+${listed.join(",\n")}
+]` : "[]";
+  const object3 = `{"devices":${devicesPart}${rest.map((r) => `,
+${r}`).join("")}}`;
+  if (stopped.length === 0) return object3;
+  return `${object3}
+${STOPPED_SIMULATORS_HEADER}
+${stopped.join("\n")}`;
+}
+
 // ../argent-mcp/src/instructions.ts
 var SERVER_INSTRUCTIONS = "Argent \u2014 iOS Simulator, Android Emulator, and Chromium app control for interacting, testing, profiling and debugging mobile and Chromium applications. Interaction tools return the screen after the action: a screenshot plus the accessibility element tree with normalized tap frames. Take coordinates from that tree; call describe only when no fresh tree is available \u2014 never guess coordinates from pixels. Do not stop simulator servers when a task finishes: the next task reuses them. Call stop-all-simulator-servers when the user asks to clean up or ends the session, or when a skill tells you to recycle a device's services, always with devices: [...] naming the devices this session used. Never stop a Metro the user started unless they ask. One tool-server is shared by every agent using this argent install, so an unscoped call tears down their devices too \u2014 reserve it for a deliberate machine-wide cleanup.";
 
@@ -29480,8 +29552,11 @@ ${hintLine}${desc}` }];
         authToken: AUTH_TOKEN,
         deviceId: getDeviceIdFromArgs(params.arguments)
       };
+      const devicesText = canonicalToolId(params.name) === "list-devices" ? listDevicesText(result) : void 0;
       let content;
-      if (canonicalToolId(params.name) === "e2e-execute" && result && typeof result === "object" && ("e2eTest" in result || "flow" in result) && "steps" in result) {
+      if (devicesText !== void 0) {
+        content = [{ type: "text", text: devicesText }];
+      } else if (canonicalToolId(params.name) === "e2e-execute" && result && typeof result === "object" && ("e2eTest" in result || "flow" in result) && "steps" in result) {
         content = await flowRunToMcpContent(result, ctx);
       } else if (params.name === "screenshot-diff" && isScreenshotDiffResult(result)) {
         content = await screenshotDiffToMcpContent(result, ctx);

package/dist/tool-server.cjs

@@ -128234,6 +128234,8 @@ async function listRemoteIosSimulators() {
     const result = await simctlListDevices();
     const out = [];
     for (const [runtime, devices] of Object.entries(result.devices)) {
+      const runtimeKind = simulatorRuntimeKind(runtime);
+      if (!runtimeKind) continue;
       for (const d of devices) {
         if (d.isAvailable === false) continue;
         out.push({
@@ -128242,7 +128244,7 @@ async function listRemoteIosSimulators() {
           name: d.name,
           state: d.state,
           runtime,
-          runtimeKind: simulatorRuntimeKind(runtime)
+          runtimeKind
         });
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swmansion/argent",
-  "version": "0.32.1-next.18",
+  "version": "0.32.1-next.19",
   "mcpName": "io.github.software-mansion/argent",
   "description": "MCP server for iOS Simulator, Android Emulator, Chromium app and Mac app control",
   "license": "Apache-2.0",

package/skills/argent-ios-simulator-setup/SKILL.md

@@ -5,7 +5,7 @@ description: Set up and connect to an iOS simulator using argent MCP tools. Use
 
 ## 1. Setup Steps
 
-1. **Find a booted simulator.** Use `list-devices`. Filter for entries with `platform: "ios"` and skip `kind: "device"` (a physical iPhone): booted simulators are listed first. If no fitting simulator is booted, call `boot-device` with `udid: <chosen UDID>`.
+1. **Find a booted simulator.** Use `list-devices`. Filter for entries with `platform: "ios"` and skip `kind: "device"` (a physical iPhone): booted simulators are listed first. Through MCP, simulators that are shut down follow the JSON object, one line each, with the udid second. If no fitting simulator is booted, call `boot-device` with `udid: <chosen UDID>`.
 2. **No connect step.** Interaction tools (`gesture-tap`, `describe`, `screenshot`, …) auto-start the simulator server on first use.
 
 ## 2. Notes