cayu.sessions.TranscriptQuery
Part of cayu.sessions.base. Read the Python API overview and install the required extra.
from cayu.sessions import TranscriptQueryPaginate retained matching rows in ascending absolute-index order.
offset skips retained matches, not absolute indexes. Separate calls are
live reads: concurrent retention can shift offsets. Use absolute windows
when continuing by message identity instead of retained-row position.
Bases: BaseModel.
Fields and attributes
Section titled “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 |
required |
interaction_id |
str | None |
None |
role |
MessageRole | str | None |
None |
offset |
StrictInt |
Field(default=0, ge=0, le=MAX_DURABLE_JSON_INTEGER) |
limit |
StrictInt |
Field(default=100, ge=1, le=5000) |
include_thinking |
StrictBool |
True |
validate_session_id (method)
Section titled “validate_session_id (method)”TranscriptQuery.validate_session_id(value: str) -> strvalidate_interaction_id (method)
Section titled “validate_interaction_id (method)”TranscriptQuery.validate_interaction_id(value: str | None) -> str | Nonevalidate_role (method)
Section titled “validate_role (method)”TranscriptQuery.validate_role(value: MessageRole | str | None) -> MessageRole | None