memory

type CommittedAppendError struct {
	Err error
}

type HistoryRevision struct {
	Revision  uint64
	Count     int
	Skip      int
	Dirty     bool
	FileSize  int64
	ModTimeNS int64
}

type HistoryRevisionStore interface {
	GetHistoryRevision(ctx context.Context, sessionKey string) (HistoryRevision, error)
}

type IndeterminateAppendError struct {
	Err error
}

type JSONLStore struct {
	// contains filtered or unexported fields
}

type SessionMeta struct {
	Key       string          `json:"key"`
	Summary   string          `json:"summary"`
	Skip      int             `json:"skip"`
	Count     int             `json:"count"`
	CreatedAt time.Time       `json:"created_at"`
	UpdatedAt time.Time       `json:"updated_at"`
	Scope     json.RawMessage `json:"scope,omitempty"`
	Aliases   []string        `json:"aliases,omitempty"`
	// HistoryRevision changes whenever the visible canonical history changes.
	// HistoryDirty remains set across crashes during multi-file mutations.
	HistoryRevision      uint64 `json:"history_revision,omitempty"`
	HistoryDirty         bool   `json:"history_dirty,omitempty"`
	HistoryHasPrevious   bool   `json:"history_has_previous,omitempty"`
	HistoryPreviousCount int    `json:"history_previous_count,omitempty"`
	HistoryPreviousSkip  int    `json:"history_previous_skip,omitempty"`
	HistoryTargetDigest  string `json:"history_target_digest,omitempty"`
}

type Store interface {
	// AddMessage appends a simple text message to a session.
	AddMessage(ctx context.Context, sessionKey, role, content string) error

	// AddFullMessage appends a complete message (with tool calls, etc.) to a session.
	AddFullMessage(ctx context.Context, sessionKey string, msg providers.Message) error

	// GetHistory returns all messages for a session in insertion order.
	// Returns an empty slice (not nil) if the session does not exist.
	GetHistory(ctx context.Context, sessionKey string) ([]providers.Message, error)

	// GetSummary returns the conversation summary for a session.
	// Returns an empty string if no summary exists.
	GetSummary(ctx context.Context, sessionKey string) (string, error)

	// SetSummary updates the conversation summary for a session.
	SetSummary(ctx context.Context, sessionKey, summary string) error

	// TruncateHistory removes all but the last keepLast messages from a session.
	// If keepLast <= 0, all messages are removed.
	TruncateHistory(ctx context.Context, sessionKey string, keepLast int) error

	// SetHistory replaces all messages in a session with the provided history.
	SetHistory(ctx context.Context, sessionKey string, history []providers.Message) error

	// Compact reclaims storage by physically removing logically truncated
	// data. Backends that do not accumulate dead data may return nil.
	Compact(ctx context.Context, sessionKey string) error

	// ListSessions returns all known session keys.
	ListSessions() []string

	// Close releases any resources held by the store.
	Close() error
}