Method executeCommand

app/src/AI/ToolDispatcher.cpp:2206–2278

* @brief Validates args and forwards to API::CommandRegistry honoring AI safety tags. */

 * @brief Validates args and forwards to API::CommandRegistry honoring AI safety tags.
 */
QJsonObject AI::ToolDispatcher::executeCommand(const QString& requestedName,
                                               const QJsonObject& args,
                                               bool autoConfirmSafe)
{
  const QString name = canonicalToolName(requestedName);
  Misc::JsonValidator::Limits limits;
  limits.maxFileSize  = 1 * 1024 * 1024;
  limits.maxDepth     = 32;
  limits.maxArraySize = 1000;

  if (!Misc::JsonValidator::validateStructure(QJsonValue(args), limits)) {
    qCWarning(AI::serialStudioAI) << "Tool args validation failed for" << name;
    QJsonObject reply;
    reply[QStringLiteral("ok")]    = false;
    reply[QStringLiteral("error")] = QStringLiteral("args_validation_failed");
    reply[QStringLiteral("repair")] =
      QStringLiteral("The arguments object failed structural validation (too deeply nested, "
                     "too many array items, or too large). Call meta.describeCommand{name: "
                     "\"%1\"} and rebuild a minimal arguments object that matches the schema.")
        .arg(name);
    return reply;
  }

  const auto safety        = AI::CommandRegistry::instance().safetyOf(name);
  const bool isDryRunQuery = args.value(QStringLiteral("dryRun")).toBool(false);
  if (safety == Safety::Blocked)
    return makeBlockedReply(name);

  if ((safety == Safety::Confirm || safety == Safety::AlwaysConfirm) && !autoConfirmSafe
      && !isDryRunQuery) {
    Q_EMIT confirmationRequested(name, args);
    QJsonObject reply;
    reply[QStringLiteral("ok")]    = false;
    reply[QStringLiteral("error")] = QStringLiteral("awaiting_confirmation");
    reply[QStringLiteral("message")] =
      QStringLiteral("User approval pending. The chat UI is showing an approval card for this "
                     "tool call. Do not retry, do not invoke with confirm/force/token params -- "
                     "the result will arrive automatically once the user clicks Approve or Deny.");
    reply[QStringLiteral("hint")] =
      QStringLiteral("If you intend many similar destructive operations, queue them all and let "
                     "the user use the Approve-all group action in the chat. Retrying this call "
                     "will only queue another pending approval -- it cannot bypass the gate.");
    return reply;
  }

  if (isAssistantTool(name))
    return executeAssistantTool(name, args);

  if (isFsTool(name))
    return executeFsTool(name, args);

  const auto callId   = QUuid::createUuid().toString(QUuid::WithoutBraces);
  const auto response = API::CommandRegistry::instance().execute(name, callId, args);

  QJsonObject reply;
  reply[QStringLiteral("ok")] = response.success;
  if (response.success)
    reply[QStringLiteral("result")] = response.result;