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
- API
  
  Reference documentation for the pkg.go.dev API
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

memory

package

Go to main page

Versions in this module

v1

v1.1.0

Jun 15, 2026

Changes in this version

+ type CompositeLongTermStore struct

+ func NewCompositeLongTermStore(store Store, retriever Retriever) *CompositeLongTermStore

+ func (c *CompositeLongTermStore) AddHook(hook StoreHook)

+ func (c *CompositeLongTermStore) AttachIndexer(indexer Indexer)

+ func (c *CompositeLongTermStore) ClearSession(ctx context.Context, sessionID string) error

+ func (c *CompositeLongTermStore) Close() error

+ func (c *CompositeLongTermStore) GetRetriever() Retriever

+ func (c *CompositeLongTermStore) GetSession(ctx context.Context, sessionID string) ([]*schema.Message, error)

+ func (c *CompositeLongTermStore) GetStore() Store

+ func (c *CompositeLongTermStore) IndexReady() bool

+ func (c *CompositeLongTermStore) Recall(ctx context.Context, sessionID string, query string, topK int) ([]*schema.Message, error)

+ func (c *CompositeLongTermStore) Save(ctx context.Context, sessionID string, msgs []*schema.Message) error

type Controller

+ func (c *Controller) AddSystemPrompt(msgs ...*schema.Message)

+ func (c *Controller) GetShortMemory() ShortMemoryManager

+ type DocumentStore interface

+ Close func() error

+ DeleteCollection func(ctx context.Context, collection string) error

+ GetDocuments func(ctx context.Context, collection string) ([]*schema.Document, error)

+ RecallDocuments func(ctx context.Context, collection string, query string, topK int) ([]*schema.Document, error)

+ SaveDocuments func(ctx context.Context, collection string, docs []*schema.Document) error

+ type Indexer interface

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

+ IndexReady func() bool

+ RebuildIndex func()

+ RemoveFromIndex func(sessionID string) error

+ type Option func(*Controller)

+ func WithLongStore(store LongTermStore) Option

+ func WithTopK(k int) Option

+ type Retriever interface

+ Close func() error

+ Recall func(ctx context.Context, sessionID string, query string, topK int) ([]*schema.Message, error)

+ type Store interface

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

+ Close func() error

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

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

+ type StoreEvent struct

+ Messages []*schema.Message

+ SessionID string

+ Type StoreEventType

+ type StoreEventType int

+ const StoreEventClear

+ const StoreEventSave

+ type StoreHook func(event StoreEvent)

v1.0.1

Jun 2, 2026

v1.0.0

May 23, 2026

Changes in this version

+ func SplitText(text string, chunkSize, chunkOverlap int) []string

+ type CombinedWeights struct

+ KeywordWeight float64

+ TimeWeight float64

+ VectorWeight float64

+ func DefaultCombinedWeights() *CombinedWeights

+ type Controller struct

+ LongStore LongTermStore

+ ShortMemory ShortMemoryManager

+ SystemPrompt []*schema.Message

+ TopK int

+ func NewController(systemPrompt []*schema.Message, shortMemory ShortMemoryManager, ...) *Controller

+ func (c *Controller) BuildContext(ctx context.Context, sessionID string, currentQuery string) ([]*schema.Message, error)

+ func (c *Controller) Clear(ctx context.Context, sessionID string) error

+ func (c *Controller) Close() error

+ func (c *Controller) GetHistory(ctx context.Context, sessionID string) ([]*schema.Message, error)

+ func (c *Controller) SaveTurn(ctx context.Context, sessionID string, msgs []*schema.Message) error

+ type Embedder interface

+ Embed func(ctx context.Context, text string) ([]float32, error)

+ type EmbeddingChunk struct

+ ChunkIndex int

+ Content string

+ Embedding string

+ ID string

+ MessageID string

+ SessionID string

+ func (EmbeddingChunk) TableName() string

+ func (c *EmbeddingChunk) GetEmbedding() ([]float32, error)

+ func (c *EmbeddingChunk) SetEmbedding(vec []float32) error

+ type EmbeddingFunc func(ctx context.Context, text string) ([]float32, error)

+ func EmbedderFunc(e Embedder) EmbeddingFunc

+ type GormStore struct

+ func NewGormStore(config *GormStoreConfig, embedding EmbeddingFunc) (*GormStore, error)

+ func (s *GormStore) ClearSession(ctx context.Context, sessionID string) error

+ func (s *GormStore) Close() error

+ func (s *GormStore) GetSession(ctx context.Context, sessionID string) ([]*schema.Message, error)

+ func (s *GormStore) GetSessionStats(ctx context.Context, sessionID string) (map[string]any, error)

+ func (s *GormStore) GetSessionWithReasoning(ctx context.Context, sessionID string) ([]*schema.Message, error)

+ func (s *GormStore) IndexReady() bool

+ func (s *GormStore) Recall(ctx context.Context, sessionID string, query string, topK int) ([]*schema.Message, error)

+ func (s *GormStore) Save(ctx context.Context, sessionID string, msgs []*schema.Message) error

+ func (s *GormStore) SearchByRole(ctx context.Context, sessionID string, role schema.RoleType, limit int) ([]*schema.Message, error)

+ func (s *GormStore) SearchByTimeRange(ctx context.Context, sessionID string, start, end time.Time) ([]*schema.Message, error)

+ type GormStoreConfig struct

+ ChunkOverlap int

+ ChunkSize int

+ CombinedWeights *CombinedWeights

+ ConnMaxLifetime time.Duration

+ DBPath string

+ DisableVectorSearch bool

+ EmbeddingDimension int

+ LogLevel logger.LogLevel

+ MaxIdleConns int

+ MaxOpenConns int

+ RecallMode RecallMode

+ func DefaultGormStoreConfig() *GormStoreConfig

+ type LongTermStore interface

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

+ Close func() error

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

+ Recall func(ctx context.Context, sessionID string, query string, topK int) ([]*schema.Message, error)

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

+ type MemNetAIConfig struct

+ APIKey string

+ AsyncMode bool

+ BaseURL string

+ HTTPClient *http.Client

+ IsThirdPerson bool

+ Language string

+ Namespace string

+ type MemNetAIStore struct

+ func NewMemNetAIStore(cfg *MemNetAIConfig) (*MemNetAIStore, error)

+ func (s *MemNetAIStore) ClearSession(ctx context.Context, sessionID string) error

+ func (s *MemNetAIStore) Close() error

+ func (s *MemNetAIStore) GetSession(ctx context.Context, sessionID string) ([]*schema.Message, error)

+ func (s *MemNetAIStore) Recall(ctx context.Context, sessionID string, query string, topK int) ([]*schema.Message, error)

+ func (s *MemNetAIStore) Save(ctx context.Context, sessionID string, msgs []*schema.Message) error

+ type MessageModel struct

+ Content string

+ CreatedAt time.Time

+ Embedding string

+ ID string

+ Metadata string

+ ReasoningContent string

+ Role string

+ SessionID string

+ Timestamp int64

+ func (MessageModel) TableName() string

+ func (m *MessageModel) GetEmbedding() ([]float32, error)

+ func (m *MessageModel) SetEmbedding(vec []float32) error

+ func (m *MessageModel) ToSchemaMessage() *schema.Message

+ type MessageRecord struct

+ Content string

+ Embedding []float32

+ ID string

+ Metadata map[string]string

+ Role string

+ SessionID string

+ Timestamp time.Time

+ type ModelContextWindow interface

+ ContextWindow func() int

+ type OllamaEmbedder struct

+ func NewOllamaEmbedder(baseURL, model string) *OllamaEmbedder

+ func (e *OllamaEmbedder) Embed(ctx context.Context, text string) ([]float32, error)

+ type RecallMode int

+ const RecallModeAuto

+ const RecallModeCombined

+ const RecallModeHybrid

+ const RecallModeVector

+ type ShortMemoryManager interface

+ AddTurn func(sessionID string, msgs []*schema.Message)

+ Clear func(sessionID string)

+ GetContextMessages func(sessionID string) []*schema.Message

+ GetRecent func(sessionID string) []*schema.Message

+ type SimpleWindowMemory struct

+ func NewSimpleWindowMemory(wm *WindowManager) *SimpleWindowMemory

+ func (sm *SimpleWindowMemory) AddTurn(sessionID string, msgs []*schema.Message)

+ func (sm *SimpleWindowMemory) Clear(sessionID string)

+ func (sm *SimpleWindowMemory) GetContextMessages(sessionID string) []*schema.Message

+ func (sm *SimpleWindowMemory) GetRecent(sessionID string) []*schema.Message

+ type SummaryFunc func(messages []*schema.Message, model chatmodel.BaseModel) string

+ func DefaultSummaryFunc() SummaryFunc

+ type TokenEstimator interface

+ Estimate func(msg *schema.Message) int

+ type WindowConfig struct

+ MaxHistoryMessages int

+ MaxHistoryTokens int

+ ReserveTokens int

+ type WindowManager struct

+ func NewWindowManager(config WindowConfig, model chatmodel.BaseModel, estimator TokenEstimator) *WindowManager

+ func (wm *WindowManager) GetConfig() WindowConfig

+ func (wm *WindowManager) Truncate(msgs []*schema.Message) []*schema.Message

+ type WindowShortMemory struct

+ func NewWindowShortMemory(wm *WindowManager, model chatmodel.BaseModel, summarizer SummaryFunc) *WindowShortMemory

+ func (ws *WindowShortMemory) AddTurn(sessionID string, msgs []*schema.Message)

+ func (ws *WindowShortMemory) Clear(sessionID string)

+ func (ws *WindowShortMemory) GetContextMessages(sessionID string) []*schema.Message

+ func (ws *WindowShortMemory) GetRecent(sessionID string) []*schema.Message