Skip to main content

Memory Data Model

The unit of memory is the Memory dataclass (src/aml/backends/interface.py). Capability-gated fields are honored only when the corresponding capability is declared.

FieldTypeGated on
contentstralways
valid_fromdatetime | NoneBI_TEMPORAL
valid_untildatetime | NoneBI_TEMPORAL
tenant_idstr | NoneMULTI_TENANT
superseded_byref | NoneSUPERSESSION_CHAIN
sourceSourceMeta | NonePROVENANCE / CRYPTOGRAPHIC_PROVENANCE

SourceMeta: write_id, written_at, written_by (populated under PROVENANCE); signature, public_key (populated under CRYPTOGRAPHIC_PROVENANCE).

WriteOptions: valid_from, tenant_id, signing_key. RetrieveOptions: as_of (honored if BI_TEMPORAL; default = now), tenant_id (honored if MULTI_TENANT), budget (in tokens).

Source: src/aml/backends/interface.py