Method list

app/src/AI/FileSandbox.cpp:368–396

* @brief Lists a directory under the read roots; supports bounded recursion. */

 * @brief Lists a directory under the read roots; supports bounded recursion.
 */
QJsonObject AI::FileSandbox::list(const QJsonObject& args) const
{
  const auto input    = args.value(QStringLiteral("path")).toString();
  const auto resolved = resolveRead(input.isEmpty() ? QStringLiteral(".") : input);
  if (!resolved.ok)
    return failure(resolved.error, resolved.hint);

  const QFileInfo info(resolved.path);
  if (!info.isDir())
    return failure(QStringLiteral("not_a_directory"),
                   QStringLiteral("Use fs.read for files; fs.list expects a directory."));

  bool truncated       = false;
  const bool recursive = args.value(QStringLiteral("recursive")).toBool(false);
  QJsonArray rows;
  collectEntries(resolved.path, workspaceRoot(), recursive, 0, rows, truncated);

  QJsonObject out;
  out[QStringLiteral("ok")]        = true;
  out[QStringLiteral("path")]      = displayPath(resolved.path, workspaceRoot());
  out[QStringLiteral("count")]     = rows.size();
  out[QStringLiteral("entries")]   = rows;
  out[QStringLiteral("truncated")] = truncated;
  if (truncated)
    out[QStringLiteral("hint")] =
      QStringLiteral("Listing capped; narrow the path or list subdirectories individually.");

  return out;
}

//--------------------------------------------------------------------------------------------------
// read