client

type APIError struct {
	StatusCode int
	Message    string
}

type Agent struct {
	Hostname         string             `json:"hostname"`
	MachineID        string             `json:"machine_id,omitempty"`
	Fingerprint      string             `json:"fingerprint,omitempty"`
	Status           string             `json:"status"`
	State            string             `json:"state,omitempty"`
	Labels           map[string]string  `json:"labels,omitempty"`
	Architecture     string             `json:"architecture,omitempty"`
	CPUCount         int                `json:"cpu_count"`
	Fqdn             string             `json:"fqdn,omitempty"`
	KernelVersion    string             `json:"kernel_version,omitempty"`
	PackageMgr       string             `json:"package_mgr,omitempty"`
	ServiceMgr       string             `json:"service_mgr,omitempty"`
	LoadAverage      *LoadAverage       `json:"load_average,omitempty"`
	Memory           *Memory            `json:"memory,omitempty"`
	OSInfo           *OSInfo            `json:"os_info,omitempty"`
	PrimaryInterface string             `json:"primary_interface,omitempty"`
	Interfaces       []NetworkInterface `json:"interfaces,omitempty"`
	Routes           []Route            `json:"routes,omitempty"`
	Conditions       []Condition        `json:"conditions,omitempty"`
	Timeline         []TimelineEvent    `json:"timeline,omitempty"`
	Uptime           string             `json:"uptime,omitempty"`
	StartedAt        time.Time          `json:"started_at"`
	RegisteredAt     time.Time          `json:"registered_at"`
	Facts            map[string]any     `json:"facts,omitempty"`
}

type AgentJobResponse struct {
	Hostname string `json:"hostname,omitempty"`
	Status   string `json:"status,omitempty"`
	Error    string `json:"error,omitempty"`
	Changed  *bool  `json:"changed,omitempty"`
	Data     any    `json:"data,omitempty"`
}

type AgentList struct {
	Agents []Agent `json:"agents"`
	Total  int     `json:"total"`
}

type AgentSchedulingState = string

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

type AgentState struct {
	Status   string `json:"status,omitempty"`
	Duration string `json:"duration,omitempty"`
	Error    string `json:"error,omitempty"`
}

type AgentStats struct {
	Total  int            `json:"total"`
	Ready  int            `json:"ready"`
	Agents []AgentSummary `json:"agents,omitempty"`
}

type AgentSummary struct {
	Hostname   string `json:"hostname"`
	Labels     string `json:"labels,omitempty"`
	Registered string `json:"registered"`
}

type AuditEntry struct {
	ID           string    `json:"id"`
	Timestamp    time.Time `json:"timestamp"`
	User         string    `json:"user"`
	Roles        []string  `json:"roles,omitempty"`
	Method       string    `json:"method"`
	Path         string    `json:"path"`
	ResponseCode int       `json:"response_code"`
	DurationMs   int64     `json:"duration_ms"`
	SourceIP     string    `json:"source_ip"`
	OperationID  string    `json:"operation_id,omitempty"`
	TraceID      string    `json:"trace_id,omitempty"`
}

type AuditList struct {
	Items      []AuditEntry `json:"items"`
	TotalItems int          `json:"total_items"`
}

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

type AuthError struct {
	APIError
}

type CertificateCA struct {
	Name   string `json:"name"`
	Source string `json:"source,omitempty"`
	Object string `json:"object,omitempty"`
}

type CertificateCAMutationResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	Name     string `json:"name"`
	Changed  bool   `json:"changed"`
	Error    string `json:"error,omitempty"`
}

type CertificateCAResult struct {
	Hostname     string          `json:"hostname"`
	Status       string          `json:"status"`
	Certificates []CertificateCA `json:"certificates,omitempty"`
	Error        string          `json:"error,omitempty"`
}

type CertificateCreateOpts struct {
	// Name is the certificate name (required).
	Name string
	// Object is the object store reference for the PEM file (required).
	Object string
}

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

type CertificateUpdateOpts struct {
	// Object is the new object store reference for the PEM file (required).
	Object string
}

type Client struct {
	// Agent provides agent discovery and details operations.
	Agent *AgentService

	// Status provides full node status queries (OS, disk, memory, load).
	Status *StatusService

	// Hostname provides hostname query and update operations.
	Hostname *HostnameService

	// Disk provides disk usage query operations.
	Disk *DiskService

	// Memory provides memory usage query operations.
	Memory *MemoryService

	// Load provides load average query operations.
	Load *LoadService

	// Uptime provides uptime query operations.
	Uptime *UptimeService

	// OS provides operating system info query operations.
	OS *OSService

	// DNS provides DNS configuration query and update operations.
	DNS *DNSService

	// Ping provides network ping operations.
	Ping *PingService

	// Command provides command execution operations (exec, shell).
	Command *CommandService

	// FileDeploy provides file deployment operations on target hosts.
	FileDeploy *FileDeployService

	// Job provides job queue operations (create, get, list, delete, retry).
	Job *JobService

	// Health provides health check operations (liveness, readiness, status).
	Health *HealthService

	// Audit provides audit log operations (list, get, export).
	Audit *AuditService

	// File provides file management operations (upload, list, get, delete).
	File *FileService

	// Docker provides Docker container management operations (create, list,
	// inspect, start, stop, remove, exec, pull).
	Docker *DockerService

	// Cron provides cron schedule management operations (list, get,
	// create, update, delete).
	Cron *CronService

	// Sysctl provides sysctl parameter management operations (list, get,
	// set, delete).
	Sysctl *SysctlService

	// NTP provides NTP management operations (get, create, update, delete).
	NTP *NTPService

	// Timezone provides system timezone management operations (get, update).
	Timezone *TimezoneService

	// Process provides process management operations (list, get, signal).
	Process *ProcessService

	// Power provides power management operations (reboot, shutdown).
	Power *PowerService

	// User provides user account management operations (list, get,
	// create, update, delete, change password).
	User *UserService

	// Group provides group management operations (list, get, create,
	// update, delete).
	Group *GroupService

	// Package provides package management operations (list, get,
	// install, remove, update, list updates).
	Package *PackageService

	// Certificate provides CA certificate management operations
	// (list, create, update, delete).
	Certificate *CertificateService

	// Log provides log viewing operations (query journal entries).
	Log *LogService

	// Service provides systemd service management operations (list, get,
	// create, update, delete, start, stop, restart, enable, disable).
	Service *ServiceService

	// Interface provides network interface management operations (list, get,
	// create, update, delete).
	Interface *InterfaceService

	// Route provides network route management operations (list, get,
	// create, update, delete).
	Route *RouteService
	// contains filtered or unexported fields
}

type Collection[T any] struct {
	Results []T    `json:"results"`
	JobID   string `json:"job_id"`
}

type CommandResult struct {
	Hostname   string `json:"hostname"`
	Status     string `json:"status"`
	Stdout     string `json:"stdout,omitempty"`
	Stderr     string `json:"stderr,omitempty"`
	Error      string `json:"error,omitempty"`
	ExitCode   int    `json:"exit_code"`
	Changed    bool   `json:"changed"`
	DurationMs int64  `json:"duration_ms"`
}

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

type ComponentHealth struct {
	Status  string `json:"status"`
	Error   string `json:"error,omitempty"`
	Address string `json:"address,omitempty"`
}

type Condition struct {
	Type               string    `json:"type"`
	Status             bool      `json:"status"`
	Reason             string    `json:"reason,omitempty"`
	LastTransitionTime time.Time `json:"last_transition_time"`
}

type ConditionType = string

type ConflictError struct {
	APIError
}

type ConsumerDetail struct {
	Name        string `json:"name"`
	Pending     int    `json:"pending"`
	AckPending  int    `json:"ack_pending"`
	Redelivered int    `json:"redelivered"`
}

type ConsumerStats struct {
	Total     int              `json:"total"`
	Consumers []ConsumerDetail `json:"consumers,omitempty"`
}

type CronCreateOpts struct {
	// Name is the cron drop-in entry name (required).
	Name string
	// Object is the name of the uploaded file in the object store (required).
	Object string
	// Schedule is the cron expression (mutually exclusive with Interval).
	Schedule string
	// Interval is the periodic interval: hourly, daily, weekly, monthly
	// (mutually exclusive with Schedule).
	Interval string
	// User is the user to run the command as (optional).
	User string
	// ContentType is "raw" or "template" (optional, defaults to raw).
	ContentType string
	// Vars contains template variables (optional).
	Vars map[string]any
}

type CronEntryResult struct {
	Hostname string `json:"hostname,omitempty"`
	Status   string `json:"status"`
	Name     string `json:"name"`
	Object   string `json:"object,omitempty"`
	Schedule string `json:"schedule,omitempty"`
	Interval string `json:"interval,omitempty"`
	Source   string `json:"source,omitempty"`
	User     string `json:"user,omitempty"`
	Error    string `json:"error,omitempty"`
}

type CronMutationResult struct {
	Hostname string `json:"hostname,omitempty"`
	Status   string `json:"status"`
	Name     string `json:"name"`
	Changed  bool   `json:"changed"`
	Error    string `json:"error,omitempty"`
}

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

type CronUpdateOpts struct {
	// Object is the new object to deploy (optional).
	Object string
	// Schedule is the cron expression (optional).
	Schedule string
	// User is the user to run the command as (optional).
	User string
	// ContentType is "raw" or "template" (optional).
	ContentType string
	// Vars contains template variables (optional).
	Vars map[string]any
}

type DNSConfig struct {
	Hostname      string   `json:"hostname"`
	Status        string   `json:"status"`
	Error         string   `json:"error,omitempty"`
	Changed       bool     `json:"changed"`
	Servers       []string `json:"servers,omitempty"`
	SearchDomains []string `json:"search_domains,omitempty"`
}

type DNSDeleteResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	Error    string `json:"error,omitempty"`
	Changed  bool   `json:"changed"`
}

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

type DNSUpdateResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	Error    string `json:"error,omitempty"`
	Changed  bool   `json:"changed"`
}

type Disk struct {
	Name  string `json:"name"`
	Total int    `json:"total"`
	Used  int    `json:"used"`
	Free  int    `json:"free"`
}

type DiskResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	Error    string `json:"error,omitempty"`
	Changed  bool   `json:"changed"`
	Disks    []Disk `json:"disks,omitempty"`
}

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

type DockerActionResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	ID       string `json:"id,omitempty"`
	Message  string `json:"message,omitempty"`
	Changed  bool   `json:"changed"`
	Error    string `json:"error,omitempty"`
}

type DockerCreateOpts struct {
	// Image is the container image reference (required).
	Image string
	// Name is an optional container name.
	Name string
	// Hostname sets the container hostname.
	Hostname string
	// DNS sets custom DNS servers for the container.
	DNS []string
	// Command overrides the image's default command.
	Command []string
	// Env is environment variables in KEY=VALUE format.
	Env []string
	// Ports is port mappings in host_port:container_port format.
	Ports []string
	// Volumes is volume mounts in host_path:container_path format.
	Volumes []string
	// AutoStart starts the container after creation (default true).
	AutoStart *bool
}

type DockerDetailResult struct {
	Hostname        string            `json:"hostname"`
	Status          string            `json:"status"`
	ID              string            `json:"id,omitempty"`
	Name            string            `json:"name,omitempty"`
	Image           string            `json:"image,omitempty"`
	State           string            `json:"state,omitempty"`
	Created         string            `json:"created,omitempty"`
	Ports           []string          `json:"ports,omitempty"`
	Mounts          []string          `json:"mounts,omitempty"`
	Env             []string          `json:"env,omitempty"`
	NetworkSettings map[string]string `json:"network_settings,omitempty"`
	Health          string            `json:"health,omitempty"`
	Changed         bool              `json:"changed"`
	Error           string            `json:"error,omitempty"`
}

type DockerExecOpts struct {
	// Command is the command and arguments to execute (required).
	Command []string
	// Env is additional environment variables in KEY=VALUE format.
	Env []string
	// WorkingDir is the working directory inside the container.
	WorkingDir string
}

type DockerExecResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	Stdout   string `json:"stdout,omitempty"`
	Stderr   string `json:"stderr,omitempty"`
	ExitCode int    `json:"exit_code"`
	Changed  bool   `json:"changed"`
	Error    string `json:"error,omitempty"`
}

type DockerImageRemoveParams struct {
	// Force forces removal even if the image is in use.
	Force bool
}

type DockerListParams struct {
	// State filters by state: "running", "stopped", "all".
	State string
	// Limit caps the number of results.
	Limit int
}

type DockerListResult struct {
	Hostname   string              `json:"hostname"`
	Status     string              `json:"status"`
	Containers []DockerSummaryItem `json:"containers,omitempty"`
	Changed    bool                `json:"changed"`
	Error      string              `json:"error,omitempty"`
}

type DockerPullOpts struct {
	// Image is the image reference to pull (required).
	Image string
}

type DockerPullResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	ImageID  string `json:"image_id,omitempty"`
	Tag      string `json:"tag,omitempty"`
	Size     int64  `json:"size"`
	Changed  bool   `json:"changed"`
	Error    string `json:"error,omitempty"`
}

type DockerRemoveParams struct {
	// Force forces removal of a running container.
	Force bool
}

type DockerResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	ID       string `json:"id,omitempty"`
	Name     string `json:"name,omitempty"`
	Image    string `json:"image,omitempty"`
	State    string `json:"state,omitempty"`
	Created  string `json:"created,omitempty"`
	Changed  bool   `json:"changed"`
	Error    string `json:"error,omitempty"`
}

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

type DockerStopOpts struct {
	// Timeout is seconds to wait before killing. Zero uses default.
	Timeout int
}

type DockerSummaryItem struct {
	ID      string `json:"id"`
	Name    string `json:"name"`
	Image   string `json:"image"`
	State   string `json:"state"`
	Created string `json:"created"`
}

type ExecRequest struct {
	// Command is the binary to execute (required).
	Command string

	// Args is the argument list passed to the command.
	Args []string

	// Cwd is the working directory. Empty uses the agent default.
	Cwd string

	// Timeout in seconds. Zero uses the server default (30s).
	Timeout int

	// Target specifies the host: "_any", "_all", hostname, or
	// label ("group:web").
	Target string
}

type FileChanged struct {
	Name    string `json:"name"`
	Changed bool   `json:"changed"`
	SHA256  string `json:"sha256"`
}

type FileDelete struct {
	Name    string `json:"name"`
	Deleted bool   `json:"deleted"`
}

type FileDeployOpts struct {
	// ObjectName is the name of the file in the Object Store (required).
	ObjectName string

	// Path is the destination path on the target filesystem (required).
	Path string

	// ContentType is "raw" or "template" (required).
	ContentType string

	// Mode is the file permission mode (e.g., "0644"). Optional.
	Mode string

	// Owner is the file owner user. Optional.
	Owner string

	// Group is the file owner group. Optional.
	Group string

	// Vars are template variables when ContentType is "template". Optional.
	Vars map[string]any

	// Target specifies the host: "_any", "_all", hostname, or
	// label ("group:web").
	Target string
}

type FileDeployResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	Changed  bool   `json:"changed"`
	Error    string `json:"error,omitempty"`
}

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

type FileItem struct {
	Name        string `json:"name"`
	SHA256      string `json:"sha256"`
	Size        int    `json:"size"`
	ContentType string `json:"content_type"`
	Source      string `json:"source"`
}

type FileList struct {
	Files []FileItem `json:"files"`
	Total int        `json:"total"`
}

type FileMetadata struct {
	Name        string `json:"name"`
	SHA256      string `json:"sha256"`
	Size        int    `json:"size"`
	ContentType string `json:"content_type"`
}

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

type FileStatusResult struct {
	Hostname string `json:"hostname"`
	Path     string `json:"path,omitempty"`
	Status   string `json:"status,omitempty"`
	SHA256   string `json:"sha256,omitempty"`
	Changed  bool   `json:"changed"`
	Error    string `json:"error,omitempty"`
}

type FileUndeployOpts struct {
	// Path is the filesystem path to remove from the target host (required).
	Path string

	// Target specifies the host: "_any", "_all", hostname, or
	// label ("group:web").
	Target string
}

type FileUndeployResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	Changed  bool   `json:"changed"`
	Error    string `json:"error,omitempty"`
}

type FileUpload struct {
	Name        string `json:"name"`
	SHA256      string `json:"sha256"`
	Size        int    `json:"size"`
	Changed     bool   `json:"changed"`
	ContentType string `json:"content_type"`
}

type GroupCreateOpts struct {
	// Name is the group name. Required.
	Name string
	// GID is the numeric group ID. If zero, the system assigns one.
	GID int
	// System creates a system group.
	System bool
}

type GroupInfo struct {
	Name    string   `json:"name,omitempty"`
	GID     int      `json:"gid,omitempty"`
	Members []string `json:"members,omitempty"`
}

type GroupInfoResult struct {
	Hostname string      `json:"hostname"`
	Status   string      `json:"status"`
	Groups   []GroupInfo `json:"groups,omitempty"`
	Error    string      `json:"error,omitempty"`
}

type GroupMutationResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	Name     string `json:"name,omitempty"`
	Changed  bool   `json:"changed"`
	Error    string `json:"error,omitempty"`
}

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

type GroupUpdateOpts struct {
	// Members is the list of group member usernames (replaces existing).
	Members []string
}

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

type HealthStatus struct {
	Status string `json:"status"`
}

type HostnameResult struct {
	Hostname string            `json:"hostname"`
	Status   string            `json:"status"`
	Error    string            `json:"error,omitempty"`
	Changed  bool              `json:"changed"`
	Labels   map[string]string `json:"labels,omitempty"`
}

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

type HostnameUpdateResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	Error    string `json:"error,omitempty"`
	Changed  bool   `json:"changed"`
}

type InterfaceConfigOpts struct {
	// DHCP4 enables or disables DHCPv4.
	DHCP4 *bool
	// DHCP6 enables or disables DHCPv6.
	DHCP6 *bool
	// Addresses is the list of IP addresses in CIDR notation.
	Addresses []string
	// Gateway4 is the IPv4 gateway address.
	Gateway4 string
	// Gateway6 is the IPv6 gateway address.
	Gateway6 string
	// MTU is the maximum transmission unit.
	MTU *int
	// MACAddress is the hardware MAC address.
	MACAddress string
	// WakeOnLAN enables or disables Wake-on-LAN.
	WakeOnLAN *bool
}

type InterfaceGetResult struct {
	Hostname  string         `json:"hostname"`
	Status    string         `json:"status"`
	Error     string         `json:"error,omitempty"`
	Interface *InterfaceInfo `json:"interface,omitempty"`
}

type InterfaceInfo struct {
	Name       string   `json:"name,omitempty"`
	IPv4       string   `json:"ipv4,omitempty"`
	IPv6       string   `json:"ipv6,omitempty"`
	MAC        string   `json:"mac,omitempty"`
	Family     string   `json:"family,omitempty"`
	Primary    bool     `json:"primary"`
	DHCP4      bool     `json:"dhcp4"`
	DHCP6      bool     `json:"dhcp6"`
	Addresses  []string `json:"addresses,omitempty"`
	Gateway4   string   `json:"gateway4,omitempty"`
	Gateway6   string   `json:"gateway6,omitempty"`
	MTU        int      `json:"mtu,omitempty"`
	MACAddress string   `json:"mac_address,omitempty"`
	WakeOnLAN  bool     `json:"wakeonlan"`
	State      string   `json:"state,omitempty"`
}

type InterfaceListResult struct {
	Hostname   string          `json:"hostname"`
	Status     string          `json:"status"`
	Error      string          `json:"error,omitempty"`
	Interfaces []InterfaceInfo `json:"interfaces,omitempty"`
}

type InterfaceMutationResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	Name     string `json:"name,omitempty"`
	Changed  bool   `json:"changed"`
	Error    string `json:"error,omitempty"`
}

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

type JobCreated struct {
	JobID     string `json:"job_id"`
	Status    string `json:"status"`
	Revision  int64  `json:"revision"`
	Timestamp string `json:"timestamp,omitempty"`
}

type JobDetail struct {
	ID          string                      `json:"id,omitempty"`
	Status      string                      `json:"status,omitempty"`
	Hostname    string                      `json:"hostname,omitempty"`
	Created     string                      `json:"created,omitempty"`
	UpdatedAt   string                      `json:"updated_at,omitempty"`
	Error       string                      `json:"error,omitempty"`
	Changed     *bool                       `json:"changed,omitempty"`
	Operation   map[string]any              `json:"operation,omitempty"`
	Result      any                         `json:"result,omitempty"`
	AgentStates map[string]AgentState       `json:"agent_states,omitempty"`
	Responses   map[string]AgentJobResponse `json:"responses,omitempty"`
	Timeline    []TimelineEvent             `json:"timeline,omitempty"`
}

type JobList struct {
	Items        []JobDetail    `json:"items,omitempty"`
	TotalItems   int            `json:"total_items"`
	StatusCounts map[string]int `json:"status_counts,omitempty"`
}

type JobOperation = string

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

type JobStats struct {
	Total       int `json:"total"`
	Completed   int `json:"completed"`
	Failed      int `json:"failed"`
	Processing  int `json:"processing"`
	Unprocessed int `json:"unprocessed"`
	Dlq         int `json:"dlq"`
}

type JobStatus string

type JobType = string

type KVBucketInfo struct {
	Name  string `json:"name"`
	Keys  int    `json:"keys"`
	Bytes int    `json:"bytes"`
}

type ListParams struct {
	// Status filters by job status (e.g., "pending", "completed").
	Status string

	// Limit is the maximum number of results. Zero uses server default.
	Limit int

	// Offset is the number of results to skip. Zero starts from the
	// beginning.
	Offset int
}

type LoadAverage struct {
	OneMin     float32 `json:"one_min"`
	FiveMin    float32 `json:"five_min"`
	FifteenMin float32 `json:"fifteen_min"`
}

type LoadResult struct {
	Hostname    string       `json:"hostname"`
	Status      string       `json:"status"`
	Error       string       `json:"error,omitempty"`
	Changed     bool         `json:"changed"`
	LoadAverage *LoadAverage `json:"load_average,omitempty"`
}

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

type LogEntry struct {
	Timestamp string `json:"timestamp,omitempty"`
	Unit      string `json:"unit,omitempty"`
	Priority  string `json:"priority,omitempty"`
	Message   string `json:"message,omitempty"`
	PID       int    `json:"pid,omitempty"`
	Hostname  string `json:"hostname,omitempty"`
}

type LogEntryResult struct {
	Hostname string     `json:"hostname"`
	Status   string     `json:"status"`
	Entries  []LogEntry `json:"entries,omitempty"`
	Error    string     `json:"error,omitempty"`
}

type LogQueryOpts struct {
	// Lines is the maximum number of log lines to return.
	Lines *int
	// Since filters entries since this time (e.g., "1h", "2026-01-01 00:00:00").
	Since *string
	// Priority filters by log priority level (e.g., "err", "warning", "info").
	Priority *string
}

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

type LogSourceResult struct {
	Hostname string   `json:"hostname"`
	Status   string   `json:"status"`
	Sources  []string `json:"sources,omitempty"`
	Error    string   `json:"error,omitempty"`
}

type Memory struct {
	Total int `json:"total"`
	Used  int `json:"used"`
	Free  int `json:"free"`
}

type MemoryResult struct {
	Hostname string  `json:"hostname"`
	Status   string  `json:"status"`
	Error    string  `json:"error,omitempty"`
	Changed  bool    `json:"changed"`
	Memory   *Memory `json:"memory,omitempty"`
}

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

type MessageResponse struct {
	Message string
}

type NATSInfo struct {
	URL     string `json:"url"`
	Version string `json:"version"`
}

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

type NetworkInterface struct {
	Name   string `json:"name"`
	Family string `json:"family,omitempty"`
	IPv4   string `json:"ipv4,omitempty"`
	IPv6   string `json:"ipv6,omitempty"`
	MAC    string `json:"mac,omitempty"`
}

type NodeStatus struct {
	Hostname    string       `json:"hostname"`
	Status      string       `json:"status"`
	Uptime      string       `json:"uptime,omitempty"`
	Error       string       `json:"error,omitempty"`
	Changed     bool         `json:"changed"`
	Disks       []Disk       `json:"disks,omitempty"`
	LoadAverage *LoadAverage `json:"load_average,omitempty"`
	Memory      *Memory      `json:"memory,omitempty"`
	OSInfo      *OSInfo      `json:"os_info,omitempty"`
}

type NotFoundError struct {
	APIError
}

type NtpCreateOpts struct {
	// Servers is the list of NTP server addresses to configure. Required.
	Servers []string
}

type NtpMutationResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	Changed  bool   `json:"changed"`
	Error    string `json:"error,omitempty"`
}

type NtpStatusResult struct {
	Hostname      string   `json:"hostname"`
	Status        string   `json:"status"`
	Synchronized  bool     `json:"synchronized,omitempty"`
	Stratum       int      `json:"stratum,omitempty"`
	Offset        string   `json:"offset,omitempty"`
	CurrentSource string   `json:"current_source,omitempty"`
	Servers       []string `json:"servers,omitempty"`
	Error         string   `json:"error,omitempty"`
}

type NtpUpdateOpts struct {
	// Servers is the list of NTP server addresses to configure. Required.
	Servers []string
}

type OSInfo struct {
	Distribution string `json:"distribution"`
	Version      string `json:"version"`
}

type OSInfoResult struct {
	Hostname string  `json:"hostname"`
	Status   string  `json:"status"`
	Error    string  `json:"error,omitempty"`
	Changed  bool    `json:"changed"`
	OSInfo   *OSInfo `json:"os_info,omitempty"`
}

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

type ObjectStoreInfo struct {
	Name string `json:"name"`
	Size int    `json:"size"`
}

type Option func(*Client)

type PackageInfo struct {
	Name        string `json:"name,omitempty"`
	Version     string `json:"version,omitempty"`
	Description string `json:"description,omitempty"`
	Status      string `json:"status,omitempty"`
	Size        int64  `json:"size,omitempty"`
}

type PackageInfoResult struct {
	Hostname string        `json:"hostname"`
	Status   string        `json:"status"`
	Packages []PackageInfo `json:"packages,omitempty"`
	Error    string        `json:"error,omitempty"`
}

type PackageMutationResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	Name     string `json:"name,omitempty"`
	Changed  bool   `json:"changed"`
	Error    string `json:"error,omitempty"`
}

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

type PackageUpdateResult struct {
	Hostname string       `json:"hostname"`
	Status   string       `json:"status"`
	Updates  []UpdateInfo `json:"updates,omitempty"`
	Error    string       `json:"error,omitempty"`
}

type PendingAgent struct {
	MachineID   string    `json:"machine_id"`
	Hostname    string    `json:"hostname"`
	Fingerprint string    `json:"fingerprint"`
	RequestedAt time.Time `json:"requested_at"`
}

type PendingAgentList struct {
	Agents []PendingAgent `json:"agents"`
	Total  int            `json:"total"`
}

type Permission = string

type PingResult struct {
	Hostname        string  `json:"hostname"`
	Status          string  `json:"status"`
	Error           string  `json:"error,omitempty"`
	Changed         bool    `json:"changed"`
	PacketsSent     int     `json:"packets_sent"`
	PacketsReceived int     `json:"packets_received"`
	PacketLoss      float64 `json:"packet_loss"`
	MinRtt          string  `json:"min_rtt,omitempty"`
	AvgRtt          string  `json:"avg_rtt,omitempty"`
	MaxRtt          string  `json:"max_rtt,omitempty"`
}

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

type PowerOpts struct {
	// Delay is the number of seconds to wait before executing the operation.
	Delay int
	// Message is an optional message to broadcast before the operation.
	Message string
}

type PowerResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	Action   string `json:"action,omitempty"`
	Delay    int    `json:"delay,omitempty"`
	Changed  bool   `json:"changed"`
	Error    string `json:"error,omitempty"`
}

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

type ProcessInfo struct {
	PID        int     `json:"pid"`
	Name       string  `json:"name,omitempty"`
	User       string  `json:"user,omitempty"`
	State      string  `json:"state,omitempty"`
	CPUPercent float64 `json:"cpu_percent,omitempty"`
	MemPercent float32 `json:"mem_percent,omitempty"`
	MemRSS     int64   `json:"mem_rss,omitempty"`
	Command    string  `json:"command,omitempty"`
	StartTime  string  `json:"start_time,omitempty"`
}

type ProcessInfoResult struct {
	Hostname  string        `json:"hostname"`
	Status    string        `json:"status"`
	Processes []ProcessInfo `json:"processes,omitempty"`
	Error     string        `json:"error,omitempty"`
}

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

type ProcessSignalOpts struct {
	// Signal is the signal name to send (e.g., TERM, KILL, HUP).
	Signal string
}

type ProcessSignalResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	PID      int    `json:"pid,omitempty"`
	Signal   string `json:"signal,omitempty"`
	Changed  bool   `json:"changed"`
	Error    string `json:"error,omitempty"`
}

type ReadyStatus struct {
	Status             string `json:"status"`
	Error              string `json:"error,omitempty"`
	ServiceUnavailable bool   `json:"service_unavailable"`
}

type RegistryEntry struct {
	Type       string   `json:"type"`
	Hostname   string   `json:"hostname"`
	Status     string   `json:"status"`
	Conditions []string `json:"conditions,omitempty"`
	Age        string   `json:"age"`
	CPUPercent float64  `json:"cpu_percent"`
	MemBytes   int64    `json:"mem_bytes"`
}

type Response[T any] struct {
	Data T
	// contains filtered or unexported fields
}

type Role = string

type Route struct {
	Destination string `json:"destination"`
	Gateway     string `json:"gateway"`
	Interface   string `json:"interface"`
	Mask        string `json:"mask,omitempty"`
	Flags       string `json:"flags,omitempty"`
	Metric      int    `json:"metric"`
}

type RouteConfigOpts struct {
	// Routes is the list of route entries. Required.
	Routes []RouteItem
}

type RouteGetResult struct {
	Hostname string      `json:"hostname"`
	Status   string      `json:"status"`
	Error    string      `json:"error,omitempty"`
	Routes   []RouteInfo `json:"routes,omitempty"`
}

type RouteInfo struct {
	Destination string `json:"destination,omitempty"`
	Gateway     string `json:"gateway,omitempty"`
	Interface   string `json:"interface,omitempty"`
	Metric      int    `json:"metric,omitempty"`
	Scope       string `json:"scope,omitempty"`
}

type RouteItem struct {
	// To is the destination in CIDR notation. Required.
	To string
	// Via is the gateway IP address. Required.
	Via string
	// Metric is the route metric (priority). Optional.
	Metric *int
}

type RouteListResult struct {
	Hostname string      `json:"hostname"`
	Status   string      `json:"status"`
	Error    string      `json:"error,omitempty"`
	Routes   []RouteInfo `json:"routes,omitempty"`
}

type RouteMutationResult struct {
	Hostname  string `json:"hostname"`
	Status    string `json:"status"`
	Interface string `json:"interface,omitempty"`
	Changed   bool   `json:"changed"`
	Error     string `json:"error,omitempty"`
}

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

type SSHKeyAddOpts struct {
	// Key is the full SSH public key line (e.g., "ssh-ed25519 AAAA... user@host").
	Key string
}

type SSHKeyInfo struct {
	Type        string `json:"type,omitempty"`
	Fingerprint string `json:"fingerprint,omitempty"`
	Comment     string `json:"comment,omitempty"`
}

type SSHKeyInfoResult struct {
	Hostname string       `json:"hostname"`
	Status   string       `json:"status"`
	Keys     []SSHKeyInfo `json:"keys,omitempty"`
	Error    string       `json:"error,omitempty"`
}

type SSHKeyMutationResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	Changed  bool   `json:"changed"`
	Error    string `json:"error,omitempty"`
}

type ServerError struct {
	APIError
}

type ServiceCreateOpts struct {
	// Name is the service unit name (required).
	Name string
	// Object is the object store reference for the unit file (required).
	Object string
}

type ServiceGetResult struct {
	Hostname string       `json:"hostname"`
	Status   string       `json:"status"`
	Service  *ServiceInfo `json:"service,omitempty"`
	Error    string       `json:"error,omitempty"`
}

type ServiceInfo struct {
	Name        string `json:"name,omitempty"`
	Status      string `json:"status,omitempty"`
	Enabled     bool   `json:"enabled"`
	Description string `json:"description,omitempty"`
	PID         int    `json:"pid,omitempty"`
}

type ServiceInfoResult struct {
	Hostname string        `json:"hostname"`
	Status   string        `json:"status"`
	Services []ServiceInfo `json:"services,omitempty"`
	Error    string        `json:"error,omitempty"`
}

type ServiceMutationResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	Name     string `json:"name"`
	Changed  bool   `json:"changed"`
	Error    string `json:"error,omitempty"`
}

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

type ServiceUpdateOpts struct {
	// Object is the new object store reference for the unit file (required).
	Object string
}

type ShellRequest struct {
	// Command is the shell command string passed to /bin/sh -c (required).
	Command string

	// Cwd is the working directory. Empty uses the agent default.
	Cwd string

	// Timeout in seconds. Zero uses the server default (30s).
	Timeout int

	// Target specifies the host: "_any", "_all", hostname, or
	// label ("group:web").
	Target string
}

type StaleDeployment struct {
	ObjectName  string `json:"object_name"`
	Hostname    string `json:"hostname"`
	Provider    string `json:"provider"`
	Path        string `json:"path"`
	DeployedSHA string `json:"deployed_sha"`
	CurrentSHA  string `json:"current_sha"`
	DeployedAt  string `json:"deployed_at"`
}

type StaleList struct {
	Stale []StaleDeployment `json:"stale"`
	Total int               `json:"total"`
}

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

type StreamInfo struct {
	Name      string `json:"name"`
	Messages  int    `json:"messages"`
	Bytes     int    `json:"bytes"`
	Consumers int    `json:"consumers"`
}

type SysctlCreateOpts struct {
	// Key is the sysctl parameter name (e.g., "net.ipv4.ip_forward"). Required.
	Key string
	// Value is the parameter value. Required.
	Value string
}

type SysctlEntryResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	Key      string `json:"key,omitempty"`
	Value    string `json:"value,omitempty"`
	Error    string `json:"error,omitempty"`
}

type SysctlMutationResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	Key      string `json:"key,omitempty"`
	Changed  bool   `json:"changed"`
	Error    string `json:"error,omitempty"`
}

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

type SysctlUpdateOpts struct {
	// Value is the new parameter value. Required.
	Value string
}

type SystemStatus struct {
	Status             string                     `json:"status"`
	Version            string                     `json:"version"`
	Uptime             string                     `json:"uptime"`
	ServiceUnavailable bool                       `json:"service_unavailable"`
	Components         map[string]ComponentHealth `json:"components,omitempty"`
	NATS               *NATSInfo                  `json:"nats,omitempty"`
	Agents             *AgentStats                `json:"agents,omitempty"`
	Jobs               *JobStats                  `json:"jobs,omitempty"`
	Consumers          *ConsumerStats             `json:"consumers,omitempty"`
	Streams            []StreamInfo               `json:"streams,omitempty"`
	KVBuckets          []KVBucketInfo             `json:"kv_buckets,omitempty"`
	ObjectStores       []ObjectStoreInfo          `json:"object_stores,omitempty"`
	Registry           []RegistryEntry            `json:"registry,omitempty"`
}

type TimelineEvent struct {
	Timestamp string `json:"timestamp"`
	Event     string `json:"event"`
	Hostname  string `json:"hostname,omitempty"`
	Message   string `json:"message,omitempty"`
	Error     string `json:"error,omitempty"`
}

type TimezoneMutationResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	Timezone string `json:"timezone,omitempty"`
	Changed  bool   `json:"changed"`
	Error    string `json:"error,omitempty"`
}

type TimezoneResult struct {
	Hostname  string `json:"hostname"`
	Status    string `json:"status"`
	Timezone  string `json:"timezone,omitempty"`
	UTCOffset string `json:"utc_offset,omitempty"`
	Error     string `json:"error,omitempty"`
}

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

type TimezoneUpdateOpts struct {
	// Timezone is the IANA timezone name (e.g., "America/New_York"). Required.
	Timezone string
}

type UnexpectedStatusError struct {
	APIError
}

type UpdateInfo struct {
	Name           string `json:"name,omitempty"`
	CurrentVersion string `json:"current_version,omitempty"`
	NewVersion     string `json:"new_version,omitempty"`
}

type UploadOption func(*uploadOptions)

type UptimeResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	Uptime   string `json:"uptime,omitempty"`
	Error    string `json:"error,omitempty"`
	Changed  bool   `json:"changed"`
}

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

type UserCreateOpts struct {
	// Name is the username. Required.
	Name string
	// UID is the numeric user ID. If zero, the system assigns one.
	UID int
	// GID is the primary group ID. If zero, a group matching the username is created.
	GID int
	// Home is the home directory path.
	Home string
	// Shell is the login shell path.
	Shell string
	// Groups is the list of supplementary group names.
	Groups []string
	// Password is the initial password (plaintext, hashed by the agent).
	Password string
	// System creates a system account.
	System bool
}

type UserInfo struct {
	Name   string   `json:"name,omitempty"`
	UID    int      `json:"uid,omitempty"`
	GID    int      `json:"gid,omitempty"`
	Home   string   `json:"home,omitempty"`
	Shell  string   `json:"shell,omitempty"`
	Groups []string `json:"groups,omitempty"`
	Locked bool     `json:"locked,omitempty"`
}

type UserInfoResult struct {
	Hostname string     `json:"hostname"`
	Status   string     `json:"status"`
	Users    []UserInfo `json:"users,omitempty"`
	Error    string     `json:"error,omitempty"`
}

type UserMutationResult struct {
	Hostname string `json:"hostname"`
	Status   string `json:"status"`
	Name     string `json:"name,omitempty"`
	Changed  bool   `json:"changed"`
	Error    string `json:"error,omitempty"`
}

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

type UserUpdateOpts struct {
	// Shell is the new login shell path.
	Shell string
	// Home is the new home directory path.
	Home string
	// Groups is the list of supplementary group names (replaces existing).
	Groups []string
	// Lock locks or unlocks the account.
	Lock *bool
}

type ValidationError struct {
	APIError
}