sessions

type AgentRunOpenResult struct {
	AgentRunSessionID string
	Mode              string // send | resume | run | focus
	Opened            bool   // true when a new window was (or would be) launched
	Focused           bool   // true when an existing agent-run host was focused
	Delivered         bool   // true when the prompt was already delivered
	Command           string // follow-up command for resume/run window (dry-run / ack)
	CWD               string
}

type AgentRunSnapshotResult struct {
	AgentRunSessionID string
	Contents          string
}

type ChatMessage struct {
	Kind      string    `json:"kind"`
	Text      string    `json:"text"`
	Truncated bool      `json:"truncated"`
	Tool      string    `json:"tool,omitempty"`
	Timestamp time.Time `json:"-"`
}

type DisplayEvent struct {
	Kind      string `json:"kind"`
	Text      string `json:"text"`
	Formatted string `json:"formatted"`
}

type FocusCandidate struct {
	WindowID    string
	WindowTitle string
	TabIndex    int
	SessionID   string // iTerm session id
	TTY         string
	PID         int
}

type FocusDiscovery struct {
	Candidates []FocusCandidate
	LiveCount  int
}

type FocusFake struct {
	Procs          []FocusProc
	OpenFiles      map[int][]string
	ITerm          []iterm2.SessionRef
	Focused        []string
	ListProcsCalls int
	LsofCalls      int
	ListITermCalls int
}

type FocusOpts struct {
	Index      *int
	ListProcs  func() []FocusProc
	Lsof       func(int) []string
	ListITerm  func() ([]iterm2.SessionRef, error)
	FocusITerm func(iterm2.SessionRef) error
}

type FocusProc struct {
	PID  int
	PPID int
	TTY  string // e.g. /dev/ttys148, ttys148, "??", or ""
	Cmd  string
}

type ListLiveFake struct {
	FocusFake
	PaneByTTY map[string]LivePaneInfo
	// CwdBySession overrides FindSession when set.
	CwdBySession map[string]string
}

type ListLiveOpts struct {
	JSON  bool
	Limit int // 0 = unlimited

	ListProcs func() []FocusProc
	Lsof      func(int) []string
	ListITerm func() ([]iterm2.SessionRef, error)

	// PaneByTTY supplies optional pane cwd for WORKSPACE (nil → path-derived summary).
	PaneByTTY func() (map[string]LivePaneInfo, error)

	// CaptureInventory, when both ListITerm and PaneByTTY are nil, runs once
	// and feeds hosting refs + pane cwd. Nil → fast path: one ListITerm
	// AppleScript and empty panes (title/cwd from open-file summary / FindSession).
	CaptureInventory func() (panes map[string]LivePaneInfo, refs []iterm2.SessionRef, err error)

	// FindSession resolves workspace when pane cwd and path-derived summary cwd are empty.
	// Title/cwd normally come from summary.json beside the lsof hard-hit session dir.
	FindSession func(sessionID string) (cwd string, ok bool)
	CodexHome   string
}

type LiveHostingRow struct {
	SessionID  string
	ITerm      string // w=<id> t=<tab>(+N)
	Title      string // from summary.json generated_title; empty → "-"
	Workspace  string
	Candidates []FocusCandidate
}

type LiveOptions struct {
	ListProcs func() []procresolve.Proc
	Lsof      func(int) []string
}

type LivePID struct {
	PID  int
	Name string
	Cmd  string
}

type LivePaneInfo struct {
	Idle *bool
	Cwd  string
}

type MessagesOpts struct {
	Limit         int
	LimitSet      bool
	OffsetFromEnd int
	JSON          bool
	Greps         []string
	ColorMode     string // "auto" | "always" | "never"
	Loc           *time.Location

	ListProcs        func() []FocusProc
	Lsof             func(int) []string
	ListITerm        func() ([]iterm2.SessionRef, error)
	CurrentSessionID func() string
	ControllingTTY   func() string
	AncestorTTYs     func() []string
}

type MessagesResult struct {
	SessionID     string
	Total         int
	OffsetFromEnd int
	Limit         int
	Messages      []ChatMessage
	Text          string
}

type OpenFake struct {
	FocusFake
	Opened           []string // "dir|followUp" entries
	CurrentSessionID string
	ControllingTTY   string

	AgentRunByID  map[string]*AgentRunOpenResult
	AgentRunErr   error
	AgentRunCalls []string
}

type OpenOpts struct {
	Index  *int
	Dir    string // optional workspace override for resume
	DryRun bool

	// NoAgentRun skips agent-run prefer (--no-agent-run).
	NoAgentRun bool
	// AgentRunHome overrides AGENT_RUN_HOME / ~/.agent-run for production prefer.
	AgentRunHome string
	// AgentRunBin overrides LookPath("agent-run") for resume/run window commands.
	AgentRunBin string

	// TabFrom, when set, short-circuits focus to this already-resolved tab
	// (used by RunOpen after ResolveFromTab). Resume is skipped.
	TabFrom *TabResolveResult

	ListProcs  func() []FocusProc
	Lsof       func(int) []string
	ListITerm  func() ([]iterm2.SessionRef, error)
	FocusITerm func(iterm2.SessionRef) error

	// Tab resolve hooks (nil → production). Used by RunOpen for --tab/--tab-index.
	CurrentSessionID func() string
	ControllingTTY   func() string
	AncestorTTYs     func() []string

	OpenInNewWindow func(dir, followUp string) error
	CodexBin        string
	LookPath        func(file string) (string, error)
	Env             []string

	// AgentRunOpen replaces production agent-run prefer (tests).
	AgentRunOpen func(codexSessionID, prompt string) (*AgentRunOpenResult, error)

	Stderr io.Writer // warnings (live-but-no-iTerm); nil → os.Stderr
}

type OpenResult struct {
	Action            string // OpenActionFocused | OpenActionResumed
	Candidate         FocusCandidate
	CWD               string
	Command           string
	ViaAgentRun       bool
	AgentRunSessionID string
	AgentRunMode      string
}

type ResolveDetails struct {
	SessionID   string `json:"session_id"`
	Mode        string `json:"mode,omitempty"` // "ancestor" | "tab"
	StartPID    int    `json:"start_pid,omitempty"`
	AncestorPID int    `json:"ancestor_pid,omitempty"`
	RunnerPID   int    `json:"runner_pid"`
	Source      string `json:"source"`
	Confidence  string `json:"confidence"`
	WindowID    string `json:"window_id,omitempty"`
	TabIndex    int    `json:"tab_index,omitempty"`
	TTY         string `json:"tty,omitempty"`
}

type ResolveOpts struct {
	Stdout, Stderr io.Writer
	PID            int
	ListProcs      func() []procresolve.Proc
	Lsof           func(pid int) []string
	CodexHome      string

	// Tab path hooks (nil → production probes used by ResolveFromTab).
	ListFocusProcs   func() []FocusProc
	ListITerm        func() ([]iterm2.SessionRef, error)
	CurrentSessionID func() string
	ControllingTTY   func() string
	AncestorTTYs     func() []string
}

type SendCall struct {
	SessionID string
	Text      string
	Opts      iterm2.SendTextOptions
}

type SendFake struct {
	FocusFake
	CurrentSessionID string
	ControllingTTY   string

	Opened     []string // "dir|followUp"
	SendCalls  []SendCall
	SendErr    error
	AfterOpen  func(*SendFake) // mutate Procs/ITerm after resume (tests)
	SleepCalls int
	Clock      time.Time // advanced by Sleep when non-zero start set via InitClock

	// AgentRunByID maps codex session id → prefer hit. Missing key = soft miss.
	AgentRunByID  map[string]*AgentRunOpenResult
	AgentRunErr   error
	AgentRunCalls []string
	// contains filtered or unexported fields
}

type SendOpts struct {
	Index    *int
	Dir      string
	DryRun   bool
	Open     bool
	Focus    bool
	NoSubmit bool
	NoCtrlU  bool

	// NoAgentRun skips agent-run prefer on --open (--no-agent-run).
	NoAgentRun bool
	// AgentRunHome overrides AGENT_RUN_HOME / ~/.agent-run for production prefer.
	AgentRunHome string
	// AgentRunBin overrides LookPath("agent-run") for resume/run window commands.
	AgentRunBin string

	// OpenWait caps how long --open polls for a hosting tab. Zero → DefaultSendOpenWait.
	OpenWait time.Duration

	// TabFrom, when set, short-circuits host discovery to this already-resolved tab.
	TabFrom *TabResolveResult

	ListProcs func() []FocusProc
	Lsof      func(int) []string
	ListITerm func() ([]iterm2.SessionRef, error)

	// Tab resolve hooks (nil → production). Used by RunSend for --tab/--tab-index.
	CurrentSessionID func() string
	ControllingTTY   func() string
	AncestorTTYs     func() []string

	// SendText writes into an iTerm session. Nil → iterm2.SendText.
	SendText func(sessionID, text string, opts iterm2.SendTextOptions, cfg *iterm2.SendTextConfig) error

	OpenInNewWindow func(dir, followUp string) error
	CodexBin        string
	LookPath        func(file string) (string, error)
	Env             []string

	// AgentRunOpen replaces production agent-run prefer+deliver (tests).
	// Return (nil, nil) soft miss; ambiguous error → warning + fall back.
	AgentRunOpen func(codexSessionID, prompt string) (*AgentRunOpenResult, error)

	// Sleep / Now inject the --open wait loop (tests). Nil → time.Sleep / time.Now.
	Sleep func(d time.Duration)
	Now   func() time.Time

	Stderr io.Writer // warnings (live-but-no-iTerm); nil → os.Stderr
}

type SendResult struct {
	SessionID         string
	ITermSessionID    string
	Text              string
	Opened            bool // true when --open resumed a new window
	ViaAgentRun       bool
	AgentRunSessionID string
	AgentRunMode      string // send | resume | run
	Candidate         FocusCandidate
	CWD               string
	Command           string
}

type Session struct {
	ID               string    `json:"id"`
	StartedAt        time.Time `json:"started_at"`
	CWD              string    `json:"cwd"`
	Title            string    `json:"title,omitempty"`
	Path             string    `json:"path"`
	NumDisplayEvents int       `json:"num_display_events,omitempty"`
}

type SessionBrief struct {
	Session
	Status         string         `json:"status"`
	LineCount      int            `json:"line_count"`
	RecentMessages []DisplayEvent `json:"recent_messages"`
}

type SessionInfo struct {
	Session
	Status            string         `json:"status"`
	LineCount         int            `json:"line_count"`
	NumDisplayEvents  int            `json:"num_display_events"`
	RecentMessages    []DisplayEvent `json:"recent_messages"`
	TotalInputTokens  int            `json:"total_input_tokens"`
	TotalOutputTokens int            `json:"total_output_tokens"`
}

type SessionSourceOpts struct {
	ListProcs        func() []FocusProc
	Lsof             func(int) []string
	ListITerm        func() ([]iterm2.SessionRef, error)
	CurrentSessionID func() string
	ControllingTTY   func() string
	AncestorTTYs     func() []string
}

type SessionStatus struct {
	SessionID  string
	Path       string // absolute rollout path from Find (display via TildeHome)
	FileActive bool
	PIDs       []LivePID
	PIDChecked bool
	State      string // "running" | "inactive"
}

type SnapshotFake struct {
	FocusFake
	CurrentSessionID string
	ControllingTTY   string

	ContentsByID  map[string]iterm2.ContentsResult
	ContentsErr   error
	ContentsCalls []string

	AgentRunByID    map[string]*AgentRunSnapshotResult
	AgentRunErr     error
	AgentRunCalls   []string
	AgentRunEnabled bool
}

type SnapshotOpts struct {
	Index  *int
	DryRun bool
	JSON   bool
	Output string // -o/--output path; empty → stdout

	// ForceITerm skips the agent-run prefer path (--iterm).
	ForceITerm bool

	// AgentRunHome overrides AGENT_RUN_HOME / ~/.agent-run for production prefer.
	AgentRunHome string

	// TabFrom, when set, short-circuits host discovery to this already-resolved tab.
	TabFrom *TabResolveResult

	ListProcs func() []FocusProc
	Lsof      func(int) []string
	ListITerm func() ([]iterm2.SessionRef, error)

	// Tab resolve hooks (nil → production). Used by RunSnapshot for --tab/--tab-index.
	CurrentSessionID func() string
	ControllingTTY   func() string
	AncestorTTYs     func() []string

	// Contents dumps visible pane text. Nil → iterm2.Contents.
	Contents func(sessionID string, cfg *iterm2.ContentsConfig) (iterm2.ContentsResult, error)

	// AgentRunSnapshot, when set, is tried before iTerm (unless ForceITerm).
	AgentRunSnapshot func(codexSessionID string) (*AgentRunSnapshotResult, error)

	// Warning, when set, receives soft-fallback messages (e.g. ambiguous mapping).
	Warning func(string)
}

type SnapshotResult struct {
	SessionID         string // Codex session id
	ITermSessionID    string
	App               string
	Contents          string
	Source            string // SnapshotSourceAgentRun | SnapshotSourceITerm
	AgentRunSessionID string
	Candidate         FocusCandidate
}

type TabResolveOpts struct {
	ListProcs        func() []FocusProc
	Lsof             func(int) []string
	ListITerm        func() ([]iterm2.SessionRef, error)
	CurrentSessionID func() string
	ControllingTTY   func() string
	AncestorTTYs     func() []string
}

type TabResolveResult struct {
	SessionID    string
	RunnerPID    int
	Source       string
	Confidence   string
	WindowID     string
	WindowName   string
	TabIndex     int // 1-based iTerm index
	TabListPos   int // 0-based position in window tab list
	TTY          string
	ITermSession string
}

type TabSelKind int

type TabSelector struct {
	Kind TabSelKind
	N    int // for TabSelAbs1 / TabSelAbs0
}