hermes

type Column struct {
	Name  string
	Value any
}

type Columns []Column

type Content struct {
	// Text is the content when it is text.
	Text string
	// Parts holds structured content, each part as written; a dict is
	// one part.
	Parts []json.RawMessage
	// Structured says the content is Parts; Null that the column is
	// null.
	Structured, Null bool
}

type Database interface {
	Store
	Close() error
}

type Delegation struct {
	ID              string
	ParentSessionID string
	OriginSessionID string
	State           string
	Cols            Columns
}

type Function struct {
	Name      string          `json:"name"`
	Arguments json.RawMessage `json:"arguments"`

	Members
}

type Members = jsonline.Members

type Memory struct {
	StoreName   string
	Schema      int
	SessionRows []*Session
	Strays      []*Stray
	MessagesOf  map[string][]*Message
	Prompts     map[string]string
	Usage       map[string][]Columns
	Delegated   []*Delegation
	// Loose are rows of messages whose session is not in
	// SessionRows.
	Loose []*Message
}

type Message struct {
	// Unit names the row in findings: <database>:messages/<id>.
	Unit string

	ID        int64
	SessionID string
	Role      string
	Content   Content
	// ToolCalls is an assistant's calls, those that decoded; BadCalls
	// the entries of the column that are not objects.
	ToolCalls  []*ToolCall
	BadCalls   []json.RawMessage
	ToolCallID string
	ToolName   string
	Time       time.Time
	// FinishReason is the provider's, as Hermes recorded it.
	FinishReason string
	// Reasoning and ReasoningContent are the reasoning texts; a nil
	// ReasoningContent is a null column, which Hermes tells from an
	// empty one.
	Reasoning        string
	ReasoningContent *string
	// ReasoningDetails, CodexReasoningItems and CodexMessageItems are
	// the reasoning carriers, as JSON arrays when they hold one.
	ReasoningDetails    json.RawMessage
	CodexReasoningItems json.RawMessage
	CodexMessageItems   json.RawMessage
	// APIContent is the text Hermes sent in place of the content, and
	// HasAPIContent says the row holds a non-empty one.
	APIContent    string
	HasAPIContent bool
	DisplayKind   string
	// DisplayMetadata is the display_metadata column when it holds a
	// JSON object, once unwrapped from the string layer rows written
	// before Hermes guarded it hold.
	DisplayMetadata json.RawMessage
	// Active and Compacted are the row's flags; a database without
	// the columns has every row active. Summary is
	// _compressed_summary, and HasSummary says the database has the
	// column.
	Active, Compacted   bool
	Summary, HasSummary bool
	Observed            bool

	// Cols is the row as read.
	Cols Columns
	// Problems lists the columns that do not hold what Hermes writes,
	// each kept as written and read as Hermes reads it.
	Problems []string
	// Err says why the row cannot be read.
	Err error
}

type Relation int

type Session struct {
	// Unit names the row in findings: <database>:sessions/<id>.
	Unit string

	ID       string
	Source   string
	ParentID string
	Model    string
	// ModelConfig is the model_config column when it holds a JSON
	// object.
	ModelConfig json.RawMessage
	// SystemPrompt is the prompt column of the row, and
	// SystemPromptHash the key of system_prompts it names, from schema
	// version 25.
	SystemPrompt     string
	SystemPromptHash string
	Started          time.Time
	Ended            time.Time
	EndReason        string
	SessionKey       string
	CWD              string
	GitBranch        string
	GitRepoRoot      string
	Title            string

	// Cols is the row as read.
	Cols Columns
	// Problems lists the columns that do not hold what Hermes writes,
	// each kept as written.
	Problems []string
	// Err says why the row cannot be read; only Unit and, when the row
	// gave one, ID are then set.
	Err error
}

type Store interface {
	// Name names the store in findings: the database's file name.
	Name() string
	// Version is the schema version the database records; false when
	// it records none.
	Version() (int, bool)
	// Sessions lists every row of sessions, and the rows that cannot
	// be read as one.
	Sessions() ([]*Session, []*Stray, error)
	// Messages reads a session's rows of messages in id order, Hermes'
	// order, never the timestamps'.
	Messages(sessionID string) ([]*Message, error)
	// SystemPrompt reads system_prompts' prompt of a hash.
	SystemPrompt(hash string) (string, bool)
	// ModelUsage reads a session's rows of session_model_usage.
	ModelUsage(sessionID string) ([]Columns, error)
	// Delegations reads async_delegations.
	Delegations() ([]*Delegation, error)
	// Orphans lists the rows of messages whose session is none of the
	// set.
	Orphans(sessions map[string]bool) ([]*Stray, error)
}

type Stray struct {
	Unit string
	// Session names the session it was read with, when it was.
	Session string
	// Kind says what the row is: "session" or "message".
	Kind string
	Why  string
	// Malformed says the row could not be read at all.
	Malformed bool
}

type ToolCall struct {
	ID       string    `json:"id"`
	CallID   string    `json:"call_id"`
	Type     string    `json:"type"`
	Function *Function `json:"function"`

	Members
}