The free monad is defined by this structure:

sealed trait Free [ F [ _ ] , A ] final case class Return [ F [ _ ] , A ]( a : A ) extends Free [ F , A ] final case class Suspend [ F [ _ ] , A ]( s : F [ Free [ F , A ]]) extends Free [ F , A ]

We can use the free monad without understanding its implementation, but to really understand it we need to know why it is defined this way.

It certainly wasn’t obvious to me why this is the correct definition, and reading the literature quickly devolved into “doughnoids in the category of pretzelmorphisms” land. Here I want to present an explanation aimed at programmers that doesn’t involve abstract alphabet-soup.

Preliminaries

The free monad represents the minimal possible structure to implement a monad and nothing else. This is achieved by separating the structure of monadic computations from the process that gives them meaning. The free monad gives us the means to construct a monad from any type (that is also a functor) by wrapping it in the free monad.

Let me give a simple example of this separation of structure and meaning that doesn’t involve any monads. Consider the expression

1 + 2 + 3

When we write this expression we bundle the structure of the computation (two additions) with the meaning given to that computation ( Int addition).

We could separate structure and meaning by representing the structure of the computation as data, perhaps as

Add ( 1 , Add ( 2 , 3 ))

Now we can write a simple interpreter to give meaning to this structure. Having separated the abstract syntax tree from the interpreter we can choose different interpretations for a given tree, such as computing with dual numbers to automatically compute derivatives, or running the code on a GPU for performance.

The free monad is just an abstract syntax tree representation of a monad. It has the advantage that we can define custom interpreters for the computations represented in the free monad, and with some further tricks compose monads and interpreters.

We should be able to derive the free monad from the operations required to define a monad, as it is just a representation of those operations as a data structure. Before we dive into the free monad, however, I want to return to our example of addition and derive the free monoid. This serves as a useful warmup before we tackle the free monad.

The Free Monoid

Our goal with implementing the free monoid is to represent computations like

1 + 2 + 3

in a generic way without giving them any particular meaning.

The free monoid will wrap an arbitrary type and must itself be a monoid.

A monoid for some type A is defined by:

an operation append with type (A, A) => A ; and an element zero of type `A

The following laws must also hold:

append is associative, meaning append(x, append(y, z)) == append(append(x, y), z) for all x , y , and z , in A . zero is an identity of append , meaning append(a, zero) == append(zero, a) == a for any a in A .

The monoid operations ( append and zero ) suggest we want a structure something like

sealed trait FreeMonoid [ +A ] final case object Zero extends FreeMonoid [ Nothing ] final case class Append [ A ]( l : A , r : A ) extends FreeMonoid [ A ]

but this doesn’t work – we can’t write, for instance, Append(Zero, Zero) because the types don’t line up.

We can use a structure like

sealed trait FreeMonoid [ +A ] final case object Zero extends FreeMonoid [ Nothing ] final case class Value [ A ]( a : A ) extends FreeMonoid [ A ] final case class Append [ A ]( l : FreeMonoid [ A ], r : FreeMonoid [ A ]) extends FreeMonoid [ A ]

Now we can represent 1 + 2 + 3 as

Append ( Value ( 1 ), Append ( Value ( 2 ), Value ( 3 )))

This is not the simplest representation we can use. With a bit of algebraic manipulation, justified by the monoid laws, we can normalize any monoid expression into a form that allows for a simpler representation. Let’s illustrate this via algebraic manipulation on 1 + 2 + 3 .

The identity law means we can insert the addition of zero in any part of the computation without changing the result, and likewise we can remove any zeros (unless the entire expression consists of just zero). We’re going to decree that any normalized expression must have a single zero at the end of the expression like so:

1 + 2 + 3 + 0

The associativity law means we can place brackets wherever we want. We’re going to decide to bracket expressions so traversing the expression from left to right goes from outermost to innermost bracket, like so:

( 1 + ( 2 + ( 3 + 0 )))

With these changes – which by the monoid laws make no difference to the meaning of the expression – we can construct the following abstract syntax tree.

sealed trait FreeMonoid [ +A ] final case object Zero extends FreeMonoid [ Nothing ] final case class Append [ A ]( l : A , r : FreeMonoid [ A ]) extends FreeMonoid [ A ]

We can represent 1 + 2 + 3 (normalized to (1 + (2 + (3 + 0))) ) as

Append ( 1 , Append ( 2 , Append ( 3 , Zero )))

The final step is to recognise that this structure is isomorphic (in the real, not the Javascript, sense) to List . So we could just as easily write

1 :: 2 :: 3 :: Nil

or

List ( 1 , 2 , 3 )

Our final step is to make sure that List itself a monoid. It is. The monoid operations on List are:

append is ++ , list concatentation;

is , list concatentation; zero is Nil , the empty list; and

is , the empty list; and we can “lift” any type into the free monoid using List.apply

High fives all around – we’ve derived the free monoid from first principles.

The Free Monad

We are now ready to tackle the free monad. We can take the same approach starting with the monad operations point and flatMap , but our task will be easier if we reformulate monads in terms of point , map , and join . Under this formulation a monad for a type F[_] has:

an operation point with type A => F[A] ;

with type ; an operation join with type F[F[A]] => F[A] ; and

with type ; and an operation map with type (F[A], A => B) => F[B] .

From this list of operations we can start to create an abstract syntax tree. We start with the definition of Free .

sealed trait Free [ F [ _ ] , A ]

We can directly convert point into a case Return (following the names I introduced in the introduction).

final case class Return [ F [ _ ] , A ]( a : A ) extends Free [ F , A ]

We are going to convert join into a case Suspend . What is the type of the value we store inside Suspend ? We might think it should store a value of type F[F[A]] but if we did this we wouldn’t be able to store, say, a Return inside the outer F . We can break it down like this:

The inner F[A] will be represented by an instance of the free monad, and thus has type Free[F, A] .

will be represented by an instance of the free monad, and thus has type . The outer F[_] will be wrapped in the Suspend we’re creating.

Therefore the value we should store has type F[Free[F, A]] giving us

final case class Suspend [ F [ _ ] , A ]( f : F [ Free [ F , A ]]) extends Free [ F , A ]

Finally we have map . This suggests a case like

final case class Map [ F [ _ ] , A , B ]( fa : Free [ F , A ], f : A => B ) extends Free [ F , B ]

This looks a little problematic. We have three type parameters while Free only has two. In fact we can do away with this case! We inherit map from monad being a functor. A map represents a pure, not an effectful, computation. We don’t need to represent Map in the free monad abstract syntax tree so long as we can implement the map operation in our free monad.

Our final free monad data type looks like

sealed trait Free [ F [ _ ] , A ] final case class Return [ F [ _ ] , A ]( a : A ) extends Free [ F , A ] final case class Suspend [ F [ _ ] , A ]( s : F [ Free [ F , A ]]) extends Free [ F , A ]

This is what we saw in the introduction. But does it really work? To show it does, let’s implement the monad operations on this data type. We’ll use the more familiar flatMap and point formulation, which is better suited to Scala, than the point , join , and map formulation above.

We can knock out point easily enough.

object Free { def point [ F [ _ ]]( a : A ) : Free [ F , A ] = Return [ F , A ]( a ) }

Things get a bit trickier with flatMap , however. Since we know Free in an algebraic data type we can easily get the structural recursion skeleton.

sealed trait Free [ F [ _ ] , A ] { def flatMap [ B ]( f : A => Free [ F , B ]) : Free [ F , B ] = this match { case Return ( a ) => ??? case Suspend ( s ) => ??? } }

The case for Return just requires us to follow the types.

sealed trait Free [ F [ _ ] , A ] { def flatMap [ B ]( f : A => Free [ F , B ]) : Free [ F , B ] = this match { case Return ( a ) => f ( a ) case Suspend ( s ) => ??? } }

The case for Suspend is a bit trickier. The value s has type F[Free[F, A]] . The only operation we (currently) have available is f , which accepts an A . We could flatMap f over the Free[F, A] wrapped in F , but we haven’t yet required any operations on F . If we require F is a functor we can then map over it. Concretely, we can use this code snippet:

s map ( free => free flatMap f )

A bit of algebra shows the result has type F[Free[F, B]] , and we can wrap that in a Suspend to get a result of type Free[F, B] . Our final implementation is thus

sealed trait Free [ F [ _ ] , A ] { def flatMap [ B ]( f : A => Free [ F , B ])( implicit functor : Functor [ F ]) : Free [ F , B ] = this match { case Return ( a ) => f ( a ) case Suspend ( s ) => Suspend ( s map ( _ flatMap f )) } }

We can write map in terms of flatMap

def map [ B ]( f : A => B )( implicit functor : Functor [ F ]) : Free [ F , B ] = flatMap ( a => Return ( f ( a )))

It’s left as an exercise to the reader to prove the monad laws hold.

Conclusions

In this blog post I’ve tried to explain how the free monad comes to be without invoking category theory. Hopefully this sheds a bit more light on the construction, and shows it’s a natural consequence of the monad operations.

There is a lot more to the free monad than just constructing it – using it is rather important too. I’ve linked to a few more ideas in the footnotes, but I have another blog post the describes why the free monad is interesting. Finally, our book Essential Interpreters has complete coverage of the free monad (at least it will, when we’ve written it!)