conversation

type Conversation struct {
	ID             uint `gorm:"primaryKey"`
	ShortName      sql.NullString
	Title          string
	Agent          sql.NullString
	Workspace      sql.NullString
	SelectedRootID *uint
	SelectedRoot   *Message  `gorm:"foreignKey:SelectedRootID"`
	RootMessages   []Message `gorm:"-:all"`
	LastMessageAt  time.Time
}

type ConversationList struct {
	Total   int
	Items   []ConversationListItem
	HasMore bool
}

type ConversationListItem struct {
	ID            uint
	ShortName     string
	Title         string
	Workspace     string
	LastMessageAt time.Time
}

type Message struct {
	ID        uint `gorm:"primaryKey"`
	CreatedAt time.Time
	Metadata  api.MessageMeta

	ConversationID  *uint         `gorm:"index"`
	Conversation    *Conversation `gorm:"foreignKey:ConversationID"`
	ParentID        *uint
	Parent          *Message  `gorm:"foreignKey:ParentID"`
	Replies         []Message `gorm:"foreignKey:ParentID"`
	SelectedReplyID *uint
	SelectedReply   *Message `gorm:"foreignKey:SelectedReplyID"`

	Role             api.MessageRole
	Content          string
	ReasoningContent string
	Parts            []api.ContentPart `gorm:"serializer:json-compat"`
	ToolCalls        []api.ToolCall    `gorm:"serializer:json-compat"` // a json array of tool calls (from the model)
	ToolResults      []api.ToolResult  `gorm:"serializer:json-compat"` // a json array of tool results
}

type Repo interface {
	LoadConversationList(limit int) (ConversationList, error)
	SearchConversations(query string, limit int) (ConversationList, error)

	FindConversationByShortName(shortName string) (*Conversation, error)
	FindLatestConversationByWorkspace(workspace string) (*Conversation, error)
	ConversationShortNameCompletions(search string) []string
	GetConversationByID(id uint) (*Conversation, error)
	GetRootMessages(conversationID uint) ([]Message, error)

	CreateConversation(title string) (*Conversation, error)
	UpdateConversation(*Conversation) error
	DeleteConversation(id uint) error

	GetMessageByID(messageID uint) (*Message, error)

	SaveMessage(message Message) (*Message, error)
	UpdateMessage(message *Message) error
	CloneBranch(toClone Message) (*Message, uint, error)
	Reply(to *Message, messages ...Message) ([]Message, error)

	// BranchMessage creates a new message at the same position as msg (same
	// parent and conversation) with the given content, without copying any
	// descendants, and sets it as the selected path. Returns the new message.
	BranchMessage(msg Message, content string) (*Message, error)

	// BranchRootMessage creates a new root message in oldRoot's conversation
	// with the given content. The old root's selected reply is re-parented to
	// the new root and the conversation's selected root is updated. This
	// avoids mutating a shared root in-place when the system prompt changes.
	// Returns the new root message.
	BranchRootMessage(oldRoot *Message, content string) (*Message, error)

	PathToRoot(message *Message) ([]Message, error)
	PathToLeaf(message *Message) ([]Message, error)

	// GetSelectedThread returns the "selected thread" of the conversation:
	// a chain of messages starting from SelectedRoot, following each
	// message's SelectedReply until the leaf is reached.
	GetSelectedThread(*Conversation) ([]Message, error)

	// SetSelected marks message as the selected choice at its position in the
	// tree. If the message has no parent, it becomes the conversation's
	// SelectedRoot; otherwise it becomes its parent's SelectedReply.
	SetSelected(message *Message) error

	// DeleteMessage deletes the given message. If withDescendants is false,
	// its children are re-parented to the deleted message's parent (or made
	// root messages), preserving the selected path where possible. If
	// withDescendants is true, the message and all its descendants are
	// deleted, and the parent's selected reply is updated to a sibling if
	// one exists.
	DeleteMessage(msg Message, withDescendants bool) error

	// CycleSelectedRoot advances (forward=true) or retreats (forward=false)
	// the conversation's SelectedRoot among the available root messages.
	// Returns nil without error when there is only one root message.
	CycleSelectedRoot(conv *Conversation, forward bool) (*Message, error)

	// CycleSelectedReply advances or retreats the message's SelectedReply
	// among its available replies.
	// Returns nil without error when there is only one reply.
	CycleSelectedReply(message *Message, forward bool) (*Message, error)

	// StartConversation creates a new conversation with the given messages.
	StartConversation(messages ...Message) (*Conversation, []Message, error)

	CloneConversation(toClone Conversation) (*Conversation, uint, error)
}

type Thread struct {
	Conversation Conversation
	Messages     []Message

	// DefaultSystemPrompt is the fallback system prompt when no agent
	// is set or the agent has no system prompt.
	DefaultSystemPrompt string

	// Agent is the currently active agent. If set, its SystemPrompt is used
	// (falling back to DefaultSystemPrompt if empty). If the agent has
	// Code=true, the system prompt is enhanced with local agents file
	// content and workspace directory information.
	Agent *api.Agent

	// Persistent controls whether produced messages are persisted
	// to the repo by the caller after receiving events from the
	// completion loop.
	Persistent bool

	// Sandbox is the user-facing sandbox configuration. When set, it is
	// used to compute the effective workspace path that appears in the
	// system prompt (e.g. /workspace when remapping is enabled).
	Sandbox *sandbox.SandboxConfig

	// Model is the resolved model for running completions.
	Model *api.Model

	// Effort is the reasoning effort level for completions.
	Effort api.ReasoningEffort
	// contains filtered or unexported fields
}