Interface GridAITools.Callbacks

All Superinterfaces:
Serializable
Enclosing class:
GridAITools

public static interface GridAITools.Callbacks extends Serializable
Callback interface for grid state access and mutation.
  • Method Summary

    Modifier and Type
    Method
    Description
    Returns the set of available grid IDs.
    getState(String gridId)
    Returns the current state of a grid as a JSON string.
    void
    updateData(String gridId, String query)
    Handles a SQL query for the given grid.
  • Method Details

    • getState

      String getState(String gridId)
      Returns the current state of a grid as a JSON string. Should throw if the grid is not found.
      Parameters:
      gridId - the grid ID
      Returns:
      the grid state as JSON
    • updateData

      void updateData(String gridId, String query)
      Handles a SQL query for the given grid. Implementations should validate the query and store it for deferred rendering. Should throw if the grid is not found or the query is invalid: a ToolException relays its message to the LLM so it can correct the query, any other exception is replaced with a generic error message.
      Parameters:
      gridId - the grid ID
      query - the SQL SELECT query
    • getGridIds

      Set<String> getGridIds()
      Returns the set of available grid IDs.
      Returns:
      the grid IDs, never null