Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

session

package

Go to main page

Versions in this module

v0

v0.1.7

Jan 9, 2026

v0.1.6

Jan 9, 2026

v0.1.4

Jan 9, 2026

v0.1.3

Jan 8, 2026

v0.1.2

Jan 8, 2026

v0.1.1

Jan 8, 2026

v0.1.0

Jan 8, 2026

Changes in this version

+ var ErrCircularReference = errors.New("circular reference detected in message thread")

+ var ErrEmptyMessageContent = errors.New("message content cannot be empty")

+ var ErrEmptySearchQuery = errors.New("search query cannot be empty")

+ var ErrEmptySessionName = errors.New("session name cannot be empty")

+ var ErrInvalidDateRange = errors.New("invalid date range: date_from must be before date_to")

+ var ErrInvalidExportFormat = errors.New("invalid export format")

+ var ErrInvalidImportData = errors.New("invalid import data")

+ var ErrInvalidMessageID = errors.New("invalid message ID")

+ var ErrInvalidRole = errors.New("invalid message role")

+ var ErrInvalidSessionID = errors.New("invalid session ID")

+ var ErrInvalidStatus = errors.New("invalid session status")

+ var ErrMessageNotFound = errors.New("message not found")

+ var ErrSearchLimitExceeded = errors.New("search limit exceeds maximum allowed (1000)")

+ var ErrSessionDeleted = errors.New("session is deleted")

+ var ErrSessionNotFound = errors.New("session not found")

+ func DetectCodeLanguage(content string) string

+ func FormatCodeBlock(content, language string) string

+ func MarshalMetadata(metadata map[string]any) (string, error)

+ func MarshalSettings(settings map[string]any) (string, error)

+ func UnmarshalMetadata(data string) (map[string]any, error)

+ func UnmarshalSettings(data string) (map[string]any, error)

+ type ExportData struct

+ Messages []*Message

+ Metadata ExportMetadata

+ Session *Session

+ type ExportFormat string

+ const ExportFormatHTML

+ const ExportFormatJSON

+ const ExportFormatMarkdown

+ const ExportFormatText

+ func (f ExportFormat) IsValid() bool

+ type ExportMetadata struct

+ ExportedAt time.Time

+ ExporterName string

+ ExporterVer string

+ FirstMessage time.Time

+ LastMessage time.Time

+ MessageCount int

+ Provider string

+ TotalTokens int64

+ type Exporter struct

+ func NewExporter(options *ExporterOptions) *Exporter

+ func (e *Exporter) ExportToFile(filePath string, format ExportFormat, session *Session, messages []*Message) error

+ func (e *Exporter) ExportToHTML(w io.Writer, session *Session, messages []*Message) error

+ func (e *Exporter) ExportToJSON(w io.Writer, session *Session, messages []*Message) error

+ func (e *Exporter) ExportToJSONWithContext(ctx context.Context, w io.Writer, session *Session, messages []*Message) error

+ func (e *Exporter) ExportToMarkdown(w io.Writer, session *Session, messages []*Message) error

+ func (e *Exporter) ExportWithTemplate(w io.Writer, templatePath string, session *Session, messages []*Message) error

+ type ExporterOptions struct

+ IncludeMetadata bool

+ PrettyPrint bool

+ TemplateDir string

+ type ListOption func(*ListOptions)

+ func WithLimit(limit int64) ListOption

+ func WithOffset(offset int64) ListOption

+ func WithSortBy(sortBy string) ListOption

+ func WithStatus(status SessionStatus) ListOption

+ type ListOptions struct

+ Limit int64

+ Offset int64

+ SortBy string

+ Status SessionStatus

+ func ApplyListOptions(opts ...ListOption) *ListOptions

+ func DefaultListOptions() *ListOptions

+ type Manager interface

+ AddMessage func(ctx context.Context, message *Message) error

+ ArchiveSession func(ctx context.Context, id string) error

+ Close func() error

+ CreateSession func(ctx context.Context, session *Session) error

+ DeleteMessage func(ctx context.Context, id string) error

+ DeleteSession func(ctx context.Context, id string) error

+ ExportSession func(ctx context.Context, sessionID string, format ExportFormat, w io.Writer) error

+ GetConversationThread func(ctx context.Context, messageID string) ([]*Message, error)

+ GetMessage func(ctx context.Context, id string) (*Message, error)

+ GetMessages func(ctx context.Context, sessionID string) ([]*Message, error)

+ GetMessagesPaginated func(ctx context.Context, sessionID string, limit, offset int64) ([]*Message, error)

+ GetSession func(ctx context.Context, id string) (*Session, error)

+ GetSessionMessageCount func(ctx context.Context, sessionID string) (int64, error)

+ GetSessionSummary func(ctx context.Context, id string) (*SessionSummary, error)

+ GetTotalTokensUsed func(ctx context.Context, sessionID string) (int64, error)

+ HardDeleteSession func(ctx context.Context, id string) error

+ ImportSession func(ctx context.Context, r io.Reader) (*Session, error)

+ ListSessions func(ctx context.Context, opts ...ListOption) ([]*Session, error)

+ SearchMessages func(ctx context.Context, sessionID string, query string, opts ...SearchOption) ([]*Message, error)

+ SearchSessions func(ctx context.Context, query string, opts ...SearchOption) ([]*Session, error)

+ TouchSession func(ctx context.Context, id string) error

+ UpdateMessage func(ctx context.Context, message *Message) error

+ UpdateSession func(ctx context.Context, session *Session) error

+ type Message struct

+ Content string

+ FinishReason *string

+ ID string

+ Metadata map[string]any

+ Model *string

+ ParentID *string

+ Role MessageRole

+ SessionID string

+ Timestamp time.Time

+ TokensUsed *int64

+ type MessageRole string

+ const RoleAssistant

+ const RoleSystem

+ const RoleTool

+ const RoleUser

+ func (r MessageRole) IsValid() bool

+ type SQLiteManager struct

+ func NewSQLiteManager(db *database.DB) *SQLiteManager

+ func (m *SQLiteManager) AddMessage(ctx context.Context, message *Message) error

+ func (m *SQLiteManager) ArchiveSession(ctx context.Context, id string) error

+ func (m *SQLiteManager) Close() error

+ func (m *SQLiteManager) CreateSession(ctx context.Context, session *Session) error

+ func (m *SQLiteManager) DeleteMessage(ctx context.Context, id string) error

+ func (m *SQLiteManager) DeleteSession(ctx context.Context, id string) error

+ func (m *SQLiteManager) ExportSession(ctx context.Context, sessionID string, format ExportFormat, w io.Writer) error

+ func (m *SQLiteManager) GetConversationThread(ctx context.Context, messageID string) ([]*Message, error)

+ func (m *SQLiteManager) GetMessage(ctx context.Context, id string) (*Message, error)

+ func (m *SQLiteManager) GetMessages(ctx context.Context, sessionID string) ([]*Message, error)

+ func (m *SQLiteManager) GetMessagesPaginated(ctx context.Context, sessionID string, limit, offset int64) ([]*Message, error)

+ func (m *SQLiteManager) GetSession(ctx context.Context, id string) (*Session, error)

+ func (m *SQLiteManager) GetSessionMessageCount(ctx context.Context, sessionID string) (int64, error)

+ func (m *SQLiteManager) GetSessionSummary(ctx context.Context, id string) (*SessionSummary, error)

+ func (m *SQLiteManager) GetTotalTokensUsed(ctx context.Context, sessionID string) (int64, error)

+ func (m *SQLiteManager) HardDeleteSession(ctx context.Context, id string) error

+ func (m *SQLiteManager) ImportSession(ctx context.Context, r io.Reader) (*Session, error)

+ func (m *SQLiteManager) ListSessions(ctx context.Context, opts ...ListOption) ([]*Session, error)

+ func (m *SQLiteManager) OptimizeSearchIndex(ctx context.Context) error

+ func (m *SQLiteManager) RebuildSearchIndex(ctx context.Context) error

+ func (m *SQLiteManager) SearchAllMessages(ctx context.Context, opts *SearchOptions) (*SearchResultSet, error)

+ func (m *SQLiteManager) SearchMessages(ctx context.Context, sessionID string, query string, opts ...SearchOption) ([]*Message, error)

+ func (m *SQLiteManager) SearchSessions(ctx context.Context, query string, opts ...SearchOption) ([]*Session, error)

+ func (m *SQLiteManager) TouchSession(ctx context.Context, id string) error

+ func (m *SQLiteManager) UpdateMessage(ctx context.Context, message *Message) error

+ func (m *SQLiteManager) UpdateSession(ctx context.Context, session *Session) error

+ type SearchOption func(*SearchOptions)

+ func WithQuery(query string) SearchOption

+ func WithSearchLimit(limit int64) SearchOption

+ func WithSearchOffset(offset int64) SearchOption

+ type SearchOptions struct

+ DateFrom *time.Time

+ DateTo *time.Time

+ Limit int64

+ Offset int64

+ Provider string

+ Query string

+ func ApplySearchOptions(opts ...SearchOption) *SearchOptions

+ func DefaultSearchOptions() *SearchOptions

+ func DefaultSearchOptionsWithQuery(query string) *SearchOptions

+ func (opts *SearchOptions) Validate() error

+ type SearchResult struct

+ Message Message

+ RelevanceScore float64

+ SessionName string

+ SessionStatus SessionStatus

+ Snippet string

+ type SearchResultSet struct

+ Limit int64

+ Offset int64

+ Query string

+ Results []SearchResult

+ TotalCount int64

+ type Session struct

+ CreatedAt time.Time

+ ID string

+ MaxTokens *int64

+ Model *string

+ Name string

+ Settings map[string]any

+ Status SessionStatus

+ Temperature *float64

+ UpdatedAt time.Time

+ type SessionError struct

+ Context string

+ Err error

+ Op string

+ func NewSessionError(op string, err error, context string) *SessionError

+ func (e *SessionError) Error() string

+ func (e *SessionError) Unwrap() error

+ type SessionExport struct

+ Messages []Message

+ Session Session

+ type SessionStatus string

+ const StatusActive

+ const StatusArchived

+ const StatusDeleted

+ func (s SessionStatus) IsValid() bool

+ type SessionSummary struct

+ MessageCount int64

+ TotalTokens int64