Skip to content

cayu.sessions.PendingActionQuery

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

from cayu.sessions import PendingActionQuery

Bounded query for durable control-plane actions blocking a session.

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
session_id str | None None
statuses frozenset[SessionStatus] frozenset({SessionStatus.INTERRUPTED, SessionStatus.FAILED, SessionStatus.COMPLETED})
kind PendingActionKind | None None
agent_name str | None None
environment_name str | None None
q str | None None
cursor str | None None
limit StrictInt Field(default=50, ge=1, le=200)
max_result_bytes StrictInt Field(default=DEFAULT_PENDING_ACTION_RESULT_MAX_BYTES, ge=1024, le=MAX_PENDING_ACTION_RESULT_BYTES)
PendingActionQuery.validate_statuses(value: object) -> frozenset[SessionStatus]
PendingActionQuery.validate_optional_strings(value: str | None, info) -> str | None

Release source · Runtime guarantees · Capability guides