Skip to main content

SemanticIndexEntry

Description

Central GrayMatter semantic index row. This stores vector embeddings and compressed recall metadata in the RDB object graph while keeping embeddings outside the normalized source business tables. Agents query this table by indexed object reference, owner/org/tenant scope, model, and status, then lazy-load the source object and graph relationships. They do not scan database schemas. Referential integrity model: - targetType + targetId is the polymorphic object reference in the relational graph - principal, organization, and memoryEntry are real FK lookup accelerators for common scopes - tenantScope is tenant/deployment isolation metadata, not a database-schema search surface - lifecycle services must mark rows stale/deleted when the source object changes

Properties

NameTypeDescriptionNotes
targetTypeStringSource model or table name for the polymorphic target reference.
targetIdUUIDSource object UUID for the polymorphic target reference.
principalPrincipal[optional]
organizationOrganization[optional]
memoryEntryMemoryEntry[optional]
tenantScopeStringOptional tenant/deployment isolation key, such as a generated customer schema name, for generated-app isolation and reindex partitioning; this is not a database-schema search surface for agents.[optional]
sourceHashStringSHA-256 hash of normalized source text used to skip unchanged reindexing.
summaryTextStringCompressed summary used for low-token context assembly.[optional]
keywordsTextStringNormalized lexical keywords for hybrid symbolic/semantic retrieval.[optional]
compressionStrategyCompressionStrategyEnumContext compression strategy applied before indexing and retrieval assembly.
embeddingProviderStringEmbedding provider that generated the vector.
embeddingModelStringEmbedding model identifier.
embeddingDimensionsIntegerNumber of dimensions in embeddingVector.
embeddingVectorbyte[]Serialized float32 little-endian vector bytes, base64 encoded on the wire.
embeddingChecksumStringSHA-256 checksum of embeddingVector bytes.
vectorEncodingVectorEncodingEnumEncoding used for embeddingVector.
statusStatusEnumLifecycle status for the semantic index row.
contentCharsIntegerCharacter count of the normalized source content.[optional]
estimatedTokensIntegerEstimated source token count before compression.[optional]
relevanceScoreDoubleCached ranking signal for retrieval.[optional]
hitCountLongNumber of successful retrieval hits for this index row.[optional]
lastHitAtOffsetDateTimeLast time this row was used in context assembly.[optional]
indexedAtOffsetDateTimeTime the vector and summary were generated.
semanticDeletedAtOffsetDateTimeTime the row was marked deleted after source lifecycle cleanup.[optional]
idUUIDUnique identifier for object in the system[optional] [readonly]
ownerIdUUIDUUID of owner of the object in the system[optional] [readonly]
createdDateOffsetDateTimeDate of object creation[optional] [readonly]
keyHashStringData, including hash of the key(s) used to encrypt this record.[optional] [readonly]
lastAccessedByIdUUIDLast user to access object[optional] [readonly]
lastAccessedDateOffsetDateTimeTimestamp of last access of object[optional] [readonly]
lastModifiedByIdUUIDUnique identifier for user who last modifed the object in the system[optional] [readonly]
lastModifiedDateOffsetDateTimeDate of last object modification[optional] [readonly]
trashedBooleanIndicates if the object is trashed (soft deleted)[optional]

Enum: CompressionStrategyEnum

NameValue
NONE"none"
SUMMARY_V1"summary_v1"
HIERARCHICAL_SUMMARY_V1"hierarchical_summary_v1"

Enum: VectorEncodingEnum

NameValue
FLOAT32_LE"float32_le"
UINT8_QUANTIZED"uint8_quantized"
SUMMARY_ONLY"summary_only"

Enum: StatusEnum

NameValue
ACTIVE"active"
STALE"stale"
DELETED"deleted"

Implemented Interfaces

  • Serializable

Generated Version Details

~value
GENERATOR VERSIONcom.valkyrlabs:ValkyrAI API 1.0.3-SNAPSHOT
API ARTIFACTcom.valkyrlabs.valkyrai-api.jar
GENERATOR VERSIONorg.openapitools.openapi-generator:7.5.0
GENERATOR CLASSorg.openapitools.codegen.languages.SpringCodegen
GENERATED DATE2026-05-16T11:45:23.900207-07:00[America/Los_Angeles]