Method fetchHelpIndex

app/src/AI/Conversation.cpp:1625–1676

* @brief Fetches help.json so a guessed page-name 404 can be self-corrected. */

 * @brief Fetches help.json so a guessed page-name 404 can be self-corrected.
 */
void AI::Conversation::fetchHelpIndex(const QString& callId, const QUrl& missedUrl)
{
  static const QUrl kIndexUrl(
    QStringLiteral("https://raw.githubusercontent.com/Serial-Studio/Serial-Studio/"
                   "master/doc/help/help.json"));

  qCDebug(serialStudioAI) << "meta.fetchHelp redirect-to-index after 404:" << missedUrl.toString();

  QNetworkRequest req(kIndexUrl);
  req.setRawHeader("User-Agent", "SerialStudio-AIAssistant");
  req.setRawHeader("Accept", "application/json");
  req.setTransferTimeout(15 * 1000);
  auto* reply = m_helpFetchNam.get(req);

  connect(reply, &QNetworkReply::finished, this, [this, callId, reply, missedUrl]() {
    QJsonObject result;
    result[QStringLiteral("url")]        = missedUrl.toString();
    result[QStringLiteral("redirected")] = true;

    if (reply->error() != QNetworkReply::NoError) {
      result[QStringLiteral("ok")] = false;
      result[QStringLiteral("error")] =
        QStringLiteral("404 on '%1', and the help index also failed: %2")
          .arg(missedUrl.toString(), reply->errorString());
    } else {
      const auto bytes             = reply->readAll();
      result[QStringLiteral("ok")] = true;
      result[QStringLiteral("note")] =
        QStringLiteral("The page '%1' does not exist. Below is the full "
                       "help index (help.json). Each entry has an `id` "
                       "and a `file` -- pass the file name (without the "
                       ".md extension and with hyphens preserved) to "
                       "meta.fetchHelp on the next call. Common "
                       "mistakes: pass 'Painter-Widget' not 'Painter', "
                       "'API-Reference' not 'API'.")
          .arg(missedUrl.toString());
      result[QStringLiteral("content")] = QString::fromUtf8(bytes);
    }

    reply->deleteLater();

    recordToolResult(callId, QStringLiteral("meta.fetchHelp"), result);
    updateToolCallCard(callId,
                       result.value(QStringLiteral("ok")).toBool() ? CallStatus::Done
                                                                   : CallStatus::Error,
                       result);
    releaseOutstandingToolResult();

    if (m_outstandingToolResults == 0 && m_awaitingConfirm.isEmpty() && !m_reply)
      resumeAfterToolBatch();
  });
}

/**
 * @brief Adds a user message to both history and the UI message list.