Module payload_strategy 

Deterministic, bounded contracts for planner-selected payload strategies.

Runtime scope

• Build: always/default.
• Execution: Surface B (planner-selected payload strategy contracts).
• Default termivar scan: yes, through StandardWebDecisionRuntime.
• Support: implemented and tested.

See docs/internals/runtime-map.md.

A planner may select a stable PayloadStrategyRef, but it never sees raw payload bytes or a transport client. A capability executor resolves that reference, derives exactly one control or candidate artifact for the current execution turn, and remains responsible for dispatching it through a host-owned accounting broker.

Structs

PayloadArtifact

One bounded raw artifact derived for one control or candidate turn.

PayloadArtifactReceipt

Raw-value-free provenance for a derived artifact.

PayloadSeed

Raw seed owned by a capability executor and hidden from serialization.

PayloadStrategyLimits

Per-turn byte envelope applied before and after strategy derivation.

PayloadStrategyRef

Stable, versioned identity selected by a planner action.

PayloadStrategyRegistry

Native strategy implementations keyed by planner-selected references.

Enums

PayloadStrategyError

Validation and resolution failures for deterministic payload strategies.

PayloadVariantRole

Role of the single artifact derived for an execution turn.

Constants

DEFAULT_MAX_PAYLOAD_ARTIFACT_BYTES

Default seed and artifact limit for one execution turn.

HARD_MAX_PAYLOAD_ARTIFACT_BYTES

Maximum seed or derived artifact size accepted by this contract.

HARD_MAX_PAYLOAD_STRATEGY_ID_BYTES

Maximum accepted strategy identifier length.

Traits

PayloadStrategy

Pure strategy contract implemented by native capability executors.