brain

type Builder struct {
	// contains filtered or unexported fields
}

type Interface interface {
	// Learn records a set of tuples.
	//
	// One tuple has an empty prefix to denote the start of the message, and
	// a different tuple has the empty string as its suffix to denote the end
	// of the message. The positions of each in the argument are not guaranteed.
	//
	// Each tuple's prefix has entropy reduction transformations applied.
	//
	// Tuples in the argument may share storage for prefixes.
	Learn(ctx context.Context, tag string, msg *Message, tuples []Tuple) error

	// Speak generates a full message and appends it to w.
	//
	// The prompt is in reverse order and has entropy reduction applied.
	Speak(ctx context.Context, tag string, prompt []string, w *Builder) error

	// Forget forgets everything learned from a single given message.
	// If nothing has been learned from the message, it must prevent anything
	// from being learned from a message with that ID.
	Forget(ctx context.Context, tag, id string) error

	// Recall reads out messages the brain knows.
	// At minimum, the message ID and text of each message must be retrieved;
	// other fields may be filled if they are available.
	//
	// Repeated calls using the pagination token returned from the previous
	// must yield every message that the brain had recorded at the time of the
	// first call exactly once. Messages learned after the first call of an
	// enumeration are read at most once.
	//
	// The first call of an enumeration uses an empty pagination token as input.
	// If the returned pagination token is empty, it is interpreted as the end
	// of the enumeration.
	Recall(ctx context.Context, tag, page string, out []Message) (n int, next string, err error)
}

type Message = message.Received[userhash.Hash]

type Skip struct {
	// contains filtered or unexported fields
}

type Tuple struct {
	// Prefix is the entropy-reduced prefix in reverse order relative to the
	// source message.
	Prefix []string
	// Suffix is the full-entropy term following the prefix.
	Suffix string
}