@@ -126,7 +126,7 @@ export async function captureAndroidHeapSnapshot(
         pid,
         path: outPath,
         remotePath,
-        hint: 'Retry with a writable --out path. If the file is still empty, inspect adb pull output with --debug.',
+        hint: 'Retry with a writable --out path. If the file is still empty, check that the device can write the heap dump at remotePath.',
       });
     }
 
@@ -240,7 +240,7 @@ function resolveAndroidHeapDumpHint(stdout: string, stderr: string): string {
   if (text.includes('permission') || text.includes('denied')) {
     return 'The device denied heap dump access. Use a debug/profileable build or a device image that permits app heap dumping.';
   }
-  return 'Reopen the app to refresh the process, then retry perf memory snapshot. If it still fails, rerun it with --json and read the adb am dumpheap output in error.details.stderr.';
+  return 'Reopen the app to refresh the process, then retry perf memory snapshot. If it still fails, read the adb am dumpheap output in error.details.stdout and error.details.stderr (--json).';
 }
 
 function parseAndroidMemInfoTopConsumers(stdout: string): AndroidMemoryConsumer[] | undefined {
 
@@ -172,7 +172,7 @@ export async function captureAppleMemorySnapshot(
       appBundleId,
       pid: processInfo.pid,
       path: outPath,
-      hint: 'Retry with a writable --out path. If the file is still empty, rerun it with --json and read the leaks output in error.details.stderr.',
+      hint: 'Retry with a writable --out path. If the file is still empty, check free disk space at path.',
     });
   }
 
@@ -252,7 +252,7 @@ function annotateAppleMemorySnapshotToolError(
       pid: processInfo.pid,
       processName: path.basename(readProcessCommandToken(processInfo.command)),
       path: outPath,
-      hint: 'Retry perf memory snapshot. If it still fails, rerun it with --json and read the leaks output in error.details.stderr.',
+      hint: 'Retry perf memory snapshot. If it still fails, the Cause line names the leaks failure.',
     },
     error,
   );
@@ -666,7 +666,7 @@ function resolveAppleMemorySnapshotHint(
       ? 'Grant the agent terminal process permission to inspect this macOS app, then retry.'
       : 'Keep the simulator booted and app running; if inspection is denied, retry with a debug simulator build.';
   }
-  return 'Keep the app process running and retry perf memory snapshot with --debug if the failure persists.';
+  return 'Keep the app process running and retry perf memory snapshot. If it still fails, read the leaks output in error.details.stdout and error.details.stderr (--json).';
 }
 
 function buildAppleMemoryPerfSample(args: {
Original file line number	Diff line number	Diff line change
`@@ -126,7 +126,7 @@ export async function captureAndroidHeapSnapshot(`
`126`	`126`	`pid,`
`127`	`127`	`path: outPath,`
`128`	`128`	`remotePath,`
`129`		`- hint: 'Retry with a writable --out path. If the file is still empty, inspect adb pull output with --debug.',`
	`129`	`+ hint: 'Retry with a writable --out path. If the file is still empty, check that the device can write the heap dump at remotePath.',`
`130`	`130`	`});`
`131`	`131`	`}`
`132`	`132`
`@@ -240,7 +240,7 @@ function resolveAndroidHeapDumpHint(stdout: string, stderr: string): string {`
`240`	`240`	`if (text.includes('permission') \|\| text.includes('denied')) {`
`241`	`241`	`return 'The device denied heap dump access. Use a debug/profileable build or a device image that permits app heap dumping.';`
`242`	`242`	`}`
`243`		`- return 'Reopen the app to refresh the process, then retry perf memory snapshot. If it still fails, rerun it with --json and read the adb am dumpheap output in error.details.stderr.';`
	`243`	`+ return 'Reopen the app to refresh the process, then retry perf memory snapshot. If it still fails, read the adb am dumpheap output in error.details.stdout and error.details.stderr (--json).';`
`244`	`244`	`}`
`245`	`245`
`246`	`246`	`function parseAndroidMemInfoTopConsumers(stdout: string): AndroidMemoryConsumer[] \| undefined {`