Skip to content

cayu.external_wait_scheduler

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.

from cayu import TaskStoreWaitScheduler

An explicitly driven adapter, not a worker or a second outcome clock.

A hint can be delivered early or late. The wait store alone elects timeout; the host’s bounded discovery remains the fallback if clocks differ or a notification is lost. Neither task input nor its lease grants execution.

TaskStoreWaitScheduler.__init__(*, waits: ExternalEventWaits, task_store: TaskStore, scheduler_id: str)
async TaskStoreWaitScheduler.schedule(registration: ExternalWaitRegistration, *, context: ExternalWaitContext) -> ExternalWaitTimer | None
async TaskStoreWaitScheduler.reconcile(*, scope: ExternalWaitScope, source: str, context: ExternalWaitContext, after: str='', limit: int=32) -> tuple[ExternalWaitTimer, ...]

Reconstruct pending scheduling intent with bounded, caller-driven discovery.

async TaskStoreWaitScheduler.notify(timer: ExternalWaitTimer, *, context: ExternalWaitContext) -> ExternalWaitSnapshot | None

Observe the owner clock; return None only for an authenticated obsolete hint.

TaskStoreWaitScheduler.worker_handler(*, context: ExternalWaitContext)

Compose with run_task_worker; construction never starts a worker.

Release source · Runtime guarantees · Capability guides