Skip to content
KortexyaKortexyaReasoning Layer SDK

Interface: TurnDto

@kortexya/reasoninglayer

@kortexya/reasoninglayer / TurnDto

Interface: TurnDto

Section titled “Interface: TurnDto”

Defined in: src/types/conversation.ts:880

A single conversation turn (message).

Properties

Section titled “Properties”

claimAnnotations?

Section titled “claimAnnotations?”

optional claimAnnotations?: ClaimAnnotationDto[] | null

Defined in: src/types/conversation.ts:900

Per-claim provenance annotations (assistant turns only).

content

Section titled “content”

content: string

Defined in: src/types/conversation.ts:888

Message content.

feedback?

Section titled “feedback?”

optional feedback?: TurnFeedback

Defined in: src/types/conversation.ts:916

The user’s rating of this answer, when one was submitted with submitAnswerFeedback (assistant turns only).

id

Section titled “id”

id: string

Defined in: src/types/conversation.ts:882

Turn ID.

intent?

Section titled “intent?”

optional intent?: string | null

Defined in: src/types/conversation.ts:894

Classified intent (assistant turns only).

osfql?

Section titled “osfql?”

optional osfql?: string | null

Defined in: src/types/conversation.ts:897

OSFQL generated (assistant turns only).

payload?

Section titled “payload?”

optional payload?: unknown

Defined in: src/types/conversation.ts:910

Opaque structured card state recorded with the turn by an external surface (see RecordTurnRequest.payload). Returned verbatim.

proofTrace?

Section titled “proofTrace?”

optional proofTrace?: ProofTraceNodeDto | null

Defined in: src/types/conversation.ts:922

Proof tree of the answer (assistant turns only): the same value the live answer carried in ConversationMessageResponse.proofTrace.

queryResults?

Section titled “queryResults?”

optional queryResults?: Record<string, OsfqlValue>[] | null

Defined in: src/types/conversation.ts:904

MATCH result rows (assistant turns only), persisted by the backend so a “show me a table of X” answer keeps its table across a reload.

reasoningTrace?

Section titled “reasoningTrace?”

optional reasoningTrace?: ReasoningTraceDto | null

Defined in: src/types/conversation.ts:928

Reasoning trace of the answer (assistant turns only): the same value the live answer carried in ConversationMessageResponse.reasoningTrace.

role

Section titled “role”

role: string

Defined in: src/types/conversation.ts:885

“user” or “assistant”.

timestamp

Section titled “timestamp”

timestamp: string

Defined in: src/types/conversation.ts:891

ISO 8601 timestamp.

validityCertificateHash?

Section titled “validityCertificateHash?”

optional validityCertificateHash?: string | null

Defined in: src/types/conversation.ts:940

SHA-256 hash of the validity certificate (assistant turns only): the same value the live answer carried.

validityCertificateId?

Section titled “validityCertificateId?”

optional validityCertificateId?: string | null

Defined in: src/types/conversation.ts:934

ID of the validity certificate (assistant turns only): the same value the live answer carried.

validityCertificateRuleProgramHash?

Section titled “validityCertificateRuleProgramHash?”

optional validityCertificateRuleProgramHash?: string | null

Defined in: src/types/conversation.ts:946

Hex SHA-256 of the rule program active when the certificate was issued (assistant turns only): the same value the live answer carried.

validityCertificateRuleRevision?

Section titled “validityCertificateRuleRevision?”

optional validityCertificateRuleRevision?: number | null

Defined in: src/types/conversation.ts:952

Rule-program revision ordinal at issuance (assistant turns only): the same value the live answer carried.