mcpserver

package
v0.1.36 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 31, 2026 License: MIT Imports: 26 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Handler

func Handler(
	deps Dependencies,
	version string,
	logger *slog.Logger,
) (http.Handler, error)

func NewServer

func NewServer(
	deps Dependencies,
	version string,
	api huma.API,
) (*sdkmcp.Server, error)

Types

type AllianceNode

type AllianceNode struct {
	AllianceID int64   `json:"alliance_id"`
	Name       *string `json:"name"`
	Ticker     *string `json:"ticker"`
}

type BattleAllianceSummary

type BattleAllianceSummary struct {
	AllianceID   int64   `json:"alliance_id"`
	Name         *string `json:"name"`
	Ticker       *string `json:"ticker"`
	ISKDestroyed float64 `json:"isk_destroyed"`
	Kills        int64   `json:"kills"`
	Losses       int64   `json:"losses"`
}

type BattleMember

type BattleMember struct {
	CorporationID     *int64  `json:"corporation_id,omitempty"`
	CorporationName   *string `json:"corporation_name,omitempty"`
	CorporationTicker *string `json:"corporation_ticker,omitempty"`
	AllianceID        *int64  `json:"alliance_id"`
	AllianceName      *string `json:"alliance_name,omitempty"`
	AllianceTicker    *string `json:"alliance_ticker,omitempty"`
	CorporationCount  int     `json:"corporation_count,omitempty"`
	Kills             int64   `json:"kills"`
	Losses            int64   `json:"losses"`
	ISKDestroyed      float64 `json:"isk_destroyed"`
	ISKLost           float64 `json:"isk_lost"`
}

type BattleReportInput

type BattleReportInput struct {
	BattleID int64  `json:"battle_id" minimum:"1"`
	Level    string `json:"level,omitempty" enum:"alliance,corp" default:"alliance"`
	Format   string `json:"format,omitempty" enum:"json,summary" default:"json"`
}

type BattleReportOutput

type BattleReportOutput struct {
	BattleID          int64                `json:"battle_id"`
	URL               string               `json:"url"`
	Summary           string               `json:"summary,omitempty"`
	StartTime         *time.Time           `json:"start_time,omitempty"`
	EndTime           *time.Time           `json:"end_time,omitempty"`
	DurationMinutes   int64                `json:"duration_minutes,omitempty"`
	KillCount         int64                `json:"kill_count,omitempty"`
	TotalISKDestroyed float64              `json:"total_isk_destroyed,omitempty"`
	IsMultiParty      bool                 `json:"is_multi_party,omitempty"`
	IsCustom          bool                 `json:"is_custom,omitempty"`
	Level             string               `json:"level,omitempty"`
	System            *BattleSystemSummary `json:"system,omitempty"`
	Teams             []BattleTeam         `json:"teams,omitempty"`
}

type BattleSystemSummary

type BattleSystemSummary struct {
	ID         int64   `json:"id"`
	Name       *string `json:"name"`
	RegionID   *int64  `json:"region_id"`
	RegionName *string `json:"region_name"`
}

type BattleTeam

type BattleTeam struct {
	TeamIndex         int            `json:"team_index"`
	TotalKills        int64          `json:"total_kills"`
	TotalLosses       int64          `json:"total_losses"`
	TotalISKDestroyed float64        `json:"total_isk_destroyed"`
	TotalISKLost      float64        `json:"total_isk_lost"`
	Members           []BattleMember `json:"members"`
}

type BattleTeamSummary

type BattleTeamSummary struct {
	TeamIndex     int                     `json:"team_index"`
	TopAlliances  []BattleAllianceSummary `json:"top_alliances"`
	AllianceCount int                     `json:"alliance_count"`
}

type BattleTopAlliance

type BattleTopAlliance struct {
	AllianceID int64   `json:"alliance_id"`
	Name       *string `json:"name"`
	Ticker     *string `json:"ticker"`
}

type CapDiff

type CapDiff struct {
	A *string `json:"a"`
	B *string `json:"b"`
}

type CharacterHistoryInput

type CharacterHistoryInput struct {
	Entity StringOrInt64 `json:"entity" doc:"Character name or id."`
	Since  *string       `json:"since,omitempty" doc:"ISO datetime lower bound. Default all history."`
}

type CharacterHistoryOutput

type CharacterHistoryOutput struct {
	Character        CharacterRef       `json:"character"`
	ObservationCount int                `json:"observation_count"`
	PeriodCount      int                `json:"period_count"`
	Periods          []MembershipPeriod `json:"periods"`
	Notes            string             `json:"notes,omitempty"`
}

type CharacterIntelInput

type CharacterIntelInput struct {
	Entity StringOrInt64 `json:"entity" doc:"Character name or id."`
	Type   *EntityType   `json:"type,omitempty" enum:"character" doc:"Must be character if specified."`
	Limit  int           `json:"limit,omitempty" default:"15" minimum:"1" maximum:"50"`
}

type CharacterIntelOutput

type CharacterIntelOutput struct {
	Entity     Entity           `json:"entity"`
	WindowDays int              `json:"window_days"`
	Count      int              `json:"count"`
	Characters []IntelCharacter `json:"characters"`
}

type CharacterRef

type CharacterRef struct {
	ID   int64  `json:"id"`
	Name string `json:"name"`
	URL  string `json:"url"`
}

type CoalitionEdge

type CoalitionEdge struct {
	A             AllianceNode `json:"a"`
	B             AllianceNode `json:"b"`
	AlliedBattles int64        `json:"allied_battles"`
	EnemyBattles  int64        `json:"enemy_battles"`
	TotalBattles  int64        `json:"total_battles"`
}

type CoalitionFocus

type CoalitionFocus struct {
	AllianceID int64   `json:"alliance_id"`
	Name       *string `json:"name"`
}

type CoalitionGraphInput

type CoalitionGraphInput struct {
	Since              *string        `json:"since,omitempty" doc:"ISO datetime lower bound. Default 30 days ago."`
	Until              *string        `json:"until,omitempty" doc:"ISO datetime upper bound. Default now."`
	MinEdgeWeight      int            `json:"min_edge_weight,omitempty" default:"3" minimum:"1"`
	MinAllianceBattles int            `json:"min_alliance_battles,omitempty" default:"5" minimum:"1"`
	FocusAlliance      *StringOrInt64 `json:"focus_alliance,omitempty" doc:"Alliance name or id for an ego graph."`
	LimitEdges         int            `json:"limit_edges,omitempty" default:"100" minimum:"1" maximum:"500"`
}

type CoalitionGraphOutput

type CoalitionGraphOutput struct {
	Window      TimeWindow      `json:"window"`
	Focus       *CoalitionFocus `json:"focus,omitempty"`
	NodeCount   int             `json:"node_count"`
	EdgeCount   int             `json:"edge_count"`
	AlliedEdges []CoalitionEdge `json:"allied_edges"`
	EnemyEdges  []CoalitionEdge `json:"enemy_edges"`
	MixedEdges  []CoalitionEdge `json:"mixed_edges"`
	Nodes       []AllianceNode  `json:"nodes"`
}

type CompareInput

type CompareInput struct {
	A StringOrInt64 `json:"a" doc:"First character name or id."`
	B StringOrInt64 `json:"b" doc:"Second character name or id."`
}

type CompareOutput

type CompareOutput struct {
	A               Entity         `json:"a"`
	B               Entity         `json:"b"`
	WindowDays      int            `json:"window_days"`
	AKilledB        HeadToHead     `json:"a_killed_b"`
	BKilledA        HeadToHead     `json:"b_killed_a"`
	SharedWingmates int64          `json:"shared_wingmates"`
	SharedSystems   []SharedSystem `json:"shared_systems"`
}

type ContestedSystem

type ContestedSystem struct {
	SolarSystemID int64   `json:"solar_system_id"`
	SystemName    *string `json:"system_name"`
	AKillsB       int64   `json:"a_kills_b"`
	BKillsA       int64   `json:"b_kills_a"`
	TotalKills    int64   `json:"total_kills"`
	TotalISK      float64 `json:"total_isk"`
}

type Database

type Database interface {
	Query(context.Context, string, ...any) (pgx.Rows, error)
	QueryRow(context.Context, string, ...any) pgx.Row
}

Database is the read-only Postgres surface used by MCP tools.

type Dependencies

type Dependencies struct {
	DB      Database
	Graph   GraphDatabase
	BaseURL string
}

Dependencies are shared by the MCP and Huma transports.

type DoctrineCluster

type DoctrineCluster struct {
	FamilyHash     string          `json:"family_hash"`
	Ship           DoctrineShip    `json:"ship"`
	Signature      string          `json:"signature,omitempty"`
	Losses         int64           `json:"losses"`
	ISKLost        float64         `json:"isk_lost"`
	AverageISKLoss float64         `json:"avg_isk_per_loss"`
	Example        DoctrineExample `json:"example_killmail"`
	FirstLoss      *time.Time      `json:"first_loss,omitempty"`
	LastLoss       *time.Time      `json:"last_loss,omitempty"`
}

type DoctrineDetectInput

type DoctrineDetectInput struct {
	Entity             StringOrInt64 `json:"entity"`
	Type               *EntityType   `json:"type,omitempty" enum:"character,corporation,alliance"`
	Since              *string       `json:"since,omitempty"`
	Until              *string       `json:"until,omitempty"`
	MinClusterSize     int           `json:"min_cluster_size,omitempty" default:"5" minimum:"2"`
	IncludeRookieShips bool          `json:"include_rookie_ships,omitempty" default:"false"`
	Limit              int           `json:"limit,omitempty" default:"10" minimum:"1" maximum:"30"`
}

type DoctrineDetectOutput

type DoctrineDetectOutput struct {
	Entity   Entity            `json:"entity"`
	Window   TimeWindow        `json:"window"`
	Count    int               `json:"count"`
	Clusters []DoctrineCluster `json:"clusters"`
	Notes    string            `json:"notes,omitempty"`
}

type DoctrineExample

type DoctrineExample struct {
	KillmailID int64    `json:"killmail_id"`
	URL        string   `json:"url"`
	Modules    []string `json:"modules,omitempty"`
}

type DoctrineShip

type DoctrineShip struct {
	TypeID int64   `json:"type_id"`
	Name   *string `json:"name"`
	Group  *string `json:"group,omitempty"`
}

type DogmaDroneInput

type DogmaDroneInput struct {
	TypeID   int64 `json:"type_id"`
	Quantity int   `json:"quantity,omitempty" default:"1" minimum:"1"`
}

type DogmaEvalInput

type DogmaEvalInput struct {
	DogmaFitInput
	Skills string `json:"skills,omitempty" enum:"all_v,none" default:"all_v"`
}

type DogmaEvalOutput

type DogmaEvalOutput struct {
	Ship        DogmaShip      `json:"ship"`
	ModuleCount int            `json:"module_count"`
	DroneCount  int            `json:"drone_count"`
	Skills      string         `json:"skills"`
	Stats       HullDisplay    `json:"stats"`
	Fitting     FittingDisplay `json:"fitting"`
	DPSNote     string         `json:"dps_note,omitempty"`
	Source      string         `json:"source"`
	KillmailID  *int64         `json:"killmail_id,omitempty"`
	FitHash     *string        `json:"fit_hash,omitempty"`
}

type DogmaFitInput

type DogmaFitInput struct {
	KillmailID *int64             `json:"killmail_id,omitempty"`
	FitHash    *string            `json:"fit_hash,omitempty"`
	EFT        *string            `json:"eft,omitempty"`
	ShipTypeID *int64             `json:"ship_type_id,omitempty"`
	Modules    []DogmaModuleInput `json:"modules,omitempty"`
	Drones     []DogmaDroneInput  `json:"drones,omitempty"`
}

type DogmaModuleInput

type DogmaModuleInput struct {
	TypeID       int64  `json:"type_id"`
	Slot         string `json:"slot" enum:"high,med,low,rig,subsystem"`
	Index        *int   `json:"index,omitempty" minimum:"0"`
	ChargeTypeID *int64 `json:"charge_type_id,omitempty"`
}

type DogmaShip

type DogmaShip struct {
	TypeID int64   `json:"type_id"`
	Name   *string `json:"name"`
}

type DossierArchetypeLastSeen

type DossierArchetypeLastSeen struct {
	LastFCSeen      *string `json:"last_fc_seen"`
	LastSuperKill   *string `json:"last_super_kill"`
	LastBlopsSeen   *string `json:"last_blops_seen"`
	LastCapitalKill *string `json:"last_capital_kill"`
	LastLogiSeen    *string `json:"last_logi_seen"`
}

type DossierInput

type DossierInput struct {
	Entity StringOrInt64 `json:"entity" doc:"Character name or id."`
	Type   *EntityType   `json:"type,omitempty" enum:"character"`
	Format string        `json:"format,omitempty" enum:"json,summary" default:"json"`
}

type DossierOutput

type DossierOutput struct {
	Entity            Entity                    `json:"entity"`
	Summary           string                    `json:"summary,omitempty"`
	Lifetime          *EntityLifetime           `json:"lifetime,omitempty"`
	ArchetypeTags     []string                  `json:"archetype_tags,omitempty"`
	ArchetypeLastSeen *DossierArchetypeLastSeen `json:"archetype_last_seen,omitempty"`
	Playstyle90D      *DossierPlaystyle         `json:"playstyle_90d,omitempty"`
	TopShips          []DossierTopShip          `json:"top_ships,omitempty"`
	TopSystems        []DossierTopSystem        `json:"top_systems,omitempty"`
	TopWingmates      []DossierWingmate         `json:"top_wingmates,omitempty"`
}

type DossierPlaystyle

type DossierPlaystyle struct {
	Dominant      string  `json:"dominant"`
	SoloPct       int     `json:"solo_pct"`
	SmallGangPct  int     `json:"small_gang_pct"`
	MidGangPct    int     `json:"mid_gang_pct"`
	FleetPct      int     `json:"fleet_pct"`
	BlobPct       int     `json:"blob_pct"`
	AvgFleetSize  float64 `json:"avg_fleet_size"`
	TotalKills90D int64   `json:"total_kills_90d"`
}

type DossierTopShip

type DossierTopShip struct {
	TypeID int64   `json:"type_id"`
	Name   *string `json:"name"`
	Kills  int64   `json:"kills"`
}

type DossierTopSystem

type DossierTopSystem struct {
	SystemID int64   `json:"system_id"`
	Name     *string `json:"name"`
	Kills    int64   `json:"kills"`
}

type DossierWingmate

type DossierWingmate struct {
	CharacterID int64   `json:"character_id"`
	Name        *string `json:"name"`
	SharedKills int64   `json:"shared_kills"`
	URL         string  `json:"url"`
}

type Entity

type Entity struct {
	ID     int64      `json:"id"`
	Name   string     `json:"name"`
	Type   EntityType `json:"type"`
	Ticker *string    `json:"ticker"`
	URL    string     `json:"url"`
}

type EntityBreakdown

type EntityBreakdown struct {
	ID           int64   `json:"id"`
	Name         *string `json:"name"`
	Kills        int64   `json:"kills"`
	Losses       int64   `json:"losses"`
	ISKDestroyed float64 `json:"isk_destroyed"`
	ISKLost      float64 `json:"isk_lost"`
}

type EntityKillsInput

type EntityKillsInput struct {
	Entity StringOrInt64 `json:"entity" jsonschema:"Entity name or numeric identifier."`
	Type   *EntityType   `` /* 175-byte string literal not displayed */
	Role   string        `json:"role,omitempty" enum:"kills,losses,all" default:"all" jsonschema:"Return kills made, losses suffered, or both."`
	Limit  int           `json:"limit,omitempty" minimum:"1" maximum:"50" default:"20" jsonschema:"Maximum number of killmails."`
	Before *int64        `json:"before,omitempty" jsonschema:"Return killmails older than this identifier."`
	From   *string       `json:"from,omitempty" jsonschema:"Inclusive ISO date or timestamp lower bound."`
	To     *string       `json:"to,omitempty" jsonschema:"Exclusive ISO date or timestamp upper bound."`
}

type EntityKillsOutput

type EntityKillsOutput struct {
	Entity     Entity            `json:"entity"`
	Count      *int              `json:"count,omitempty"`
	NextBefore *int64            `json:"next_before"`
	Kills      []KillmailSummary `json:"kills"`
}

type EntityLifetime

type EntityLifetime struct {
	Kills         int64      `json:"kills"`
	Losses        int64      `json:"losses"`
	SoloKills     int64      `json:"solo_kills"`
	SoloLosses    int64      `json:"solo_losses"`
	NPCLosses     int64      `json:"npc_losses"`
	FinalBlows    int64      `json:"final_blows"`
	Points        int64      `json:"points"`
	ISKDestroyed  float64    `json:"isk_destroyed"`
	ISKLost       float64    `json:"isk_lost"`
	ISKEfficiency float64    `json:"isk_efficiency"`
	FirstSeenYear *time.Time `json:"first_seen_year"`
	LastSeenYear  *time.Time `json:"last_seen_year"`
}

type EntityOverviewInput

type EntityOverviewInput struct {
	Entity StringOrInt64 `json:"entity" jsonschema:"Entity name or numeric identifier."`
	Type   *EntityType   `` /* 167-byte string literal not displayed */
	Format string        `json:"format,omitempty" enum:"json,summary" default:"json" jsonschema:"Use summary for a concise narrative response."`
}

type EntityOverviewOutput

type EntityOverviewOutput struct {
	Entity        Entity            `json:"entity"`
	Lifetime      *EntityLifetime   `json:"lifetime,omitempty"`
	TopShipsFlown []EntityBreakdown `json:"top_ships_flown,omitempty"`
	TopShipsLost  []EntityBreakdown `json:"top_ships_lost,omitempty"`
	TopSystems    []EntityBreakdown `json:"top_systems,omitempty"`
	TopRegions    []EntityBreakdown `json:"top_regions,omitempty"`
	TopTormentors []EntityBreakdown `json:"top_tormentors,omitempty"`
	TopPrey       []EntityBreakdown `json:"top_prey,omitempty"`
	Summary       string            `json:"summary,omitempty"`
}

type EntityTimelineInput

type EntityTimelineInput struct {
	Entity StringOrInt64  `json:"entity"`
	Type   *EntityType    `json:"type,omitempty" enum:"character,corporation,alliance,ship,system,constellation,region"`
	Bucket string         `json:"bucket,omitempty" enum:"day,month,year" default:"month"`
	Since  *string        `json:"since,omitempty"`
	Until  *string        `json:"until,omitempty"`
	VS     *StringOrInt64 `json:"vs,omitempty" doc:"Opponent character, corporation, or alliance."`
}

type EntityTimelineOutput

type EntityTimelineOutput struct {
	Entity  Entity           `json:"entity"`
	VS      *Entity          `json:"vs,omitempty"`
	Bucket  string           `json:"bucket"`
	Window  TimelineWindow   `json:"window"`
	Count   int              `json:"count"`
	Buckets []TimelineBucket `json:"buckets"`
}

type EntityTopInput

type EntityTopInput struct {
	Entity    StringOrInt64  `json:"entity"`
	Type      *EntityType    `json:"type,omitempty" enum:"character,corporation,alliance"`
	Dimension string         `` /* 144-byte string literal not displayed */
	SortBy    string         `json:"sort_by,omitempty" enum:"kills,losses,isk_destroyed,isk_lost" default:"kills"`
	Since     *string        `json:"since,omitempty"`
	Until     *string        `json:"until,omitempty"`
	VS        *StringOrInt64 `json:"vs,omitempty" doc:"Opponent character, corporation, or alliance."`
	Limit     int            `json:"limit,omitempty" default:"10" minimum:"1" maximum:"50"`
}

type EntityTopOutput

type EntityTopOutput struct {
	Entity    Entity            `json:"entity"`
	VS        *Entity           `json:"vs,omitempty"`
	Dimension string            `json:"dimension"`
	SortBy    string            `json:"sort_by"`
	Window    StatsWindow       `json:"window"`
	Count     int               `json:"count"`
	Rows      []EntityBreakdown `json:"rows"`
	Warnings  []string          `json:"warnings,omitempty"`
}

type EntityType

type EntityType string
const (
	EntityCharacter     EntityType = "character"
	EntityCorporation   EntityType = "corporation"
	EntityAlliance      EntityType = "alliance"
	EntityShip          EntityType = "ship"
	EntityItem          EntityType = "item"
	EntitySystem        EntityType = "system"
	EntityRegion        EntityType = "region"
	EntityConstellation EntityType = "constellation"
	EntityFaction       EntityType = "faction"
)

type EsfCharge

type EsfCharge struct {
	TypeID int64 `json:"type_id"`
}

type EsfDrone

type EsfDrone struct {
	TypeID int64  `json:"type_id"`
	State  string `json:"state"`
}

type EsfFit

type EsfFit struct {
	ShipTypeID int64       `json:"ship_type_id"`
	Modules    []EsfModule `json:"modules"`
	Drones     []EsfDrone  `json:"drones"`
}

type EsfModule

type EsfModule struct {
	TypeID int64      `json:"type_id"`
	Slot   EsfSlot    `json:"slot"`
	State  string     `json:"state"`
	Charge *EsfCharge `json:"charge,omitempty"`
}

type EsfSlot

type EsfSlot struct {
	Type  string `json:"type"`
	Index int    `json:"index"`
}

type ExpensiveLoss

type ExpensiveLoss struct {
	KillmailID int64          `json:"killmail_id"`
	URL        string         `json:"url"`
	Time       *time.Time     `json:"time"`
	TotalValue float64        `json:"total_value"`
	System     LossSystem     `json:"system"`
	VictimShip LossShip       `json:"victim_ship"`
	Victim     KillmailVictim `json:"victim"`
}

type ExpensiveLossesInput

type ExpensiveLossesInput struct {
	Days              int            `json:"days,omitempty" default:"30" minimum:"1" maximum:"365"`
	RegionID          *int64         `json:"region_id,omitempty"`
	SystemID          *int64         `json:"system_id,omitempty"`
	ShipTypeID        *int64         `json:"ship_type_id,omitempty"`
	VictimAllianceID  *int64         `json:"victim_alliance_id,omitempty"`
	VictimCharacterID *int64         `json:"victim_character_id,omitempty"`
	VS                *StringOrInt64 `json:"vs,omitempty" doc:"Character, corporation, or alliance present as attacker."`
	MinValue          *float64       `json:"min_value,omitempty"`
	Limit             int            `json:"limit,omitempty" default:"20" minimum:"1" maximum:"50"`
}

type ExpensiveLossesOutput

type ExpensiveLossesOutput struct {
	WindowDays int             `json:"window_days"`
	Count      int             `json:"count"`
	Kills      []ExpensiveLoss `json:"kills"`
}

type FindBattlesInput

type FindBattlesInput struct {
	RegionID     *int64          `json:"region_id,omitempty"`
	SystemID     *int64          `json:"system_id,omitempty"`
	MinKills     *int64          `json:"min_kills,omitempty" minimum:"1"`
	MinISK       *float64        `json:"min_isk,omitempty"`
	Since        *string         `json:"since,omitempty"`
	Until        *string         `json:"until,omitempty"`
	Participants []StringOrInt64 `json:"participants,omitempty" maxItems:"6"`
	Opposing     bool            `json:"opposing,omitempty" default:"false"`
	Sort         string          `json:"sort,omitempty" enum:"isk,kills,recent,intensity" default:"isk"`
	Limit        int             `json:"limit,omitempty" default:"20" minimum:"1" maximum:"50"`
}

type FindBattlesOutput

type FindBattlesOutput struct {
	Count                int                   `json:"count"`
	Battles              []FoundBattle         `json:"battles"`
	ParticipantsResolved []ResolvedParticipant `json:"participants_resolved,omitempty"`
	OpposingRequired     bool                  `json:"opposing_required,omitempty"`
}

type FitCompareInput

type FitCompareInput struct {
	A      DogmaFitInput `json:"a"`
	B      DogmaFitInput `json:"b"`
	Skills string        `json:"skills,omitempty" enum:"all_v,none" default:"all_v"`
}

type FitCompareOutput

type FitCompareOutput struct {
	A      FitComparisonSide `json:"a"`
	B      FitComparisonSide `json:"b"`
	Diff   FitDiff           `json:"diff"`
	Skills string            `json:"skills"`
}

type FitComparisonSide

type FitComparisonSide struct {
	Ship    DogmaShip   `json:"ship"`
	Stats   HullDisplay `json:"stats"`
	DPSNote string      `json:"dps_note,omitempty"`
}

type FitDiff

type FitDiff struct {
	DPS              *NumericDiff `json:"dps"`
	Alpha            *NumericDiff `json:"alpha"`
	EHP              *NumericDiff `json:"ehp"`
	EHPShield        *NumericDiff `json:"ehp_shield"`
	EHPArmor         *NumericDiff `json:"ehp_armor"`
	EHPHull          *NumericDiff `json:"ehp_hull"`
	AlignTimeSeconds *NumericDiff `json:"align_time_s"`
	MaxVelocityMS    *NumericDiff `json:"max_velocity_ms"`
	SignatureRadiusM *NumericDiff `json:"signature_radius_m"`
	Cap              CapDiff      `json:"cap"`
}

type FittingDisplay

type FittingDisplay struct {
	Powergrid   *float64 `json:"powergrid"`
	CPU         *float64 `json:"cpu"`
	Calibration *float64 `json:"calibration"`
}

type FittingItem

type FittingItem struct {
	TypeID   int64        `json:"type_id"`
	Name     *string      `json:"name"`
	Quantity int64        `json:"quantity"`
	Charge   *FittingType `json:"charge,omitempty"`
}

type FittingSlot

type FittingSlot struct {
	Slot  string        `json:"slot"`
	Items []FittingItem `json:"items"`
}

type FittingType

type FittingType struct {
	TypeID int64   `json:"type_id"`
	Name   *string `json:"name"`
}

type FittingVictim

type FittingVictim struct {
	CharacterID   *int64  `json:"character_id"`
	CharacterName *string `json:"character_name"`
}

type FliesWithOutput

type FliesWithOutput struct {
	Entity     Entity         `json:"entity"`
	WindowDays int            `json:"window_days"`
	Count      int            `json:"count"`
	Partners   []IntelPartner `json:"partners"`
}

type ForensicsEvidence

type ForensicsEvidence struct {
	AttackerCount    *int64   `json:"attacker_count,omitempty"`
	TypicalThreshold *int     `json:"typical_threshold,omitempty"`
	HullClass        *string  `json:"hull_class,omitempty"`
	CapTimeSeconds   *int64   `json:"cap_time_s,omitempty"`
	CapStable        *bool    `json:"cap_stable,omitempty"`
	ActualEHP        *int64   `json:"actual_ehp,omitempty"`
	TypicalEHP       *int64   `json:"typical_ehp,omitempty"`
	AlignTimeSeconds *float64 `json:"align_time_s,omitempty"`
	FamilyHash       *string  `json:"family_hash,omitempty"`
	TopFamilyCount   *int     `json:"top_family_count,omitempty"`
}

type ForensicsFinding

type ForensicsFinding struct {
	Code     string            `json:"code"`
	Severity string            `json:"severity" enum:"info,warn,critical"`
	Message  string            `json:"message"`
	Evidence ForensicsEvidence `json:"evidence"`
}

type ForensicsShip

type ForensicsShip struct {
	TypeID int64   `json:"type_id"`
	Name   *string `json:"name"`
	Group  *string `json:"group"`
}

type ForensicsSystem

type ForensicsSystem struct {
	ID       int64    `json:"id"`
	Name     *string  `json:"name"`
	Security *float64 `json:"security"`
}

type FoundBattle

type FoundBattle struct {
	BattleID              int64               `json:"battle_id"`
	URL                   string              `json:"url"`
	StartTime             *time.Time          `json:"start_time"`
	EndTime               *time.Time          `json:"end_time"`
	DurationMinutes       int64               `json:"duration_minutes"`
	KillCount             int64               `json:"kill_count"`
	TotalISKDestroyed     float64             `json:"total_isk_destroyed"`
	IntensityISKPerMinute *float64            `json:"intensity_isk_per_minute"`
	IsMultiParty          bool                `json:"is_multi_party"`
	CorporationsInvolved  *int64              `json:"corporations_involved"`
	AlliancesInvolved     *int64              `json:"alliances_involved"`
	TopAllianceByISK      *BattleTopAlliance  `json:"top_alliance_by_isk"`
	System                BattleSystemSummary `json:"system"`
}

type GlobalPulseAlliance

type GlobalPulseAlliance struct {
	AllianceID    int64   `json:"alliance_id"`
	Name          *string `json:"name"`
	Ticker        *string `json:"ticker"`
	Kills         int64   `json:"kills"`
	SystemsActive int64   `json:"systems_active"`
	URL           string  `json:"url"`
}

type GlobalPulseCorporation

type GlobalPulseCorporation struct {
	CorporationID int64   `json:"corporation_id"`
	Name          *string `json:"name"`
	Ticker        *string `json:"ticker"`
	AllianceID    *int64  `json:"alliance_id"`
	AllianceName  *string `json:"alliance_name"`
	Kills         int64   `json:"kills"`
	URL           string  `json:"url"`
}

type GlobalPulseInput

type GlobalPulseInput struct {
	Hours float64 `json:"hours,omitempty" default:"1" minimum:"0.25" maximum:"24" doc:"Lookback window in hours (max 24)."`
	TopN  int     `json:"top_n,omitempty" default:"10" minimum:"1" maximum:"20" doc:"How many rows in each list."`
}

type GlobalPulseOutput

type GlobalPulseOutput struct {
	WindowHours            float64                  `json:"window_hours"`
	Since                  string                   `json:"since"`
	Totals                 GlobalPulseTotals        `json:"totals"`
	HottestSystems         []GlobalPulseSystem      `json:"hottest_systems"`
	MostActiveAlliances    []GlobalPulseAlliance    `json:"most_active_alliances"`
	MostActiveCorporations []GlobalPulseCorporation `json:"most_active_corporations"`
}

type GlobalPulseSystem

type GlobalPulseSystem struct {
	SolarSystemID int64      `json:"solar_system_id"`
	Name          *string    `json:"name"`
	RegionName    *string    `json:"region_name"`
	Security      *float64   `json:"security"`
	Kills         int64      `json:"kills"`
	ISKDestroyed  float64    `json:"isk_destroyed"`
	LatestKill    *time.Time `json:"latest_kill"`
	URL           string     `json:"url"`
}

type GlobalPulseTotals

type GlobalPulseTotals struct {
	Kills         int64   `json:"kills"`
	ISKDestroyed  float64 `json:"isk_destroyed"`
	SystemsActive int64   `json:"systems_active"`
	SoloKills     int64   `json:"solo_kills"`
}

type GraphDatabase

type GraphDatabase interface {
	Read(context.Context, string, map[string]any) ([]map[string]any, error)
}

GraphDatabase is the read-only Memgraph surface used by intelligence tools.

type HeadToHead

type HeadToHead struct {
	Count        int64    `json:"count"`
	ISKDestroyed *float64 `json:"isk_destroyed,omitempty"`
	FinalBlows   *int64   `json:"final_blows,omitempty"`
	LastSeen     *string  `json:"last_seen,omitempty"`
}

type HullCapacitor

type HullCapacitor struct {
	Capacity  *float64 `json:"capacity"`
	RechargeS *float64 `json:"recharge_s"`
}

type HullCargo

type HullCargo struct {
	Standard   *float64 `json:"standard"`
	SpecialBay *float64 `json:"special_bay"`
}

type HullDifference

type HullDifference struct {
	ShieldHP        *ValueDifference `json:"shield_hp,omitempty"`
	ArmorHP         *ValueDifference `json:"armor_hp,omitempty"`
	HullHP          *ValueDifference `json:"hull_hp,omitempty"`
	MaxVelocityMS   *ValueDifference `json:"max_velocity_ms,omitempty"`
	SignatureRadius *ValueDifference `json:"signature_radius_m,omitempty"`
	Powergrid       *ValueDifference `json:"powergrid,omitempty"`
	CPU             *ValueDifference `json:"cpu,omitempty"`
	MaxTargetRangeM *ValueDifference `json:"max_target_range_m,omitempty"`
}

type HullDisplay

type HullDisplay struct {
	DPSWithReload    *float64 `json:"dps_with_reload"`
	DPSWithoutReload *float64 `json:"dps_without_reload"`
	Alpha            *float64 `json:"alpha"`
	EHP              *float64 `json:"ehp"`
	EHPShield        *float64 `json:"ehp_shield"`
	EHPArmor         *float64 `json:"ehp_armor"`
	EHPHull          *float64 `json:"ehp_hull"`
	CapStable        bool     `json:"cap_stable"`
	CapTimeSeconds   *float64 `json:"cap_time_s"`
	CapCapacityGJ    *float64 `json:"cap_capacity_gj"`
	CapPeakDeltaGJS  *float64 `json:"cap_peak_delta_gj_s"`
	AlignTimeSeconds *float64 `json:"align_time_s"`
	MaxVelocityMS    *float64 `json:"max_velocity_ms"`
	SignatureRadiusM *float64 `json:"signature_radius_m"`
	MaxTargetRangeKM *float64 `json:"max_target_range_km"`
	ScanResolutionMM *float64 `json:"scan_resolution_mm"`
	MaxLockedTargets *int64   `json:"max_locked_targets"`
}

type HullDrones

type HullDrones struct {
	Bay       *float64 `json:"bay"`
	Bandwidth *float64 `json:"bandwidth"`
}

type HullFitting

type HullFitting struct {
	Powergrid   *float64 `json:"powergrid"`
	CPU         *float64 `json:"cpu"`
	Calibration *float64 `json:"calibration"`
}

type HullHP

type HullHP struct {
	Shield *float64 `json:"shield"`
	Armor  *float64 `json:"armor"`
	Hull   *float64 `json:"hull"`
}

type HullMobility

type HullMobility struct {
	Mass             *float64 `json:"mass"`
	MaxVelocityMS    *float64 `json:"max_velocity_ms"`
	SignatureRadiusM *float64 `json:"signature_radius_m"`
	Agility          *float64 `json:"agility"`
}

type HullResists

type HullResists struct {
	Shield ResistLayer `json:"shield"`
	Armor  ResistLayer `json:"armor"`
	Hull   ResistLayer `json:"hull"`
}

type HullSensors

type HullSensors struct {
	MaxTargetRangeM       *float64 `json:"max_target_range_m"`
	ScanResolutionMM      *float64 `json:"scan_resolution_mm"`
	MaxLockedTargets      *int64   `json:"max_locked_targets"`
	LadarStrength         *float64 `json:"ladar_strength"`
	RadarStrength         *float64 `json:"radar_strength"`
	MagnetometricStrength *float64 `json:"magnetometric_strength"`
	GravimetricStrength   *float64 `json:"gravimetric_strength"`
}

type HullSlots

type HullSlots struct {
	High               *int64 `json:"high"`
	Med                *int64 `json:"med"`
	Low                *int64 `json:"low"`
	Rig                *int64 `json:"rig"`
	Subsystem          *int64 `json:"subsystem"`
	TurretHardpoints   *int64 `json:"turret_hardpoints"`
	LauncherHardpoints *int64 `json:"launcher_hardpoints"`
}

type HullStats

type HullStats struct {
	AlignTime        *float64 `json:"align_time"`
	MaxVelocity      *float64 `json:"max_velocity"`
	SignatureRadius  *float64 `json:"signature_radius"`
	Mass             *float64 `json:"mass"`
	EHP              *float64 `json:"ehp"`
	ShieldEHP        *float64 `json:"shield_ehp"`
	ArmorEHP         *float64 `json:"armor_ehp"`
	HullEHP          *float64 `json:"hull_ehp"`
	CapCapacity      *float64 `json:"cap_capacity"`
	CapDepletesIn    *float64 `json:"cap_depletes_in"`
	CapPeakDelta     *float64 `json:"cap_peak_delta"`
	DPSWithReload    *float64 `json:"dps_with_reload"`
	DPSWithoutReload *float64 `json:"dps_without_reload"`
	Alpha            *float64 `json:"alpha"`
	MaxTargetRange   *float64 `json:"max_target_range"`
	ScanResolution   *float64 `json:"scan_resolution"`
	MaxLockedTargets *float64 `json:"max_locked_targets"`
	PGOutput         *float64 `json:"pg_output"`
	CPUOutput        *float64 `json:"cpu_output"`
	Calibration      *float64 `json:"calibration"`
}

type HuntsInOutput

type HuntsInOutput struct {
	Entity     Entity        `json:"entity"`
	WindowDays int           `json:"window_days"`
	Count      int           `json:"count"`
	Systems    []IntelSystem `json:"systems"`
}

type IDName

type IDName struct {
	ID   *int64  `json:"id"`
	Name *string `json:"name"`
}

type IDNameTicker

type IDNameTicker struct {
	ID     int64   `json:"id"`
	Name   *string `json:"name"`
	Ticker *string `json:"ticker"`
}

type IntelCharacter

type IntelCharacter struct {
	CharacterID     int64   `json:"character_id"`
	CharacterName   *string `json:"character_name"`
	CorporationID   *int64  `json:"corporation_id"`
	CorporationName *string `json:"corporation_name"`
	AllianceID      *int64  `json:"alliance_id"`
	AllianceName    *string `json:"alliance_name"`
	Count           int64   `json:"count"`
	ISKDestroyed    float64 `json:"isk_destroyed"`
	FinalBlows      int64   `json:"final_blows"`
	LastSeen        *string `json:"last_seen"`
	URL             string  `json:"url"`
}

type IntelPartner

type IntelPartner struct {
	CharacterID     int64   `json:"character_id"`
	CharacterName   *string `json:"character_name"`
	CorporationID   *int64  `json:"corporation_id"`
	CorporationName *string `json:"corporation_name"`
	AllianceID      *int64  `json:"alliance_id"`
	AllianceName    *string `json:"alliance_name"`
	SharedKills     int64   `json:"shared_kills"`
	FirstSeen       *string `json:"first_seen"`
	LastSeen        *string `json:"last_seen"`
	URL             string  `json:"url"`
}

type IntelSystem

type IntelSystem struct {
	SystemID   int64    `json:"system_id"`
	SystemName *string  `json:"system_name"`
	RegionID   *int64   `json:"region_id"`
	RegionName *string  `json:"region_name"`
	Security   *float64 `json:"security"`
	Kills      int64    `json:"kills"`
	LastSeen   *string  `json:"last_seen"`
	URL        string   `json:"url"`
}

type ItemFitting

type ItemFitting struct {
	CPU         *float64 `json:"cpu"`
	Powergrid   *float64 `json:"powergrid"`
	Calibration *float64 `json:"calibration"`
}

type ItemInfoInput

type ItemInfoInput struct {
	Item StringOrInt64 `json:"item" jsonschema:"Item name or type identifier."`
}

type ItemInfoOutput

type ItemInfoOutput struct {
	TypeID                int64         `json:"type_id"`
	Name                  string        `json:"name"`
	URL                   string        `json:"url"`
	Category              IDName        `json:"category"`
	Group                 IDName        `json:"group"`
	MetaGroup             IDName        `json:"meta_group"`
	VariationParentTypeID *int64        `json:"variation_parent_type_id"`
	Description           *string       `json:"description"`
	Physical              ItemPhysical  `json:"physical"`
	Fitting               ItemFitting   `json:"fitting"`
	CurrentJitaPrice      *float64      `json:"current_jita_price"`
	MarketNote            string        `json:"market_note,omitempty"`
	Variants              []ItemVariant `json:"variants"`
}

type ItemPhysical

type ItemPhysical struct {
	Mass     *float64 `json:"mass"`
	Volume   *float64 `json:"volume"`
	Capacity *float64 `json:"capacity"`
}

type ItemVariant

type ItemVariant struct {
	TypeID    int64   `json:"type_id"`
	Name      string  `json:"name"`
	MetaGroup *string `json:"meta_group"`
}

type KillmailAttacker

type KillmailAttacker struct {
	CharacterID       *int64   `json:"character_id"`
	CharacterName     *string  `json:"character_name"`
	CorporationID     *int64   `json:"corporation_id"`
	CorporationName   *string  `json:"corporation_name"`
	CorporationTicker *string  `json:"corporation_ticker"`
	AllianceID        *int64   `json:"alliance_id"`
	AllianceName      *string  `json:"alliance_name"`
	AllianceTicker    *string  `json:"alliance_ticker"`
	FactionID         *int64   `json:"faction_id"`
	FactionName       *string  `json:"faction_name"`
	ShipTypeID        *int64   `json:"ship_type_id"`
	ShipName          *string  `json:"ship_name"`
	WeaponTypeID      *int64   `json:"weapon_type_id"`
	WeaponName        *string  `json:"weapon_name"`
	DamageDone        int64    `json:"damage_done"`
	FinalBlow         bool     `json:"final_blow"`
	SecurityStatus    *float64 `json:"security_status"`
}

type KillmailFittingInput

type KillmailFittingInput struct {
	KillmailID int64  `json:"killmail_id" minimum:"1" jsonschema:"Numeric killmail identifier."`
	Format     string `json:"format,omitempty" enum:"json,eft" default:"json" jsonschema:"Return structured JSON or an EFT text fit."`
}

type KillmailFittingOutput

type KillmailFittingOutput struct {
	KillmailID  int64          `json:"killmail_id"`
	URL         string         `json:"url"`
	KillTime    *time.Time     `json:"kill_time,omitempty"`
	Ship        FittingType    `json:"ship"`
	Victim      *FittingVictim `json:"victim,omitempty"`
	FitHash     string         `json:"fit_hash"`
	FamilyHash  string         `json:"family_hash"`
	FirstSeenAt *time.Time     `json:"first_seen_at,omitempty"`
	Slots       []FittingSlot  `json:"slots,omitempty"`
	Drones      []FittingItem  `json:"drones,omitempty"`
	TotalValue  *float64       `json:"total_value,omitempty"`
	EFT         string         `json:"eft,omitempty"`
}

type KillmailForensicsOutput

type KillmailForensicsOutput struct {
	KillmailID    int64              `json:"killmail_id"`
	URL           string             `json:"url"`
	KillTime      *time.Time         `json:"kill_time"`
	VictimShip    ForensicsShip      `json:"victim_ship"`
	System        ForensicsSystem    `json:"system"`
	AttackerCount int64              `json:"attacker_count"`
	TotalValue    float64            `json:"total_value"`
	FitHash       *string            `json:"fit_hash"`
	DogmaStats    *HullStats         `json:"dogma_stats"`
	Findings      []ForensicsFinding `json:"findings"`
	FindingCount  int                `json:"finding_count"`
}

type KillmailInput

type KillmailInput struct {
	KillmailID int64 `json:"killmail_id" minimum:"1" jsonschema:"Numeric killmail identifier."`
}

type KillmailLocation

type KillmailLocation struct {
	ID                int64    `json:"id"`
	Name              *string  `json:"name"`
	Security          *float64 `json:"security"`
	ConstellationID   *int64   `json:"constellation_id"`
	ConstellationName *string  `json:"constellation_name"`
	RegionID          *int64   `json:"region_id"`
	RegionName        *string  `json:"region_name"`
}

type KillmailOutput

type KillmailOutput struct {
	KillmailID     int64              `json:"killmail_id"`
	URL            string             `json:"url"`
	Time           time.Time          `json:"time"`
	Hash           string             `json:"hash"`
	TotalValue     float64            `json:"total_value"`
	FittedValue    float64            `json:"fitted_value"`
	DroppedValue   float64            `json:"dropped_value"`
	DestroyedValue float64            `json:"destroyed_value"`
	Points         int64              `json:"points"`
	AttackerCount  int64              `json:"attacker_count"`
	IsNPC          bool               `json:"is_npc"`
	IsSolo         bool               `json:"is_solo"`
	WarID          *int64             `json:"war_id"`
	System         KillmailLocation   `json:"system"`
	Victim         KillmailVictim     `json:"victim"`
	FinalBlow      *KillmailAttacker  `json:"final_blow"`
	Attackers      []KillmailAttacker `json:"attackers"`
}

type KillmailParticipant

type KillmailParticipant struct {
	CharacterID       *int64  `json:"character_id"`
	CharacterName     *string `json:"character_name"`
	CorporationID     *int64  `json:"corporation_id"`
	CorporationName   *string `json:"corporation_name"`
	CorporationTicker *string `json:"corporation_ticker"`
	AllianceID        *int64  `json:"alliance_id"`
	AllianceName      *string `json:"alliance_name"`
	AllianceTicker    *string `json:"alliance_ticker"`
	ShipTypeID        *int64  `json:"ship_type_id"`
	ShipName          *string `json:"ship_name"`
}

type KillmailStoryFacts

type KillmailStoryFacts struct {
	Time              time.Time         `json:"time"`
	TotalValue        float64           `json:"total_value"`
	IsSolo            bool              `json:"is_solo"`
	IsNPC             bool              `json:"is_npc"`
	AttackerCount     int64             `json:"attacker_count"`
	System            KillmailLocation  `json:"system"`
	VictimShip        *string           `json:"victim_ship"`
	Victim            *string           `json:"victim"`
	VictimAffiliation *string           `json:"victim_affiliation"`
	FinalBlow         *KillmailAttacker `json:"final_blow"`
}

type KillmailStoryOutput

type KillmailStoryOutput struct {
	KillmailID int64              `json:"killmail_id"`
	URL        string             `json:"url"`
	Story      string             `json:"story"`
	Facts      KillmailStoryFacts `json:"facts"`
}

type KillmailSummary

type KillmailSummary struct {
	KillmailID    int64                `json:"killmail_id"`
	URL           string               `json:"url"`
	Time          *time.Time           `json:"time,omitempty"`
	TotalValue    *float64             `json:"total_value,omitempty"`
	AttackerCount *int64               `json:"attacker_count,omitempty"`
	IsNPC         *bool                `json:"is_npc,omitempty"`
	IsSolo        *bool                `json:"is_solo,omitempty"`
	System        *KillmailSystem      `json:"system,omitempty"`
	Victim        *KillmailParticipant `json:"victim,omitempty"`
	FinalBlow     *KillmailParticipant `json:"final_blow"`
}

type KillmailSystem

type KillmailSystem struct {
	ID         int64    `json:"id"`
	Name       *string  `json:"name"`
	Security   *float64 `json:"security"`
	RegionID   *int64   `json:"region_id"`
	RegionName *string  `json:"region_name"`
}

type KillmailVictim

type KillmailVictim struct {
	CharacterID       *int64  `json:"character_id"`
	CharacterName     *string `json:"character_name"`
	CorporationID     *int64  `json:"corporation_id"`
	CorporationName   *string `json:"corporation_name"`
	CorporationTicker *string `json:"corporation_ticker"`
	AllianceID        *int64  `json:"alliance_id"`
	AllianceName      *string `json:"alliance_name"`
	AllianceTicker    *string `json:"alliance_ticker"`
	FactionID         *int64  `json:"faction_id"`
	FactionName       *string `json:"faction_name"`
	ShipTypeID        *int64  `json:"ship_type_id"`
	ShipName          *string `json:"ship_name"`
	ShipGroupID       *int64  `json:"ship_group_id"`
	ShipGroupName     *string `json:"ship_group_name"`
	DamageTaken       int64   `json:"damage_taken"`
}

type KillsWithBreakdown

type KillsWithBreakdown struct {
	Month        *string `json:"month,omitempty"`
	TypeID       *int64  `json:"type_id,omitempty"`
	SystemID     *int64  `json:"system_id,omitempty"`
	RegionID     *int64  `json:"region_id,omitempty"`
	Name         *string `json:"name,omitempty"`
	Kills        int64   `json:"kills"`
	ISKDestroyed float64 `json:"isk_destroyed"`
}

type KillsWithFilters

type KillsWithFilters struct {
	EntityShip   *NamedShip `json:"entity_ship"`
	PartnerShip  *NamedShip `json:"partner_ship"`
	VictimShip   *NamedShip `json:"victim_ship"`
	VictimEntity *Entity    `json:"victim_entity"`
	System       *Entity    `json:"system"`
	Region       *Entity    `json:"region"`
	From         *string    `json:"from"`
	To           *string    `json:"to"`
}

type KillsWithInput

type KillsWithInput struct {
	Entity       StringOrInt64  `json:"entity"`
	Type         *EntityType    `json:"type,omitempty" enum:"character"`
	Partner      StringOrInt64  `json:"partner"`
	EntityShip   *StringOrInt64 `json:"entity_ship,omitempty"`
	PartnerShip  *StringOrInt64 `json:"partner_ship,omitempty"`
	VictimShip   *StringOrInt64 `json:"victim_ship,omitempty"`
	VictimEntity *StringOrInt64 `json:"victim_entity,omitempty"`
	System       *StringOrInt64 `json:"system,omitempty"`
	Region       *StringOrInt64 `json:"region,omitempty"`
	From         *string        `json:"from,omitempty"`
	To           *string        `json:"to,omitempty"`
	GroupBy      string         `json:"group_by,omitempty" enum:"none,victim_ship,system,region,month,partner_ship,entity_ship" default:"none"`
	Limit        int            `json:"limit,omitempty" default:"10" minimum:"1" maximum:"50"`
}

type KillsWithOutput

type KillsWithOutput struct {
	Entity    Entity               `json:"entity"`
	Partner   Entity               `json:"partner"`
	Filters   KillsWithFilters     `json:"filters"`
	Totals    KillsWithTotals      `json:"totals"`
	GroupBy   string               `json:"group_by,omitempty"`
	Breakdown []KillsWithBreakdown `json:"breakdown,omitempty"`
}

type KillsWithTotals

type KillsWithTotals struct {
	Kills        int64   `json:"kills"`
	ISKDestroyed float64 `json:"isk_destroyed"`
}

type LossShip

type LossShip struct {
	TypeID *int64  `json:"type_id"`
	Name   *string `json:"name"`
}

type LossSystem

type LossSystem struct {
	ID         int64   `json:"id"`
	Name       *string `json:"name"`
	RegionID   *int64  `json:"region_id"`
	RegionName *string `json:"region_name"`
}

type MeInput

type MeInput struct {
	Me string `json:"me" minLength:"1" doc:"Your EVE character name as typed in-game."`
}

type MeIntelInput

type MeIntelInput struct {
	Me    string `json:"me" minLength:"1"`
	Limit int    `json:"limit,omitempty" minimum:"1" maximum:"50" default:"10"`
}

type MeKillsInput

type MeKillsInput struct {
	Me     string  `json:"me" minLength:"1"`
	Role   string  `json:"role,omitempty" enum:"kills,losses,all" default:"all"`
	Limit  int     `json:"limit,omitempty" minimum:"1" maximum:"50" default:"20"`
	Before *int64  `json:"before,omitempty"`
	From   *string `json:"from,omitempty"`
	To     *string `json:"to,omitempty"`
}

type MeKillsWithInput

type MeKillsWithInput struct {
	Me           string         `json:"me" minLength:"1"`
	Partner      StringOrInt64  `json:"partner"`
	EntityShip   *StringOrInt64 `json:"entity_ship,omitempty"`
	PartnerShip  *StringOrInt64 `json:"partner_ship,omitempty"`
	VictimShip   *StringOrInt64 `json:"victim_ship,omitempty"`
	VictimEntity *StringOrInt64 `json:"victim_entity,omitempty"`
	System       *StringOrInt64 `json:"system,omitempty"`
	Region       *StringOrInt64 `json:"region,omitempty"`
	From         *string        `json:"from,omitempty"`
	To           *string        `json:"to,omitempty"`
	GroupBy      string         `json:"group_by,omitempty" enum:"none,victim_ship,system,region,month,partner_ship,entity_ship" default:"none"`
	Limit        int            `json:"limit,omitempty" minimum:"1" maximum:"50" default:"10"`
}

type MeShipsUsedInput

type MeShipsUsedInput struct {
	Me      string         `json:"me" minLength:"1"`
	Ship    *StringOrInt64 `json:"ship,omitempty"`
	Role    string         `json:"role,omitempty" enum:"kills,losses,all" default:"all"`
	From    *string        `json:"from,omitempty"`
	To      *string        `json:"to,omitempty"`
	System  *StringOrInt64 `json:"system,omitempty"`
	Region  *StringOrInt64 `json:"region,omitempty"`
	GroupBy string         `json:"group_by,omitempty" enum:"none,ship,victim_ship,system,region,month" default:"ship"`
	Limit   int            `json:"limit,omitempty" minimum:"1" maximum:"50" default:"10"`
}

type MeTimelineInput

type MeTimelineInput struct {
	Me     string         `json:"me" minLength:"1"`
	Bucket string         `json:"bucket,omitempty" enum:"day,month,year" default:"month"`
	Since  *string        `json:"since,omitempty"`
	Until  *string        `json:"until,omitempty"`
	VS     *StringOrInt64 `json:"vs,omitempty"`
}

type MembershipPeriod

type MembershipPeriod struct {
	FirstSeen        time.Time     `json:"first_seen"`
	LastSeen         time.Time     `json:"last_seen"`
	DurationDays     int           `json:"duration_days"`
	ObservationCount int           `json:"observation_count"`
	Corporation      *IDNameTicker `json:"corporation"`
	Alliance         *IDNameTicker `json:"alliance"`
}

type MetaPulseInput

type MetaPulseInput struct {
	RegionID           *int64  `json:"region_id,omitempty"`
	ShipCategory       string  `` /* 130-byte string literal not displayed */
	Since              *string `json:"since,omitempty"`
	Until              *string `json:"until,omitempty"`
	MinClusterSize     int     `json:"min_cluster_size,omitempty" default:"10" minimum:"1"`
	IncludeRookieShips bool    `json:"include_rookie_ships,omitempty" default:"false"`
	Limit              int     `json:"limit,omitempty" default:"15" minimum:"1" maximum:"30"`
}

type MetaPulseOutput

type MetaPulseOutput struct {
	Window       TimeWindow        `json:"window"`
	RegionID     *int64            `json:"region_id"`
	ShipCategory string            `json:"ship_category"`
	Count        int               `json:"count"`
	Clusters     []DoctrineCluster `json:"clusters"`
}

type NamedShip

type NamedShip struct {
	TypeID int64  `json:"type_id"`
	Name   string `json:"name"`
}

type NumericDiff

type NumericDiff struct {
	A        *float64 `json:"a"`
	B        *float64 `json:"b"`
	Delta    *float64 `json:"delta"`
	DeltaPct *float64 `json:"delta_pct"`
}

type OrganizationActivity

type OrganizationActivity struct {
	ID     int64   `json:"id"`
	Name   *string `json:"name"`
	Ticker *string `json:"ticker"`
	Kills  int64   `json:"kills"`
}

type PilotActivity

type PilotActivity struct {
	Semantics          string           `json:"semantics"`
	Description        string           `json:"description"`
	ByHourUTC          map[string]int64 `json:"by_hour_utc"`
	ByDayOfWeek        map[string]int64 `json:"by_day_of_week"`
	PeakHourUTC        int              `json:"peak_hour_utc"`
	PeakHourEventCount int64            `json:"peak_hour_event_count"`
}

type PilotEfficiencyInput

type PilotEfficiencyInput struct {
	Entity     StringOrInt64 `json:"entity" doc:"Character name or id."`
	ShipTypeID *int64        `json:"ship_type_id,omitempty" doc:"Restrict to events involving this ship type."`
	Since      *string       `json:"since,omitempty" doc:"ISO datetime lower bound. Default 90 days ago."`
	Until      *string       `json:"until,omitempty" doc:"ISO datetime upper bound. Default now."`
}

type PilotEfficiencyOutput

type PilotEfficiencyOutput struct {
	Character  CharacterRef          `json:"character"`
	Window     TimeWindow            `json:"window"`
	ShipFilter *ShipFilter           `json:"ship_filter,omitempty"`
	Totals     PilotEfficiencyTotals `json:"totals"`
	Activity   PilotActivity         `json:"activity"`
}

type PilotEfficiencyTotals

type PilotEfficiencyTotals struct {
	Kills            int64    `json:"kills"`
	Losses           int64    `json:"losses"`
	KillLossRatio    *float64 `json:"kill_loss_ratio"`
	ISKDestroyed     float64  `json:"isk_destroyed"`
	ISKLost          float64  `json:"isk_lost"`
	ISKRatio         *float64 `json:"isk_ratio"`
	ISKEfficiencyPct float64  `json:"isk_efficiency_pct"`
	SoloKills        int64    `json:"solo_kills"`
	SoloRatePct      float64  `json:"solo_rate_pct"`
	FinalBlows       int64    `json:"final_blows"`
	AvgGangOnKills   float64  `json:"avg_gang_on_kills"`
	AvgGangOnLosses  float64  `json:"avg_gang_on_losses"`
}

type Registry

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

type RequiredIDName

type RequiredIDName struct {
	ID   int64   `json:"id"`
	Name *string `json:"name"`
}

type ResistLayer

type ResistLayer struct {
	EM        *float64 `json:"em"`
	Thermal   *float64 `json:"thermal"`
	Kinetic   *float64 `json:"kinetic"`
	Explosive *float64 `json:"explosive"`
}

type ResolvedEntity

type ResolvedEntity struct {
	ID     int64
	Name   string
	Type   EntityType
	Ticker *string
}

func (ResolvedEntity) Public

func (r ResolvedEntity) Public(baseURL string) Entity

type ResolvedParticipant

type ResolvedParticipant struct {
	ID   int64      `json:"id"`
	Name string     `json:"name"`
	Type EntityType `json:"type"`
}

type RouteDangerInput

type RouteDangerInput struct {
	From      StringOrInt64   `json:"from" doc:"Starting solar system name or id."`
	To        StringOrInt64   `json:"to" doc:"Destination solar system name or id."`
	Prefer    string          `json:"prefer,omitempty" enum:"shortest,safest,lowsec_ok" default:"shortest"`
	Avoid     []StringOrInt64 `json:"avoid,omitempty" maxItems:"20"`
	RoundTrip bool            `json:"round_trip,omitempty" default:"false"`
	Hours     float64         `json:"hours,omitempty" default:"1" minimum:"0.25" maximum:"72"`
}

type RouteDangerOutput

type RouteDangerOutput struct {
	From              SystemRef     `json:"from"`
	To                SystemRef     `json:"to"`
	Prefer            string        `json:"prefer"`
	AvoidedSystems    int           `json:"avoided_systems"`
	Jumps             int           `json:"jumps"`
	WindowHours       float64       `json:"window_hours"`
	TotalKillsOnRoute int64         `json:"total_kills_on_route"`
	CrossesLowsec     bool          `json:"crosses_lowsec"`
	CrossesNullsec    bool          `json:"crosses_nullsec"`
	AverageDanger     float64       `json:"avg_danger"`
	WorstHop          WorstRouteHop `json:"worst_hop"`
	Hops              []RouteHop    `json:"hops"`
	ReturnLeg         *RouteLeg     `json:"return_leg,omitempty"`
}

type RouteHop

type RouteHop struct {
	Step        int      `json:"step"`
	SystemID    int64    `json:"system_id"`
	SystemName  *string  `json:"system_name"`
	Security    *float64 `json:"security"`
	SecBand     string   `json:"sec_band"`
	RegionID    *int64   `json:"region_id"`
	RegionName  *string  `json:"region_name"`
	KillsWindow int64    `json:"kills_window"`
	Danger      float64  `json:"danger"`
	URL         string   `json:"url"`
}

type RouteLeg

type RouteLeg struct {
	Jumps             int        `json:"jumps"`
	TotalKillsOnRoute int64      `json:"total_kills_on_route"`
	CrossesLowsec     bool       `json:"crosses_lowsec"`
	CrossesNullsec    bool       `json:"crosses_nullsec"`
	AverageDanger     float64    `json:"avg_danger"`
	Hops              []RouteHop `json:"hops"`
}

type SearchHit

type SearchHit struct {
	ID            int64      `json:"id"`
	Name          string     `json:"name"`
	Ticker        *string    `json:"ticker"`
	Type          EntityType `json:"type"`
	URL           string     `json:"url"`
	CorporationID *int64     `json:"corporation_id,omitempty"`
	AllianceID    *int64     `json:"alliance_id,omitempty"`
}

type SearchInput

type SearchInput struct {
	Query string      `` /* 153-byte string literal not displayed */
	Type  *EntityType `` /* 155-byte string literal not displayed */
	Limit int         `json:"limit,omitempty" minimum:"1" maximum:"25" default:"10" jsonschema:"Maximum number of matches to return."`
}

type SearchOutput

type SearchOutput struct {
	Query string      `json:"query"`
	Count int         `json:"count"`
	Hits  []SearchHit `json:"hits"`
}

type SharedSystem

type SharedSystem struct {
	SystemID   int64   `json:"system_id"`
	SystemName *string `json:"system_name"`
	RegionName *string `json:"region_name"`
	AKillsSeen int64   `json:"a_kills_seen"`
	BKillsSeen int64   `json:"b_kills_seen"`
}

type ShipCompareInput

type ShipCompareInput struct {
	A StringOrInt64 `json:"a" jsonschema:"First hull name or type identifier."`
	B StringOrInt64 `json:"b" jsonschema:"Second hull name or type identifier."`
}

type ShipCompareOutput

type ShipCompareOutput struct {
	A    ShipInfoOutput `json:"a"`
	B    ShipInfoOutput `json:"b"`
	Diff HullDifference `json:"diff"`
}

type ShipFilter

type ShipFilter struct {
	TypeID int64 `json:"type_id"`
}

type ShipInfoInput

type ShipInfoInput struct {
	Ship StringOrInt64 `json:"ship" jsonschema:"Hull name or type identifier."`
}

type ShipInfoOutput

type ShipInfoOutput struct {
	TypeID           int64         `json:"type_id"`
	Name             string        `json:"name"`
	URL              string        `json:"url"`
	Category         *string       `json:"category"`
	Group            *string       `json:"group"`
	Race             *string       `json:"race"`
	MetaGroup        *string       `json:"meta_group"`
	Slots            HullSlots     `json:"slots"`
	Fitting          HullFitting   `json:"fitting"`
	BaseHP           HullHP        `json:"base_hp"`
	ResistProfile    HullResists   `json:"resist_profile"`
	Capacitor        HullCapacitor `json:"capacitor"`
	Mobility         HullMobility  `json:"mobility"`
	Sensors          HullSensors   `json:"sensors"`
	Drones           HullDrones    `json:"drones"`
	Cargo            HullCargo     `json:"cargo"`
	Description      *string       `json:"description"`
	CurrentJitaPrice *float64      `json:"current_jita_price"`
	MarketNote       string        `json:"market_note,omitempty"`
}

type ShipLossActivity

type ShipLossActivity struct {
	TypeID  *int64  `json:"type_id"`
	Name    *string `json:"name"`
	Losses  int64   `json:"losses"`
	ISKLost float64 `json:"isk_lost"`
}

type ShipsUsedBreakdown

type ShipsUsedBreakdown struct {
	Month        *string `json:"month,omitempty"`
	TypeID       *int64  `json:"type_id,omitempty"`
	SystemID     *int64  `json:"system_id,omitempty"`
	RegionID     *int64  `json:"region_id,omitempty"`
	Name         *string `json:"name,omitempty"`
	Kills        int64   `json:"kills"`
	Losses       int64   `json:"losses"`
	ISKDestroyed float64 `json:"isk_destroyed"`
	ISKLost      float64 `json:"isk_lost"`
}

type ShipsUsedFilters

type ShipsUsedFilters struct {
	Ship   *NamedShip `json:"ship"`
	Role   string     `json:"role"`
	From   *string    `json:"from"`
	To     *string    `json:"to"`
	System *Entity    `json:"system"`
	Region *Entity    `json:"region"`
}

type ShipsUsedInput

type ShipsUsedInput struct {
	Entity  StringOrInt64  `json:"entity"`
	Type    *EntityType    `json:"type,omitempty" enum:"character,corporation,alliance"`
	Ship    *StringOrInt64 `json:"ship,omitempty"`
	Role    string         `json:"role,omitempty" enum:"kills,losses,all" default:"all"`
	From    *string        `json:"from,omitempty"`
	To      *string        `json:"to,omitempty"`
	System  *StringOrInt64 `json:"system,omitempty"`
	Region  *StringOrInt64 `json:"region,omitempty"`
	GroupBy string         `json:"group_by,omitempty" enum:"none,ship,victim_ship,system,region,month" default:"ship"`
	Limit   int            `json:"limit,omitempty" default:"10" minimum:"1" maximum:"50"`
}

type ShipsUsedOutput

type ShipsUsedOutput struct {
	Entity    Entity               `json:"entity"`
	Filters   ShipsUsedFilters     `json:"filters"`
	Totals    ShipsUsedTotals      `json:"totals"`
	GroupBy   string               `json:"group_by,omitempty"`
	Breakdown []ShipsUsedBreakdown `json:"breakdown,omitempty"`
}

type ShipsUsedTotals

type ShipsUsedTotals struct {
	Kills        int64   `json:"kills"`
	Losses       int64   `json:"losses"`
	ISKDestroyed float64 `json:"isk_destroyed"`
	ISKLost      float64 `json:"isk_lost"`
}

type StatsWindow

type StatsWindow struct {
	Lifetime bool
	Since    string
	Until    string
}

StatsWindow preserves the established MCP wire contract where lifetime results use the string "lifetime" and bounded results use a date object.

func BoundedWindow

func BoundedWindow(since, until string) StatsWindow

func LifetimeWindow

func LifetimeWindow() StatsWindow

func (StatsWindow) MarshalJSON

func (v StatsWindow) MarshalJSON() ([]byte, error)

func (StatsWindow) Schema

func (StatsWindow) Schema(_ huma.Registry) *huma.Schema

type StringOrInt64

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

StringOrInt64 preserves the existing MCP convention that an entity or type may be addressed by either its display name or numeric identifier.

func IntRef

func IntRef(value int64) StringOrInt64

func StringRef

func StringRef(value string) StringOrInt64

func (StringOrInt64) Int64

func (v StringOrInt64) Int64() int64

func (StringOrInt64) IsInt

func (v StringOrInt64) IsInt() bool

func (StringOrInt64) MarshalJSON

func (v StringOrInt64) MarshalJSON() ([]byte, error)

func (StringOrInt64) Schema

func (StringOrInt64) Schema(_ huma.Registry) *huma.Schema

Schema supplies Huma with the same union used by the MCP JSON Schema.

func (StringOrInt64) String

func (v StringOrInt64) String() string

func (*StringOrInt64) UnmarshalJSON

func (v *StringOrInt64) UnmarshalJSON(data []byte) error

type SystemFlags

type SystemFlags struct {
	Border        bool `json:"border"`
	Fringe        bool `json:"fringe"`
	Corridor      bool `json:"corridor"`
	Hub           bool `json:"hub"`
	International bool `json:"international"`
	Regional      bool `json:"regional"`
}

type SystemInfoInput

type SystemInfoInput struct {
	System StringOrInt64 `json:"system" jsonschema:"System name or solar system identifier."`
}

type SystemInfoOutput

type SystemInfoOutput struct {
	SolarSystemID int64            `json:"solar_system_id"`
	Name          string           `json:"name"`
	URL           string           `json:"url"`
	Security      *float64         `json:"security"`
	SecurityBand  *string          `json:"security_band"`
	SecurityClass *string          `json:"security_class"`
	Region        RequiredIDName   `json:"region"`
	Constellation RequiredIDName   `json:"constellation"`
	Faction       *RequiredIDName  `json:"faction"`
	Flags         SystemFlags      `json:"flags"`
	StationCount  int              `json:"station_count"`
	Stations      []SystemStation  `json:"stations"`
	NeighborCount int              `json:"neighbor_count"`
	IsPipeTip     bool             `json:"is_pipe_tip"`
	Neighbors     []SystemNeighbor `json:"neighbors"`
}

type SystemNeighbor

type SystemNeighbor struct {
	SolarSystemID int64    `json:"solar_system_id"`
	Name          string   `json:"name"`
	Security      *float64 `json:"security"`
	RegionName    *string  `json:"region_name"`
}

type SystemPulseInput

type SystemPulseInput struct {
	System StringOrInt64 `json:"system" doc:"System name or id."`
	Hours  float64       `json:"hours,omitempty" default:"6" minimum:"0.5" maximum:"168"`
	Since  *string       `json:"since,omitempty" doc:"ISO datetime lower bound."`
	Until  *string       `json:"until,omitempty" doc:"ISO datetime upper bound."`
	TopN   int           `json:"top_n,omitempty" default:"5" minimum:"1" maximum:"20"`
}

type SystemPulseOutput

type SystemPulseOutput struct {
	System               SystemRef              `json:"system"`
	Window               TimeWindow             `json:"window"`
	WindowHours          *float64               `json:"window_hours"`
	Totals               SystemPulseTotals      `json:"totals"`
	HeatScore            float64                `json:"heat_score"`
	TopAttackerCorps     []OrganizationActivity `json:"top_attacker_corps"`
	TopAttackerAlliances []OrganizationActivity `json:"top_attacker_alliances"`
	TopVictimShips       []ShipLossActivity     `json:"top_victim_ships"`
}

type SystemPulseTotals

type SystemPulseTotals struct {
	Kills          int64   `json:"kills"`
	PVPKills       int64   `json:"pvp_kills"`
	SoloKills      int64   `json:"solo_kills"`
	AttackersTotal int64   `json:"attackers_total"`
	ISKDestroyed   float64 `json:"isk_destroyed"`
}

type SystemRef

type SystemRef struct {
	ID   int64  `json:"id"`
	Name string `json:"name"`
	URL  string `json:"url"`
}

type SystemStation

type SystemStation struct {
	StationID int64  `json:"station_id"`
	Name      string `json:"name"`
}

type TimeWindow

type TimeWindow struct {
	Since string `json:"since"`
	Until string `json:"until"`
}

type TimelineBucket

type TimelineBucket struct {
	PeriodStart  time.Time `json:"period_start"`
	Kills        int64     `json:"kills"`
	Losses       int64     `json:"losses"`
	SoloKills    int64     `json:"solo_kills,omitempty"`
	SoloLosses   int64     `json:"solo_losses,omitempty"`
	FinalBlows   int64     `json:"final_blows,omitempty"`
	Points       int64     `json:"points,omitempty"`
	ISKDestroyed float64   `json:"isk_destroyed"`
	ISKLost      float64   `json:"isk_lost"`
}

type TimelineWindow

type TimelineWindow struct {
	Since *string `json:"since"`
	Until *string `json:"until"`
}

type ToolDefinition

type ToolDefinition struct {
	Name        string
	Title       string
	Description string
}

type ToolHandler

type ToolHandler[In, Out any] func(context.Context, In) (Out, error)

type ValueDifference

type ValueDifference struct {
	A        float64  `json:"a"`
	B        float64  `json:"b"`
	Delta    float64  `json:"delta"`
	DeltaPct *float64 `json:"delta_pct"`
}

type WarBattleSummary

type WarBattleSummary struct {
	BattleID          int64               `json:"battle_id"`
	URL               string              `json:"url"`
	StartTime         *time.Time          `json:"start_time"`
	EndTime           *time.Time          `json:"end_time"`
	DurationMinutes   int64               `json:"duration_minutes"`
	KillCount         int64               `json:"kill_count"`
	TotalISKDestroyed float64             `json:"total_isk_destroyed"`
	IsMultiParty      bool                `json:"is_multi_party"`
	System            BattleSystemSummary `json:"system"`
	Teams             []BattleTeamSummary `json:"teams"`
}

type WarReportInput

type WarReportInput struct {
	A          StringOrInt64 `json:"a"`
	B          StringOrInt64 `json:"b"`
	Since      *string       `json:"since,omitempty"`
	Until      *string       `json:"until,omitempty"`
	TopSystems int           `json:"top_systems,omitempty" default:"10" minimum:"1" maximum:"50"`
	TopBattles int           `json:"top_battles,omitempty" default:"5" minimum:"1" maximum:"20"`
}

type WarReportOutput

type WarReportOutput struct {
	A                   Entity             `json:"a"`
	B                   Entity             `json:"b"`
	Window              TimeWindow         `json:"window"`
	Totals              WarTotals          `json:"totals"`
	TimelineDaily       []WarTimelineDay   `json:"timeline_daily"`
	TopContestedSystems []ContestedSystem  `json:"top_contested_systems"`
	RecentBattles       []WarBattleSummary `json:"recent_battles"`
}

type WarTimelineDay

type WarTimelineDay struct {
	PeriodStart time.Time `json:"period_start"`
	AKillsB     int64     `json:"a_kills_b"`
	BKillsA     int64     `json:"b_kills_a"`
	AISKOnB     float64   `json:"a_isk_on_b"`
	BISKOnA     float64   `json:"b_isk_on_a"`
}

type WarTotals

type WarTotals struct {
	AKillsB       int64   `json:"a_kills_b"`
	BKillsA       int64   `json:"b_kills_a"`
	AISKDestroyed float64 `json:"a_isk_destroyed"`
	BISKDestroyed float64 `json:"b_isk_destroyed"`
	TotalKills    int64   `json:"total_kills"`
	TotalISK      float64 `json:"total_isk"`
	Leader        string  `json:"leader"`
	AISKShare     float64 `json:"a_isk_share"`
}

type WorstRouteHop

type WorstRouteHop struct {
	SystemID    int64   `json:"system_id"`
	SystemName  *string `json:"system_name"`
	SecBand     string  `json:"sec_band"`
	KillsWindow int64   `json:"kills_window"`
	Danger      float64 `json:"danger"`
}

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL