Method onToolCallRequested

app/src/AI/Conversation.cpp:477–509

* @brief Records a tool-use request and dispatches per safety tag. */

 * @brief Records a tool-use request and dispatches per safety tag.
 */
void AI::Conversation::onToolCallRequested(const QString& callId,
                                           const QString& requestedName,
                                           const QJsonObject& arguments,
                                           const QJsonObject& extras)
{
  if (m_cancelled)
    return;

  const QString name = m_dispatcher->canonicalToolName(requestedName);
  ++m_toolCallCount;
  if (m_toolCallCount > kMaxToolCalls) {
    qCWarning(serialStudioAI) << "Tool-call budget exceeded; forcing summary";
    m_summaryForced = true;

    m_pendingToolUseBlocks.append(makeToolUseBlock(callId, name, arguments, extras));

    QJsonObject denial;
    denial[QStringLiteral("error")] =
      tr("Tool-call budget reached for this turn; no further tools will run.");
    recordToolResult(callId, name, denial);
    updateToolCallCard(callId, CallStatus::Blocked, denial);
    return;
  }

  m_pendingToolUseBlocks.append(makeToolUseBlock(callId, name, arguments, extras));

  ++m_outstandingToolResults;

  if (dispatchMetaTool(callId, name, arguments))
    return;

  dispatchByCallSafety(callId, name, arguments);
}

/**
 * @brief Auto-handles meta-tool calls; returns true when consumed.