Interface: ClaimAnnotationDto
@kortexya/reasoninglayer / ClaimAnnotationDto
Interface: ClaimAnnotationDto
Section titled “Interface: ClaimAnnotationDto”Defined in: src/types/conversation.ts:444
A claim annotation with provenance information.
Properties
Section titled “Properties”citationChecks?
Section titled “citationChecks?”
optionalcitationChecks?:CitationCheckDto[]
Defined in: src/types/conversation.ts:482
One record per [ref:…] citation in this claim.
claimType
Section titled “claimType”claimType:
string
Defined in: src/types/conversation.ts:465
Claim classification: kb_grounded, schema_grounded, derived,
llm_framing, proven, contradicted, citation_unverified.
schema_grounded is backed by the tenant’s sort catalog rather than by
records — see ClaimAnnotationDto.schemaExcerpts.
contradicted and citation_unverified are deliberately separate.
contradicted means the tenant’s data proves the claim wrong; a client may
show it as a refutation and count it against the answer.
citation_unverified means one [ref:…] citation could not be checked —
most often two fields merged into one marker — and nothing in the data
disagrees with the sentence. Treating the second as the first is what put a
red badge over a correct answer (backend issue #205); see
ClaimAnnotationDto.citationChecks for which marker and why.
confidence
Section titled “confidence”confidence:
number
Defined in: src/types/conversation.ts:467
Confidence score (0.0-1.0).
derivationSummary?
Section titled “derivationSummary?”
optionalderivationSummary?:DerivationSummaryDto|null
Defined in: src/types/conversation.ts:480
Derivation chain summary.
osfqlQuery?
Section titled “osfqlQuery?”
optionalosfqlQuery?:string|null
Defined in: src/types/conversation.ts:478
OSFQL query that produced the grounding data.
schemaExcerpts?
Section titled “schemaExcerpts?”
optionalschemaExcerpts?:SchemaExcerptDto[]
Defined in: src/types/conversation.ts:476
Sorts from the tenant’s catalog that this claim names — the evidence for a
schema_grounded claim, and additional context on any other.
sourceExcerpts?
Section titled “sourceExcerpts?”
optionalsourceExcerpts?:SourceExcerptDto[]
Defined in: src/types/conversation.ts:471
Source data excerpts from the KB.
sourceTermIds?
Section titled “sourceTermIds?”
optionalsourceTermIds?:string[]
Defined in: src/types/conversation.ts:469
Term IDs that ground this claim.
span:
unknown[]
Defined in: src/types/conversation.ts:448
Character offsets (start, end) in the assistant_message.
text:
string
Defined in: src/types/conversation.ts:446
The sentence/phrase text.