Feedback API

Layer 4: Extend Framework

The Feedback API exposes candidate proposals, observations, and Feedback policies. Proposal and observation contract types belong to the public vocabulary of saealib.core.contracts, while builders and policies are available from saealib.policies.

Contracts on the graph-native path

ProposalBatch, ObservationBatch, FeedbackBatch, and FeedbackContract are contracts on the graph-native path. They handle subject, proposal relation, sequence, status, source, completion semantics, and the consumer’s ordering and completion declarations.

saealib.core.contracts.ProposalBatch	A candidate population plus its relations and feedback requirement.
saealib.core.contracts.ObservationBatch	A fixed-schema batch whose candidate IDs are derived from subjects.
saealib.core.contracts.FeedbackBatch	Observations delivered for one proposal.
saealib.core.contracts.FeedbackContract	Declare the feedback deliveries a component can consume.

Policies and builders

saealib.FeedbackBuilder	Build algorithm feedback from true and predicted values.
saealib.TrueOnlyFeedback	Return completed true objective rows.
saealib.PredictedFeedback	Return the objective prediction channel.
saealib.MixedFeedback	Prefer true rows and fill the remainder from objective predictions.
saealib.NoFeedback	Return an empty feedback batch.

Stage compatibility type

FeedbackResult is the dense compatibility data type used on the Stage compatibility path. Array row consistency and candidate-ID uniqueness belong to this type’s boundary.

saealib.FeedbackResult

Validated values supplied to an algorithm tell operation.