cache

type CacheEntry struct {
	// Query 原始查询文本
	Query string

	// Embedding 查询的向量表示
	Embedding []float64

	// Result 缓存的检索结果
	Result *CacheResult

	// CreatedAt 创建时间
	CreatedAt time.Time

	// HitCount 命中次数（用于统计和 LRU 淘汰参考）
	HitCount int64
}

type CacheResult struct {
	// Documents 缓存的文档列表
	Documents []CachedDocument

	// Answer 缓存的生成答案
	Answer string

	// Metadata 附加元数据
	Metadata map[string]any
}

type CacheStats struct {
	// Size 当前缓存条目数
	Size int

	// MaxSize 最大缓存容量
	MaxSize int

	// Hits 命中次数
	Hits int64

	// Misses 未命中次数
	Misses int64

	// HitRate 命中率 (0-1)
	HitRate float64

	// Evictions 淘汰次数
	Evictions int64
}

type CachedDocument struct {
	// Content 文档内容
	Content string

	// Score 相关性分数
	Score float64

	// Metadata 文档元数据
	Metadata map[string]any
}

type Embedder interface {
	// Embed 将文本转换为向量
	Embed(ctx context.Context, text string) ([]float64, error)
}

type Option func(*SemanticCache)

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