effects

type Client interface {
	// GetDaemonStatus returns the current daemon status snapshot.
	// Never returns an error for "daemon not running" — it returns a StatusData
	// with Running=false instead, so callers can distinguish gracefully.
	GetDaemonStatus() (*daemon.StatusData, error)

	// ListSessions returns recent sessions from the project ledger.
	// Returns nil, nil when no ledger path is available.
	ListSessions() ([]session.SessionInfo, error)

	// ListMurmurs returns murmur entries from team context workspace paths.
	// Returns nil, nil on any filesystem error.
	ListMurmurs() ([]domain.MurmurEntry, error)

	// ListTeamDiscussions returns team discussion preview entries from memory/
	// directories in team context paths.
	// Returns nil, nil on any filesystem error.
	ListTeamDiscussions() ([]domain.TeamDiscussion, error)

	// ListInstances returns active AI coworker instances from the daemon.
	// Returns nil, nil when the daemon is offline.
	ListInstances() ([]daemon.InstanceInfo, error)

	// ListStoredErrors returns unviewed stored errors from the daemon.
	// Returns nil, nil when the daemon is offline.
	ListStoredErrors() ([]daemon.StoredError, error)

	// ListTeamContexts returns metadata about all synced team context workspaces,
	// loaded directly from disk (daemon-independent).
	// Returns nil, nil when no team contexts are found.
	ListTeamContexts() ([]domain.TeamContextEntry, error)

	// LoadCodeIndexStats returns code index statistics.
	// Prefers daemon-reported stats; falls back to reading the ledger cache directory
	// when the daemon is offline.
	// Returns nil, nil when no index data is available.
	LoadCodeIndexStats() (*daemon.CodeDBStats, error)

	// ListWhisperHistory returns recent whispers delivered by the daemon.
	// Fetches from the daemon's WhisperHistory IPC endpoint.
	// Returns nil, nil when the daemon is offline.
	ListWhisperHistory() ([]domain.WhisperHistoryEntry, error)

	// BuildSessionURL constructs the canonical web URL for a session name.
	// Returns empty string when required config (endpoint, repo_id) is unavailable.
	BuildSessionURL(sessionName string) string
}

type CodeIndexStatsLoadedMsg struct {
	Stats *daemon.CodeDBStats
	Gen   int
	Err   error
}

type DaemonStatusLoadedMsg struct {
	Data *daemon.StatusData
	Gen  int
	Err  error
}

type InstancesLoadedMsg struct {
	Instances []daemon.InstanceInfo
	Gen       int
	Err       error
}

type MurmursLoadedMsg struct {
	Murmurs []domain.MurmurEntry
	Gen     int
	Err     error
}

type RefreshTickMsg struct {
	Gen int
}

type SessionsLoadedMsg struct {
	Sessions []session.SessionInfo
	Gen      int
	Err      error
}

type StoredErrorsLoadedMsg struct {
	Errors []daemon.StoredError
	Gen    int
	Err    error
}

type TeamContextsLoadedMsg struct {
	TeamContexts []domain.TeamContextEntry
	Gen          int
	Err          error
}

type TeamDiscussionsLoadedMsg struct {
	Discussions []domain.TeamDiscussion
	Gen         int
	Err         error
}

type WhisperHistoryLoadedMsg struct {
	Entries []domain.WhisperHistoryEntry
	Gen     int
	Err     error
}