server

type ACIDSpecifier struct {
	ControllerToken string
	ACID            sim.ACID
}

type ATPAConfigArgs struct {
	ControllerToken string
	Op              sim.ATPAConfigOp
	VolumeId        string
}

type ATPAConfigResult struct {
	SimStateUpdate
	Output string
}

type AcceptHandoffArgs ACIDSpecifier

type ActivateFlightPlanArgs struct {
	ControllerToken     string
	TrackCallsign       av.ADSBCallsign
	FpACID              sim.ACID
	FlightPlanSpecifier sim.FlightPlanSpecifier
}

type AircraftCommandsArgs struct {
	ControllerToken   string
	Callsign          av.ADSBCallsign
	Commands          string
	Multiple          bool
	ClickedTrack      bool
	EnableTTS         bool          // Whether to synthesize readback audio
	WhisperDuration   time.Duration // Time from PTT release to whisper completion (zero for keyboard input)
	AudioDuration     time.Duration // Duration of the recorded audio (zero for keyboard input)
	WhisperTranscript string        // Raw whisper transcript (empty for keyboard input)
	WhisperProcessor  string        // Description of the processor running whisper (GPU model or CPU info)
	WhisperModel      string
	AircraftContext   map[string]stt.Aircraft // Aircraft context used for STT decoding (for logging)
	STTDebugLogs      []string                // Local STT processing logs (for logging)
}

type AircraftCommandsResult struct {
	ErrorMessage   string
	RemainingInput string
	ReadbackQueued bool // True if a readback TTS was queued for delivery
}

type AircraftSpecifier struct {
	ControllerToken string
	Callsign        av.ADSBCallsign
}

type AssociateFlightPlanArgs struct {
	ControllerToken     string
	Callsign            av.ADSBCallsign
	FlightPlanSpecifier sim.FlightPlanSpecifier
}

type BroadcastMessage struct {
	Password string
	Message  string
}

type CancelHandoffArgs ACIDSpecifier

type ConnectResult struct {
	ScenarioCatalogs    map[string]map[string]*ScenarioCatalog
	RunningSims         map[string]*RunningSim
	HaveTTS             bool
	AvailableWXByTRACON map[string][]util.TimeInterval
}

type ConsolidateTCPArgs struct {
	ControllerToken string
	ReceivingTCW    sim.TCW
	SendingTCP      sim.TCP
	Type            sim.ConsolidationType
}

type CreateArrivalArgs struct {
	ControllerToken string
	Group           string
	Airport         string
}

type CreateDepartureArgs struct {
	ControllerToken string
	Airport         string
	Runway          string
	Category        string
	Rules           av.FlightRules
}

type CreateFlightPlanArgs struct {
	ControllerToken     string
	FlightPlanSpecifier sim.FlightPlanSpecifier
}

type CreateOverflightArgs struct {
	ControllerToken string
	Group           string
}

type CreateRestrictionAreaResultArgs struct {
	Index       int
	StateUpdate SimStateUpdate
}

type DeconsolidateTCPArgs struct {
	ControllerToken string
	TCP             sim.TCP // TCP to deconsolidate (optional - if empty, deconsolidate user's own TCP)
}

type DeleteAircraftArgs AircraftSpecifier

type DeleteAircraftListArgs struct {
	ControllerToken string
	Aircraft        []sim.Aircraft
}

type DeleteFlightPlanArgs ACIDSpecifier

type FlightPlanDirectArgs struct {
	ControllerToken string
	ACID            sim.ACID
	Fix             string
}

type ForceQLArgs struct {
	ControllerToken string
	ACID            sim.ACID
	ToPosition      sim.ControlPosition
}

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

type GetAtmosArgs struct {
	Facility       string
	Time           time.Time
	PrimaryAirport string
}

type GetAtmosResult struct {
	AtmosByPointSOA *wx.AtmosByPointSOA
	Time            time.Time
	NextTime        time.Time
}

type GlobalMessageArgs struct {
	ControllerToken string
	Message         string
}

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

type HandoffArgs struct {
	ControllerToken string
	ACID            sim.ACID
	ToPosition      sim.ControlPosition
}

type HeldDepartureArgs AircraftSpecifier

type JoinSimRequest struct {
	SimName         string
	TCW             sim.TCW   // Which TCW to sign into
	SelectedTCPs    []sim.TCP // TCPs to consolidate (non-relief only)
	Initials        string    // Controller initials (e.g., "MP")
	Password        string
	Privileged      bool
	JoiningAsRelief bool
}

type LaunchAircraftArgs struct {
	ControllerToken string
	Aircraft        sim.Aircraft
	DepartureRunway string
}

type ModifyFlightPlanArgs struct {
	ControllerToken     string
	FlightPlanSpecifier sim.FlightPlanSpecifier
	ACID                sim.ACID
}

type NewSimRequest struct {
	Facility     string
	NewSimName   string
	GroupName    string
	ScenarioName string

	ScenarioSpec *ScenarioSpec
	StartTime    time.Time

	TFRs        []av.TFR
	Emergencies []sim.Emergency

	RequirePassword bool
	Password        string

	EnforceUniqueCallsignSuffix bool

	PilotErrorInterval float32

	Initials   string // Controller initials (e.g., "XX")
	Privileged bool
}

type NewSimResult struct {
	SimState        *SimState
	ControllerToken string
	SpeechWSPort    int
}

type PointOutArgs struct {
	ControllerToken string
	ACID            sim.ACID
	ToPosition      sim.ControlPosition
}

type PrecipURL struct {
	URL      string
	NextTime time.Time
}

type PrecipURLArgs struct {
	Facility string
	Time     time.Time
}

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

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

type RepositionTrackArgs struct {
	ControllerToken string
	ACID            sim.ACID        // from
	Callsign        av.ADSBCallsign // to
	Position        math.Point2LL   // to
}

type RequestContactArgs struct {
	ControllerToken string
}

type RequestContactResult struct {
	ContactSpeech *sim.PilotSpeech // Synthesized contact speech, or nil if none pending
}

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

type RestrictionAreaArgs struct {
	ControllerToken string
	Index           int
	RestrictionArea av.RestrictionArea
}

type RunningSim struct {
	GroupName                    string
	ScenarioName                 string
	RequirePassword              bool
	ScenarioDefaultConsolidation map[sim.TCP][]sim.TCP
	CurrentConsolidation         map[sim.TCW]TCPConsolidation
}

type STTBugReportArgs struct {
	ControllerToken string
	PrevTranscript  string                  // Transcript of the previous transmission
	PrevCommand     string                  // Decoded command from previous transmission
	AircraftContext map[string]stt.Aircraft // Aircraft context used for decoding
	DebugLogs       []string                // Debug log lines from the decode
	UserExplanation string                  // User's explanation of the issue
	ReportTime      time.Time

	// GPU and performance information
	GPUInfo           whisper.GPUInfo // GPU acceleration status and devices
	WhisperModelName  string          // Name of the whisper model being used
	RecentDurations   []time.Duration // Recent whisper transcription durations
	IsSlowPerformance bool            // True if this is an automatic slow performance report
}

type STTLogArgs struct {
	Callsign          string
	Commands          string
	WhisperDuration   time.Duration
	AudioDuration     time.Duration
	WhisperTranscript string
	WhisperProcessor  string
	WhisperModel      string
	AircraftContext   map[string]stt.Aircraft
	STTDebugLogs      []string
}

type ScenarioCatalog struct {
	Scenarios        map[string]*ScenarioSpec
	ControlPositions map[sim.TCP]*av.Controller
	DefaultScenario  string
	Facility         string
	ARTCC            string
	Area             string
	Airports         []string // ICAO codes of airports in this scenario group
}

type ScenarioSpec struct {
	ControllerConfiguration *sim.ControllerConfiguration
	PrimaryAirport          string
	MagneticVariation       float32
	WindSpecifier           *wx.WindSpecifier

	LaunchConfig sim.LaunchConfig

	DepartureRunways []sim.DepartureRunway
	ArrivalRunways   []sim.ArrivalRunway
}

type SendRouteCoordinatesArgs struct {
	ControllerToken string
	ACID            sim.ACID
	Minutes         int
}

type ServerLaunchConfig struct {
	Port          int // if 0, finds an open one
	ExtraScenario string
	ExtraVideoMap string
	ServerAddress string // address to use for remote TTS provider
	IsLocal       bool
}

type SetLaunchConfigArgs struct {
	ControllerToken string
	Config          sim.LaunchConfig
}

type SetSimRateArgs struct {
	ControllerToken string
	Rate            float32
}

type SetWaypointCommandsArgs struct {
	ControllerToken string
	Commands        string
}

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

type SimState struct {
	sim.UserState

	// User-related items not managed by the Sim.
	UserTCW                             sim.TCW
	ActiveTCWs                          []sim.TCW
	ControllerVideoMaps                 []string
	ControllerDefaultVideoMaps          []string
	ControllerMonitoredBeaconCodeBlocks []av.Squawk

	UserIsPrivileged bool // Whether this user has elevated privileges (can control any aircraft)
}

type SimStateUpdate struct {
	sim.StateUpdate

	ActiveTCWs []sim.TCW
	Events     []sim.Event
}

type TCPConsolidation struct {
	sim.TCPConsolidation
	Initials []string // Server-layer addition: initials of signed-in controllers
}

type TTSRequest struct {
	Voice    sim.Voice
	Text     string
	ClientIP string // Automatically populated by util.LoggingServerCodec
}

type TriggerEmergencyArgs struct {
	ControllerToken string
	EmergencyName   string
}

type VideoMapsArgs struct {
	Filename string
}

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

type WhisperBenchmarkReport struct {
	DeviceName    string // GPU/device description from whisper.ProcessorDescription()
	SelectedModel string
	Results       []WhisperBenchmarkResult
}

type WhisperBenchmarkResult struct {
	ModelName string
	LatencyMs int64
	Status    string // "selected", "acceptable", "too_slow", "failed", "skipped"
}