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.
Properties
Section titled “Properties”command?
Section titled “command?”
optionalcommand?:string
Defined in: packages/core/src/history/historyStore.ts:129
Originating command (chat/code/ask/exec/…).
model?
Section titled “model?”
optionalmodel?:string
Defined in: packages/core/src/history/historyStore.ts:131
Human-readable model/provider label.
project?
Section titled “project?”
optionalproject?: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.
threadId?
Section titled “threadId?”
optionalthreadId?: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).
optionalts?:string
Defined in: packages/core/src/history/historyStore.ts:117
ISO-8601 start timestamp; defaults to now when omitted.