The aim of waitForEx is to repair the stack trace the users sees the 'expected' stack trace rather than the microtask stack trace.

wait_for_ex.dart

T waitForEx<T>(Future<T> future) {
  Exception exception;
  T value;
  try {
    value = cli.waitFor<T>(future);
  }
  // ignore: avoid_catching_errors
  on AsyncError catch (e) {
    if (e.error is Exception) {
      exception = e.error as Exception;
    } else {
      Settings().verbose('Rethrowing a non DCliException $e');
      rethrow;
    }
  }

  if (exception != null) {
    // recreate the exception so we have a full
    // stacktrace rather than the microtask
    // stacktrace the future leaves us with.
    final stackTrace = StackTraceImpl(skipFrames: 2);

    if (exception is DCliException) {
      throw exception.copyWith(stackTrace);
    } else {
      /// Want to change this so we can throw the original exception with the repaired stack trace.
      throw DCliException.from(exception, stackTrace);
    }
  }
  return value;
}