memory

Jun 10, 2026

Changes in this version

+ type EmbeddingConfig struct

+ APIKey string

+ BaseURL string

+ Dims int

+ Model string

+ Provider string

+ TimeoutSeconds int

type MemoryConfig

+ Embedding *EmbeddingConfig

Jun 6, 2026

Changes in this version

+ var AlwaysExternalTools = map[string]bool

+ var PathReadingTools = map[string]bool

+ func FactLooksUnsafe(fact string) bool

+ func ToolCallTaints(name, argsJSON string) bool

type EpisodeProvenance

+ AutoApproved bool

type EpisodeStore

+ func NewEpisodeStoreWithLifecycle(dir string, rankFn RankStrategy, dedupThreshold float32, ...) *EpisodeStore

+ func (e *EpisodeStore) PendingReview() ([]EpisodeMeta, error)

+ func (e *EpisodeStore) Promote(sessionID string) error

+ func (e *EpisodeStore) Prune() error

+ func (e *EpisodeStore) SetNotifier(n MemoryNotifier)

type MemoryConfig

+ AutoApproveEpisodes *bool

+ ConsolidateOnEnd *bool

+ EpisodeDedupThreshold float32

+ EpisodeTTLDays int

+ ExtractFacts *bool

+ MaxEpisodes int

+ type MemoryEvent struct

+ Content string

+ Count int

+ NewCount int

+ SessionID string

+ Sessions []string

+ Similarity float32

+ Target string

+ Timestamp time.Time

+ Type string

+ Untrusted bool

type MemoryManager

+ func (m *MemoryManager) PendingReviewEpisodes() ([]EpisodeMeta, error)

+ func (m *MemoryManager) PromoteEpisode(sessionID string) error

+ func (m *MemoryManager) SetNotifier(n MemoryNotifier)

+ type MemoryNotifier interface

+ Notify func(event MemoryEvent)

+ type MultiMemoryNotifier struct

+ func NewMultiMemoryNotifier(notifiers ...MemoryNotifier) *MultiMemoryNotifier

+ func (m *MultiMemoryNotifier) Notify(event MemoryEvent)

+ type NoopMemoryNotifier struct

+ func (NoopMemoryNotifier) Notify(event MemoryEvent)

May 29, 2026

Changes in this version

+ var UntrustedToolNames = map[string]bool

type EpisodeMeta

+ Provenance EpisodeProvenance

+ type EpisodeProvenance struct

+ Sources []string

+ Untrusted bool

+ UserApproved bool

+ func DeriveProvenance(messages []llm.Message) EpisodeProvenance

type EpisodeStore

+ func (e *EpisodeStore) WriteIfEnoughWithProvenance(sessionID, summary string, turns int, prov EpisodeProvenance) error

+ func (e *EpisodeStore) WriteWithProvenance(sessionID, summary string, turns int, prov EpisodeProvenance) error

type MemoryManager

+ func (m *MemoryManager) OnSessionEndWithProvenance(sessionID string, turns int, messages []string, prov EpisodeProvenance)

May 25, 2026

Changes in this version

+ const AddThreshold

+ const MergeThreshold

+ func BoolPtr(b bool) *bool

+ func FormatBufferLine(role, message string) string

+ func ScanContent(content string) error

+ type Buffer struct

+ func NewBuffer(cap int) *Buffer

+ func (b *Buffer) Append(line string)

+ func (b *Buffer) Cap() int

+ func (b *Buffer) Clear()

+ func (b *Buffer) Len() int

+ func (b *Buffer) Lines() []string

+ type EpisodeMeta struct

+ CreatedAt time.Time

+ SessionID string

+ Summary string

+ Turns int

+ type EpisodeStore struct

+ func NewEpisodeStore(dir string, rankFn RankStrategy) *EpisodeStore

+ func (e *EpisodeStore) Read(sessionID string) (string, error)

+ func (e *EpisodeStore) ReadIndex() ([]EpisodeMeta, error)

+ func (e *EpisodeStore) Search(query string, limit int) ([]EpisodeMeta, error)

+ func (e *EpisodeStore) Write(sessionID, summary string, turns int) error

+ func (e *EpisodeStore) WriteIfEnough(sessionID, summary string, turns int) error

+ type FactStore struct

+ func NewFactStore(dir string, capUser, capEnv int) *FactStore

+ func (f *FactStore) Add(target, content string) error

+ func (f *FactStore) Entries(target string) ([]string, error)

+ func (f *FactStore) Read(target string) (string, error)

+ func (f *FactStore) Remove(target, oldText string) error

+ func (f *FactStore) Replace(target, oldText, content string) error

+ type LLMClient interface

+ SimpleCall func(ctx context.Context, system, user string) (string, error)

+ type MemoryConfig struct

+ AddThreshold float32

+ BufferEnabled *bool

+ BufferLines int

+ Enabled *bool

+ ExtractOnEnd *bool

+ FactsLimitEnv int

+ FactsLimitUser int

+ LLMConsolidate *bool

+ LLMExtract *bool

+ LLMSearch *bool

+ MergeOnWrite *bool

+ MergeThreshold float32

+ MinTurnsForExtraction int

+ func DefaultMemoryConfig() MemoryConfig

+ type MemoryManager struct

+ func NewMemoryManager(memoryDir string, llc LLMClient, cfg MemoryConfig) *MemoryManager

+ func (m *MemoryManager) AddFact(target, content string) error

+ func (m *MemoryManager) AppendBuffer(role, message string)

+ func (m *MemoryManager) BuildSystemPrompt() string

+ func (m *MemoryManager) ClearBuffer()

+ func (m *MemoryManager) Consolidate(target string) error

+ func (m *MemoryManager) FormatEpisodeContext(query string) string

+ func (m *MemoryManager) GetBuffer() []string

+ func (m *MemoryManager) OnSessionEnd(sessionID string, turns int, messages []string)

+ func (m *MemoryManager) ReadFacts() (userContent, envContent string, err error)

+ func (m *MemoryManager) RemoveFact(target, oldText string) error

+ func (m *MemoryManager) ReplaceFact(target, oldText, content string) error

+ func (m *MemoryManager) RestoreBuffer(lines []string)

+ func (m *MemoryManager) SearchEpisodes(query string, limit int) ([]EpisodeMeta, error)

+ type MemoryTool struct

+ func NewMemoryTool(mm *MemoryManager) *MemoryTool

+ func (t *MemoryTool) Call(args string) (string, error)

+ func (t *MemoryTool) Description() string

+ func (t *MemoryTool) Name() string

+ func (t *MemoryTool) Schema() any

+ type MergeDetector struct

+ func NewMergeDetector(dims int) *MergeDetector

+ func NewMergeDetectorWithThresholds(dims int, mergeThreshold, addThreshold float32) *MergeDetector

+ func (m *MergeDetector) AppendEntry(entry string)

+ func (m *MergeDetector) Classify(entry string) (action string, similarIdx int, similarity float32)

+ func (m *MergeDetector) Corpus() []string

+ func (m *MergeDetector) Fit(corpus []string)

+ func (m *MergeDetector) ReplaceEntry(idx int, entry string)

+ type RankStrategy func(query string, episodes []EpisodeMeta) ([]EpisodeMeta, error)

+ func NewLLMRanker(llm LLMClient) RankStrategy

+ func NewRPRanker(dims int) RankStrategy