wire

type ASInfo struct {
	Number uint32 `json:"number"`
	Name   string `json:"name"`
	Prefix string `json:"prefix"`
}

type AddressMetadata struct {
	AddressSource string                `json:"address_source"`
	ASN           IPLookup[ASInfo]      `json:"asn"`
	Location      IPLookup[GeoLocation] `json:"location"`
}

type AddressObservation struct {
	Source string `json:"source"` // Always dispatcher-observed.
	Via    string `json:"via"`    // control or reflection.
	// ObservedAt is the Unix second of the last observation: the last
	// heartbeat of the control session that carries the address, or the
	// receipt of the last reflection call.
	ObservedAt int64 `json:"observed_at"`
	// LookupSource names the offline ASN database the prefix and ASN come
	// from, as in ip_metadata; null when no database is configured.
	LookupSource *string `json:"lookup_source"`
	// LookupReason is empty when the database knew the address; otherwise
	// it explains a null prefix and ASN, with the ip_metadata vocabulary.
	LookupReason string `json:"lookup_reason"`
}

type AddressObservations struct {
	V4 *AddressObservation `json:"v4"`
	V6 *AddressObservation `json:"v6"`
}

type Allowance struct {
	Currency    string `json:"currency"`
	Granted     string `json:"granted"`
	Reserved    string `json:"reserved"`
	Consumed    string `json:"consumed"`
	Remaining   string `json:"remaining"`
	PricingRule string `json:"pricing_rule"`
}

type AllowanceGrant struct {
	ID             int64     `json:"id"`
	Amount         string    `json:"amount"`
	Currency       string    `json:"currency"`
	Reason         string    `json:"reason"`
	IdempotencyKey string    `json:"idempotency_key"`
	GrantedBy      string    `json:"granted_by"`
	GrantedAt      time.Time `json:"granted_at"`
}

type AllowanceGrantRequest struct {
	Amount         string `json:"amount,omitempty"`
	Reason         string `json:"reason"`
	IdempotencyKey string `json:"idempotency_key"`
}

type AllowanceGrantResult struct {
	Grant     AllowanceGrant `json:"grant"`
	Allowance Allowance      `json:"allowance"`
}

type AttributionCandidate struct {
	ExecutorID string    `json:"executor_id"`
	RunID      string    `json:"run_id"`
	ActiveFrom time.Time `json:"active_from"`
	ActiveTo   time.Time `json:"active_to"`
	// IPSource is observed when the address is the one the dispatcher saw on
	// the executor's control connection, advertised when it is the executor's
	// own claim.
	IPSource string              `json:"ip_source"`
	Schedule AttributionSchedule `json:"schedule"`
	// DisclosedThrough is the latest epoch whose disclosed key is on record,
	// 0 when none is.
	DisclosedThrough int64 `json:"disclosed_through"`
	// DisclosedThroughAtNs is when the dispatcher recorded the key of
	// DisclosedThrough, in Unix nanoseconds; 0 when none is on record.
	DisclosedThroughAtNs int64 `json:"disclosed_through_at_ns"`
	// NextDisclosureAtNs is the earliest Unix nanoseconds the key of epoch
	// DisclosedThrough+1 may be disclosed; 0 when the schedule is unknown.
	NextDisclosureAtNs int64 `json:"next_disclosure_at_ns"`
}

type AttributionCandidates struct {
	IP string    `json:"ip"`
	At time.Time `json:"at"`
	// RetainedFrom is the start of the retained history: for an earlier
	// time the absence of a candidate is no evidence of absence.
	RetainedFrom time.Time              `json:"retained_from"`
	Candidates   []AttributionCandidate `json:"candidates"`
	// Truncated is set when more runs matched than the answer lists.
	Truncated bool `json:"truncated"`
}

type AttributionKey struct {
	Epoch int64  `json:"epoch"`
	Key   []byte `json:"key"`
}

type AttributionKeys struct {
	ExecutorID string           `json:"executor_id"`
	ChainID    string           `json:"chain_id"`
	Keys       []AttributionKey `json:"keys"`
	// NextEpoch is the from_epoch of the next page, nil on the last one.
	NextEpoch *int64 `json:"next_epoch"`
}

type AttributionSchedule struct {
	// ChainID identifies the chain: the lowercase hex of the first 16 bytes
	// of SHA-256(K0).
	ChainID string `json:"chain_id"`
	// K0 is the chain anchor, the key of epoch 0; every disclosed key hashes
	// to it.
	K0 []byte `json:"k0"`
	// T0UnixNs is the start of epoch 0 in Unix nanoseconds.
	T0UnixNs int64 `json:"t0_unix_ns"`
	// EpochSeconds is the epoch length I in seconds.
	EpochSeconds int64 `json:"epoch_seconds"`
	// DisclosureDelayEpochs is the disclosure delay d in epochs; zero is an
	// executor that predates it, whose tags a verifier must not accept.
	DisclosureDelayEpochs int64 `json:"disclosure_delay_epochs"`
	// ChainLength is L, the number of epochs the chain serves; zero is unknown.
	ChainLength int64 `json:"chain_length"`
	// TagSpec is the tag specification version the executor reported when it
	// registered the chain: TagSpecVersionV1, or TagSpecVersionLegacy for an
	// executor that did not report debuglet-tag-v1. Verifiers of tag spec v1
	// must treat a legacy chain as unsupported, not as a mismatch.
	TagSpec int64 `json:"tag_spec"`
}

type AttributionState struct {
	State               string `json:"state"`                 // available or unavailable.
	Reason              string `json:"reason"`                // Empty when available; epoch_zero, chain_exhausted, refresh_failing, disclosure_held.
	Epoch               int64  `json:"epoch"`                 // Current key-schedule epoch.
	InstalledEpoch      *int64 `json:"installed_epoch"`       // Oldest epoch a kernel tagger may still sign with; null when none holds a key.
	LastRefreshAt       *int64 `json:"last_refresh_at"`       // Oldest last successful kernel key install; null without one.
	RefreshError        string `json:"refresh_error"`         // Short error of a failing kernel key refresh; empty when none fails.
	DisclosureHeldSince *int64 `json:"disclosure_held_since"` // When an installed key started holding disclosure back; null when not held.
}

type Cancellation struct {
	ID              string          `json:"id"`
	RequestID       string          `json:"request_id"`
	ExecutorID      string          `json:"executor_id"`
	OriginalBinding *ControlBinding `json:"original_binding"`
	RequestedAt     time.Time       `json:"requested_at"`
	AttemptedAt     *time.Time      `json:"attempted_at"`
	AcknowledgedAt  *time.Time      `json:"acknowledged_at"`
	CheckedAt       time.Time       `json:"checked_at"`
	Disposition     string          `json:"disposition"`
	Reason          string          `json:"reason"`
	State           string          `json:"state"`
	Error           string          `json:"error"`
}

type CapabilityObservation struct {
	State      string `json:"state"`
	ObservedAt *int64 `json:"observed_at"`
	ExpiresAt  *int64 `json:"expires_at"`
}

type CapabilityReport struct {
	SchemaVersion   int      `json:"schema_version"`
	Protocols       []string `json:"protocols"`
	EnforcementMode string   `json:"enforcement_mode"`
	// Tagging is the report's tagging mode; null when the report had none.
	// Additive within result format 1.1.
	Tagging *TaggingMode `json:"tagging"`
	// Added within vantage_point schema 1; absent in earlier files.
	EnforcementReason string      `json:"enforcement_reason"`
	ICMP              *ProbeState `json:"icmp"`
}

type ChainTransfer struct {
	ID        int64     `json:"id"`
	Kind      string    `json:"kind"`
	Amount    string    `json:"amount"`
	Currency  string    `json:"currency"`
	Receiver  string    `json:"receiver"`
	State     string    `json:"state"`
	Digest    string    `json:"digest"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

type ClockReport struct {
	State            string `json:"state"`              // synced, unsynced or unknown.
	EstimatedErrorNS *int64 `json:"estimated_error_ns"` // Kernel esterror; null unknown.
	MaxErrorNS       *int64 `json:"max_error_ns"`       // Kernel maxerror; null unknown.
	ErrorBoundNS     int64  `json:"error_bound_ns"`     // Operator-configured bound on the estimated error.
	Readiness        string `json:"readiness"`          // ready, degraded or unknown.
	Reason           string `json:"reason"`             // Empty unless degraded: unsynced or error_exceeds_bound.
}

type Connectivity struct {
	SchemaVersion int            `json:"schema_version"`
	IPv4          Reachability   `json:"ipv4"`
	IPv6          Reachability   `json:"ipv6"`
	TCPListener   Reachability   `json:"tcp_listener"`
	UDPListener   Reachability   `json:"udp_listener"`
	SCIONListener Reachability   `json:"scion_listener"`
	SCIONHost     ObservedString `json:"scion_host"`
	SCIONPaths    Reachability   `json:"scion_paths"`
	Disagreements []string       `json:"disagreements"`
}

type ControlBinding struct {
	DispatcherIncarnation string `json:"dispatcher_incarnation"`
	SessionID             string `json:"session_id"`
}

type Economics struct {
	PaymentMethods []string `json:"payment_methods"`
	ChainPayments  bool     `json:"chain_payments"`
	Allowances     bool     `json:"allowances"`
}

type Executor struct {
	Connectivity           *Connectivity            `json:"connectivity,omitempty"`
	AdmissionLimits        *ExecutorAdmissionLimits `json:"admission_limits,omitempty"`
	CapabilityObservation  *CapabilityObservation   `json:"capability_observation,omitempty"`
	Capabilities           *ExecutorCapabilities    `json:"capabilities,omitempty"`
	ID                     string                   `json:"id"`
	Ready                  bool                     `json:"ready"`
	LastSeen               int64                    `json:"last_seen"`
	Version                string                   `json:"version"`
	TeslaDelaySec          int64                    `json:"tesla_delay_sec"`
	TeslaAnchorTimestampNs int64                    `json:"tesla_anchor_timestamp_ns"`
	TeslaAnchorKey         []byte                   `json:"tesla_anchor_key"` // k_0, the public chain anchor
	PricePerBw             int64                    `json:"price_per_bw"`
	Currency               string                   `json:"currency"`
	// Admission is ready, maintenance or offline; empty from older dispatchers.
	Admission  string          `json:"admission"`
	Display    ExecutorDisplay `json:"display"`
	SCIONISDAS ObservedString  `json:"scion_isd_as"`
	// Listeners are the transports the executor can open run listeners on.
	Listeners ObservedList `json:"listeners"`
	// Clock is the executor-reported kernel clock state. Host platform detail
	// is operator-only and never part of this public listing.
	Clock      ObservedClock `json:"clock"`
	IPMetadata *IPMetadata   `json:"ip_metadata,omitempty"`
	// ProbeAddressing (API 1.16) adds the RIPE Atlas-style is_public,
	// address, prefix and ASN fields of each address family.
	ProbeAddressing
	// ProbeStatus (API 1.17) adds the RIPE Atlas-style status history and
	// host and system tags.
	ProbeStatus
}

type ExecutorAdmissionLimits struct {
	Scheduling      bool   `json:"scheduling"`
	MinTimeoutMS    int64  `json:"min_timeout_ms"`
	MaxTimeoutMS    int64  `json:"max_timeout_ms"`
	MaxBandwidthBPS int64  `json:"max_bandwidth_bps"`
	PriceUnit       string `json:"price_unit"`
}

type ExecutorCapabilities struct {
	SchemaVersion         uint32            `json:"schema_version"`
	ObservedAt            int64             `json:"observed_at"`             // Dispatcher receipt time, Unix seconds.
	Protocols             []string          `json:"protocols"`               // Positive tcp, tls, udp, icmp (IPv4), scion support.
	EnforcementMode       string            `json:"enforcement_mode"`        // Actual ebpf/fallback packet counter; empty unknown.
	AdvertisedCapacityBPS *int64            `json:"advertised_capacity_bps"` // Total reported bandwidth, not free capacity; null unknown.
	Attribution           *AttributionState `json:"attribution"`             // Null unknown, including executors that predate it.
	Tagging               *TaggingMode      `json:"tagging"`                 // Null unknown, including executors that predate it.
	// EnforcementReason says why the counter is fallback: configured,
	// no_interface, not_permitted, unsupported or attach_failed. Empty when
	// unknown or ebpf.
	EnforcementReason string `json:"enforcement_reason"`
	// ICMP is the executor's raw ICMPv4 socket probe; null unknown.
	ICMP *ProbeState `json:"icmp"`
}

type ExecutorDisplay struct {
	DisplayName LabelledString `json:"display_name"`
	City        LabelledString `json:"city"`
	Country     LabelledString `json:"country"` // ISO 3166-1 alpha-2.
	Network     LabelledString `json:"network"`
}

type ExecutorEarnings struct {
	Currency       string          `json:"currency"`
	TotalIncome    string          `json:"total_income"`
	CurrentBalance string          `json:"current_balance"`
	Transfers      []ChainTransfer `json:"transfers"`
	Payouts        string          `json:"payouts"`
}

type FieldError struct {
	Field   string `json:"field"`
	Code    string `json:"code"`
	Message string `json:"message"`
	OrderID *int64 `json:"order_id,omitempty"`
}

type GeoLocation struct {
	Country   string `json:"country"`
	City      string `json:"city"`
	Precision string `json:"precision"`
}

type HostPlatform struct {
	OS            *string `json:"os"`   // Go GOOS.
	Arch          *string `json:"arch"` // Go GOARCH.
	KernelRelease *string `json:"kernel_release"`
	CPUs          *int64  `json:"cpus"`
	MemoryBytes   *uint64 `json:"memory_bytes"`
	BuildVersion  *string `json:"build_version"`
}

type IPLookup[T any] struct {
	Value      *T      `json:"value"`
	Source     *string `json:"source"`
	ObservedAt int64   `json:"observed_at"`
	Reason     string  `json:"reason"`
}

type IPMetadata struct {
	Reported       *AddressMetadata `json:"reported,omitempty"` // Separate hello claim when it differs from the observed control address.
	Observed       AddressMetadata  `json:"observed"`
	Advertised     AddressMetadata  `json:"advertised"`
	LocationOptOut bool             `json:"location_opt_out"`
	Disagreements  []string         `json:"disagreements"`
}

type LabelledObservation struct {
	Value      *string    `json:"value"`
	Source     *string    `json:"source"`
	ObservedAt *time.Time `json:"observed_at"`
	Stale      *bool      `json:"stale"`
}

type LabelledReport[T any] struct {
	Value      *T         `json:"value"`
	Source     *string    `json:"source"`
	ObservedAt *time.Time `json:"observed_at"`
	Stale      *bool      `json:"stale"`
}

type LabelledString struct {
	Value  *string `json:"value"`
	Source *string `json:"source"`
}

type LogEntry[Binary ~string | ~[]byte] struct {
	ID        int64  `json:"id"`
	Timestamp string `json:"timestamp"`
	Output    Binary `json:"output"`
}

type LogPage[Binary ~string | ~[]byte] struct {
	State   string             `json:"state"`
	Error   string             `json:"error"`
	After   int64              `json:"after"`
	Logs    []LogEntry[Binary] `json:"logs"`
	HasMore bool               `json:"has_more"`
	Output  OutputStatus       `json:"output"`
}

type Measurement struct {
	ID     string           `json:"id"`
	Runs   []MeasurementRun `json:"runs"`
	Total  int64            `json:"total"`
	Limit  int64            `json:"limit"`
	Offset int64            `json:"offset"`
}

type MeasurementPage struct {
	Measurements []MeasurementSummary `json:"measurements"`
	Total        int64                `json:"total"`
	Counts       map[string]int64     `json:"counts"`
	Limit        int64                `json:"limit"`
	Offset       int64                `json:"offset"`
}

type MeasurementRun struct {
	RunID       string `json:"run_id"`
	ExecutorID  string `json:"executor_id"`
	OrderID     int64  `json:"order_id"`
	State       string `json:"state"`
	Label       string `json:"label"`
	ProgramName string `json:"program_name"`
}

type MeasurementSummary struct {
	ID             string    `json:"id"`
	Label          string    `json:"label"`
	State          string    `json:"state"`
	Children       int64     `json:"children"`
	ScheduledStart time.Time `json:"scheduled_start"`
}

type MeasurementTemplate struct {
	ID                 string            `json:"id"`
	Version            int               `json:"version"`
	Name               string            `json:"name"`
	Description        string            `json:"description"`
	ProgramSHA256      string            `json:"program_sha256"`
	ProgramAsset       string            `json:"program_asset"`
	Arguments          TemplateArguments `json:"arguments"`
	RequiredTransports []string          `json:"required_transports"`
	DefaultPolicy      Policy            `json:"default_policy"`
}

type ObservedClock struct {
	Value      *ClockReport `json:"value"`
	Source     *string      `json:"source"`
	ObservedAt *int64       `json:"observed_at"` // Dispatcher receipt time, Unix seconds.
}

type ObservedList struct {
	Value      []string `json:"value"`
	Source     *string  `json:"source"`
	ObservedAt *int64   `json:"observed_at"` // Dispatcher receipt time, Unix seconds.
}

type ObservedString struct {
	Value      *string `json:"value"`
	Source     *string `json:"source"`
	ObservedAt *int64  `json:"observed_at"` // Dispatcher receipt time, Unix seconds.
}

type OrderHistory struct {
	Intents []OrderHistoryIntent `json:"intents"`
	Next    string               `json:"next"`
}

type OrderHistoryIntent struct {
	ID          string              `json:"id"`
	Method      string              `json:"method"`
	Status      string              `json:"status"`
	Price       string              `json:"price"`
	Currency    string              `json:"currency"`
	PricingRule string              `json:"pricing_rule"`
	ExpiresAt   time.Time           `json:"expires_at"`
	Orders      []OrderHistoryOrder `json:"orders"`
}

type OrderHistoryOrder struct {
	OrderID    int64  `json:"order_id"`
	ExecutorID string `json:"executor_id"`
	Price      string `json:"price"`
	Currency   string `json:"currency"`
	Settlement string `json:"settlement"`
	RunID      string `json:"run_id,omitempty"`
}

type OutputStatus struct {
	State       string `json:"state"`
	FinalCursor *int64 `json:"final_cursor"`
	LossReason  string `json:"loss_reason"`
}

type Policy struct {
	FloorBW     int64    `json:"floor_bw"`
	CeilBW      int64    `json:"ceil_bw"`
	TimeoutMS   int64    `json:"timeout_ms"`
	Addresses   []string `json:"addresses"`
	RequireICMP bool     `json:"require_icmp"`
	ListenUDP   bool     `json:"listen_udp"`
	ListenTCP   bool     `json:"listen_tcp"`
	ListenSCION bool     `json:"listen_scion"`
}

type ProbeAddressing struct {
	IsPublic            *bool                `json:"is_public"`
	AddressV4           *string              `json:"address_v4"`
	AddressV6           *string              `json:"address_v6"`
	PrefixV4            *string              `json:"prefix_v4"`
	PrefixV6            *string              `json:"prefix_v6"`
	ASNV4               *uint32              `json:"asn_v4"`
	ASNV6               *uint32              `json:"asn_v6"`
	AddressObservations *AddressObservations `json:"address_observations"`
}

type ProbeState struct {
	State  string `json:"state"`  // available or unavailable.
	Reason string `json:"reason"` // Empty when available; disabled, not_permitted, ping_socket_only or unsupported.
}

type ProbeStatus struct {
	Status         *ProbeStatusName `json:"status"`
	StatusSince    *int64           `json:"status_since"`
	FirstConnected *int64           `json:"first_connected"`
	LastConnected  *int64           `json:"last_connected"`
	TotalUptime    *int64           `json:"total_uptime"`
	Tags           []string         `json:"tags"`
}

type ProbeStatusName struct {
	Name  string `json:"name"`
	Since *int64 `json:"since"`
}

type Profile struct {
	ID     string        `json:"id"`
	Config ProfileConfig `json:"config"`
}

type ProfileConfig struct {
	Version    int                `json:"version"`
	Name       string             `json:"name"`
	Program    ProfileProgram     `json:"program"`
	ExecutorID string             `json:"executor_id"`
	Args       []string           `json:"args"`
	Policy     Policy             `json:"policy"`
	Template   *TemplateReference `json:"template,omitempty"`
}

type ProfileProgram struct {
	SHA256 string `json:"sha256"`
	Wasm   []byte `json:"wasm"`
}

type ProfileSummary struct {
	ID            string `json:"id"`
	Name          string `json:"name"`
	ProgramSHA256 string `json:"program_sha256"`
}

type Quote struct {
	PricingRule string        `json:"pricing_rule"`
	Currency    string        `json:"currency"`
	Unit        string        `json:"unit"`
	Total       string        `json:"total"`
	Orders      []QuotedOrder `json:"orders"`
	Errors      []FieldError  `json:"errors"`
}

type QuotedOrder struct {
	OrderID    int64        `json:"order_id"`
	ExecutorID string       `json:"executor_id"`
	Price      string       `json:"price"`
	Errors     []FieldError `json:"errors"`
}

type Reachability struct {
	State      string `json:"state"` // reachable, unreachable or untested.
	Reason     string `json:"reason"`
	Source     string `json:"source"`
	ObservedAt *int64 `json:"observed_at"`
	ExpiresAt  *int64 `json:"expires_at"`
	Stale      bool   `json:"stale"`
	Address    string `json:"address,omitempty"`
	Endpoint   string `json:"endpoint,omitempty"`
}

type Recovery struct {
	ID                    string              `json:"id"`
	ExecutorID            string              `json:"executor_id"`
	State                 string              `json:"state"`
	Error                 string              `json:"error"`
	CheckedAt             time.Time           `json:"checked_at"`
	OriginalBinding       *ControlBinding     `json:"original_binding"`
	ControlStatus         string              `json:"control_status"`
	Observation           RecoveryObservation `json:"observation"`
	AllocationReclaimedAt *time.Time          `json:"allocation_reclaimed_at,omitempty"`
}

type RecoveryObservation struct {
	Classification string            `json:"classification"`
	Observer       *RecoveryObserver `json:"observer"`
	ReceivedAt     *time.Time        `json:"received_at"`
	CurrentAtCheck *bool             `json:"current_at_check"`
	Retained       *RetainedRun      `json:"retained"`
}

type RecoveryObserver struct {
	ExecutorID string         `json:"executor_id"`
	Binding    ControlBinding `json:"binding"`
}

type Request[Binary ~string | ~[]byte] struct {
	// OrderID must be unique within one batch.
	OrderID int64 `json:"order_id"`
	// StartTimestamp is an optional Unix epoch start time.
	StartTimestamp *int64   `json:"start_time,omitempty"`
	ExecutorID     string   `json:"executor_id"`
	Args           []string `json:"args,omitempty"`
	Wasm           Binary   `json:"wasm"`
	Policy         Policy   `json:"policy"`
	Label          string   `json:"label,omitempty"`
	ProgramName    string   `json:"program_name,omitempty"`
}

type Result struct {
	Format       string             `json:"format"`
	Version      string             `json:"version"`
	RunID        string             `json:"run_id"`
	ExecutorID   string             `json:"executor_id"`
	Attempt      *ControlBinding    `json:"attempt"`
	Provenance   *ResultProvenance  `json:"provenance"`
	Outcome      ResultOutcome      `json:"outcome"`
	Timing       ResultTiming       `json:"timing"`
	Output       ResultOutput       `json:"output"`
	Verification ResultVerification `json:"verification"`
}

type ResultOutcome struct {
	State    string `json:"state"`
	Error    string `json:"error"`
	ExitCode *int64 `json:"exit_code"`
}

type ResultOutput struct {
	Status  OutputStatus       `json:"status"`
	Entries []LogEntry[[]byte] `json:"entries"`
}

type ResultProvenance struct {
	Retry              *RetryLink     `json:"retry,omitempty"`
	RunID              string         `json:"run_id"`
	ExecutorID         string         `json:"executor_id"`
	Attempt            ControlBinding `json:"attempt"`
	AdmittedAt         time.Time      `json:"admitted_at"`
	WorkloadSHA256     string         `json:"workload_sha256"`
	Arguments          []string       `json:"arguments"`
	AdmittedPolicy     Policy         `json:"admitted_policy"`
	HostPolicy         string         `json:"host_policy"`
	ExecutorSoftware   *string        `json:"executor_software"`
	DispatcherSoftware *string        `json:"dispatcher_software"`
	DispatcherRevision *string        `json:"dispatcher_revision"`
	CertificateSHA256  *string        `json:"certificate_sha256"`
	VantagePoint       *VantagePoint  `json:"vantage_point"`
}

type ResultTiming struct {
	ObservedAt         time.Time  `json:"observed_at"`
	ScheduledStart     *time.Time `json:"scheduled_start"`
	ReservedUntil      *time.Time `json:"reserved_until"`
	StartedAt          *time.Time `json:"started_at"`
	FinishedAt         *time.Time `json:"finished_at"`
	ClockUncertaintyNS *int64     `json:"clock_uncertainty_ns"`
}

type ResultVerification struct {
	Attribution      string `json:"attribution"`
	PacketEvidence   string `json:"packet_evidence"`
	MeasurementTruth string `json:"measurement_truth"`
}

type RetainedRun struct {
	OriginalBinding *ControlBinding `json:"original_binding"`
	Started         bool            `json:"started"`
	StartedAt       *time.Time      `json:"started_at"`
	StartTime       *time.Time      `json:"start_time"`
}

type RetryLink struct {
	ParentRunID string `json:"parent_run_id"`
	RequestID   string `json:"request_id"`
}

type RetryReceipt struct {
	RetryLink
	RunID string `json:"run_id,omitempty"`
}

type RunCost struct {
	Currency   string  `json:"currency"`
	Unit       string  `json:"unit"`
	Reserved   string  `json:"reserved"`
	Charged    *string `json:"charged"`
	Settlement string  `json:"settlement"`
}

type RunDetail struct {
	Execution  *RunExecution           `json:"execution"`
	RunID      string                  `json:"run_id"`
	ExecutorID string                  `json:"executor_id"`
	BatchID    string                  `json:"batch_id"`
	OrderID    int64                   `json:"order_id"`
	Submitted  *SubmittedConfiguration `json:"submitted"`
	Provenance *ResultProvenance       `json:"provenance"`
	Outcome    ResultOutcome           `json:"outcome"`
	Timing     ResultTiming            `json:"timing"`
	Cost       *RunCost                `json:"cost"`
}

type RunExecution struct {
	TimeSource         string     `json:"time_source"`
	StartedObservedAt  *time.Time `json:"started_observed_at"`
	TerminalObservedAt *time.Time `json:"terminal_observed_at"`
	ReportedExitCode   *int32     `json:"reported_exit_code"`
	TCPListener        *string    `json:"tcp_listener"`
	ListenerReady      bool       `json:"listener_ready"`
}

type State struct {
	State      string `json:"state"`
	Error      string `json:"error"`
	ExecutorID string `json:"executor_id"`
}

type SubmittedConfiguration struct {
	Label          string   `json:"label"`
	ProgramName    string   `json:"program_name"`
	RequestedStart *int64   `json:"requested_start"`
	Args           []string `json:"args"`
	Policy         Policy   `json:"policy"`
}

type TaggingMode struct {
	IPv4  string `json:"ipv4"`
	IPv6  string `json:"ipv6"`
	SCION string `json:"scion"`
	// TagSpec is the packet-tag specification the tagged families follow,
	// TagSpecV1 from this build on (docs/tag-spec.md). Empty, and absent from
	// JSON, is unknown: an executor or dispatcher that predates it. Readers
	// must tolerate values they do not know.
	TagSpec string `json:"tag_spec,omitempty"`
}

type TemplateArgument struct {
	Type        string `json:"type"`
	Description string `json:"description"`
	Default     string `json:"default"`
}

type TemplateArguments struct {
	Type                 string                      `json:"type"`
	Properties           map[string]TemplateArgument `json:"properties"`
	Required             []string                    `json:"required"`
	AdditionalProperties bool                        `json:"additionalProperties"`
}

type TemplateReference struct {
	ID      string `json:"id"`
	Version int    `json:"version"`
}

type User struct {
	ID   string `json:"id"`
	Name string `json:"name"`
	// Role reports the account's permissions; it is not a credential.
	Role string `json:"role"`
	// Economics is reported by API 1.15 and later; it is nil from an older
	// dispatcher.
	Economics *Economics `json:"economics,omitempty"`
}

type VantageCapabilities struct {
	Value      *CapabilityReport `json:"value"`
	Source     *string           `json:"source"`
	ObservedAt *time.Time        `json:"observed_at"`
	Stale      *bool             `json:"stale"`
}

type VantagePoint struct {
	ReportedSourceIP *LabelledString     `json:"reported_source_ip,omitempty"`
	Connectivity     *Connectivity       `json:"connectivity,omitempty"`
	SchemaVersion    int                 `json:"schema_version"`
	IPMetadata       *IPMetadata         `json:"ip_metadata,omitempty"`
	Capabilities     VantageCapabilities `json:"capabilities"`
	SourceIP         LabelledString      `json:"source_ip"`
	PublicHost       LabelledString      `json:"public_host"`
	// Added within schema 1; absent in earlier 1.1 files, which means null.
	SCIONISDAS LabelledObservation `json:"scion_isd_as"`
	Display    ExecutorDisplay     `json:"display"`
	// Added within schema 1 with the executor probes; absent means null.
	// Platform is host detail, recorded here because a result is visible only
	// to the run's owner and operators.
	Clock    LabelledReport[ClockReport]  `json:"clock"`
	Platform LabelledReport[HostPlatform] `json:"platform"`
	// Addressing is the RIPE Atlas-style addressing at admission, with the
	// addresses of a private executor too. Added within schema 1; absent in
	// earlier files, which means null.
	Addressing *ProbeAddressing `json:"addressing,omitempty"`
}

type Version struct {
	Version         string   `json:"version"`
	APIVersion      string   `json:"api_version"`
	APIVersions     []string `json:"api_versions"`
	BinaryVersion   string   `json:"binary_version"`
	BinaryRevision  string   `json:"binary_revision"`
	ProtocolVersion string   `json:"protocol_version"`
}