cats

type Caps struct {
	// InCats reports the env marker plus a pane handle: we are running in a
	// cats pane. True even when the control socket is unusable — the hook
	// socket is a separate address and may still work.
	InCats bool

	// Control reports that the control socket answered a ping. This is the
	// Tier-1 gate: a socket FILE proves nothing (a crashed server leaves one
	// behind), and even a successful dial proves only that something is
	// listening. Only a reply identifies a live cats.
	Control bool

	// Hooks reports that a hook socket path was given and exists. Not
	// pinged: the hook API is one-shot fire-and-forget with no liveness
	// verb, and a reporter that silently no-ops is exactly the degradation
	// we want anyway.
	Hooks bool

	// PaneHandle is CATS_PANE_ID verbatim — the public "w1:p3" form, or the
	// "p_<raw>" fallback cats emits when a pane has no public id yet. It is
	// what the HOOK api addresses a pane by, so it is used as-is there.
	PaneHandle string

	// PaneID is the internal numeric id every CONTROL command addresses a
	// pane by, and PaneIDKnown reports whether we have it. Only the "p_<n>"
	// handle carries it inline; the public "w1:p3" form has to be resolved
	// against pane.list (Client.ResolvePane), which needs the socket that
	// Control is still being decided for at detection time.
	PaneID      uint32
	PaneIDKnown bool

	ControlSocket string
	HookSocket    string

	// Service and Protocol are the ping reply's self-identification, kept for
	// the log line and for future protocol gating. The service name is
	// deliberately NOT matched against a constant: catway answers "catway",
	// a sibling implementation answers its own name, and a client that
	// rejected an unfamiliar one would break on the very host it is meant to
	// work with.
	Service  string
	Protocol int

	// Reason explains a Tier-0 verdict in one phrase ("not running inside a
	// cats pane", "control socket not answering"). Empty at Tier 1. Nothing
	// branches on it — it exists so the degradation is silent but not
	// INVISIBLE when a user goes looking for why.
	Reason string
}

type Client struct {
	Socket string

	// Timeout bounds one whole call (dial + write + read). Zero means
	// defaultCallTimeout. It is a field rather than a constant so a caller
	// with a different budget — a startup probe that must give up fast —
	// can hand out a copy rather than mutate the shared client.
	Timeout time.Duration
}

type ConfigGetResult struct {
	Path  string      `json:"path"`
	Theme ConfigTheme `json:"theme"`
}

type ConfigTheme struct {
	Name   string            `json:"name,omitempty"`
	Colors map[string]string `json:"colors,omitempty"`
	Font   string            `json:"font,omitempty"`
}

type Event struct {
	Name string          `json:"event"`
	Data json.RawMessage `json:"data,omitempty"`
}

type PaneAgentEvent struct {
	Pane  uint32 `json:"pane"`
	Agent string `json:"agent"`
	State string `json:"state"`
}

type PaneInfo struct {
	Pane       uint32 `json:"pane"`
	Handle     string `json:"handle,omitempty"`
	Name       string `json:"name,omitempty"`
	Focused    bool   `json:"focused"`
	Visible    bool   `json:"visible"`
	Agent      string `json:"agent,omitempty"`
	AgentState string `json:"agent_state,omitempty"`
	Title      string `json:"title,omitempty"`
	Cwd        string `json:"cwd,omitempty"`
}

type PaneListResult struct {
	Panes []PaneInfo `json:"panes"`
}

type PaneNotifyEvent struct {
	Pane    uint32 `json:"pane"`
	Agent   string `json:"agent"`
	Kind    string `json:"kind"`
	Message string `json:"message"`
}

type PaneRefEvent struct {
	Pane   uint32 `json:"pane"`
	Handle string `json:"handle,omitempty"`
}

type Pong struct {
	Protocol int    `json:"protocol"`
	Service  string `json:"service"`
}

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

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

type SubscribeFilter struct {
	Pane   *uint32  `json:"pane,omitempty"`
	Events []string `json:"events,omitempty"`
}

type ThemeChangedEvent = ConfigTheme