v2

type BackupReport struct {
	// AgeSeconds 距最后一次【成功】备份的秒数；-1 表示无法确定
	//（状态文件缺失或不可解析），此时 Ok 必为 0。
	AgeSeconds int64 `json:"age_seconds"`
	// Ok 为 1 表示最近一次备份成功，0 表示失败或状态未知。
	Ok int `json:"ok"`
	// Message 是可选的人类可读说明（例如失败原因），便于排查。
	Message string `json:"message,omitempty"`
}

type BasicInfoParams struct {
	Info map[string]interface{} `json:"info"`
}

type CPUReport struct {
	Name  string  `json:"name,omitempty"`
	Cores int     `json:"cores,omitempty"`
	Arch  string  `json:"arch,omitempty"`
	Usage float64 `json:"usage,omitempty"`
}

type ConnectionsReport struct {
	TCP int `json:"tcp"`
	UDP int `json:"udp"`
}

type DiskReport struct {
	Total int64 `json:"total"`
	Used  int64 `json:"used"`
}

type Event struct {
	ID        string    `json:"id"`
	Method    string    `json:"method"`
	Params    any       `json:"params,omitempty"`
	CreatedAt time.Time `json:"created_at"`
	ExpiresAt time.Time `json:"expires_at"`
}

type EventParams struct {
	Type string `json:"type"`
	Data any    `json:"data,omitempty"`
}

type ExecParams struct {
	TaskID  string `json:"task_id"`
	Command string `json:"command"`
}

type FileOperation struct {
	UUID      string         `json:"uuid"`
	RequestID string         `json:"request_id"`
	Op        string         `json:"op"`
	Args      map[string]any `json:"args,omitempty"`
}

type FileResult struct {
	UUID      string          `json:"uuid"`
	RequestID string          `json:"request_id"`
	OK        bool            `json:"ok"`
	Result    json.RawMessage `json:"result,omitempty"`
	Error     string          `json:"error,omitempty"`
}

type GPUDetailReport struct {
	Count        int             `json:"count"`
	AverageUsage float64         `json:"average_usage"`
	DetailedInfo []GPUDeviceInfo `json:"detailed_info"`
}

type GPUDeviceInfo struct {
	Name        string  `json:"name"`
	MemoryTotal int64   `json:"memory_total"`
	MemoryUsed  int64   `json:"memory_used"`
	Utilization float64 `json:"utilization"`
	Temperature int     `json:"temperature"`
}

type IPAddress struct {
	Ipv4 string `json:"ipv4"`
	Ipv6 string `json:"ipv6"`
}

type IPFamily string

type LoadReport struct {
	Load1  float64 `json:"load1"`
	Load5  float64 `json:"load5"`
	Load15 float64 `json:"load15"`
}

type MeshMode string

type MeshTraceAccepted struct {
	JobID          string    `json:"job_id"`
	Status         string    `json:"status"`
	TotalPairs     int       `json:"total_pairs"`
	AcceptedAt     time.Time `json:"accepted_at"`
	PollIntervalMs int       `json:"poll_interval_ms"`
}

type MeshTraceJobSnapshot struct {
	JobID      string            `json:"job_id"`
	Status     string            `json:"status"`
	Total      int               `json:"total"`
	Done       int               `json:"done"`
	Failed     int               `json:"failed"`
	Running    int               `json:"running"`
	Results    []NextTraceResult `json:"results"`
	StartedAt  time.Time         `json:"started_at"`
	UpdatedAt  time.Time         `json:"updated_at"`
	FinishedAt *time.Time        `json:"finished_at"`
	Error      string            `json:"error"`
}

type MeshTraceParams struct {
	SourceNodeIDs  []string      `json:"source_node_ids"`
	TargetNodeIDs  []string      `json:"target_node_ids"`
	Mode           MeshMode      `json:"mode"`
	IPFamily       IPFamily      `json:"ip_family"`
	Protocol       TraceProtocol `json:"protocol"`
	MaxHops        int           `json:"max_hops"`
	TimeoutMs      int           `json:"timeout_ms"`
	MaxConcurrency int           `json:"max_concurrency"`
	PerAgentLimit  int           `json:"per_agent_limit"`
}

type Message struct {
	Type      string `json:"type"`
	Content   string `json:"content"`
	Sender    string `json:"sender"`
	Timestamp int64  `json:"timestamp"`
}

type MessageParams struct {
	Type    string `json:"type"`
	Message string `json:"message"`
	Data    any    `json:"data,omitempty"`
}

type NetworkReport struct {
	TCPRetransPercent *float64 `json:"tcp_retrans_percent,omitempty"`
	Up                int64    `json:"up"`
	Down              int64    `json:"down"`
	// TotalUp / TotalDown 是内核自开机以来的累计字节数：单调，可以做差得到"这段时间用了多少"。
	TotalUp   int64 `json:"totalUp"`
	TotalDown int64 `json:"totalDown"`
	// CycleUp / CycleDown 是自计费周期重置日以来的累计流量（--month-rotate）。
	//
	// 它**不是**计数器：跨周期会归零。面板必须按 gauge 存它的最后值，而不是对采样求和
	// （求和等于"累计值 × 采样次数"），也不要对它取差值（那会把整个累计当增量）。
	CycleUp   int64 `json:"cycleUp,omitempty"`
	CycleDown int64 `json:"cycleDown,omitempty"`
}

type NextTraceParams struct {
	TaskID     string        `json:"task_id"`
	SourceID   string        `json:"source_id"`
	TargetID   string        `json:"target_id"`
	TargetHost string        `json:"target_host"`
	IPFamily   IPFamily      `json:"ip_family"`
	Protocol   TraceProtocol `json:"protocol"`
	MaxHops    int           `json:"max_hops"`
	TimeoutMs  int           `json:"timeout_ms"`
	RawOutput  bool          `json:"raw_output"`
}

type NextTraceResult struct {
	TaskID     string          `json:"task_id"`
	SourceID   string          `json:"source_id"`
	TargetID   string          `json:"target_id"`
	TargetHost string          `json:"target_host"`
	IPFamily   IPFamily        `json:"ip_family"`
	Protocol   TraceProtocol   `json:"protocol"`
	StartedAt  time.Time       `json:"started_at"`
	FinishedAt time.Time       `json:"finished_at"`
	DurationMs int             `json:"duration_ms"`
	OK         bool            `json:"ok"`
	Error      string          `json:"error"`
	Summary    TraceSummary    `json:"summary"`
	Hops       []TraceHop      `json:"hops"`
	Raw        json.RawMessage `json:"raw"`
	RawText    string          `json:"raw_text"`
	ExitCode   int             `json:"exit_code"`
	Truncated  bool            `json:"truncated"`
}

type NodeEndpoint struct {
	NodeID string   `json:"node_id"`
	Name   string   `json:"name"`
	Host   string   `json:"host"`
	Family IPFamily `json:"ip_family"`
}

type PingParams struct {
	TaskID uint   `json:"ping_task_id"`
	Type   string `json:"ping_type"`
	Target string `json:"ping_target"`
	// Reference 非空时，agent 会在同一周期额外探测该目标，
	// 并以 role="reference" 上报，用于主机 vs 网关的路径归因。
	Reference string `json:"ping_reference,omitempty"`
}

type PingResultParams struct {
	TaskID   uint   `json:"task_id"`
	PingType string `json:"ping_type"`
	Value    int    `json:"value"`
	// ValueUS 是同一测量结果的微秒精度值（新 agent 上报的 value_us）。
	//
	// 旧 agent 不发这个字段，此时为 0，面板回退到 Value（整数毫秒）。落库形态不变：
	// 仍然写 ping.latency_ms 这一条序列，只是值从整数毫秒变成小数毫秒
	// （420 µs → 0.42 ms）—— 不新增指标、不新增标签、不新增序列。
	ValueUS    int64     `json:"value_us,omitempty"`
	FinishedAt time.Time `json:"finished_at"`
	// Role 为空表示主目标；"reference" 表示这是参考点的结果。
	Role string `json:"role,omitempty"`
	// Family 是本次测量实际使用的地址族（"ipv4"/"ipv6"）。
	// 目标是域名时由各节点自行解析，双栈域名可能落到不同族；面板靠它把
	// 「同一任务、不同路径」拆成两条序列。旧 agent 不发该字段，此时为空，
	// 行为与改动前完全一致。
	Family string `json:"family,omitempty"`
}

type PullParams struct {
	Capabilities []string `json:"capabilities,omitempty"`
	AckEventIDs  []string `json:"ack_event_ids,omitempty"`
	LastEventID  string   `json:"last_event_id,omitempty"`
}

type RPCError struct {
	Code    int    `json:"code"`
	Message string `json:"message"`
	Data    any    `json:"data,omitempty"`
}

type RamReport struct {
	Total int64 `json:"total"`
	Used  int64 `json:"used"`
}

type RawRequest struct {
	JSONRPC string          `json:"jsonrpc"`
	Method  string          `json:"method"`
	Params  json.RawMessage `json:"params,omitempty"`
	ID      any             `json:"id,omitempty"`
}

type Report struct {
	UUID        string            `json:"uuid,omitempty"`
	CPU         CPUReport         `json:"cpu"`
	Ram         RamReport         `json:"ram"`
	Swap        RamReport         `json:"swap"`
	Load        LoadReport        `json:"load"`
	Disk        DiskReport        `json:"disk"`
	Network     NetworkReport     `json:"network"`
	Connections ConnectionsReport `json:"connections"`
	GPU         *GPUDetailReport  `json:"gpu,omitempty"`
	Uptime      int64             `json:"uptime"`
	Process     int               `json:"process"`
	// Backup 是可选的备份新鲜度上报。agent 未配置备份状态文件时为 nil，
	// 因此不影响未使用该功能的部署，也不会写入任何 point。
	Backup                *BackupReport     `json:"backup,omitempty"`
	Message               string            `json:"message"`
	Method                string            `json:"method,omitempty"`
	UpdatedAt             time.Time         `json:"updated_at"`
	SampledAt             time.Time         `json:"sampled_at,omitempty"`
	ReceivedAt            time.Time         `json:"received_at,omitempty"`
	SampleIntervalSeconds float64           `json:"sample_interval_seconds,omitempty"`
	CounterEpoch          string            `json:"counter_epoch,omitempty"`
	Quality               map[string]string `json:"quality,omitempty"`
}

type ReportParams struct {
	Report      Report   `json:"report"`
	AckEventIDs []string `json:"ack_event_ids,omitempty"`
}

type Request struct {
	JSONRPC string `json:"jsonrpc"`
	Method  string `json:"method"`
	Params  any    `json:"params,omitempty"`
	ID      any    `json:"id,omitempty"`
}

type Response struct {
	JSONRPC string    `json:"jsonrpc"`
	ID      any       `json:"id,omitempty"`
	Result  any       `json:"result,omitempty"`
	Error   *RPCError `json:"error,omitempty"`
}

type RouteItem struct {
	Carrier string `json:"carrier"`
	Target  string `json:"target"`
	Label   string `json:"label"`
	Reached bool   `json:"reached"`
	Hops    int    `json:"hops"`
	Error   string `json:"error,omitempty"`
}

type TaskResultParams struct {
	TaskID     string    `json:"task_id"`
	Result     string    `json:"result"`
	ExitCode   int       `json:"exit_code"`
	FinishedAt time.Time `json:"finished_at"`
}

type TerminalRequestParams struct {
	RequestID string `json:"request_id"`
}

type TraceHop struct {
	Hop      int     `json:"hop"`
	Host     string  `json:"host"`
	IP       string  `json:"ip"`
	RTTMs    float64 `json:"rtt_ms"`
	Loss     float64 `json:"loss"`
	ASN      string  `json:"asn"`
	Location string  `json:"location"`
}

type TraceProtocol string

type TraceSummary struct {
	HopCount   int     `json:"hop_count"`
	Reached    bool    `json:"reached"`
	PacketLoss float64 `json:"packet_loss"`
	RTTMs      float64 `json:"rtt_ms"`
}

type UnlockItem struct {
	ID     string `json:"id"`
	Name   string `json:"name"`
	Kind   string `json:"kind"`
	Status string `json:"status"`
	Region string `json:"region,omitempty"`
	Basis  string `json:"basis"`
	Detail string `json:"detail,omitempty"`
}

type UnlockParams struct {
	EgressIP       string       `json:"egress_ip,omitempty"`
	EgressRegion   string       `json:"egress_region,omitempty"`
	ProbedAt       time.Time    `json:"probed_at"`
	Results        []UnlockItem `json:"results"`
	Routes         []RouteItem  `json:"routes,omitempty"`
	RoutesProbedAt time.Time    `json:"routes_probed_at,omitempty"`
}

type UpdateParams struct {
	Target string `json:"target"`
}