cayu.snapshots.AgentSnapshotLogicalRef
Part of cayu.snapshots.base. Read the Python API overview and install the required extra.
from cayu.snapshots import AgentSnapshotLogicalRefExact logical identity with an optional bounded local drill-down alias.
Bases: _SnapshotModel.
Fields and attributes
Section titled “Fields and attributes”Defaults below are source expressions; Field(...) includes schema/validation settings and default_factory creates a fresh value. Inherited declarations are included. Constructor behavior follows the model or dataclass shown in the bases/decorators.
| Name | Type | Default |
|---|---|---|
fingerprint |
StrictStr |
required |
revision |
StrictStr | None |
Field(default=None, max_length=512) |
frontier |
StrictStr | None |
Field(default=None, max_length=512) |
scope_fingerprint |
StrictStr | None |
None |
source_ref |
StrictStr | None |
Field(default=None, max_length=512) |
validate_fingerprint (method)
Section titled “validate_fingerprint (method)”AgentSnapshotLogicalRef.validate_fingerprint(value: str, info) -> strvalidate_scope_fingerprint (method)
Section titled “validate_scope_fingerprint (method)”AgentSnapshotLogicalRef.validate_scope_fingerprint(value: str | None, info) -> str | Nonevalidate_optional_identity (method)
Section titled “validate_optional_identity (method)”AgentSnapshotLogicalRef.validate_optional_identity(value: str | None, info) -> str | Nonevalidate_safe_source_ref (method)
Section titled “validate_safe_source_ref (method)”AgentSnapshotLogicalRef.validate_safe_source_ref(value: str | None) -> str | Nonevalidate_exact_identity (method)
Section titled “validate_exact_identity (method)”AgentSnapshotLogicalRef.validate_exact_identity() -> AgentSnapshotLogicalRefidentity_material (method)
Section titled “identity_material (method)”AgentSnapshotLogicalRef.identity_material() -> dict[str, object]Return relocation-stable fingerprint input.
source_ref is intentionally excluded: a physical/package alias may
change while the same logical content and frontiers remain equivalent.