pub(open) trait Params {
  fn schema() -> JsonSchema
  fn from_json(Json) -> Self raise ToolError
  fn to_json(Self) -> Json
}

pub trait ToToolResult {
  fn to_tool_result(Self) -> 
@colmugx/mcp/protocol/tool.ToolResult
ToolResult
}

pub suberror ToolError {
  ToolError(String)
}

pub struct JsonSchema {
  type_name : String
  description : String
  properties : Map[String, JsonSchema]?
  required : Array[String]?
  items : JsonSchema?
  default : Json?
} derive(
@moonbitlang/core/debug.Debug
Debug)

pub(all) enum ParamKind {
  String
  Integer
  Number
  Boolean
  Array(ParamKind)
  Object(Map[String, ParamKind])
}

pub(all) struct ToolWrapper {
  name_impl : () -> String
  description_impl : () -> String
  params_impl : () -> Array[
@colmugx/mcp/protocol/tool.ParamDef
ParamDef]
  execute_impl : (Json) -> 
@colmugx/mcp/protocol/tool.ToolResult
ToolResult
}

fn arr_schema(item : JsonSchema, desc? : String) -> JsonSchema

fn bool_schema(desc? : String) -> JsonSchema

fn int_schema(desc? : String) -> JsonSchema

fn num_schema(desc? : String) -> JsonSchema

fn obj_schema(props : Map[String, JsonSchema], required : Array[String], desc? : String) -> JsonSchema

fn simple_tool(name : String, description : String, handler : (Json) -> 
@colmugx/mcp/protocol/tool.ToolResult
ToolResult) -> ToolWrapper

fn str_schema(desc? : String) -> JsonSchema

fn[Args : Params, Ret : ToToolResult] tool_fn(handler : (Args) -> Ret, name~ : String, description~ : String) -> ToolWrapper