Interface: ConversationMessageResponse

@kortexya/reasoninglayer / Conversation / ConversationMessageResponse

Interface: ConversationMessageResponse

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

Response from processing a conversation message.

Remarks

Contains the assistant’s NL response, the OSFQL that was generated and executed, query results (for MATCH queries), and contextual suggestions for follow-up queries.

Properties

assistantMessage

assistantMessage: string

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

The assistant’s natural language response.

claimAnnotations?

optional claimAnnotations: ClaimAnnotationDto[] | null

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

Per-claim provenance annotations (if claims were annotated).

conversationId

conversationId: string

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

The conversation ID (existing or newly created).

intent

intent: string

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

Classified intent type (e.g., “query”, “insert”, “define”).

osfqlExecuted?

optional osfqlExecuted: string | null

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

OSFQL that was executed (if any).

producedTermIds

producedTermIds: string[]

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

IDs of terms produced by the OSFQL execution.

proofTrace?

optional proofTrace: ProofTraceNodeDto | null

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

Proof tree for this response (populated when PROVE / backward chaining was used).

queryResults?

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

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

Query results (if OSFQL was a MATCH). Each entry maps variable names to bound values.

suggestions

suggestions: string[]

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

Contextual OSFQL suggestions for follow-up queries.

uiCustomizations?

optional uiCustomizations: UICustomizationDto[] | null

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

UI customizations detected in this response (for multi-turn UI evolution).

uiSortId?

optional uiSortId: string | null

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

Sort ID referenced in the message (for UI rendering).

validityCertificateHash?

optional validityCertificateHash: string | null

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

SHA-256 hash of the validity certificate.

validityCertificateId?

optional validityCertificateId: string | null

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

ID of the validity certificate (if generate_certificate was true).