Method read

app/src/AI/FileSandbox.cpp:405–453

* @brief Reads a byte slice of a file under the read roots, paged via offset/limit. */

 * @brief Reads a byte slice of a file under the read roots, paged via offset/limit.
 */
QJsonObject AI::FileSandbox::read(const QJsonObject& args) const
{
  const auto resolved = resolveRead(args.value(QStringLiteral("path")).toString());
  if (!resolved.ok)
    return failure(resolved.error, resolved.hint);

  QFileInfo info(resolved.path);
  if (!info.isFile())
    return failure(QStringLiteral("not_a_file"),
                   QStringLiteral("Use fs.list for directories; fs.read expects a file."));

  QFile file(resolved.path);
  if (!file.open(QIODevice::ReadOnly))
    return failure(QStringLiteral("open_failed"), file.errorString());

  if (info.isSymLink() || !openedPathWithinRoots(file.fileName(), readRoots()))
    return failure(QStringLiteral("outside_sandbox"),
                   QStringLiteral("Refusing to read a symlinked or sandbox-escaping path."));

  const qint64 total  = file.size();
  const qint64 offset = qBound<qint64>(0, args.value(QStringLiteral("offset")).toInteger(0), total);
  const qint64 want   = args.value(QStringLiteral("limit")).toInt(kMaxReadSlice);
  const qint64 limit  = qBound<qint64>(1, want, kMaxReadSlice);

  if (!file.seek(offset))
    return failure(QStringLiteral("seek_failed"), file.errorString());

  const QByteArray sniff = file.peek(qMin<qint64>(limit, kBinarySniffBytes));
  if (looksBinary(sniff))
    return failure(QStringLiteral("binary_file"),
                   QStringLiteral("File appears binary. fs.read returns text only; request a "
                                  "different file or a known text range."));

  const QByteArray chunk = file.read(limit);
  const qint64 next      = offset + chunk.size();

  QJsonObject out;
  out[QStringLiteral("ok")]            = true;
  out[QStringLiteral("path")]          = displayPath(resolved.path, workspaceRoot());
  out[QStringLiteral("content")]       = QString::fromUtf8(chunk);
  out[QStringLiteral("offset")]        = static_cast<double>(offset);
  out[QStringLiteral("bytesReturned")] = static_cast<double>(chunk.size());
  out[QStringLiteral("totalBytes")]    = static_cast<double>(total);
  out[QStringLiteral("eof")]           = (next >= total);
  if (next < total)
    out[QStringLiteral("nextOffset")] = static_cast<double>(next);

  return out;
}

//--------------------------------------------------------------------------------------------------
// search