Function appendCommandMetaTools

app/src/AI/Conversation.cpp:2139–2202

* @brief Appends meta.describeCommand, meta.executeCommand, meta.fetchHelp tools. */

 * @brief Appends meta.describeCommand, meta.executeCommand, meta.fetchHelp tools.
 */
static void appendCommandMetaTools(QJsonArray& out)
{
  {
    auto schema = objectSchemaWithProperty(
      QStringLiteral("name"),
      stringProp(QStringLiteral("Exact command name as returned by meta.listCommands.")),
      true);
    out.append(makeMetaTool(
      QStringLiteral("meta.describeCommand"),
      QStringLiteral("Fetch the full input schema and description for one command. "
                     "Call this before meta.executeCommand on any unfamiliar command."),
      schema));
  }

  {
    QJsonObject schema;
    schema[QStringLiteral("type")] = QStringLiteral("object");
    QJsonObject props;
    props[QStringLiteral("name")] = stringProp(QStringLiteral("Command name to invoke."));
    QJsonObject argsProp;
    argsProp[QStringLiteral("type")] = QStringLiteral("object");
    argsProp[QStringLiteral("description")] =
      QStringLiteral("Arguments object matching the command's input schema.");
    props[QStringLiteral("arguments")]   = argsProp;
    schema[QStringLiteral("properties")] = props;
    schema[QStringLiteral("required")]   = QJsonArray{QStringLiteral("name")};
    out.append(makeMetaTool(QStringLiteral("meta.executeCommand"),
                            QStringLiteral("Execute any command by name with an arguments object. "
                                           "Use this for commands that aren't directly in your "
                                           "tool list."),
                            schema));
  }

  {
    auto schema = objectSchemaWithProperty(
      QStringLiteral("path"),
      stringProp(QStringLiteral("A bare page name without the .md extension (e.g. "
                                "\"About\", \"FAQ\", \"Getting-Started\", "
                                "\"API-Reference\", \"Painter-Widget\", "
                                "\"Drivers-UART\"), or \"help.json\" to fetch the "
                                "index (a JSON array of {id, title, section, file}). "
                                "Multi-word names use hyphens. Full URLs on "
                                "github.com / raw.githubusercontent.com / "
                                "serial-studio.com are also accepted. **A 404 "
                                "auto-redirects to help.json**, so if you can name "
                                "the page in plain English with high confidence "
                                "(About, FAQ, Troubleshooting, Pro-vs-Free, etc.) "
                                "just try it directly -- the index fallback catches "
                                "you for free. Fetch help.json first only when the "
                                "page name isn't obvious from the user's question.")),
      true);
    out.append(makeMetaTool(QStringLiteral("meta.fetchHelp"),
                            QStringLiteral("Fetch a Serial Studio documentation page from "
                                           "the canonical doc/help markdown source. Use "
                                           "whenever the user asks about features, "
                                           "concepts, or workflows -- always cite from the "
                                           "fetched page, never synthesize content from "
                                           "training data. If the response indicates a 404 "