memory

Apr 16, 2026

Changes in this version

type FileStore

+ func (fs *FileStore) BaseDir() string

Apr 13, 2026

Changes in this version

+ const ClassifierDominanceFactor

+ const ClassifierMinConfidence

+ const ClassifierMinHits

+ const DefaultLegacyClassificationBatchSize

+ const MaxHallNameLength

+ const MaxRoomNameLength

+ const MaxWingNameLength

+ const MemoryFileName

+ const MinAllowedClassifierConfidence

+ const ReservedWingPrefix

+ var ErrChannelWingNotFound = errors.New("channel wing mapping not found")

+ func BuildPathForCoords(c PalaceCoords) string

+ func DefaultTTLForCategory(category string) time.Duration

+ func InitHierarchySchema(db *sql.DB, logger *slog.Logger) error

+ func IsLegacyPath(relPath string) bool

+ func MigrateEssentialStories(db *sql.DB, logger *slog.Logger) error

+ func MigrateKgSchema(db *sql.DB, logger *slog.Logger) error

+ func NormalizeHall(input string) string

+ func NormalizeRoom(input string) string

+ func NormalizeWing(input string) string

+ func SeedSuggestedWings(db *sql.DB) error

+ func SetL1CacheHitFn(fn func())

+ func SetL1CacheMissFn(fn func())

+ func StripAccents(s string) string

+ func SuggestedWings() []string

+ func VectorNorm(v []float32) float64

+ type ChannelWingMapping struct

+ Channel string

+ Confidence float64

+ CreatedAt time.Time

+ ExternalID string

+ Source string

+ UpdatedAt time.Time

+ Wing string

+ type ClassifierResult struct

+ Confidence float64

+ MatchedKeywords []string

+ SecondWingHits int

+ TopWingHits int

+ Wing string

+ func ClassifyLegacyContent(content string, keywords map[string][]string) ClassifierResult

type EmbeddingConfig

+ Quantize bool

+ QuantizeBits int

+ type EnrichedEntityMatch struct

+ EntityID int64

+ Matched string

+ Name string

+ type EnrichedSearchResult struct

+ EntityMatches []EnrichedEntityMatch

+ KGFacts []KGFact

+ Memories []SearchResult

+ type EntityCandidate struct

+ Normalized string

+ Offset int

+ Text string

+ type EntityDetector struct

+ func NewEntityDetector(store *SQLiteStore, cfg EntityDetectorConfig, logger *slog.Logger) *EntityDetector

+ func (d *EntityDetector) Detect(ctx context.Context, turn string) ([]EntityMatch, error)

+ func (d *EntityDetector) Refresh(ctx context.Context) error

+ type EntityDetectorConfig struct

+ CacheTTL time.Duration

+ MaxTokens int

+ MinTokenLen int

+ func DefaultEntityDetectorConfig() EntityDetectorConfig

+ type EntityMatch struct

+ Candidate EntityCandidate

+ Kind string

+ Room string

+ Wing string

type Entry

+ ExpiresAt *time.Time

+ type EssentialLayer struct

+ func NewEssentialLayer(store *SQLiteStore, cfg EssentialLayerConfig, logger *slog.Logger) *EssentialLayer

+ func (l *EssentialLayer) Generate(ctx context.Context, wing string) (string, error)

+ func (l *EssentialLayer) Invalidate(ctx context.Context, wing string) (int64, error)

+ func (l *EssentialLayer) Render(ctx context.Context, wing string) string

+ type EssentialLayerConfig struct

+ ByteBudget int

+ LeadSentencesPerRoom int

+ RoomsPerWing int

+ StaleAfter time.Duration

+ func DefaultEssentialLayerConfig() EssentialLayerConfig

type FileStore

+ func (fs *FileStore) Compact() (int, error)

+ func (fs *FileStore) SaveIfNotDuplicate(entry Entry, contentHash string, isDuplicate func(existing Entry) bool) (bool, string, error)

+ type HybridSearchOptions struct

+ BM25Weight float64

+ KGFactsPerEntity int

+ MaxResults int

+ MinScore float64

+ QueryWing string

+ VectorWeight float64

+ WingBoostMatch float64

+ WingBoostPenalty float64

+ type IdentityLayer struct

+ func NewIdentityLayer(path string, logger *slog.Logger, budget int) *IdentityLayer

+ func (l *IdentityLayer) Reload() error

+ func (l *IdentityLayer) Render() string

+ func (l *IdentityLayer) Start() error

+ func (l *IdentityLayer) Stop()

+ type KGFact struct

+ Confidence float64

+ ObjectText string

+ PredicateName string

+ SourceMemoryID string

+ SubjectName string

+ Wing string

+ type LegacyClassificationConfig struct

+ BatchSize int

+ DryRun bool

+ Keywords map[string][]string

+ MinConfidence float64

+ type LegacyClassificationStats struct

+ Classified int

+ Errors int

+ PerWing map[string]int

+ Scanned int

+ Skipped int

+ type ONNXEmbedder struct

+ func NewONNXEmbedder(cfg EmbeddingConfig) (*ONNXEmbedder, error)

+ func (e *ONNXEmbedder) Close() error

+ func (e *ONNXEmbedder) Dimensions() int

+ func (e *ONNXEmbedder) Embed(_ context.Context, texts []string) ([][]float32, error)

+ func (e *ONNXEmbedder) Model() string

+ func (e *ONNXEmbedder) Name() string

+ type ONNXPaths struct

+ ModelFile string

+ RuntimeLib string

+ VocabFile string

+ type OnDemandLayer struct

+ func NewOnDemandLayer(store *SQLiteStore, detector *EntityDetector, cfg OnDemandLayerConfig, ...) *OnDemandLayer

+ func (l *OnDemandLayer) Render(ctx context.Context, activeWing string, turn string) string

+ func (l *OnDemandLayer) SetKG(k *kg.KG, factsPerRender int)

+ func (l *OnDemandLayer) SetTopicDetector(d *TopicChangeDetector)

+ type OnDemandLayerConfig struct

+ ByteBudget int

+ CrossWingEnabled bool

+ DetectorTimeoutMs int

+ MaxResults int

+ SearchTimeoutMs int

+ func DefaultOnDemandLayerConfig() OnDemandLayerConfig

+ type PalaceCoords struct

+ Hall string

+ Room string

+ Wing string

+ func ExtractCoordsFromPath(relPath string) PalaceCoords

+ func (c PalaceCoords) IsEmpty() bool

+ type QuantizedEmbedding struct

+ Data []uint8

+ Dims int

+ MinVal float32

+ Scale float32

+ func QuantizeFloat32(vec []float32) QuantizedEmbedding

+ func (q *QuantizedEmbedding) UnmarshalBinary(data []byte) error

+ func (q QuantizedEmbedding) CosineSimilarity(query []float32, queryNorm float64) float64

+ func (q QuantizedEmbedding) Dequantize() []float32

+ func (q QuantizedEmbedding) DotProduct(query []float32) float64

+ func (q QuantizedEmbedding) MarshalBinary() ([]byte, error)

+ type RoomFileSummary struct

+ AccessCount int

+ FileID string

+ IndexedAt time.Time

+ Text string

+ type RoomInfo struct

+ Confidence float64

+ CreatedAt time.Time

+ Description string

+ DisplayName string

+ Hall string

+ LastActivity time.Time

+ MemoryCount int

+ Name string

+ ReuseCount int

+ Source string

+ Wing string

type SQLiteStore

+ func (s *SQLiteStore) AssignWingToFile(ctx context.Context, fileID string, wing string) error

+ func (s *SQLiteStore) DB() *sql.DB

+ func (s *SQLiteStore) DeleteChannelWing(channel, externalID string) error

+ func (s *SQLiteStore) DeleteWing(name string, force bool) error

+ func (s *SQLiteStore) GetChannelWing(channel, externalID string) (ChannelWingMapping, error)

+ func (s *SQLiteStore) GetTaxonomy() ([]TaxonomyEntry, error)

+ func (s *SQLiteStore) HybridSearchEnriched(ctx context.Context, query string, opts HybridSearchOptions) (*EnrichedSearchResult, error)

+ func (s *SQLiteStore) HybridSearchWithOpts(ctx context.Context, query string, opts HybridSearchOptions) ([]SearchResult, error)

+ func (s *SQLiteStore) HybridSearchWithOptsAndPostFilters(ctx context.Context, query string, opts HybridSearchOptions, ...) ([]SearchResult, error)

+ func (s *SQLiteStore) KG() *kg.KG

+ func (s *SQLiteStore) LastQueryEmbedding() []float32

+ func (s *SQLiteStore) ListChannelWings(wingFilter string) ([]ChannelWingMapping, error)

+ func (s *SQLiteStore) ListRooms(wing string) ([]RoomInfo, error)

+ func (s *SQLiteStore) ListRoomsByRecency(ctx context.Context, wing string, limit int) ([]RoomInfo, error)

+ func (s *SQLiteStore) ListWings() ([]WingInfo, error)

+ func (s *SQLiteStore) RunLegacyClassificationPass(ctx context.Context, cfg LegacyClassificationConfig) (*LegacyClassificationStats, error)

+ func (s *SQLiteStore) SetChannelWing(channel, externalID, wing, source string, confidence float64) error

+ func (s *SQLiteStore) SetKG(k *kg.KG)

+ func (s *SQLiteStore) SetQuantizeEnabled(enabled bool)

+ func (s *SQLiteStore) TopFilesInRoom(ctx context.Context, wing, room string, limit int) ([]RoomFileSummary, error)

+ func (s *SQLiteStore) TotalLegacyFiles() (int, error)

+ func (s *SQLiteStore) UpsertRoom(wing, name, hall, source string, confidence float64) error

+ func (s *SQLiteStore) UpsertWing(name, displayName, description string) error

type SearchResult

+ Wing string

+ type TaxonomyEntry struct

+ LegacyCount int

+ Rooms []RoomInfo

+ Wing WingInfo

+ type TopicChangeDetector struct

+ func NewTopicChangeDetector(cosineThreshold, entityOverlap float32, kgStore *kg.KG, factsPerInjection int) *TopicChangeDetector

+ func (d *TopicChangeDetector) Detect(currentEntities []EntityMatch, currentEmbedding []float32) TopicChangeResult

+ func (d *TopicChangeDetector) LookupKGFacts(ctx context.Context, entities []EntityMatch) []kg.Triple

+ func (d *TopicChangeDetector) UpdateTopic(entities []EntityMatch, embedding []float32)

+ type TopicChangeResult struct

+ Changed bool

+ Confidence float32

+ type WingInfo struct

+ Color string

+ CreatedAt time.Time

+ Description string

+ DisplayName string

+ IsDefault bool

+ IsSuggested bool

+ MemoryCount int

+ Name string

+ RoomCount int

+ UpdatedAt time.Time

+ type WordPieceTokenizer struct

+ func NewWordPieceTokenizer(vocabPath string, maxLen int) (*WordPieceTokenizer, error)

+ func (t *WordPieceTokenizer) Tokenize(text string) (inputIDs, attentionMask, tokenTypeIDs []int64)

Mar 11, 2026

Changes in this version

type EmbeddingConfig

+ Fallback string

+ FallbackAPIKey string

+ FallbackBaseURL string

+ FallbackModel string

+ type FallbackEmbedder struct

+ func NewFallbackEmbedder(primary, fallback EmbeddingProvider, logger *slog.Logger) *FallbackEmbedder

+ func (f *FallbackEmbedder) Dimensions() int

+ func (f *FallbackEmbedder) Embed(ctx context.Context, texts []string) ([][]float32, error)

+ func (f *FallbackEmbedder) Model() string

+ func (f *FallbackEmbedder) Name() string

+ type GeminiEmbedder struct

+ func NewGeminiEmbedder(cfg EmbeddingConfig) *GeminiEmbedder

+ func (e *GeminiEmbedder) Dimensions() int

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

+ func (e *GeminiEmbedder) Model() string

+ func (e *GeminiEmbedder) Name() string

+ type MistralEmbedder struct

+ func NewMistralEmbedder(cfg EmbeddingConfig) *MistralEmbedder

+ func (e *MistralEmbedder) Dimensions() int

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

+ func (e *MistralEmbedder) Model() string

+ func (e *MistralEmbedder) Name() string

type SQLiteStore

+ func (s *SQLiteStore) IndexTranscript(ctx context.Context, sessionID string, entries []TranscriptEntry) error

+ type TranscriptEntry struct

+ Content string

+ Role string

+ type VoyageEmbedder struct

+ func NewVoyageEmbedder(cfg EmbeddingConfig) *VoyageEmbedder

+ func (e *VoyageEmbedder) Dimensions() int

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

+ func (e *VoyageEmbedder) Model() string

+ func (e *VoyageEmbedder) Name() string

Feb 26, 2026

Changes in this version

+ type MMRConfig struct

+ Enabled bool

+ Lambda float64

type SQLiteStore

+ func (s *SQLiteStore) ApplyMMR(results []SearchResult, cfg MMRConfig, maxResults int) []SearchResult

+ func (s *SQLiteStore) ApplyTemporalDecay(results []SearchResult, cfg TemporalDecayConfig) []SearchResult

+ func (s *SQLiteStore) HybridSearchWithOptions(ctx context.Context, query string, maxResults int, minScore float64, ...) ([]SearchResult, error)

+ type TemporalDecayConfig struct

+ Enabled bool

+ HalfLifeDays float64

Feb 20, 2026

Changes in this version

+ func FileHash(path string) (string, error)

+ func IndexDirectory(dir string, cfg ChunkConfig) (map[string][]Chunk, error)

+ type Chunk struct

+ FileID string

+ Hash string

+ Index int

+ Text string

+ func ChunkMarkdown(text string, cfg ChunkConfig) []Chunk

+ type ChunkConfig struct

+ MaxTokens int

+ Overlap int

+ func DefaultChunkConfig() ChunkConfig

+ type EmbeddingConfig struct

+ APIKey string

+ BaseURL string

+ Cache bool

+ Dimensions int

+ Model string

+ Provider string

+ func DefaultEmbeddingConfig() EmbeddingConfig

+ type EmbeddingProvider interface

+ Dimensions func() int

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

+ Model func() string

+ Name func() string

+ func NewEmbeddingProvider(cfg EmbeddingConfig) EmbeddingProvider

+ type Entry struct

+ Category string

+ Content string

+ Source string

+ Timestamp time.Time

+ type FileStore struct

+ func NewFileStore(baseDir string) (*FileStore, error)

+ func (fs *FileStore) GetAll() ([]Entry, error)

+ func (fs *FileStore) GetByDate(date time.Time) ([]Entry, error)

+ func (fs *FileStore) GetRecent(limit int) ([]Entry, error)

+ func (fs *FileStore) ListDailyLogs() ([]string, error)

+ func (fs *FileStore) RecentFacts(maxFacts int, query string) string

+ func (fs *FileStore) Save(entry Entry) error

+ func (fs *FileStore) SaveDailyLog(date time.Time, content string) error

+ func (fs *FileStore) Search(query string, maxResults int) ([]Entry, error)

+ type NullEmbedder struct

+ func (e *NullEmbedder) Dimensions() int

+ func (e *NullEmbedder) Embed(_ context.Context, _ []string) ([][]float32, error)

+ func (e *NullEmbedder) Model() string

+ func (e *NullEmbedder) Name() string

+ type OpenAIEmbedder struct

+ func NewOpenAIEmbedder(cfg EmbeddingConfig) *OpenAIEmbedder

+ func (e *OpenAIEmbedder) Dimensions() int

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

+ func (e *OpenAIEmbedder) Model() string

+ func (e *OpenAIEmbedder) Name() string

+ type SQLiteStore struct

+ func NewSQLiteStore(dbPath string, embedder EmbeddingProvider, logger *slog.Logger) (*SQLiteStore, error)

+ func (s *SQLiteStore) ChunkCount() int

+ func (s *SQLiteStore) Close() error

+ func (s *SQLiteStore) FileCount() int

+ func (s *SQLiteStore) HybridSearch(ctx context.Context, query string, maxResults int, minScore float64, ...) ([]SearchResult, error)

+ func (s *SQLiteStore) IndexChunks(ctx context.Context, fileID string, chunks []Chunk, fileHash string) error

+ func (s *SQLiteStore) IndexMemoryDir(ctx context.Context, memDir string, chunkCfg ChunkConfig) error

+ func (s *SQLiteStore) PruneEmbeddingCache(maxEntries int)

+ func (s *SQLiteStore) SearchBM25(query string, maxResults int) ([]SearchResult, error)

+ func (s *SQLiteStore) SearchVector(ctx context.Context, query string, maxResults int) ([]SearchResult, error)

+ type SearchResult struct

+ FileID string

+ Score float64

+ Text string

+ type Store interface

+ GetAll func() ([]Entry, error)

+ GetByDate func(date time.Time) ([]Entry, error)

+ GetRecent func(limit int) ([]Entry, error)

+ Save func(entry Entry) error

+ SaveDailyLog func(date time.Time, content string) error

+ Search func(query string, maxResults int) ([]Entry, error)