Class DuplicateReasoningAgentProvider

Builds the Nunjucks/template data context for the shared "Duplicate Resolution" instruction set. Both providers feed the prompt the exact same shape, so this lives on the base class. Keys match the seeded template's variable names verbatim.

Coerces a JSON string or object into a plain record, else null.

Derive the set-level verdict from the per-candidate verdicts: Merge if any candidate is a Merge, else Uncertain if any is Uncertain, else NotDuplicate. Overall confidence is the max confidence among the candidates matching the winning recommendation (null if none reported).

Render a field value for the prompt: the trimmed value, or '(empty)' for null/blank.

Builds a failed reasoning output (logged, never thrown).

Normalize the per-candidate verdicts array, dropping malformed entries. Each must carry a non-empty record id; recommendation/confidence are clamped, reasoning defaults to ''.

Clamps confidence into [0,1], returning null when absent/invalid. null (not 0) so a missing confidence isn't mistaken for "confidently NOT a duplicate" downstream.

Normalizes the fieldChoices array, dropping malformed entries.

Clamps the recommendation to the allowed union, defaulting to 'Uncertain'.

Returns the survivor id string, or null when absent/empty.

Parses a provider's raw structured output (the {recommendation, confidence, ...} object) into a normalized DuplicateReasoningOutput. Tolerant of either an already-parsed object or a JSON string. Returns a failed output on any parse error.