Skip to content

SessionSearchResult

Defined in: packages/core/src/history/historyStore.ts:104

A search hit: the stored record plus its id and a highlighted snippet.

optional command?: string

Defined in: packages/core/src/history/historyStore.ts:78

Originating command (ask/chat/code/exec/…).

SessionRecord.command


optional conversationId?: number

Defined in: packages/core/src/history/historyStore.ts:54

GS2-19 — the parent conversation this turn belongs to. When omitted, HistoryStore.record opens a fresh single-turn conversation for the row (so a bare single-shot run = a 1-turn conversation). Interactive sessions open one conversation up-front and pass its id here on every turn, grouping the whole chat under one conversation.

SessionRecord.conversationId


optional costUsd?: number

Defined in: packages/core/src/history/historyStore.ts:96

Estimated cost in USD, when known.

SessionRecord.costUsd


optional durationMs?: number

Defined in: packages/core/src/history/historyStore.ts:100

Wall-clock duration of the run in milliseconds, when known.

SessionRecord.durationMs


id: number

Defined in: packages/core/src/history/historyStore.ts:105


optional model?: string

Defined in: packages/core/src/history/historyStore.ts:86

Human-readable model/provider label.

SessionRecord.model


optional origin?: string

Defined in: packages/core/src/history/historyStore.ts:84

GS2-106 — the fan-out surface that started this run (batch, eval, gth-batch, workflow), omitted for a direct run. Like threadId, written only when this record opens its own fresh conversation.

SessionRecord.origin


optional project?: string

Defined in: packages/core/src/history/historyStore.ts:76

The PROJECT ROOT the turn was recorded under — every write site fills this from getProjectDir(), which is the discovered config root when discovery matched above the session, the --config override’s own directory when one was given, and the working directory only when neither applied.

It is not where the user was, and the two coincide only in the common case: a session opened in a subdirectory of a configured project records the PARENT. Nothing may render this value under a phrase that places the session in it, and the row carries no second path to recover the working directory from.

SessionRecord.project


optional prompt?: string

Defined in: packages/core/src/history/historyStore.ts:88

The user prompt / source that started the run (full-text indexed).

SessionRecord.prompt


optional response?: string

Defined in: packages/core/src/history/historyStore.ts:90

The final assistant response text (full-text indexed).

SessionRecord.response


snippet: string

Defined in: packages/core/src/history/historyStore.ts:108

FTS5 snippet around the match (may be empty).


optional threadId?: string

Defined in: packages/core/src/history/historyStore.ts:62

GS2-106 — the LangGraph thread a single-shot run checkpointed under. Used ONLY when this record opens its own fresh conversation (no conversationId), and written onto that new row, so the run’s durable state is linked to the conversation it belongs to in the same transaction that creates the row. Ignored when conversationId is given: an existing conversation already carries its own link, and a turn must never move it.

SessionRecord.threadId


optional tokensInput?: number

Defined in: packages/core/src/history/historyStore.ts:92

Prompt/input token count, when known.

SessionRecord.tokensInput


optional tokensOutput?: number

Defined in: packages/core/src/history/historyStore.ts:94

Completion/output token count, when known.

SessionRecord.tokensOutput


optional tools?: string[]

Defined in: packages/core/src/history/historyStore.ts:98

Names of tools invoked during the run, when known.

SessionRecord.tools


ts: string

Defined in: packages/core/src/history/historyStore.ts:106

ISO-8601 timestamp; defaults to now when omitted.

SessionRecord.ts