vectorstore

type Entry struct {
	ID       string            `json:"id"`
	Vector   []float32         `json:"vector"`
	Content  string            `json:"content"`
	Metadata map[string]string `json:"metadata"`
}

type SearchOptions struct {
	// TopK is the maximum number of results to return.
	TopK int `json:"top_k"`
	// Filter restricts search to entries matching these metadata key-value pairs.
	Filter map[string]string `json:"filter"`
	// TenantKey is the namespace key for tenant isolation.
	TenantKey string `json:"tenant_key"`
	// MinScore is the minimum similarity score threshold.
	MinScore float64 `json:"min_score"`
}

type SearchResult struct {
	Entry
	Score float64 `json:"score"`
}

type VectorStore interface {
	// Upsert inserts or updates vector entries.
	Upsert(ctx context.Context, entries []Entry) error

	// Search returns the most similar entries to the given vector.
	Search(ctx context.Context, vector []float32, opts *SearchOptions) ([]SearchResult, error)

	// Delete removes entries by their IDs.
	Delete(ctx context.Context, ids []string) error

	// DeleteByMetadata removes entries matching the given metadata filter.
	DeleteByMetadata(ctx context.Context, filter map[string]string) error
}