ModelObject

Source:

src/ometeotl_core/model/base.py

Local role: Universal schema root for core model entities.

Big-picture role: Canonical serialization backbone used by GenericObject, Action, and all domain subclasses.

Inheritance:

dataclass root

Parameters and fields:

id: ObjectId
object_type: str
schema_version: SchemaVersion
attributes: JsonMap
relations: RelationMap
state: JsonMap
context: JsonMap
provenance: JsonMap

Methods:

mutation helpers: set_mutation_guard, add_relation, remove_relation, _manage_relation
map/list helpers: set_attribute, set_state, set_provenance, add_to_attribute_list, remove_from_attribute_list
serialization: to_dict, from_dict, _base_kwargs

Example:

from ometeotl_core.model.base import ModelObject

obj = ModelObject(id="obj-1", object_type="generic")
obj.set_attribute("label", "Demo Object")
obj.add_relation("owns", "resource-1")
obj.set_state("active", True)
obj.set_provenance("created_by", "system")

data = obj.to_dict()
obj2 = ModelObject.from_dict(data)
assert obj2.id == obj.id

Ometeotl