client

type AgentListOptions struct {
	Online bool
}

type AgentScope struct {
	Backend  ClientBackend
	Hostname string
}

type AgentServicesScope struct {
	Backend  ClientBackend
	Hostname string
}

type AgentsScope struct {
	Backend   ClientBackend
	Hostnames []string
}

type Arg struct {
	// Name is the template variable name used in ExecParts (e.g. "container").
	Name string `json:"name"`
	// Type is the value type: "string", "int", "bool".
	Type string `json:"type"`
	// Required indicates the arg must be supplied by the caller.
	Required bool `json:"required"`
	// Pattern is a regex the value must match before substitution.
	// Use the PatternXxx constants or a custom expression.
	Pattern string `json:"pattern,omitempty"`
}

type CPU struct {
	Info    []gopsutilcpu.InfoStat `json:"info"`
	Percent []float64              `json:"percent_per_cpu"`
	Total   float64                `json:"percent_total"`
}

type ClientBackend interface {
	// Do executes an HTTP request against a specific node and decodes JSON into 'out'
	Do(ctx context.Context, hostname, method, path string, body io.Reader, out any) error

	// DoRaw executes a request and returns the raw bytes (useful for files/logs)
	DoRaw(ctx context.Context, hostname, method, path string, body io.Reader, accept string) ([]byte, error)

	// Stream opens an SSE or continuous log stream
	Stream(ctx context.Context, hostname, method, path string) (io.ReadCloser, error)

	Peers(ctx context.Context, opts *PeerListOptions) ([]string, error)

	Hosts(ctx context.Context, opts *HostListOptions) ([]string, error)

	Agents(ctx context.Context, opts *AgentListOptions) ([]string, error)
}

type ComposeScope struct {
	Backend  ClientBackend
	Hostname string
}

type ComposeService struct {
	Name        string   `json:"name"`
	Status      string   `json:"status"`
	ConfigFiles []string `json:"config_files"`
}

type ComposeServicescope struct {
	Backend     ClientBackend
	Hostname    string
	ServiceName string
}

type Container = container.Summary

type ContainerScope struct {
	Backend     ClientBackend
	Hostname    string
	ContainerID string
}

type ContainersNamespace struct {
	Backend  ClientBackend
	Hostname string
}

type DirEntry struct {
	Name    string    `json:"name"`
	Size    int64     `json:"size"`
	IsDir   bool      `json:"is_dir"`
	ModTime time.Time `json:"mod_time"`
	Mode    string    `json:"mode"`
}

type DirScope struct {
	Backend  ClientBackend
	Hostname string
	Path     string
}

type Disk = *gopsutildisk.UsageStat

type DockerEvent = events.Message

type DockerScope struct {
	Backend  ClientBackend
	Hostname string
}

type Event[T any] struct {
	Name string `json:"name"`
	ID   int64  `json:"id"`
	Data T      `json:"data"`
}

type EventsScope struct {
	Backend  ClientBackend
	Hostname string
}

type FileScope struct {
	Backend  ClientBackend
	Hostname string
	Path     string
}

type FileStat struct {
	DirEntry
	SHA256 string `json:"sha256"`
}

type FilesScope struct {
	Backend  ClientBackend
	Hostname string
}

type FleetFilesScope struct {
	Backend   ClientBackend
	Hostnames []string
}

type FleetMetricsScope struct {
	Backend   ClientBackend
	Hostnames []string
}

type FleetVarsScope struct {
	Backend   ClientBackend
	Hostnames []string
	Service   string
	Env       string
}

type Host struct {
	Name         string            `json:"name"`
	Role         string            `json:"role"`
	Environment  string            `json:"environment"`
	Provider     string            `json:"provider"`
	InstanceType string            `json:"instance_type"`
	Tags         []string          `json:"tags"`
	Metadata     map[string]string `json:"metadata"`

	Peer     *Peer     `json:"peer,omitempty"`
	Tailkitd *Tailkitd `json:"tailkitd,omitempty"`

	TSHostname string   `json:"ts_hostname"`
	TSDNSName  string   `json:"ts_dns_name"`
	TSIPs      []string `json:"ts_ips"`
	OS         string   `json:"os"`
	Arch       string   `json:"arch"`
	Online     bool     `json:"online"`
	IsAdmin    bool     `json:"is_admin"`
}

type HostListOptions struct {
	Online      bool
	Tags        []string
	Environment string
}

type HostScope struct {
	Backend  ClientBackend
	Hostname string
}

type HostsScope struct {
	Backend   ClientBackend
	Hostnames []string
}

type Image = image.Summary

type ImagesNamespace struct {
	Backend  ClientBackend
	Hostname string
}

type Job struct {
	// JobID is the opaque identifier used to poll for results.
	JobID  string    `json:"job_id"`
	Status JobStatus `json:"status"`
}

type JobResult struct {
	JobID      string    `json:"job_id"`
	Status     JobStatus `json:"status"`
	ExitCode   int       `json:"exit_code"`
	Stdout     string    `json:"stdout"`
	Stderr     string    `json:"stderr"`
	DurationMs int64     `json:"duration_ms"`
	// Error is set when the job failed to start (not when the command exits non-zero).
	Error string `json:"error,omitempty"`
}

type JobStatus string

type JobUpdate struct {
	Event    string    `json:"-"`
	JobID    string    `json:"job_id"`
	Line     string    `json:"line,omitempty"`
	Stream   string    `json:"stream,omitempty"`
	Status   JobStatus `json:"status,omitempty"`
	ExitCode int       `json:"exit_code,omitempty"`
	Error    string    `json:"error,omitempty"`
}

type JournalEntry struct {
	Timestamp uint64            `json:"timestamp_us"` // realtime timestamp in microseconds
	Message   string            `json:"message"`
	Unit      string            `json:"unit,omitempty"`
	Priority  string            `json:"priority,omitempty"`
	Fields    map[string]string `json:"fields,omitempty"`
}

type LogLine struct {
	ContainerID string    `json:"container_id"`
	Stream      string    `json:"stream"`
	TS          time.Time `json:"ts"`
	Line        string    `json:"line"`
}

type LogsScope struct {
	Backend  ClientBackend
	Hostname string
}

type Memory struct {
	Virtual *gopsutilmem.VirtualMemoryStat `json:"virtual"`
	Swap    *gopsutilmem.SwapMemoryStat    `json:"swap"`
}

type Metrics struct {
	Host      *gopsutilhost.InfoStat       `json:"host,omitempty"`
	CPU       *CPU                         `json:"cpu,omitempty"`
	Memory    *Memory                      `json:"memory,omitempty"`
	Disk      []*gopsutildisk.UsageStat    `json:"disk,omitempty"`
	Network   []gopsutilnet.IOCountersStat `json:"network,omitempty"`
	Processes []Process                    `json:"processes,omitempty"`
	Ports     []Port                       `json:"ports,omitempty"`

} // metrics/handler328

type MetricsScope struct {
	Backend  ClientBackend
	Hostname string
}

type MetricsStreamScope struct {
	Backend  ClientBackend
	Hostname string
}

type Network = gopsutilnet.IOCountersStat

type Peer struct {
	ID        string            `json:"id,omitempty"`
	PublicKey string            `json:"public_key,omitempty"`
	HostName  string            `json:"host_name,omitempty"`
	DNSName   string            `json:"dns_name,omitempty"`
	IPs       []string          `json:"ips"`
	OS        string            `json:"os,omitempty"`
	Online    bool              `json:"online"`
	Metadata  map[string]string `json:"metadata,omitempty"`

	// Status keeps the raw Tailscale peer payload available for local SDK
	// enrichment and classification without making it part of the shared wire
	// contract.
	Status *ipnstate.PeerStatus `json:"-"`
}

type PeerListOptions struct{ Online bool }

type PeerScope struct {
	Backend  ClientBackend
	Hostname string
}

type PeersScope struct {
	Backend   ClientBackend
	Hostnames []string
}

type Port struct {
	Addr    string `json:"addr"`
	Port    uint16 `json:"port"`
	Proto   string `json:"proto"`
	PID     int    `json:"pid"`
	Process string `json:"process"`
}

type PortUpdate struct {
	Kind  string `json:"kind"`
	Port  Port   `json:"port,omitempty"`
	Ports []Port `json:"ports,omitempty"`
}

type Process struct {
	PID        int32   `json:"pid"`
	Name       string  `json:"name"`
	Status     string  `json:"status"`
	CPUPercent float64 `json:"cpu_percent"`
	MemoryRSS  uint64  `json:"memory_rss_bytes"`
	Cmdline    string  `json:"cmdline"`
}

type RawEvent struct {
	Name string
	ID   int64
	Data json.RawMessage
}

type SendDirRequest struct {
	// ToolName is the name of the tool that sent the directory.
	ToolName string `json:"tool_name"`
	// Filename is the name of the file that was sent.
	Filename string `json:"filename"`
	// LocalDir is the absolute path to the source directory on the caller's machine.
	LocalDir string
	// DestPath is the absolute destination directory path on the node.
	DestPath string
}

type SendRequest struct {
	// ToolName is the name of the tool that sent the file.
	ToolName string `json:"tool_name"`
	// Filename is the name of the file that was sent.
	Filename string `json:"filename"`
	// LocalPath is the absolute path to the file on the caller's machine.
	LocalPath string
	// DestPath is the absolute path the file should be written to on the node.
	DestPath string
}

type SendResult struct {
	// ToolName is the name of the tool that sent the file.
	ToolName string `json:"tool_name"`

	// Filename is the name of the file that was sent.
	Filename string `json:"filename"`

	LocalPath string `json:"local_path"`
	// Success indicates whether the file was successfully sent.
	Success bool `json:"success"`
	// WrittenTo is the absolute path the file was written to on the node.
	WrittenTo string `json:"written_to"`
	// BytesWritten is the number of bytes written.
	BytesWritten int64 `json:"bytes_written"`
	// DestMachine is the hostname of the machine the file was sent to.
	DestMachine string `json:"dest_machine"`
	//Error is set when the file was not successfully sent.
	Error string `json:"error,omitempty"`
}

type Service struct {
	ID          string `json:"id,omitempty"`
	Name        string `json:"name"`
	Kind        string `json:"kind,omitempty"`
	Runtime     string `json:"runtime"`
	HostName    string `json:"host_name,omitempty"`
	NodeName    string `json:"node_name,omitempty"`
	Description string `json:"description,omitempty"`

	Source        string   `json:"source,omitempty"`
	Priority      string   `json:"priority,omitempty"`
	Tags          []string `json:"tags"`
	Version       string   `json:"version,omitempty"`
	Addresses     []string `json:"addresses"`
	Ports         []uint16 `json:"ports"`
	ExpectedPorts []uint16 `json:"expected_ports,omitempty"`

	SystemdUnit string `json:"systemd_unit,omitempty"`
	ContainerID string `json:"container_id,omitempty"`
	BinaryPath  string `json:"binary_path,omitempty"`
	PidFile     string `json:"pid_file,omitempty"`

	Capabilities ServiceCapabilities `json:"capabilities"`
	Status       ServiceStatus       `json:"status"`
}

type ServiceCapabilities struct {
	Status  bool `json:"status"`
	Start   bool `json:"start"`
	Stop    bool `json:"stop"`
	Restart bool `json:"restart"`
	Reload  bool `json:"reload"`
	Logs    bool `json:"logs"`
}

type ServiceListOptions struct {
	Kind    string
	Runtime string
}

type ServiceScope struct {
	Backend   ClientBackend
	ServiceID string
}

type ServiceStatus struct {
	State     string     `json:"state,omitempty"`
	Health    string     `json:"health,omitempty"`
	Message   string     `json:"message,omitempty"`
	PID       int        `json:"pid,omitempty"`
	StartedAt *time.Time `json:"started_at,omitempty"`
	UpdatedAt *time.Time `json:"updated_at,omitempty"`
}

type ServicesScope struct {
	Backend   ClientBackend
	TargetIDs []string
}

type SwarmScope struct {
	Backend  ClientBackend
	Hostname string
}

type SwarmServicesNamespace struct {
	Backend  ClientBackend
	Hostname string
}

type SwarmStatus = swarm.Swarm

type SwarmStreamScope struct {
	ID       string
	Backend  ClientBackend
	Hostname string
}

type SwarmUpdate struct {
	SwarmID []string
	Servies []swarm.Service
}

type SwarwService = swarm.Service

type SystemdScope struct {
	Backend  ClientBackend
	Hostname string
}

type SystemdStreamScope struct {
	Backend  ClientBackend
	Hostname string
}

type SystemdUnit = dbus.UnitStatus

type Tailkitd struct {
	HostName string    `json:"host_name,omitempty"`
	Peer     *Peer     `json:"peer,omitempty"`
	Services []Service `json:"services"`
}

type TailnetClient interface {
	// Plural Namespaces (Optional variadic targets for fleet fan-outs)
	Peers(hostnames ...string) PeersScope
	Hosts(hostnames ...string) HostsScope
	Agents(hostnames ...string) AgentsScope
	Services(serviceIDs ...string) ServicesScope

	// Singular Namespaces
	Peer(hostname string) PeerScope
	Host(hostname string) HostScope
	Agent(hostname string) AgentScope
	Service(serviceID string) ServiceScope
}

type Tool struct {
	// Name is a unique identifier for the tool across the tailnet.
	Name string `json:"name"`
	// Version is the tool's current version string (semver recommended).
	Version string `json:"version"`
	// TsnetHost is the tsnet hostname this tool registers on the tailnet.
	TsnetHost string `json:"tsnet_host"`
}

type UnitScope struct {
	Backend  ClientBackend
	Hostname string
	UnitName string
}

type UnitStreamScope struct {
	Backend  ClientBackend
	Hostname string
	UnitName string
}

type UnitsNamespace struct {
	Backend  ClientBackend
	Hostname string
}

type VarsScope struct {
	Backend  ClientBackend
	Hostname string
	Service  string
	Env      string
}