KnobChoice

KnobChoice()

The resolved value of one knob for one operator.

resolved_by agrees with requested: explicit means a value was asked for and used as given (value equals requested); auto_table and auto_heuristic mean requested is auto.

model_config = ConfigDict(json_schema_extra=_closed(_provenance_is_consistent))

value: str = Field(..., description='The value used')

requested: str = Field(..., description='The value asked for, possibly auto')

resolved_by: Annotated[str, _Members('explicit', 'auto_table', 'auto_heuristic', 'plan')] = Field(..., description='explicit when a value was asked for; auto_table when auto chose it from the goal; auto_heuristic and plan are reserved')

source: KnobSource

approximate: bool = Field(..., description="Whether the value changes numerics relative to the knob's default where it applies")