Function runOffMainThread

app/src/AI/ToolDispatcher.cpp:585–612

* @brief Runs blocking work on a worker thread; a main-thread reentrancy guard makes a * re-entrant fs tool fail fast rather than spin a second nested event loop. */

 *        re-entrant fs tool fail fast rather than spin a second nested event loop.
 */
static QJsonObject runOffMainThread(const std::function<QJsonObject()>& work)
{
  if (QThread::currentThread() != QCoreApplication::instance()->thread())
    return work();

  static bool s_inNestedLoop = false;
  if (s_inNestedLoop) {
    QJsonObject out;
    out[QStringLiteral("ok")]    = false;
    out[QStringLiteral("error")] = QStringLiteral("fs_tool_busy");
    out[QStringLiteral("hint")]  = QStringLiteral("Another filesystem tool is still running. Wait "
                                                  "for it to finish, then retry this call.");
    return out;
  }

  s_inNestedLoop = true;
  const QScopeGuard clearGuard([] { s_inNestedLoop = false; });

  QJsonObject result;
  QEventLoop loop;
  QThread* worker = QThread::create([&]() { result = work(); });
  QObject::connect(worker, &QThread::finished, &loop, &QEventLoop::quit);
  worker->start();
  loop.exec();
  worker->wait();
  delete worker;
  return result;
}

/**
 * @brief Routes an fs.* tool call to the FileSandbox primitive.