pgvector

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

type AdapterConfig struct {
	DSN                string        // PostgreSQL runtime connection string
	BootstrapDSN       string        // optional privileged DDL connection; empty falls back to DSN
	Schema             string        // schema name (default cortex_vector)
	Table              string        // table name (default embeddings)
	Dimension          int           // expected vector dimension
	ModelName          string        // model name for namespace enforcement (empty = skip)
	IndexType          string        // hnsw or ivfflat (default hnsw)
	HNSWM              int           // HNSW max connections per node (default 16, range 2-100)
	HNSWEfConstruction int           // HNSW dynamic candidate list for build (default 64, range 1-1000)
	IVFFlatLists       int           // IVFFlat number of inverted lists (default 100, range 1-50000)
	MaxBatchSize       int           // upsert batch ceiling (default 256)
	Timeout            time.Duration // per-operation timeout (default 30s)
	MaxConns           int32         // pool max connections (default 10)
	StatementTimeoutMs int           // PostgreSQL statement_timeout in ms (default 5000)

	// GrantRoles names additional PostgreSQL roles to receive USAGE on the
	// schema and SELECT on the table during bootstrap. The server composition
	// passes the storage runtime role so the background embedding worker's
	// RLS-bound observation query can check embedding existence through
	// NOT EXISTS on this table (issue #115). Best-effort: a vector-dedicated
	// database may legitimately not contain the storage role.
	GrantRoles []string

	// Tuning carries the config-gated exact-scan tuning knobs (REQ-RET-102).
	// The zero value is fully disabled (byte-identical default cosine exact
	// scan). The factory constructor New() populates it from the
	// CORTEX_VECTOR_PGVECTOR_* environment pattern; NewWithDB callers set it
	// explicitly (tests and external compositions stay deterministic).
	Tuning SearchTuning
}

type SearchTuning struct {
	// MaxParallelWorkersPerGather > 0 enables SET LOCAL
	// max_parallel_workers_per_gather scoped to the search transaction only.
	MaxParallelWorkersPerGather int
	// InnerProduct enables the normalized inner-product distance mode
	// ('<#>') for pre-normalized corpora. Scores stay 1 - distance per the
	// retrieval-engine contract; on unit vectors the ordering is identical to
	// cosine ordering.
	InnerProduct bool
}