cayu.external_wait_host

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.

ExternalWaitHost

from cayu import ExternalWaitHost

Discover durable responsibility; native receiving admission arbitrates workers.

The caller owns scheduling and shutdown. A page does not claim work: a process that dies leaves the same native handoff available to another configured host. Permission failures propagate. Row conflicts remain explicit failures in the returned page while independent rows continue; they are never exclusion evidence.

init (method)

ExternalWaitHost.__init__(adapter: SessionExternalWaitAdapter, *, context: ExternalWaitContext)

service_once (method)

async ExternalWaitHost.service_once(*, scope: ExternalWaitScope, source: str, after: str='', limit: int=EXTERNAL_WAIT_PAGE_SIZE) -> ExternalWaitHostPage

run (method)

async ExternalWaitHost.run(*, scope: ExternalWaitScope, source: str, stop: asyncio.Event, interval_s: float=1.0) -> None

Explicit polling loop. Cancellation propagates; it never cancels the external job.

Release source · Runtime guarantees · Capability guides

ExternalWaitHostFailure

from cayu import ExternalWaitHostFailure

Safe per-row diagnostics; no private exception text or receiving authority.

Bases: _Value.

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
correlation_key	Identifier	required
kind	Literal['conflict', 'fenced', 'capacity', 'orphaned']	required

clean_strings (method)

ExternalWaitHostFailure.clean_strings(value: object) -> object

Release source · Runtime guarantees · Capability guides

ExternalWaitHostPage

from cayu import ExternalWaitHostPage

Bases: _Value.

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
inspected	StrictInt	required
settled	tuple[Identifier, ...]	required
pending	tuple[Identifier, ...]	required
next_cursor	Identifier | None	required
failures	tuple[ExternalWaitHostFailure, ...]	()

clean_strings (method)

ExternalWaitHostPage.clean_strings(value: object) -> object

Release source · Runtime guarantees · Capability guides