Skip to content

cayu.sessions.SessionTopologyQuery

Part of cayu.sessions.base. Read the Python API overview and install the required extra.

from cayu.sessions import SessionTopologyQuery

One bounded ancestry plus batched child-branch read.

Bases: BaseModel.

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
focus_session_id str required
expanded_parent_ids tuple[str, ...] Field(default_factory=tuple, max_length=SESSION_TOPOLOGY_MAX_EXPANDED_PARENTS)
child_cursors dict[str, str] Field(default_factory=dict, max_length=SESSION_TOPOLOGY_MAX_EXPANDED_PARENTS)
ancestor_depth_limit StrictInt Field(default=SESSION_TOPOLOGY_MAX_ANCESTOR_DEPTH, ge=1, le=SESSION_TOPOLOGY_MAX_ANCESTOR_DEPTH)
child_limit StrictInt Field(default=SESSION_TOPOLOGY_DEFAULT_CHILD_LIMIT, ge=1, le=SESSION_TOPOLOGY_MAX_CHILD_LIMIT)
SessionTopologyQuery.validate_focus_session_id(value: str) -> str
SessionTopologyQuery.copy_expanded_parent_ids(value) -> tuple[str, ...]
SessionTopologyQuery.copy_child_cursors(value) -> dict[str, str]
SessionTopologyQuery.validate_cursor_parents() -> SessionTopologyQuery

Release source · Runtime guarantees · Capability guides