cayu.sessions.CompactSessionRequest

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

from cayu.sessions import CompactSessionRequest

Request an explicit, application-owned compaction of durable session context.

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	required
idempotency_key	str	Field(max_length=256)
expected_run_epoch	StrictInt	Field(ge=0, le=MAX_DURABLE_JSON_INTEGER)
expected_transcript_cursor	StrictInt	Field(ge=0, le=MAX_DURABLE_JSON_INTEGER)
reason	Literal['application_requested']	'application_requested'
instructions	str | None	Field(default=None, max_length=COMPACTION_INSTRUCTIONS_MAX_CHARS)
limits	RunLimits	Field(default_factory=RunLimits)
budget_limits	tuple[BudgetLimit, ...]	Field(default_factory=tuple)
requested_by	ResolutionActor | None	None

validate_required_strings (method)

CompactSessionRequest.validate_required_strings(value: str, info) -> str

validate_optional_instructions (method)

CompactSessionRequest.validate_optional_instructions(value: str | None) -> str | None

copy_limits (method)

CompactSessionRequest.copy_limits(value: RunLimits) -> RunLimits

copy_budget_limits (method)

CompactSessionRequest.copy_budget_limits(value) -> tuple[BudgetLimit, ...]

copy_requested_by (method)

CompactSessionRequest.copy_requested_by(value: ResolutionActor | None) -> ResolutionActor | None

validate_durable_text (method)

CompactSessionRequest.validate_durable_text() -> CompactSessionRequest

Release source · Runtime guarantees · Capability guides