Method completeHelpFetch

app/src/AI/Conversation.cpp:1564–1620

* @brief Finalizes a meta.fetchHelp request: parses the body, records, resumes. */

 * @brief Finalizes a meta.fetchHelp request: parses the body, records, resumes.
 */
void AI::Conversation::completeHelpFetch(const QString& callId,
                                         const QUrl& url,
                                         QNetworkReply* reply)
{
  const auto status    = reply->attribute(QNetworkRequest::HttpStatusCodeAttribute).toInt();
  const auto netError  = reply->error();
  const auto host      = url.host();
  const auto path      = url.path();
  const bool isHelpDoc = host.endsWith(QStringLiteral("githubusercontent.com"))
                      && path.contains(QStringLiteral("/doc/help/"));

  QJsonObject result;
  result[QStringLiteral("url")] = url.toString();

  if (status == 404 && isHelpDoc && !path.endsWith(QStringLiteral("help.json"))) {
    reply->deleteLater();
    fetchHelpIndex(callId, url);
    return;
  }

  if (netError != QNetworkReply::NoError) {
    result[QStringLiteral("ok")]    = false;
    result[QStringLiteral("error")] = reply->errorString();
  } else {
    const auto bytes         = reply->readAll();
    const bool isRawMarkdown = host.endsWith(QStringLiteral("githubusercontent.com"))
                            || path.endsWith(QStringLiteral(".md"), Qt::CaseInsensitive);

    QString text;
    if (isRawMarkdown) {
      text = QString::fromUtf8(bytes);
    } else {
      QTextDocument doc;
      doc.setHtml(QString::fromUtf8(bytes));
      text = doc.toPlainText();
    }

    constexpr int kMaxBytes = 32 * 1024;
    if (text.size() > kMaxBytes)
      text = text.left(kMaxBytes) + QStringLiteral("\n... [truncated]");

    result[QStringLiteral("ok")]      = true;
    result[QStringLiteral("content")] = text;
  }

  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();
}