Skip to content

ConversationMeta

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

GS2-19 — metadata for a conversation (a group of turns). Passed to HistoryStore.openConversation at interactive-session start.

optional command?: string

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

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


optional model?: string

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

Human-readable model/provider label.


optional project?: string

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

The PROJECT ROOT the conversation was opened under — getProjectDir() at the moment the row was written, on the same terms as SessionRecord.project: the discovered config root, the --config override’s directory, or the working directory only as a fallback.

Not where the user was. This is also the value a resume’s workspace check compares against the resuming session’s own getProjectDir(), so what goes in here decides which conversations a later session is allowed to reopen.


optional threadId?: string

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

GS2-20 — the LangGraph thread whose durable checkpoint holds this conversation’s graph state. It is the link a resume travels: gth history list prints conversation ids, and this is what turns one of those back into the thread to re-enter. Omitted by callers that do not checkpoint, leaving the conversation listable but not resumable. A single-shot run does not come through here: HistoryStore.record opens its row and links its thread (see SessionRecord.threadId).


optional ts?: string

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

ISO-8601 start timestamp; defaults to now when omitted.