vector

type Architecture struct {
	// Centroids stores the centroid vectors.
	// Key: CentroidID (int) -> Value: Centroid struct
	// Name: "{domain}_centroids"
	Centroids btree.BtreeInterface[int, ai.Centroid]

	// Vectors stores the item vectors, indexed by centroid and distance.
	// Key: VectorKey{CentroidID, Distance, ItemID} -> Value: ItemVector ([]float32)
	// Name: "{domain}_vectors"
	// Optimization: Keeping this small allows more vectors to fit in CPU cache during scanning.
	Vectors btree.BtreeInterface[ai.VectorKey, []float32]

	// Content stores the actual item data.
	// Key: ContentKey (Metadata) -> Value: Document/JSON (string)
	// Name: "{domain}_content"
	Content btree.BtreeInterface[ai.ContentKey, string]

	// Lookup (Int -> ID): Maps integer IDs to string IDs, enabling efficient random sampling.
	// Key: SequenceID (int) -> Value: ItemID (string)
	// Name: "{domain}_lookup"
	Lookup btree.BtreeInterface[int, string]

	// TempVectors stores vectors temporarily during the ingestion phase.
	// Key: ItemID (string) -> Value: Vector ([]float32)
	// Name: "{domain}_temp_vectors"
	TempVectors btree.BtreeInterface[string, []float32]

	// Version tracks the current version of the index (Centroids/Vectors).
	Version int64
}

type Config struct {
	// TransactionOptions specifies the transaction options for the store.
	TransactionOptions sop.TransactionOptions
	ContentSize        sop.ValueDataSize
	UsageMode          ai.UsageMode
	// EnableIngestionBuffer enables the initial "TempVectors" stage (Stage 0)
	// which buffers vectors for faster ingestion (O(1)) before they are indexed.
	// If false (default), vectors are written directly to the main index (Stage 1),
	// which is slower for ingestion but allows immediate querying and structure.
	EnableIngestionBuffer bool
	// Cache is the L2 cache client used for optimization locking and other operations.
	Cache sop.L2Cache
	// Metadata contains the knowledge base information, such as the required Embedder details.
	Metadata Metadata
}

type EmbedderInfo struct {
	Provider   string `json:"provider,omitempty"`
	Model      string `json:"model,omitempty"`
	Dimensions int    `json:"dimensions,omitempty"`
}

type Metadata struct {
	ActiveVersion int64        `json:"active_version"`
	Embedder      EmbedderInfo `json:"embedder,omitempty"`
	Description   string       `json:"description,omitempty"`
}