Interface: ResearchSessionResponse
@kortexya/reasoninglayer / ResearchSessionResponse
Interface: ResearchSessionResponse
Section titled “Interface: ResearchSessionResponse”Defined in: src/types/research.ts:126
Full research session state.
Properties
Section titled “Properties”createdAt
Section titled “createdAt”createdAt:
string
Defined in: src/types/research.ts:170
When the session was created (ISO 8601).
cycles
Section titled “cycles”cycles:
ResearchCycleResultDto[]
Defined in: src/types/research.ts:136
Results from each completed cycle.
error?
Section titled “error?”
optionalerror?:string|null
Defined in: src/types/research.ts:134
Error message if status is Failed.
papers
Section titled “papers”papers:
PaperMetadataDto[]
Defined in: src/types/research.ts:143
Papers ingested so far, with full metadata (title, authors, DOI, URL).
This is the session’s actual corpus — totalPapersIngested is only its
length. Empty against a backend that does not send it.
question
Section titled “question”question:
string
Defined in: src/types/research.ts:130
The research question.
sessionId
Section titled “sessionId”sessionId:
string
Defined in: src/types/research.ts:128
Session ID (UUID).
status
Section titled “status”status:
ResearchSessionStatusDto
Defined in: src/types/research.ts:132
Current session status.
totalContradictions
Section titled “totalContradictions”totalContradictions:
number
Defined in: src/types/research.ts:166
Total contradictions.
totalFindings
Section titled “totalFindings”totalFindings:
number
Defined in: src/types/research.ts:164
Total findings.
totalGaps
Section titled “totalGaps”totalGaps:
number
Defined in: src/types/research.ts:168
Total knowledge gaps.
totalPapersIngested
Section titled “totalPapersIngested”totalPapersIngested:
number
Defined in: src/types/research.ts:162
Total papers ingested.
totalPapersPooled
Section titled “totalPapersPooled”totalPapersPooled:
number
Defined in: src/types/research.ts:160
Total papers in the deduplicated retrieval pool, before ranking and the budget cut. Live during a run.
totalPapersRetrieved
Section titled “totalPapersRetrieved”totalPapersRetrieved:
number
Defined in: src/types/research.ts:155
Total papers KEPT, including by the cycle currently running: after ranking and the cut to the paper budget, so never above the budget. ResearchSessionResponse.totalPapersPooled is the pool before the cut.
Live throughout a run, unlike cycles[].papersRetrieved, which a cycle
only publishes once it completes — minutes after the papers arrived.
Deriving the figure from cycles alone therefore renders 0 over a
visibly growing paper list for most of a session; read this instead, and
keep cycles[].papersRetrieved for the per-cycle breakdown.
updatedAt
Section titled “updatedAt”updatedAt:
string
Defined in: src/types/research.ts:172
When the session was last updated (ISO 8601).