history

type Conversation struct {
	ProjectName  string
	ContextID    string
	CreatedAt    time.Time
	LastActiveAt time.Time
	TurnCount    int64
	// Title is what the conversation is about: the opening user message,
	// collapsed to one line and cut to MaxTitleLen runes. Empty when the
	// conversation has no ordinary user turn (only a compaction summary).
	Title string
	// Name is what the user called this conversation (see [Renamer]), empty
	// until they name one. It is kept alongside Title rather than replacing
	// it so a rename never destroys the derived label underneath — clients
	// show the name when set and fall back to the title.
	Name string
}

type Lister interface {
	ListConversations(ctx context.Context, projectName string, limit int) ([]Conversation, error)
}

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

type Message struct {
	Seq       int64
	Role      string
	Content   string
	CreatedAt time.Time
}

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

type Reader interface {
	Lister
	// GetConversation returns one conversation's metadata, or
	// [ErrConversationNotFound] if the (project, context) key is unknown.
	GetConversation(ctx context.Context, projectName, contextID string) (Conversation, error)
	// Messages returns a conversation's messages, oldest first (ascending seq).
	// An unknown conversation yields nil, nil.
	Messages(ctx context.Context, projectName, contextID string) ([]Message, error)
}

type Renamer interface {
	// Rename sets the conversation's name (see [Conversation.Name]), or
	// clears it when name normalizes to empty. An unknown (project, context)
	// key yields [ErrConversationNotFound] — a rename creates nothing.
	Rename(ctx context.Context, projectName, contextID, name string) error
}

type Store interface {
	// Turns returns the conversation's turns, oldest first. A conversation
	// that has never been seen yields nil, nil.
	Turns(ctx context.Context, projectName, contextID string) ([]Turn, error)
	// Append records one completed turn at the end of the conversation.
	Append(ctx context.Context, projectName, contextID string, turn Turn) error
	// Compact atomically replaces every stored turn with summary followed by
	// keep, preserving keep's order. Used only by the summarization
	// compaction step (internal/agent); never called from the normal chat
	// Append path.
	Compact(ctx context.Context, projectName, contextID string, summary Turn, keep []Turn) error
	Renamer
}

type Turn struct {
	UserText      string
	AssistantText string
}