McpTools.h

// -*- mode: c++; c-file-style: "linux"; c-basic-offset: 2; indent-tabs-mode: nil -*-
//
//  Copyright (C) 2026 Gunter Königsmann <wxMaxima@physikbuch.de>
//
//  This program is free software; you can redistribute it and/or modify
//  it under the terms of the GNU General Public License as published by
//  the Free Software Foundation; either version 2 of the License, or
//  (at your option) any later version.
//
//  This program is distributed in the hope that it will be useful,
//  but WITHOUT ANY WARRANTY; without even the implied warranty of
//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
//  GNU General Public License for more details.
//
//
//  You should have received a copy of the GNU General Public License
//  along with this program; if not, write to the Free Software
//  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
//
//  SPDX-License-Identifier: GPL-2.0+
 
#ifndef MCPTOOLS_H
#define MCPTOOLS_H
 
#include <nlohmann/json.hpp>
#include <wx/string.h>
#include <functional>
#include <stdexcept>
#include <string>
#include <vector>
 
class Worksheet;
class Variablespane;
class GroupCell;
 
struct McpSidebarInfo {
  wxString name;
  wxString caption;
  bool visible = false;
  bool canHide = true;
};
 
class McpToolError : public std::runtime_error {
public:
  explicit McpToolError(const std::string &msg) : std::runtime_error(msg) {}
};
 
class McpTools {
public:
  McpTools(Worksheet *worksheet, Variablespane *variablesPane);
 
  void SetConnectionCheck(std::function<bool()> isConnected)
    {
      m_isMaximaConnected = std::move(isConnected);
    }
 
  void SetSidebarAccess(std::function<std::vector<McpSidebarInfo>()> list,
                        std::function<bool(const wxString &, bool)> setVisible)
    {
      m_listSidebars = std::move(list);
      m_setSidebarVisible = std::move(setVisible);
    }
 
  nlohmann::json ListTools() const;
 
  nlohmann::json CallTool(const wxString &name,
                          const nlohmann::json &arguments) const;
 
  nlohmann::json ListCells() const;
  nlohmann::json ReadCell(const nlohmann::json &arguments) const;
  nlohmann::json ReadWorksheet() const;
  nlohmann::json ReadToc() const;
  nlohmann::json ReadSection(const nlohmann::json &arguments) const;
  nlohmann::json ReadVariables() const;
  nlohmann::json EvaluationStatus() const;
  nlohmann::json WatchVariable(const nlohmann::json &arguments) const;
  nlohmann::json UnwatchVariable(const nlohmann::json &arguments) const;
  nlohmann::json SearchCells(const nlohmann::json &arguments) const;
  nlohmann::json ListSidebars() const;
  nlohmann::json ShowSidebar(const nlohmann::json &arguments) const;
  nlohmann::json HideSidebar(const nlohmann::json &arguments) const;
 
  static constexpr std::size_t MAX_TEXT_LENGTH = 200000;
  static constexpr std::size_t MAX_SEARCH_MATCHES = 50;
  static constexpr std::size_t OUTPUT_PREVIEW_LENGTH = 2000;
 
private:
  Worksheet *m_worksheet;
  Variablespane *m_variablesPane;
  std::function<bool()> m_isMaximaConnected;
  std::function<std::vector<McpSidebarInfo>()> m_listSidebars;
  std::function<bool(const wxString &, bool)> m_setSidebarVisible;
 
  nlohmann::json SetSidebarVisible(const nlohmann::json &arguments,
                                   bool show) const;
  void RequireSidebarAccess() const;
 
  GroupCell *FindGroupByUUID(const wxString &uuid) const;
  static wxString GroupTypeName(int groupType);
  static wxString InputText(GroupCell &cell);
  static wxString OutputText(GroupCell &cell);
  nlohmann::json CellSummary(GroupCell &cell, int index) const;
  wxString CellText(GroupCell &cell) const;
  GroupCell *CurrentCell() const;
  bool HasError(GroupCell &cell) const;
  bool MaximaIsBusy() const;
  bool IsMaximaConnected() const
    {
      return !m_isMaximaConnected || m_isMaximaConnected();
    }
  static wxString CapLength(wxString text);
  static wxString TruncateText(const wxString &text, std::size_t maxLen,
                               bool fromEnd, bool &wasTruncated);
  static wxString RequireString(const nlohmann::json &arguments,
                                const char *name);
};
 
#endif // MCPTOOLS_H