session

type ReapAction struct {
	Name   string
	Killed bool   // a live-but-wedged daemon was terminated
	Reason string // human-readable explanation
}

type ReapOptions struct {
	// NATSProbeTimeout bounds a single NATS reachability probe.
	NATSProbeTimeout time.Duration
	// NATSProbeAttempts is how many times to probe before declaring a live
	// daemon unreachable, guarding against a transient blip killing a healthy
	// daemon.
	NATSProbeAttempts int
	// StartupGrace skips records updated within this window, so a daemon that is
	// still coming up (PID alive, NATS not yet listening) is never mistaken for a
	// wedged orphan and killed.
	StartupGrace time.Duration
	// contains filtered or unexported fields
}

type Record struct {
	Name    string `json:"name"`
	Path    string `json:"path"`
	State   string `json:"state"`
	PID     int    `json:"pid,omitempty"`      // daemon process PID
	TUIPIDs []int  `json:"tui_pids,omitempty"` // all attached TUI process PIDs
	// AppClients is the number of desktop-app (WebSocket) clients currently
	// connected to the daemon's web server. The registry's State field tracks
	// TUI attachment only, so app sessions read "detached" even while the
	// desktop app is driving them — this field lets list/info render them as
	// "attached (app)". Maintained live by the daemon's web hub.
	AppClients int `json:"app_clients,omitempty"`
	NATSPort   int `json:"nats_port,omitempty"`
	// ProxyPort is the loopback governance proxy's port (design 001) while it is
	// running, or 0 when it is off. Maintained live by the daemon on ##proxy
	// on/off (read-modify-write, so attach bookkeeping is preserved), so tools
	// inspecting the registry — and ##session info — can see the governed
	// endpoint (http://127.0.0.1:{ProxyPort}) without attaching a TUI.
	ProxyPort int       `json:"proxy_port,omitempty"`
	UpdatedAt time.Time `json:"updated_at"`
	// Version and BinHash identify the rysh binary that the running daemon was
	// launched from. They are stamped by the daemon at startup and compared on
	// attach so a rebuilt binary can detect that the live daemon is outdated and
	// (with --upgrade) restart it. Version is the human-readable build string
	// (main.version, e.g. a git-describe tag); BinHash is a short content hash of
	// the executable, which changes on every rebuild even when Version does not
	// (e.g. repeated "-dirty" dev builds at the same commit).
	Version string `json:"version,omitempty"`
	BinHash string `json:"bin_hash,omitempty"`
	// ConfigFile is the rysh.config.yaml the daemon loaded (empty when none was
	// found), and RyshDir is the rysh directory that config location implied
	// (see config.resolveConfig). They are recorded so the session — and tools
	// that inspect the registry (e.g. "rysh list-sessions") — are aware of which
	// configuration and rysh state directory this session resolved at startup.
	ConfigFile string `json:"config_file,omitempty"`
	RyshDir    string `json:"rysh_dir,omitempty"`
	// Source identifies the front-end that owns the session: "cli" (rysh command
	// line) or "app" (rysh desktop app). It is stamped by the daemon at startup
	// from cfg.SessionSource (RYSH_SESSION_SOURCE). The two front-ends refuse to
	// open each other's sessions so the CLI TUI and the desktop app never drive
	// the same saved layout. Empty means legacy/unknown and is treated as
	// compatible with either front-end.
	Source string `json:"source,omitempty"`
}

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