session

type ExportData struct {
	Session  *Session
	Messages []*Message
	Metadata ExportMetadata
}

type ExportFormat string

type ExportMetadata struct {
	ExportedAt   time.Time
	ExporterName string
	ExporterVer  string
	MessageCount int
	TotalTokens  int64
	FirstMessage time.Time
	LastMessage  time.Time
	Provider     string
}

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

type ExporterOptions struct {
	// TemplateDir is the directory containing custom templates
	TemplateDir string

	// IncludeMetadata controls whether to include detailed metadata in exports
	IncludeMetadata bool

	// PrettyPrint controls JSON formatting
	PrettyPrint bool
}

type ListOption func(*ListOptions)

type ListOptions struct {
	Status SessionStatus
	Limit  int64
	Offset int64
	SortBy string
}

type Manager interface {
	// Session operations
	CreateSession(ctx context.Context, session *Session) error
	GetSession(ctx context.Context, id string) (*Session, error)
	GetSessionSummary(ctx context.Context, id string) (*SessionSummary, error)
	ListSessions(ctx context.Context, opts ...ListOption) ([]*Session, error)
	UpdateSession(ctx context.Context, session *Session) error
	DeleteSession(ctx context.Context, id string) error
	ArchiveSession(ctx context.Context, id string) error
	HardDeleteSession(ctx context.Context, id string) error

	// Message operations
	AddMessage(ctx context.Context, message *Message) error
	GetMessage(ctx context.Context, id string) (*Message, error)
	GetMessages(ctx context.Context, sessionID string) ([]*Message, error)
	GetMessagesPaginated(ctx context.Context, sessionID string, limit, offset int64) ([]*Message, error)
	GetConversationThread(ctx context.Context, messageID string) ([]*Message, error)
	UpdateMessage(ctx context.Context, message *Message) error
	DeleteMessage(ctx context.Context, id string) error

	// Search operations
	SearchSessions(ctx context.Context, query string, opts ...SearchOption) ([]*Session, error)
	SearchMessages(ctx context.Context, sessionID string, query string, opts ...SearchOption) ([]*Message, error)

	// Statistics operations
	GetSessionMessageCount(ctx context.Context, sessionID string) (int64, error)
	GetTotalTokensUsed(ctx context.Context, sessionID string) (int64, error)

	// Export/Import operations
	ExportSession(ctx context.Context, sessionID string, format ExportFormat, w io.Writer) error
	ImportSession(ctx context.Context, r io.Reader) (*Session, error)

	// Utility operations
	TouchSession(ctx context.Context, id string) error
	Close() error
}

type Message struct {
	ID           string         `json:"id"`
	SessionID    string         `json:"session_id"`
	Role         MessageRole    `json:"role"`
	Content      string         `json:"content"`
	Timestamp    time.Time      `json:"timestamp"`
	ParentID     *string        `json:"parent_id,omitempty"`
	TokensUsed   *int64         `json:"tokens_used,omitempty"`
	Model        *string        `json:"model,omitempty"`
	FinishReason *string        `json:"finish_reason,omitempty"`
	Metadata     map[string]any `json:"metadata,omitempty"`
}

type MessageRole string

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

type SearchOption func(*SearchOptions)

type SearchOptions struct {
	Query  string
	Limit  int64
	Offset int64
	// FTS5 full-text search options
	DateFrom *time.Time // Filter messages from this date
	DateTo   *time.Time // Filter messages until this date
	Provider string     // Filter by provider/model (e.g., "claude", "gpt")
}

type SearchResult struct {
	Message        Message       `json:"message"`
	SessionName    string        `json:"session_name"`
	SessionStatus  SessionStatus `json:"session_status"`
	Snippet        string        `json:"snippet"`         // HTML snippet with highlighted matches
	RelevanceScore float64       `json:"relevance_score"` // BM25 relevance score
}

type SearchResultSet struct {
	Results    []SearchResult `json:"results"`
	TotalCount int64          `json:"total_count"`
	Query      string         `json:"query"`
	Limit      int64          `json:"limit"`
	Offset     int64          `json:"offset"`
}

type Session struct {
	ID          string         `json:"id"`
	Name        string         `json:"name"`
	CreatedAt   time.Time      `json:"created_at"`
	UpdatedAt   time.Time      `json:"updated_at"`
	Status      SessionStatus  `json:"status"`
	Model       *string        `json:"model,omitempty"`
	Temperature *float64       `json:"temperature,omitempty"`
	MaxTokens   *int64         `json:"max_tokens,omitempty"`
	Settings    map[string]any `json:"settings,omitempty"`
}

type SessionError struct {
	Op      string // Operation that failed
	Err     error  // Underlying error
	Context string // Additional context
}

type SessionExport struct {
	Session  Session   `json:"session"`
	Messages []Message `json:"messages"`
}

type SessionStatus string

type SessionSummary struct {
	Session
	MessageCount int64 `json:"message_count"`
	TotalTokens  int64 `json:"total_tokens,omitempty"`
}