conversation

type BotLookup interface {
	IsAnyBot(userID string) bool

	// GetBotConfigByID returns the bot's EnableVision and MaxFileSize.
	// ok is false when botID is unknown.
	GetBotConfigByID(botID string) (enableVision bool, maxFileSize int64, ok bool)
}

type BuildOptions struct {
	ExcludeAfterPostID string

	// AllowUnsharedToolContent opts IN to sending tool_result content whose
	// Shared flag is not true to the LLM. The default is to redact — any
	// code path whose LLM response may reach other users (channel mentions,
	// channel follow-ups, regenerations in channels) MUST leave this false
	// so kept-private tool output cannot be paraphrased into a channel post.
	//
	// Set to true only in contexts where the LLM response is scoped to the
	// requester (e.g. the DM follow-up stream), since DM tool_results are
	// always shared=true anyway and nothing would be redacted in that case.
	AllowUnsharedToolContent bool
}

type Citation struct {
	Type       string `json:"type"`
	URL        string `json:"url,omitempty"`
	Title      string `json:"title,omitempty"`
	StartIndex int    `json:"start_index"`
	EndIndex   int    `json:"end_index"`
}

type ContentBlock struct {
	Type string `json:"type"`

	// Text / Thinking fields
	Text      string     `json:"text,omitempty"`
	Signature string     `json:"signature,omitempty"` // thinking blocks only
	Citations []Citation `json:"citations,omitempty"` // text blocks only

	// ToolUse fields
	ID           string          `json:"id,omitempty"`
	Name         string          `json:"name,omitempty"`
	ServerOrigin string          `json:"server_origin,omitempty"`
	Input        json.RawMessage `json:"input,omitempty"`
	MCPBareName  string          `json:"mcp_bare_name,omitempty"`
	Status       string          `json:"status,omitempty"`
	Shared       *bool           `json:"shared,omitempty"` // pointer to distinguish unset from false

	// UserInteraction is the persisted form of llm.Tool.UserInteraction.
	UserInteraction string `json:"user_interaction,omitempty"`

	// WouldAutoExecute marks any pending tool_use block that passed the
	// auto-execution policy (see llm.ToolCall.WouldAutoExecute).
	WouldAutoExecute bool `json:"would_auto_execute,omitempty"`

	// DecidedAt (tool_result blocks) records when the share/keep-private
	// decision was made — either by the user clicking Share or Keep Private
	// in a channel, or implicitly at creation time (DMs, rejected tools,
	// auto_run_everywhere results). A nil value means the result still
	// needs a user decision; any non-nil value means the decision is final
	// and no further approval UI should appear. This distinguishes the
	// "undecided" and "decided to keep private" states, which both present
	// Shared=false but require opposite UI behavior.
	DecidedAt *int64 `json:"decided_at,omitempty"`

	// ToolResult fields
	ToolUseID string `json:"tool_use_id,omitempty"`
	Content   string `json:"content,omitempty"` // tool_result or file content

	// File / Image fields
	Filename string `json:"filename,omitempty"`
	MimeType string `json:"mime_type,omitempty"`
	FileID   string `json:"file_id,omitempty"` // image blocks: references Mattermost file attachment

	// Annotations fields
	WebSearchContext *WebSearchContext `json:"web_search_context,omitempty"`
}

type CreateConversationParams struct {
	UserID       string
	BotID        string
	ChannelID    *string // nullable for non-channel conversations
	RootPostID   *string // nullable for non-thread conversations
	Operation    string  // e.g., "conversation", "thread_analysis", "search"
	SystemPrompt string  // already-formatted system prompt text
	UserMessage  string  // the first user message content
	UserPostID   *string // nullable: post ID for the user turn, if a post exists
	FileIDs      []string
}

type CreateConversationResult struct {
	ConversationID string
	UserTurnID     string
}

type GetOrCreateParams struct {
	UserID       string
	BotID        string
	ChannelID    string
	RootPostID   string // the thread root post ID
	Operation    string
	SystemPrompt string  // formatted system prompt (used only if creating)
	UserMessage  string  // new user message
	UserPostID   *string // post ID for the new user turn
	FileIDs      []string
}

type GetOrCreateResult struct {
	Conversation *store.Conversation
	IsNew        bool
	UserTurnID   string // the newly created user turn
}

type PostConversionOptions struct {
	RedactUnshared bool
	MMClient       mmapi.Client
	EnableVision   bool
	MaxFileSize    int64
	ToolStore      *llm.ToolStore
}

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

type Store interface {
	CreateConversation(conv *store.Conversation) error
	GetConversation(id string) (*store.Conversation, error)
	GetConversationByThreadBotUser(rootPostID, botID, userID string) (*store.Conversation, error)
	UpdateConversationTitle(id, title string) error
	UpdateConversationRootPostID(id string, rootPostID string) error
	CreateTurn(turn *store.Turn) error
	CreateTurnAutoSequence(turn *store.Turn) error
	GetTurnsForConversation(conversationID string) ([]store.Turn, error)
	GetTurnByPostID(postID string) (*store.Turn, error)
	UpdateTurnContent(id string, content json.RawMessage) error
	UpdateTurnTokens(id string, tokensIn, tokensOut int64) error
	UpdateTurnPostID(id string, postID *string) error
	DeleteResponseTurns(conversationID, postID string) error
	GetMaxSequenceForConversation(conversationID string) (int, error)
}

type WebSearchContext struct {
	Results         json.RawMessage `json:"results"`
	ExecutedQueries json.RawMessage `json:"executed_queries"`
	Count           int             `json:"count"`
}