server

type ListArgs struct{}

type ListResult struct {
	Channels []store.Info `json:"channels"`
}

type PostArgs struct {
	Channel string `json:"channel" jsonschema:"channel name; created on first post"`
	From    string `json:"from" jsonschema:"your identity as shown to readers, e.g. an agent or session name"`
	Body    string `json:"body" jsonschema:"the message"`
}

type PostResult struct {
	Posted store.Message `json:"posted"`
}

type ReadArgs struct {
	Channel string `json:"channel" jsonschema:"channel name"`
	Since   string `json:"since,omitempty" jsonschema:"opaque cursor from a prior read; omit to read from the start"`
	Limit   int    `json:"limit,omitempty" jsonschema:"max messages to return; 0 or omitted = all"`
}

type ReadResult struct {
	Messages []store.Message `json:"messages"`
	Cursor   string          `json:"cursor"`
}

type Store interface {
	Post(name, from, body string) (store.Message, error)
	Read(name, cursor string, limit int) ([]store.Message, string, error)
	List() ([]store.Info, error)
}