@swmansion/argent 0.21.1-next.1 → 0.21.1-next.10

package/dist/cli-cmds.mjs

@@ -7214,7 +7214,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID2 = randomUUID5();
 function readCliVersion() {
   if (true) {
-    return "0.21.0";
+    return "0.21.1-next.10";
   }
   return "0.0.0";
 }

package/dist/installer.mjs

@@ -16434,7 +16434,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID = randomUUID4();
 function readCliVersion() {
   if (true) {
-    return "0.21.0";
+    return "0.21.1-next.10";
   }
   return "0.0.0";
 }

package/dist/tool-server.cjs

@@ -95690,7 +95690,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID = (0, import_node_crypto3.randomUUID)();
 function readCliVersion() {
   if (true) {
-    return "0.21.0";
+    return "0.21.1-next.10";
   }
   return "0.0.0";
 }
@@ -111799,7 +111799,21 @@ function adaptAXDescribeToDescribeResult(response) {
 }
 
 // ../tool-server/src/tools/describe/platforms/ios/index.ts
-var DEGRADED_HINT = "This simulator was not booted through argent \u2014 system dialogs and native modals may not appear. You MUST call boot-device with force=true now to restart the simulator and apply full accessibility settings before continuing.";
+var DEGRADED_BLIND_HINT = "The accessibility read returned no elements, and this simulator was not booted through argent, so the pre-boot accessibility settings were never applied. Unless the screen is genuinely blank, call boot-device with force=true to reboot it with those settings \u2014 this restarts the simulator";
+var DEGRADED_STANDING_HINT = "This simulator was not booted through argent, so system dialogs and native modals may not appear in this tree; everything else reads normally. If something you expect is missing, boot-device with force=true reboots the simulator with the full accessibility settings";
+var bootCaveatToldDevices = /* @__PURE__ */ new Set();
+function withBootCaveatOncePerDevice(deviceId, data) {
+  if (data.hint !== DEGRADED_STANDING_HINT) {
+    if (data.hint !== DEGRADED_BLIND_HINT) bootCaveatToldDevices.delete(deviceId);
+    return data;
+  }
+  if (!bootCaveatToldDevices.has(deviceId)) {
+    bootCaveatToldDevices.add(deviceId);
+    return data;
+  }
+  const { hint: _alreadyTold, ...rest } = data;
+  return rest;
+}
 function tcpArtifactHint(err) {
   const message = err instanceof Error ? err.message : typeof err === "string" ? err : "";
   return /TCP-transport (?:binary|dylib) not found/.test(message) ? message : void 0;
@@ -111820,17 +111834,21 @@ async function describeIos(registry2, device, params, options = {}) {
     return { tree: emptyTree(), source: "ax-service", hint: TVOS_HINT };
   }
   let tree;
-  let hint;
+  let degraded;
+  let resolverHint;
   try {
     const axRef = axServiceRef(device);
     const axApi = await registry2.resolveService(axRef.urn, axRef.options);
     const response = await axApi.describe();
     tree = adaptAXDescribeToDescribeResult(response);
-    hint = axApi.degraded ? DEGRADED_HINT : void 0;
+    degraded = axApi.degraded;
   } catch (err) {
     tree = emptyTree();
-    hint = tcpArtifactHint(err) ?? DEGRADED_HINT;
+    resolverHint = tcpArtifactHint(err);
+    degraded = resolverHint === void 0;
   }
+  const degradedHint = !degraded ? void 0 : tree.children.length === 0 ? DEGRADED_BLIND_HINT : DEGRADED_STANDING_HINT;
+  const hint = resolverHint ?? degradedHint;
   if (tree.children.length > 0) {
     return { tree, source: "ax-service", hint };
   }
@@ -131784,7 +131802,12 @@ function makeDescribeExecute(registry2) {
       requires: iosRequires,
       handler: async (_services, params, device) => (
         // Probe tvOS once here, then pass the verdict into describeIos.
-        await isTvOsSimulator(device.id) ? describeTv(registry2, device) : withDescription(await describeIos(registry2, device, params, { isTvOs: false }))
+        await isTvOsSimulator(device.id) ? describeTv(registry2, device) : withDescription(
+          withBootCaveatOncePerDevice(
+            device.id,
+            await describeIos(registry2, device, params, { isTvOs: false })
+          )
+        )
       )
     },
     iosRemote: {
@@ -131793,7 +131816,12 @@ function makeDescribeExecute(registry2) {
       // ios-remote. Only the preflight dep differs. Remote sims are iOS-only
       // (never tvOS), so the isTvOs verdict is always false.
       requires: ["sim-remote"],
-      handler: async (_services, params, device) => withDescription(await describeIos(registry2, device, params, { isTvOs: false }))
+      handler: async (_services, params, device) => withDescription(
+        withBootCaveatOncePerDevice(
+          device.id,
+          await describeIos(registry2, device, params, { isTvOs: false })
+        )
+      )
     },
     android: {
       requires: androidRequires,
@@ -136339,13 +136367,13 @@ function summarizeHangBlocking(states) {
 var MAX_INLINE_HOTSPOTS = 5;
 var MAX_INLINE_HANGS = 3;
 async function renderNativeProfilerReport(input) {
-  const { payload, traceFile, freshnessNote, mallocStackLogging } = input;
+  const { payload, traceFile, freshnessNote, cpuDiagnostic, mallocStackLogging } = input;
   const exportErrors = input.exportErrors ?? {};
   const bottlenecksTotal = payload.bottlenecks.length;
   const status = Object.keys(exportErrors).length > 0 ? "analysis_failed" : "ok";
   const cpuHotspotsCount = payload.bottlenecks.filter((b) => b.type === "cpu_hotspot").length;
   const uiHangsCount = payload.bottlenecks.filter((b) => b.type === "ui_hang").length;
-  const fullReport = bottlenecksTotal === 0 ? renderAllClear2(payload, exportErrors, freshnessNote) : renderFullReport(
+  const fullReport = bottlenecksTotal === 0 ? renderAllClear2(payload, exportErrors, freshnessNote, cpuDiagnostic) : renderFullReport(
     payload,
     exportErrors,
     {
@@ -136353,11 +136381,12 @@ async function renderNativeProfilerReport(input) {
       hangLimit: Infinity
     },
     freshnessNote,
-    mallocStackLogging
+    mallocStackLogging,
+    cpuDiagnostic
   );
   const reportFile = traceFile ? deriveReportPath(traceFile) : null;
   const wroteFile = reportFile ? await writeReport2(reportFile, fullReport) : false;
-  const inlineReport = bottlenecksTotal === 0 ? renderAllClear2(payload, exportErrors, freshnessNote) : renderFullReport(
+  const inlineReport = bottlenecksTotal === 0 ? renderAllClear2(payload, exportErrors, freshnessNote, cpuDiagnostic) : renderFullReport(
     payload,
     exportErrors,
     {
@@ -136365,13 +136394,19 @@ async function renderNativeProfilerReport(input) {
       hangLimit: MAX_INLINE_HANGS
     },
     freshnessNote,
-    mallocStackLogging
+    mallocStackLogging,
+    cpuDiagnostic
   );
   const shownHotspots = Math.min(MAX_INLINE_HOTSPOTS, cpuHotspotsCount);
   const shownHangs = Math.min(MAX_INLINE_HANGS, uiHangsCount);
+  const shownParts = [
+    ...shownHotspots > 0 ? [`top ${shownHotspots} CPU hotspots`] : [],
+    ...shownHangs > 0 ? [`top ${shownHangs} hangs`] : []
+  ];
+  const shownSummary = shownParts.length > 0 ? `showing ${shownParts.join(" and ")} inline` : `summary inline`;
   const report = wroteFile && reportFile ? inlineReport + `
 
-> Full report saved \u2014 ${bottlenecksTotal} bottleneck(s) total, showing top ${shownHotspots} CPU hotspots and top ${shownHangs} hangs inline. Use the Read tool on the \`reportFile\` path in this result to view all details.` : inlineReport;
+> Full report saved \u2014 ${bottlenecksTotal} bottleneck(s) total, ${shownSummary}. Use the Read tool on the \`reportFile\` path in this result to view all details.` : inlineReport;
   return {
     report,
     reportFile: wroteFile ? reportFile : null,
@@ -136411,7 +136446,7 @@ function renderTraceProcessorUnavailable(err) {
 function reportTitle(payload) {
   return payload.metadata.platform.toLowerCase() === "android" ? "Android Perfetto Analysis" : "iOS Instruments Analysis";
 }
-function renderAllClear2(payload, exportErrors, freshnessNote) {
+function renderAllClear2(payload, exportErrors, freshnessNote, cpuDiagnostic) {
   const traceName = payload.metadata.traceFile ? `\`${path24.basename(payload.metadata.traceFile)}\`` : "unknown";
   const lines = [
     `# ${reportTitle(payload)}`,
@@ -136420,6 +136455,7 @@ function renderAllClear2(payload, exportErrors, freshnessNote) {
     ``
   ];
   if (freshnessNote) lines.push(freshnessNote, ``);
+  if (cpuDiagnostic) lines.push(`> \u26A0\uFE0F **CPU sampling:** ${cpuDiagnostic}`, ``);
   const errorLines = renderExportErrors(exportErrors);
   if (errorLines.length > 0) {
     lines.push(...errorLines, ``);
@@ -136439,7 +136475,7 @@ function renderAllClear2(payload, exportErrors, freshnessNote) {
   }
   return lines.join("\n");
 }
-function renderFullReport(payload, exportErrors, cap = { hotspotLimit: Infinity, hangLimit: Infinity }, freshnessNote, mallocStackLogging) {
+function renderFullReport(payload, exportErrors, cap = { hotspotLimit: Infinity, hangLimit: Infinity }, freshnessNote, mallocStackLogging, cpuDiagnostic) {
   const traceName = payload.metadata.traceFile ? `\`${path24.basename(payload.metadata.traceFile)}\`` : "unknown";
   const cpuHotspots = payload.bottlenecks.filter((b) => b.type === "cpu_hotspot");
   const uiHangs = payload.bottlenecks.filter((b) => b.type === "ui_hang");
@@ -136454,6 +136490,7 @@ function renderFullReport(payload, exportErrors, cap = { hotspotLimit: Infinity,
     ``
   ];
   if (freshnessNote) lines.push(freshnessNote, ``);
+  if (cpuDiagnostic) lines.push(`> \u26A0\uFE0F **CPU sampling:** ${cpuDiagnostic}`, ``);
   const errorLines = renderExportErrors(exportErrors);
   if (errorLines.length > 0) {
     lines.push(...errorLines, ``);
@@ -138044,8 +138081,13 @@ async function runAndroidProfilerPipeline(tracePath, appPackage) {
     exportErrors.rss = msg;
   });
   if (cpuRows.length === 0 && hangRows.length === 0 && !exportErrors.cpu) {
-    exportErrors.cpu = `No CPU samples were captured for cmdline \`${appPackage}\`. The most common cause is the target app being non-debuggable (release build) without a \`<profileable shell="true">\` entry in its AndroidManifest.xml. Without that, Perfetto silently drops the linux.perf data source. Add \`<profileable android:shell="true"/>\` to the \`<application>\` element and rebuild, or run a debug variant of the app.`;
+    exportErrors.cpu = `No CPU samples were captured for cmdline \`${appPackage}\`. The trace contains no perf_sample rows for a process with that name, so no CPU analysis is possible. Either the name never matched a running process (it must equal the process cmdline exactly), or the app was never scheduled on-CPU during the recording. If it was running, it must be a debug build or declare \`<profileable android:shell="true"/>\` under \`<application>\` in its AndroidManifest.xml \u2014 then re-record.`;
   }
+  const stacklessSamples = cpuRows.reduce(
+    (sum, r) => r.leaf_function ? sum : sum + Number(r.sample_count),
+    0
+  );
+  const cpuDiagnostic = cpuRows.length > 0 && !cpuRows.some((r) => r.leaf_function) && stacklessSamples > 0 ? describeStacklessSamples(appPackage, cpuRows, stacklessSamples) : void 0;
   const cpuHotspots = aggregateCpuHotspots(cpuRowsToAggregatorRows(cpuRows, traceStartNs), {
     platform: "android"
   });
@@ -138073,7 +138115,14 @@ async function runAndroidProfilerPipeline(tracePath, appPackage) {
   });
   const rssGrowth = rssRowsToBottlenecks(rssRows);
   const bottlenecks = [...cpuHotspots, ...uiHangs, ...rssGrowth];
-  return { bottlenecks, cpuHotspots, uiHangs, rssGrowth, exportErrors };
+  return {
+    bottlenecks,
+    cpuHotspots,
+    uiHangs,
+    rssGrowth,
+    exportErrors,
+    ...cpuDiagnostic ? { cpuDiagnostic } : {}
+  };
 }
 async function loadAndroidCombinedData(tracePath, appPackage) {
   const target = sanitizeProcessName(appPackage);
@@ -138306,6 +138355,11 @@ async function renderThreadBreakdownAndroid(opts, target) {
   }
   return lines.join("\n");
 }
+function describeStacklessSamples(appPackage, cpuRows, stacklessSamples) {
+  const unwound = cpuRows.some((r) => r.leaf_mapping);
+  const head = `${stacklessSamples} CPU sample${stacklessSamples === 1 ? "" : "s"} were captured for \`${appPackage}\`, but none carry a usable call stack, so no CPU hotspots could be computed and \`profiler-stack-query\` mode=\`function_callers\` / mode=\`hang_stacks\` will find nothing. The app was running \u2014 this is a capture limitation, not an idle app. mode=\`thread_breakdown\` still works, since it counts samples and needs no stacks.`;
+  return unwound ? `${head} The stacks were unwound but no frame resolved to a symbol, which points at stripped native libraries. Profile a build that keeps its symbols (a debug build, or a release build with unstripped \`.so\`s).` : `${head} No stack was unwound at all: Perfetto only unwinds a process it can read \`/proc/<pid>/mem\` for. Profile a debug build, or add \`<profileable android:shell="true"/>\` to \`<application>\` and rebuild \u2014 verify with \`adb shell dumpsys package ${appPackage}\`, which shows \`DEBUGGABLE\` for a profileable target. Platform packages such as \`com.android.settings\` are never profileable.`;
+}
 function cpuRowsToAggregatorRows(rows, traceStartNs) {
   const traceStartMs = Math.round(traceStartNs / 1e6);
   const out = [];
@@ -138647,7 +138701,9 @@ async function analyzeNativeProfilerAndroid(api) {
     // wallClockStartMs is the recording's start time (set at start, persisted in
     // the metadata sidecar, restored by profiler-load). A large gap to "now"
     // means we're analyzing a trace from an earlier session, not a fresh capture.
-    freshnessNote: formatTraceFreshness(api.wallClockStartMs, Date.now()) ?? void 0
+    freshnessNote: formatTraceFreshness(api.wallClockStartMs, Date.now()) ?? void 0,
+    // Explains an absent CPU section when samples exist but carry no stacks.
+    cpuDiagnostic: pipelineResult.cpuDiagnostic
   });
 }
 

package/package.json

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