vibespatial.runtime.residency¶

Classes¶

`Residency`	Enum where members are also (and must be) strings
`TransferTrigger`	Enum where members are also (and must be) strings
`ResidencyPlan`

Functions¶

`normalize_residency`(→ Residency)
`combined_residency`(→ Residency)	Return DEVICE when any provided value is device-resident, else HOST.
`select_residency_plan`(→ ResidencyPlan)

Module Contents¶

class vibespatial.runtime.residency.Residency¶

Enum where members are also (and must be) strings

HOST = 'host'¶

DEVICE = 'device'¶

class vibespatial.runtime.residency.TransferTrigger¶

Enum where members are also (and must be) strings

USER_MATERIALIZATION = 'user-materialization'¶

EXPLICIT_RUNTIME_REQUEST = 'explicit-runtime-request'¶

UNSUPPORTED_GPU_PATH = 'unsupported-gpu-path'¶

INTEROP_VIEW = 'interop-view'¶

vibespatial.runtime.residency.normalize_residency(value: Residency | str) → Residency¶

vibespatial.runtime.residency.combined_residency(*values: object) → Residency¶

Return DEVICE when any provided value is device-resident, else HOST.

Accepts explicit Residency values, strings, or arbitrary objects with a residency attribute. This lets dispatch wrappers preserve device stickiness without special-casing every owned-array type.

class vibespatial.runtime.residency.ResidencyPlan¶

current: Residency¶

target: Residency¶

trigger: TransferTrigger¶

transfer_required: bool¶

visible_to_user: bool¶

zero_copy_eligible: bool¶

reason: str¶

vibespatial.runtime.residency.select_residency_plan(*, current: Residency | str, target: Residency | str, trigger: TransferTrigger | str) → ResidencyPlan¶