Function appendReferenceMetaTools

app/src/AI/Conversation.cpp:2216–2292

* @brief Appends meta.fetchScriptingDocs + meta.howTo + meta.loadSkill. */

 * @brief Appends meta.fetchScriptingDocs + meta.howTo + meta.loadSkill.
 */
static void appendReferenceMetaTools(QJsonArray& out)
{
  {
    auto kindProp =
      stringProp(QStringLiteral("Which scripting reference to fetch. The doc kinds return the "
                                "canonical API surface, idiomatic patterns, and worked examples "
                                "for that scripting context. sdk_js / sdk_lua return the actual "
                                "generated SerialStudio SDK source -- the authoritative listing "
                                "of every callable (io.*, tableGet, deviceWrite, notify*, delay, "
                                "SerialStudio.Hex, ...); fetch these to confirm exact signatures."),
                 QJsonArray{QStringLiteral("frame_parser_js"),
                            QStringLiteral("frame_parser_lua"),
                            QStringLiteral("transform_js"),
                            QStringLiteral("transform_lua"),
                            QStringLiteral("output_widget_js"),
                            QStringLiteral("painter_js"),
                            QStringLiteral("control_script_js"),
                            QStringLiteral("sdk_js"),
                            QStringLiteral("sdk_lua")});
    auto schema = objectSchemaWithProperty(QStringLiteral("kind"), kindProp, true);
    out.append(makeMetaTool(QStringLiteral("meta.fetchScriptingDocs"),
                            QStringLiteral("Fetch the Serial Studio scripting reference for one "
                                           "scripting context (frame parser JS / "
                                           "Lua, value transform JS / Lua, output-widget JS, "
                                           "painter JS, control script JS, or the generated "
                                           "SDK source). Call this BEFORE writing or modifying "
                                           "any user script -- the available APIs differ "
                                           "between contexts and you must not invent function "
                                           "names. Returns markdown."),
                            schema));
  }

  {
    QJsonArray taskEnum;
    for (const auto& t : AI::ContextBuilder::howToTasks())
      taskEnum.append(t);

    auto taskProp =
      stringProp(QStringLiteral("Which workflow recipe to fetch. Each returns a numbered list "
                                "of the exact tool calls to make in order, with the parameters "
                                "and gotchas that the API surface alone won't tell you."),
                 taskEnum);
    auto schema = objectSchemaWithProperty(QStringLiteral("task"), taskProp, true);
    out.append(makeMetaTool(QStringLiteral("meta.howTo"),
                            QStringLiteral("Fetch a step-by-step recipe for a common Serial "
                                           "Studio workflow. Call this BEFORE acting on any "
                                           "request that matches one of the recipe ids "
                                           "(adding a painter, building an executive "
                                           "dashboard, attaching an output widget, etc). "
                                           "Recipes are short and authoritative -- follow "
                                           "them in order rather than improvising."),
                            schema));
  }

  {
    QJsonArray skillEnum;
    for (const auto& s : AI::ContextBuilder::skillIds())
      skillEnum.append(s);