process

type DiscoveryResult struct {
	Instance   InstanceID
	Generation uint64
	// Sequence orders results *within* one Generation, which Generation alone
	// cannot: the initial discovery and a list_changed refresh both describe
	// generation N, so without it an older snapshot applied late overwrites
	// newer tools. Producers stamp it with Handle.NextDiscoverySequence at the
	// moment the data is obtained — not at publish or apply time, which can be
	// arbitrarily delayed by scheduling. Zero means unsequenced: ordering falls
	// back to Generation alone.
	Sequence     uint64
	Initialized  bool
	Capabilities mcp.ServerCapabilities
	Tools        []mcp.Tool
	Err          error
}

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

type HandleKind int

type InstanceID struct {
	Server  string `json:"server"`
	Session string `json:"session,omitempty"`
}

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

type ManagerLockInfo struct {
	PID  int    `json:"pid"`
	Mode string `json:"mode"` // "tui" or "web"
}

type Observer interface {
	OnDiscoveryResult(DiscoveryResult)
	OnInstanceStopped(InstanceID, uint64)
	OnUpstreamNotification(UpstreamNotification)
}

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

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

type SupervisorOptions struct {
	// CredentialStoreMode specifies the OAuth credential store mode.
	// If empty, defaults to "auto".
	CredentialStoreMode string

	// PIDTrackerDir overrides the directory used for the PID tracking file.
	// If empty, the default ~/.config/mcpmu/ directory is used.
	PIDTrackerDir string

	// PIDFilePrefix labels this owner process's registry file by manager mode.
	// Unique owner identity, not the prefix, prevents concurrent clobbering.
	PIDFilePrefix string

	// GlobalOAuthCallbackPort is the global fallback OAuth callback port.
	// Per-server oauth.callback_port takes precedence over this.
	GlobalOAuthCallbackPort *int

	// InitAttemptTimeout overrides the timeout for each MCP initialization
	// attempt. If non-positive, the package default is used.
	InitAttemptTimeout time.Duration

	// InitRetryBaseDelay overrides the base exponential backoff between MCP
	// initialization attempts. If non-positive, the package default is used.
	InitRetryBaseDelay time.Duration
}

type UpstreamNotification struct {
	Instance   InstanceID
	Generation uint64
	Method     string
	Params     json.RawMessage
	Upstream   bool
}