cayu.sessions.SessionQuery

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

from cayu.sessions import SessionQuery

Bases: BaseModel.

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
`q`	`str \| None`	`None`
`status`	`SessionStatus \| None`	`None`
`debug_state`	`SessionDebugState \| None`	`None`
`agent_name`	`str \| None`	`None`
`provider_name`	`str \| None`	`None`
`model`	`str \| None`	`None`
`environment_name`	`str \| None`	`None`
`parent_session_id`	`str \| None`	`None`
`causal_budget_id`	`str \| None`	`None`
`last_activity_before`	`datetime \| None`	`None`
`inactive_for_seconds`	`StrictInt \| None`	`Field(default=None, ge=0, le=MAX_DURABLE_JSON_INTEGER)`
`labels`	`dict[str, str]`	`Field(default_factory=dict)`
`label_selectors`	`tuple[LabelSelectorRequirement, ...]`	`Field(default_factory=tuple)`
`limit`	`StrictInt`	`Field(default=100, ge=1, le=1000)`
`offset`	`StrictInt`	`Field(default=0, ge=0, le=MAX_DURABLE_JSON_INTEGER)`
`cursor`	`str \| None`	`None`
`include_total_count`	`StrictBool`	`False`
`order_by`	`SessionOrder`	`SessionOrder.UPDATED_AT_DESC`

validate_cursor (method)

SessionQuery.validate_cursor(value: str | None) -> str | None

reject_cursor_with_offset (method)

SessionQuery.reject_cursor_with_offset() -> SessionQuery

validate_optional_nonblank_fields (method)

SessionQuery.validate_optional_nonblank_fields(value: str | None, info) -> str | None

validate_last_activity_before (method)

SessionQuery.validate_last_activity_before(value: datetime | None) -> datetime | None

copy_query_labels (method)

SessionQuery.copy_query_labels(value) -> dict[str, str]

copy_query_label_selectors (method)

SessionQuery.copy_query_label_selectors(value) -> tuple[LabelSelectorRequirement, ...]

Release source · Runtime guarantees · Capability guides