stt

type Aircraft struct {
	Callsign                  string
	AircraftType              string                       `json:",omitempty"` // Aircraft type code (e.g., "C172", "BE36")
	Fixes                     map[string]string            `json:",omitempty"` // spoken name -> fix ID
	CandidateApproaches       map[string]string            `json:",omitempty"` // canonical name ("RNAV Z Runway 28R") -> approach ID
	CandidateVisualApproaches map[string]string            `json:",omitempty"` // spoken name -> runway ID for active plain visual approaches
	ApproachFixes             map[string]map[string]string `json:",omitempty"` // approach ID -> (spoken name -> fix ID)
	AssignedApproach          string                       `json:",omitempty"`
	ExpectedDirectFix         string                       `json:",omitempty"` // Fix the controller said to "expect direct" (if any)
	SID                       string                       `json:",omitempty"`
	STAR                      string                       `json:",omitempty"`
	Route                     []string                     `json:",omitempty"` // Ordered route waypoint fix names (full route, no truncation)
	Altitude                  int                          `json:",omitempty"` // Current altitude in feet
	Heading                   int                          `json:",omitempty"` // Current magnetic heading in degrees (0 if unknown)
	Speed                     int                          `json:",omitempty"` // Current groundspeed in knots (0 if unknown)
	AssignedAltitude          int                          `json:",omitempty"` // Controller-assigned altitude in feet (0 if none)
	AssignedHeading           int                          `json:",omitempty"` // Controller-assigned heading in degrees (0 if none)
	AssignedSpeed             int                          `json:",omitempty"` // Controller-assigned speed in knots (0 if none, or if assigned in mach)
	AssignedMach              int                          `json:",omitempty"` // Controller-assigned mach in hundredths, e.g. 78 for M0.78 (0 if none, or if assigned in knots)
	State                     string                       `json:",omitempty"` // "departure", "arrival", "cleared approach", "overflight", "vfr flight following"
	ControllerFrequency       string                       `json:",omitempty"` // Current controller position the aircraft is tuned to
	TrackingController        string                       `json:",omitempty"` // Controller tracking this aircraft (from flight plan)
	AddressingForm            sim.CallsignAddressingForm   `json:",omitempty"` // How this aircraft was addressed (based on which key matched)
	LAHSORunways              []string                     `json:",omitempty"` // Runways that intersect the approach runway (for LAHSO matching)
}

type CallsignMatch struct {
	Callsign       string                     // The matched ICAO callsign (e.g., "AAL5936")
	SpokenKey      string                     // The key in the aircraft context map
	Confidence     float64                    // Match confidence (0.0-1.0)
	Consumed       int                        // Number of tokens consumed for the callsign
	AddressingForm sim.CallsignAddressingForm // How the callsign was addressed (full vs type+trailing3)
}

type CallsignPattern struct {
	Name            string                                    // Human-readable name for debugging
	Template        string                                    // Original template string
	Priority        int                                       // Higher priority patterns are tried first
	Matchers        []callsignMatcher                         // Parsed from template
	MinScore        float64                                   // Minimum score to accept a match
	FixedConfidence float64                                   // If > 0, use this confidence instead of computed
	ScoringFunc     func(result *callsignMatchResult) float64 // Custom scoring function
	Condition       func(Aircraft) bool                       // Pre-filter aircraft (returns true to include)
	RequireUnique   bool                                      // Only accept if exactly one aircraft matches
}

type CallsignPatternOption func(*CallsignPattern)

type CandidateApproach struct {
	Id       string
	FullName string
	Spoken   string
}

type CommandMatch struct {
	Command    string      // The output command string
	Name       string      // Matched template's name, for logging
	Confidence float64     // Per-token match score
	Score      float64     // Coverage-adjusted score used to rank competing matches
	Kind       commandKind // What kind of segment this template matched
	Consumed   int         // Tokens consumed
	IsThen     bool        // Whether this is a "then" sequenced command
	IsSayAgain bool        // True if this is a partial match that needs say-again
}

type CommandOption func(*sttCommand)

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

type NumberCandidate struct {
	Value    int
	Consumed int // tokens consumed starting at the decode position
	Score    float64
}

type NumberContext struct {
	Kind NumberKind
	AC   Aircraft
	// AllowFlightLevel permits altitude values in 100-400 (which would
	// otherwise be reserved for speeds) when decoding in explicit
	// climb/descend context.
	AllowFlightLevel bool
}

type NumberKind int

type ParseResult struct {
	Callsign       string
	Commands       []string
	Confidence     float64
	CallsignConf   float64
	CommandConf    float64
	ValidationConf float64
	Errors         []string
}

type ReviewState struct {
	Queue []TestFile      `json:"queue"`
	Seen  map[string]bool `json:"seen"`
}

type TestFile struct {
	Time              string              `json:"time,omitempty"`
	Level             string              `json:"level,omitempty"`
	Msg               string              `json:"msg"`
	Callstack         []string            `json:"callstack,omitempty"`
	Transcript        string              `json:"transcript"`
	WhisperPrompt     string              `json:"whisper_prompt,omitempty"`
	WhisperDurationMs float64             `json:"whisper_duration_ms,omitempty"`
	Duration          int64               `json:"duration,omitempty"`
	AudioDurationMs   float64             `json:"audio_duration_ms,omitempty"`
	Processor         string              `json:"processor,omitempty"`
	WhisperModel      string              `json:"whisper_model,omitempty"`
	Callsign          string              `json:"callsign"`
	Command           string              `json:"command"`
	Suggested         string              `json:"suggested,omitempty"` // reviewer-prefill correction, if any
	Reason            string              `json:"reason,omitempty"`    // why the entry is a suspect / the suggestion (review note)
	STTAircraft       map[string]Aircraft `json:"stt_aircraft"`
	Logs              []string            `json:"logs,omitempty"`
}

type Token struct {
	Original string    // Original text from STT (before normalization)
	Text     string    // Normalized text
	Type     TokenType // Token type
	Value    int       // Numeric value if applicable (-1 if not)
}

type TokenType int

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

type ValidationResult struct {
	ValidCommands []string // Commands that passed validation
	Confidence    float64  // Adjusted confidence based on validation
	Errors        []string // Validation error messages (for debugging)
}