Ivorleaf Developers

Evidence and Sources

Technical Session responses can expose validated evidence through sources and lessons_used. Current source records use the LessonUsed schema, which includes source identity and citation-oriented metadata when available.

Where sources appear

  • TutorResponse.sources
  • TutorResponse.lessons_used
  • technical_analysis.analyses[].sources
  • retrieved session sources, citation_sources, and validated_evidence
  • workflow packets and artifact content

The retrieved-session route intentionally derives all four evidence lists from validated_evidence_for_session. Legacy sessions without validated evidence receive a citation_warnings entry rather than having unknown sources displayed as trusted evidence.

Display guidance

Display source titles and links only when present. Preserve citation_warnings. Do not describe an empty sources array as validation success, and do not infer official status from a domain name when a structured flag exists.

const sources = response.sources ?? [];
const warnings = response.citation_warnings ?? [];

renderSources(sources);
if (warnings.length) renderValidationWarnings(warnings);

See Display Sources for a defensive rendering pattern.