Function appendBasicMetaTools

app/src/AI/Conversation.cpp:2068–2134

* @brief Appends meta.listCategories, meta.snapshot, meta.listCommands tools. */

 * @brief Appends meta.listCategories, meta.snapshot, meta.listCommands tools.
 */
static void appendBasicMetaTools(QJsonArray& out)
{
  {
    QJsonObject schema;
    schema[QStringLiteral("type")]       = QStringLiteral("object");
    schema[QStringLiteral("properties")] = QJsonObject();
    out.append(
      makeMetaTool(QStringLiteral("meta.listCategories"),
                   QStringLiteral("List the top-level command scopes (project, io, console, "
                                  "consoleExport, csvExport, csvPlayer, mdf4Export, mdf4Player, "
                                  "controlscript, scripts, dashboard, ui, sessions, licensing, "
                                  "notifications, extensions, assistant, fs, meta) with one-line "
                                  "descriptions and command counts. "
                                  "Call this FIRST when you need to know what is even possible -- "
                                  "it's much smaller than meta.listCommands and tells you which "
                                  "prefix to drill into next."),
                   schema));
  }

  {
    QJsonObject schema;
    schema[QStringLiteral("type")]       = QStringLiteral("object");
    schema[QStringLiteral("properties")] = QJsonObject();
    out.append(
      makeMetaTool(QStringLiteral("meta.snapshot"),
                   QStringLiteral("One-shot composite of every readable status endpoint "
                                  "(project.getStatus, io.getStatus, dashboard.getStatus, "
                                  "console.getConfig, csvExport/Player.getStatus, "
                                  "project.mqtt.publisher/subscriber.getStatus, "
                                  "sessions.getStatus, "
                                  "mdf4Export/Player.getStatus, licensing.getStatus, "
                                  "notifications.getUnreadCount). Use when you want a global "
                                  "picture without making 10+ separate calls."),
                   schema));
  }

  {
    QJsonObject schema;
    schema[QStringLiteral("type")] = QStringLiteral("object");
    QJsonObject props;
    props[QStringLiteral("prefix")] =
      stringProp(QStringLiteral("Optional dotted prefix filter, e.g. \"project.\" or \"io.\"."));
    QJsonObject offsetProp;
    offsetProp[QStringLiteral("type")] = QStringLiteral("integer");
    offsetProp[QStringLiteral("description")] =
      QStringLiteral("Skip this many entries before returning results (default 0). Use the "
                     "nextOffset from a previous reply to page through long lists.");
    offsetProp[QStringLiteral("minimum")] = 0;
    props[QStringLiteral("offset")]       = offsetProp;
    QJsonObject limitProp;
    limitProp[QStringLiteral("type")] = QStringLiteral("integer");
    limitProp[QStringLiteral("description")] =
      QStringLiteral("Max entries to return (default 0 = all). Combine with offset when a "
                     "result reports truncated:true.");
    limitProp[QStringLiteral("minimum")] = 0;
    props[QStringLiteral("limit")]       = limitProp;
    schema[QStringLiteral("properties")] = props;
    out.append(makeMetaTool(QStringLiteral("meta.listCommands"),