sysproxy

type Manager interface {
	// Supported reports whether this build and host can change the system
	// proxy at all.
	Supported() bool

	// Enable snapshots the current settings of every enabled network service
	// to the state file BEFORE changing anything, then points the HTTP and
	// HTTPS proxies of each service at host:port and sets the bypass domain
	// list. The bypass list written is the union of the service's existing
	// list, DefaultBypass and bypass.
	//
	// It also turns off automatic proxy configuration (PAC URL and WPAD
	// auto-discovery) on every service: Chrome and most macOS apps use a PAC
	// INSTEAD of the manual proxies, so leaving one on (a corporate agent's,
	// say) would silently route traffic around pano. Disable puts it back.
	//
	// If a snapshot already exists (pano is already enabled, or a previous
	// daemon crashed without restoring) it is kept rather than overwritten,
	// so a later Disable still restores the settings that predate pano.
	Enable(ctx context.Context, host string, port int, bypass []string) error

	// Disable restores the snapshot — the exact previous host, port and
	// enabled state of every service — and deletes the state file. It is
	// idempotent: with no state file there is nothing to do. Per-service
	// failures do not stop the restore of the remaining services; they are
	// joined into the returned error and the state file is kept so the
	// restore can be retried.
	Disable(ctx context.Context) error

	// Status reports the current state: whether a snapshot exists (pano set
	// the proxy), which services currently point at host:port, and a short
	// human-readable detail line.
	Status(ctx context.Context, host string, port int) (api.SysProxy, error)

	// RestoreStale restores the previous settings if a state file exists. It
	// is used at daemon start and by `pano doctor` to clean up after a crash.
	// It reports whether anything was restored.
	RestoreStale(ctx context.Context) (bool, error)
}