agentlink

type AllocationSpec struct {
	IP   string `json:"ip"`
	Port int    `json:"port"`
}

type CertRenew struct {
	CSR string `json:"csr"`
}

type CertRenewed struct {
	Certificate string    `json:"certificate"`
	ExpiresAt   time.Time `json:"expires_at"`
}

type ConfigFileSpec struct {
	Path   string          `json:"path"`
	Parser string          `json:"parser"`
	Find   json.RawMessage `json:"find"`
}

type ConsoleCommand struct {
	ID      string `json:"id"`
	Command string `json:"command"`
}

type ConsoleLines struct {
	ID    string   `json:"id"`
	Lines []string `json:"lines"`
}

type CronJob struct {
	Schedule string `json:"schedule"`
	Command  string `json:"command"`
}

type FileChunk struct {
	Size int64  `json:"size"`
	Data []byte `json:"data"`
	EOF  bool   `json:"eof"`
}

type FileDelete struct {
	ID    string   `json:"id"`
	Paths []string `json:"paths"`
}

type FileEntry struct {
	Name    string `json:"name"`
	Size    int64  `json:"size"`
	Mode    string `json:"mode"`
	ModTime int64  `json:"mod_time"`
	IsDir   bool   `json:"is_dir"`
	Symlink bool   `json:"symlink"`
}

type FileList struct {
	Path    string      `json:"path"`
	Entries []FileEntry `json:"entries"`
}

type FilePath struct {
	ID   string `json:"id"`
	Path string `json:"path"`
}

type FileRead struct {
	ID     string `json:"id"`
	Path   string `json:"path"`
	Offset int64  `json:"offset"`
	Length int    `json:"length"`
}

type FileRename struct {
	ID        string `json:"id"`
	From      string `json:"from"`
	To        string `json:"to"`
	Overwrite bool   `json:"overwrite,omitempty"`
}

type FileWrite struct {
	ID      string `json:"id"`
	Path    string `json:"path"`
	Content string `json:"content,omitempty"`
	Data    []byte `json:"data,omitempty"`
	Append  bool   `json:"append,omitempty"`
}

type Hello struct {
	Protocol      int    `json:"protocol"`
	AgentVersion  string `json:"agent_version"`
	Hostname      string `json:"hostname"`
	OS            string `json:"os"`
	Kernel        string `json:"kernel"`
	Arch          string `json:"arch"`
	CPUs          int    `json:"cpus"`
	MemoryBytes   uint64 `json:"memory_bytes"`
	DiskBytes     uint64 `json:"disk_bytes"`
	DiskFreeBytes uint64 `json:"disk_free_bytes"`
	DockerVersion string `json:"docker_version"`
	SFTPPort      int    `json:"sftp_port"`
	// Services the agent knows about and their current state.
	Services []ServiceState `json:"services"`
	// Web is the node's web hosting stack (nil = no web hosting).
	Web *WebCapabilities `json:"web,omitempty"`
	// Websites the agent knows.
	Websites []string `json:"websites,omitempty"`
}

type HelloOK struct {
	Protocol int    `json:"protocol"`
	NodeID   string `json:"node_id"`
}

type Hub struct {

	// OnConnect runs (in its own goroutine) after each successful handshake, e.g. to
	// deliver services created while the node was offline.
	OnConnect func(nodeID string)
	// OnRequest answers requests an agent sends to the panel (e.g. sftp.auth). It runs in its
	// own goroutine; the returned value becomes the reply's data.
	OnRequest func(ctx context.Context, nodeID string, msg Message) (any, error)
	// contains filtered or unexported fields
}

type InstallSpec struct {
	Container  string `json:"container"`
	Entrypoint string `json:"entrypoint"`
	Script     string `json:"script"`
}

type Limits struct {
	MemoryMB   int `json:"memory_mb"`
	CPUPercent int `json:"cpu_percent"` // 100 = one core; 0 = unlimited
	DiskMB     int `json:"disk_mb"`     // 0 = unlimited
	PIDs       int `json:"pids"`
}

type Message struct {
	ID      string          `json:"id,omitempty"`
	Type    string          `json:"type"`
	ReplyTo string          `json:"reply_to,omitempty"`
	Error   string          `json:"error,omitempty"`
	Data    json.RawMessage `json:"data,omitempty"`
}

type PowerRequest struct {
	ID     string `json:"id"`
	Action string `json:"action"` // start | stop | restart | kill
}

type SFTPAuth struct {
	Username string `json:"username"`
	Password string `json:"password"`
	IP       string `json:"ip"`
}

type SFTPLogin struct {
	ServiceID string `json:"service_id"`
}

type ServiceRef struct {
	ID string `json:"id"`
}

type ServiceSpec struct {
	ID          string            `json:"id"`
	Image       string            `json:"image"`
	Invocation  string            `json:"invocation"` // startup command with variables substituted
	Env         map[string]string `json:"env"`
	Install     InstallSpec       `json:"install"`
	Stop        StopSpec          `json:"stop"`
	DoneMarkers []string          `json:"done_markers"`
	ConfigFiles []ConfigFileSpec  `json:"config_files"`
	Limits      Limits            `json:"limits"`
	Allocation  AllocationSpec    `json:"allocation"`
	// SkipInstall: the files already exist (a server migrated from Wings); a first create
	// adopts them instead of running the install script.
	SkipInstall bool `json:"skip_install,omitempty"`
}

type ServiceState struct {
	ID     string `json:"id"`
	State  string `json:"state"`
	Detail string `json:"detail,omitempty"`
}

type Stats struct {
	ID               string  `json:"id"`
	CPUPercent       float64 `json:"cpu_percent"`
	MemoryBytes      uint64  `json:"memory_bytes"`
	MemoryLimitBytes uint64  `json:"memory_limit_bytes"`
	NetRxBytes       uint64  `json:"net_rx_bytes"`
	NetTxBytes       uint64  `json:"net_tx_bytes"`
	DiskBytes        uint64  `json:"disk_bytes"`
}

type StopSpec struct {
	Command string `json:"command,omitempty"`
	Signal  string `json:"signal,omitempty"`
}

type Subscriber struct {
	C chan Message
	// contains filtered or unexported fields
}

type WebBackup struct {
	File      string    `json:"file"`
	SizeBytes int64     `json:"size_bytes"`
	CreatedAt time.Time `json:"created_at"`
}

type WebCapabilities struct {
	PHP     []string `json:"php"`
	Caddy   bool     `json:"caddy"`
	MariaDB bool     `json:"mariadb"`
}

type WebDatabase struct {
	Name      string `json:"name"`
	SizeBytes int64  `json:"size_bytes"`
}

type WebDomain struct {
	Name    string   `json:"name"`
	Aliases []string `json:"aliases,omitempty"`
	Root    string   `json:"root"` // document root relative to ~/sites/<name> ("public", "." …)
	TLS     string   `json:"tls"`  // "auto" (ACME) or "internal" (Caddy's local CA, for testing)
}

type WebLimits struct {
	DiskMB     int `json:"disk_mb"`
	MemoryMB   int `json:"memory_mb"`
	CPUPercent int `json:"cpu_percent"`
	Processes  int `json:"processes"`
}

type WebsiteApp struct {
	ID     string `json:"id"`
	App    string `json:"app"`    // wordpress | git
	Domain string `json:"domain"` // one of the account's domains
	// WordPress: an existing database of the account.
	DBName     string `json:"db_name,omitempty"`
	DBPassword string `json:"db_password,omitempty"`
	// Git: HTTPS repository; a first deploy clones into the domain directory, later ones pull.
	Repo   string `json:"repo,omitempty"`
	Branch string `json:"branch,omitempty"`
}

type WebsiteAppResult struct {
	Message string `json:"message"`
}

type WebsiteBackup struct {
	ID     string `json:"id"`
	Action string `json:"action"`
	File   string `json:"file,omitempty"`
}

type WebsiteBackupList struct {
	Backups []WebBackup `json:"backups"`
}

type WebsiteDB struct {
	ID       string `json:"id"`
	Action   string `json:"action"`
	Name     string `json:"name,omitempty"`
	Password string `json:"password,omitempty"`
}

type WebsiteDBList struct {
	Databases []WebDatabase `json:"databases"`
}

type WebsiteSpec struct {
	ID          string            `json:"id"`
	Username    string            `json:"username"` // Linux user, also the database name prefix
	PHPVersion  string            `json:"php_version"`
	Domains     []WebDomain       `json:"domains"`
	Limits      WebLimits         `json:"limits"`
	PHP         map[string]string `json:"php,omitempty"` // php.ini overrides (allow-listed keys)
	Cron        []CronJob         `json:"cron,omitempty"`
	Suspended   bool              `json:"suspended"`
	BackupsKeep int               `json:"backups_keep,omitempty"`
}

type WebsiteStatus struct {
	ID        string `json:"id"`
	PHPActive bool   `json:"php_active"`
	DiskBytes uint64 `json:"disk_bytes"`
	Home      string `json:"home"`
}