Skip to content

cayu.session_external_waits

Public Cayu API. Definitions are grouped by their public source module, and definitions from private implementation modules appear on their package’s page; adding a symbol does not move existing links. The import shown at each entry is a supported public namespace. Read the Python API overview and install the required extra.

SessionExternalWaitAdapter

Section titled “SessionExternalWaitAdapter”
from cayu import SessionExternalWaitAdapter

init (method)

Section titled “init (method)”
SessionExternalWaitAdapter.__init__(app: CayuApp, waits: ExternalEventWaits, *, request_loop_policies: Iterable[LoopPolicy]=()) -> None

recover_to_wait (method)

Section titled “recover_to_wait (method)”
async SessionExternalWaitAdapter.recover_to_wait(registration: ExternalWaitRegistration, *, context: ExternalWaitContext, inactive_for_seconds: int=60) -> SessionExternalWaitReceipt

Recover an admitted unfinished turn through the native recovery owner.

reconcile_binding (method)

Section titled “reconcile_binding (method)”
async SessionExternalWaitAdapter.reconcile_binding(registration: ExternalWaitRegistration, *, context: ExternalWaitContext) -> ExternalWaitSnapshot

Repair a committed ticket’s missing binding without executing the session.

exclude_prepared_execution (method)

Section titled “exclude_prepared_execution (method)”
async SessionExternalWaitAdapter.exclude_prepared_execution(registration: ExternalWaitRegistration, *, context: ExternalWaitContext) -> ExternalWaitSnapshot

Explicitly exclude unbound execution without replacing its elected outcome.

Native admission must still be excluded or its writer positively released. This does not cancel a provider, tool, external job, or bound continuation.

retire_execution (method)

Section titled “retire_execution (method)”
async SessionExternalWaitAdapter.retire_execution(registration: ExternalWaitRegistration, *, operation_key: str, context: ExternalWaitContext) -> ExternalWaitSnapshot

Request exact released-writer retirement without changing the elected outcome.

The request is durable, not a claim that execution has stopped. Native retirement must still arbitrate against consumption and prove release.

run_to_wait (method)

Section titled “run_to_wait (method)”
async SessionExternalWaitAdapter.run_to_wait(request: RunRequest, registration: ExternalWaitRegistration, *, context: ExternalWaitContext) -> SessionExternalWaitReceipt

resume_to_wait (method)

Section titled “resume_to_wait (method)”
async SessionExternalWaitAdapter.resume_to_wait(request: ResumeRequest, registration: ExternalWaitRegistration, *, context: ExternalWaitContext) -> SessionExternalWaitReceipt

Run one ordinary resumed turn and park its exact completed boundary.

service_wait (method)

Section titled “service_wait (method)”
async SessionExternalWaitAdapter.service_wait(registration: ExternalWaitRegistration, *, context: ExternalWaitContext) -> SessionExternalWaitReceipt

Continue one elected wait through native fenced resume, or replay its receipt.

Release source · Runtime guarantees · Capability guides

SessionExternalWaitReceipt

Section titled “SessionExternalWaitReceipt”
from cayu import SessionExternalWaitReceipt

Bases: _Value.

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 Identifier required
wait ExternalWaitSnapshot required

clean_strings (method)

Section titled “clean_strings (method)”
SessionExternalWaitReceipt.clean_strings(value: object) -> object

Release source · Runtime guarantees · Capability guides