Module speculative_selection 

Family-blind speculative requirements, selection, and construction gating. Family-blind selection and construction gates for speculative execution.

Structs

ConstructedSpeculativeResources

Resources constructed only after a speculative realization is fully selected.

PreparedSpeculativeRealization

A selected realization paired with backend-native mechanism resources.

SelectedSpeculativeCompletion

Selected exact-completion policy.

SelectedSpeculativePlacement

Placement proven against generic backend mechanisms.

SelectedSpeculativeRealization

One authoritative speculative realization selected before native work.

SelectedSpeculativeSampling

Selected generic sampling mechanisms.

SelectedSpeculativeState

State/cache identity paired with selected target/draft placement.

SpeculativeArchitectureCompatibilityProof

Architecture compatibility proof produced before backend construction.

SpeculativeCaptureEntry

One architecture-selected tensor in an ordered target capture.

SpeculativeCaptureEnvelope

Architecture-selected tensors paired with exact capture metadata.

SpeculativeCaptureMetadata

Capture metadata proven by the already selected ordinary target.

SpeculativeCaptureSchema

Exact ordered target-capture contract declared by an architecture.

SpeculativeContractError

Invalid neutral speculative contract.

SpeculativeIdentity

Stable neutral identity used by speculative selection and cache keys.

SpeculativeLaneIdentity

Request-local cache identity completed after input preparation.

SpeculativeMechanismCapabilities

Generic speculative mechanisms implemented by a backend.

SpeculativeMechanismRequirements

Exact generic mechanisms required by one strategy.

SpeculativeRealizationRequirements

Complete neutral requirements for one speculative realization.

SpeculativeSelectionError

Fail-closed speculative selection diagnostic.

SpeculativeSelectionRequest

Preconstruction proofs and placement requested for one realization.

SpeculativeStateCacheIdentityIngredients

Stable semantic inputs to target, prediction, assistant, and cache identity.

SpeculativeStrategyRequirements

Exact architecture-owned strategy requirements.

Enums

SpeculativeCaptureError

Invalid target-capture envelope.

SpeculativeMechanism

Generic backend mechanism needed by speculative composition.

SpeculativePlacementRequest

Facade-requested target/draft placement, resolved before queue construction.

SpeculativePreparationError

Failure after or during the preconstruction selection gate.

SpeculativeStrategyClass

Family-neutral prediction strategy class.

Functions

select_and_prepare_speculative_realization

Selects once, then invokes family-blind construction callbacks in dependency order.

select_and_prepare_speculative_realization_observed

Selects once, then observes and constructs every native resource in dependency order.

select_speculative_realization

Selects the complete speculative realization without invoking native construction.