Method listCommands

app/src/AI/ToolDispatcher.cpp:1944–1996

@brief Returns a compact name+description list of every command, optionally * filtered by prefix and windowed by offset/limit (limit 0 = all). */

/** @brief Returns a compact name+description list of every command, optionally
 *         filtered by prefix and windowed by offset/limit (limit 0 = all). */
QJsonObject AI::ToolDispatcher::listCommands(const QString& prefix, int offset, int limit) const
{
  const auto& commands = API::CommandRegistry::instance().commands();
  const auto& aiReg    = AI::CommandRegistry::instance();

  QJsonArray entries;
  auto appendVirtual = [&entries, &prefix](const QVector<detail::AssistantToolDef>& defs) {
    for (const auto& def : defs) {
      if (!prefix.isEmpty() && !def.name.startsWith(prefix))
        continue;

      QJsonObject row;
      row[QStringLiteral("name")]        = def.name;
      row[QStringLiteral("description")] = def.description;
      entries.append(row);
    }
  };
  appendVirtual(assistantToolDefs());
  appendVirtual(fsToolDefs());
  appendVirtual(metaToolRoster());

  for (auto it = commands.constBegin(); it != commands.constEnd(); ++it) {
    const auto& def = it.value();
    if (aiReg.safetyOf(def.name) == Safety::Blocked)
      continue;

    if (!prefix.isEmpty() && !def.name.startsWith(prefix))
      continue;

    QJsonObject row;
    row[QStringLiteral("name")]        = def.name;
    row[QStringLiteral("description")] = def.description;
    entries.append(row);
  }

  const int total = entries.size();
  const int start = qBound(0, offset, total);
  const int count = limit > 0 ? qMin(limit, total - start) : total - start;

  QJsonArray window;
  for (int i = start; i < start + count; ++i)
    window.append(entries.at(i));

  QJsonObject reply;
  reply[QStringLiteral("ok")]       = true;
  reply[QStringLiteral("total")]    = total;
  reply[QStringLiteral("count")]    = window.size();
  reply[QStringLiteral("commands")] = window;
  if (start + count < total)
    reply[QStringLiteral("nextOffset")] = start + count;

  return reply;
}

/**
 * @brief Returns the curated one-line description for each top-level command scope.