Skip to main content

Module completion

Module completion 

Source
Expand description

Input completion waiters — allows callers to await the execution outcome of an accepted input.

When a surface accepts an input via the runtime, it can optionally receive a CompletionHandle. It normally resolves when the input reaches a terminal state (Consumed or Abandoned). If an execution attempt fails durably and the machine requeues the input, the process-local handle resolves that generated attempt failure without terminalizing the durable input. This bridges the async accept/await pattern needed for surfaces that want synchronous-feeling turn execution through the runtime.

CompletionRegistry is waiter plumbing only. Production code must never treat waiter presence, waiter counts, or sender membership as semantic runtime truth.

Structs§

CompletionCleanupObservation
Runtime-minted observation for post-completion cleanup.
CompletionHandle
Handle for awaiting the completion of an accepted input.
CompletionRegistrySnapshot
Diagnostic snapshot of the completion waiter registry.
CompletionWaiterEntrySnapshot
Snapshot of one input’s registered completion waiters.

Enums§

CompletionOutcome
Outcome delivered to a completion waiter.
CompletionWaitError
Mechanical failure while waiting for completion plumbing.

Functions§

interaction_terminal_event
Project one generated-authority completion onto the canonical interaction-scoped terminal event. Both the comms live stream and durable placed-turn observation use this single mapping so result/failure semantics cannot drift between surfaces.