cayu.sessions.EventQuery

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

from cayu.sessions import EventQuery

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
`session_id`	`str \| None`	`None`
`session_ids`	`tuple[str, ...]`	`Field(default_factory=tuple)`
`event_id`	`str \| None`	`None`
`interaction_id`	`str \| None`	`None`
`causal_budget_id`	`str \| None`	`None`
`budget_limit_id`	`str \| None`	`None`
`model_step_id`	`str \| None`	`None`
`parent_model_step_id`	`str \| None`	`None`
`operation_attempt_id`	`str \| None`	`None`
`event_type`	`EventType \| str \| None`	`None`
`event_types`	`tuple[EventType \| str, ...]`	`Field(default_factory=tuple)`
`exclude_event_types`	`tuple[EventType \| str, ...]`	`Field(default_factory=tuple)`
`agent_name`	`str \| None`	`None`
`environment_name`	`str \| None`	`None`
`workflow_name`	`str \| None`	`None`
`workflow_attempt_id`	`str \| None`	`None`
`workflow_step_id`	`str \| None`	`None`
`workflow_attempt_fenced`	`StrictBool`	`False`
`tool_name`	`str \| None`	`None`
`since`	`datetime \| None`	`None`
`until`	`datetime \| None`	`None`
`after_sequence`	`StrictInt \| None`	`Field(default=None, ge=0, le=MAX_DURABLE_JSON_INTEGER)`
`before_sequence`	`StrictInt \| None`	`Field(default=None, ge=1, le=MAX_DURABLE_JSON_INTEGER)`
`limit`	`StrictInt`	`Field(default=100, ge=1, le=5000)`
`order_by`	`EventOrder`	`EventOrder.SEQUENCE_ASC`

validate_optional_nonblank_fields (method)

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

copy_session_ids (method)

EventQuery.copy_session_ids(value) -> tuple[str, ...]

validate_event_type (method)

EventQuery.validate_event_type(value: EventType | str | None) -> EventType | str | None

copy_event_types (method)

EventQuery.copy_event_types(value, info) -> tuple[EventType | str, ...]

validate_query_timestamp (method)

EventQuery.validate_query_timestamp(value: datetime | None, info) -> datetime | None

validate_time_range (method)

EventQuery.validate_time_range() -> EventQuery

Release source · Runtime guarantees · Capability guides