Method recordToolResult

app/src/AI/Conversation.cpp:1870–1920

* @brief Stores a tool_result block to be sent back in the next request. */

 * @brief Stores a tool_result block to be sent back in the next request.
 */
void AI::Conversation::recordToolResult(const QString& callId,
                                        const QString& name,
                                        const QJsonObject& payload)
{
  if (!m_busy) {
    qCWarning(serialStudioAI) << "Dropping tool result for" << name << "(" << callId
                              << "): no turn in flight (late completion after error/cancel)";
    return;
  }

  const auto scrubbed = AI::Redactor::scrubObject(payload);

  constexpr int kFsResultByteBudget = 48 * 1024;
  const bool isFsReadResult         = name == QStringLiteral("fs.read")
                           || name == QStringLiteral("fs.search")
                           || name == QStringLiteral("fs.list");
  const int kMaxToolResultBytes =
    isFsReadResult ? kFsResultByteBudget
                   : qBound(2048,
                            m_provider ? m_provider->capabilities().toolResultByteBudget : 4096,
                            16 * 1024);

  QJsonObject effective = scrubbed;
  auto contentBytes     = QJsonDocument(scrubbed).toJson(QJsonDocument::Compact);
  if (contentBytes.size() > kMaxToolResultBytes) {
    effective    = makeTruncatedResult(scrubbed, contentBytes, kMaxToolResultBytes);
    contentBytes = QJsonDocument(effective).toJson(QJsonDocument::Compact);
    qCDebug(serialStudioAI) << "Tool result for" << name << "truncated to" << contentBytes.size()
                            << "bytes";
  }

  const auto sourceTag = name.isEmpty() ? QStringLiteral("tool_result") : name;
  QString wrapped;
  wrapped += QStringLiteral("<untrusted source=\"");
  wrapped += sourceTag.toHtmlEscaped();
  wrapped += QStringLiteral("\">\n");
  wrapped += neutralizeUntrustedDelimiter(QString::fromUtf8(contentBytes));
  wrapped += QStringLiteral("\n</untrusted>");

  QJsonObject block;
  block[QStringLiteral("type")]                       = QStringLiteral("tool_result");
  block[QStringLiteral("tool_use_id")]                = callId;
  block[QStringLiteral("content")]                    = wrapped;
  QJsonObject geminiPayload                           = effective;
  geminiPayload[QStringLiteral("__untrusted_source")] = sourceTag;
  block[QStringLiteral("_gemini_response")]           = geminiPayload;
  if (!name.isEmpty())
    block[QStringLiteral("_tool_name")] = name;

  m_pendingToolResultBlocks.append(block);
}

/**
 * @brief Decrements the outstanding tool-result counter without underflowing past zero.