agentstorage

type Config struct {
	DefaultAgentRunner string `json:"default_agent_runner"`
	DefaultModel       string `json:"default_model"`
	LastSession        string `json:"last_session"`
	// SelectedWorkspace is the active workspace path for status + new sessions.
	SelectedWorkspace string `json:"selected_workspace,omitempty"`
	// RecentWorkspaces is an MRU list of workspace paths (newest first, max ~12).
	RecentWorkspaces []string `json:"recent_workspaces,omitempty"`
}

type IdlePolicy struct {
	ExitOnIdle  bool          `json:"exit_on_idle"`
	IdleTimeout time.Duration `json:"-"`
}

type LogRecord struct {
	Timestamp string `json:"timestamp"`
	Level     string `json:"level"`
	Component string `json:"component"`
	Message   string `json:"message"`
}

type Message struct {
	ID        string `json:"id"`
	Text      string `json:"text"`
	SessionID string `json:"session_id"`
	CreatedAt string `json:"created_at"`
}

type Session struct {
	Meta SessionMeta
}

type SessionMeta struct {
	Runner          string `json:"runner"`
	SessionID       string `json:"session_id"`
	InitialPrompt   string `json:"initial_prompt,omitempty"`
	RunnerSessionID string `json:"runner_session_id,omitempty"`
	// RunnerSessions maps provider family (codex, grok, or exact runner name)
	// to that family's last bound runner_session_id. RunnerSessionID is the
	// active family's id; this map keeps inactive families so a later runner
	// switch can resume instead of starting over.
	RunnerSessions    map[string]string `json:"runner_sessions,omitempty"`
	TerminalSessionID string            `json:"terminal_session_id,omitempty"`
	Status            string            `json:"status"`
	Workspace         string            `json:"workspace,omitempty"`
	Model             string            `json:"model,omitempty"`
	// PrependPaths are absolute directories prepended to the TTY child PATH (ordered, no dedup).
	PrependPaths []string `json:"prepend_paths,omitempty"`
	// Env is ordered KEY=VALUE entries applied to the TTY child (last-win per key).
	Env []string `json:"env,omitempty"`
	// AgentRunnerConfigHome is the agent data dir (grok: GROK_HOME, codex: CODEX_HOME).
	AgentRunnerConfigHome string `json:"agent_runner_config_home,omitempty"`
	CreatedAt             string `json:"created_at,omitempty"`
	UpdatedAt             string `json:"updated_at,omitempty"`
}

type Store interface {
	Home() string
	Config() (Config, error)
	SaveConfig(Config) error
	ListSessions() ([]SessionMeta, error)
	ClearAllSessions() error
	GetSession(sessionID string) (*Session, error)
	CreateSession(sessionID string, meta SessionMeta) error
	UpdateSessionStatus(sessionID, status string) error
	UpdateSessionRunnerSessionID(sessionID, runnerSessionID string) error
	// ClearSessionRunnerSessionID removes the live runner_session_id and the
	// current family's RunnerSessions slot so the next AutoSendOrResume can
	// ModeRun that family (orphan/missing provider sessions). Other families
	// in the map are kept. No-op when the current family is already unbound.
	ClearSessionRunnerSessionID(sessionID string) error
	// ActivateSessionRunner sets meta.runner to runner and restores the live
	// runner_session_id from RunnerSessions[family] when present (else clears
	// the live slot). Other families in the map are kept.
	ActivateSessionRunner(sessionID, runner string) error
	UpdateSessionTerminalSessionID(sessionID, terminalSessionID string) error
	// UpdateSessionWorkspace sets meta.workspace (e.g. after Grok session relocate).
	UpdateSessionWorkspace(sessionID, workspace string) error
	// UpdateSessionEnvConfig writes session-scoped TTY child env fields.
	// prependPaths/env replace the stored lists; configHome replaces when non-empty.
	UpdateSessionEnvConfig(sessionID string, prependPaths, env []string, configHome string) error
	AppendEvent(sessionID string, ev types.AgentEvent) error
	ReadEvents(sessionID string, afterOffset int64) ([]types.AgentEvent, int64, error)
	AppendMessage(sessionID, text string) (Message, error)
	PopMessages(sessionID string) ([]Message, error)
	ListMessages(sessionID string) ([]Message, error)
}