feat: add public plan library for system-agent

Signed-off-by: Carlos Salas <carlos.salas@suse.com>

Author: salasberryfin

pkg/plan/go.mod

@@ -0,0 +1,5 @@
+module github.com/rancher/rancher/pkg/plan
+
+go 1.25.0
+
+toolchain go1.25.8

pkg/plan/types.go

@@ -0,0 +1,61 @@
+package plan
+
+// Plan represents the basic unit of work performed by the system-agent
+type Plan struct {
+	Files                []File                `json:"files,omitempty"`
+	OneTimeInstructions  []OneTimeInstruction  `json:"instructions,omitempty"`
+	Probes               map[string]Probe      `json:"probes,omitempty"`
+	PeriodicInstructions []PeriodicInstruction `json:"periodicInstructions,omitempty"`
+}
+
+type File struct {
+	Content     string `json:"content,omitempty"`
+	Directory   bool   `json:"directory,omitempty"`
+	UID         int    `json:"uid,omitempty"`
+	GID         int    `json:"gid,omitempty"`
+	Path        string `json:"path,omitempty"`
+	Permissions string `json:"permissions,omitempty"` // internally, the string will be converted to a uint32 to satisfy os.FileMode
+	Action      string `json:"action,omitempty"`
+}
+
+type Probe struct {
+	Name                string        `json:"name,omitempty"`
+	InitialDelaySeconds int           `json:"initialDelaySeconds,omitempty"` // default 0
+	TimeoutSeconds      int           `json:"timeoutSeconds,omitempty"`      // default 1
+	SuccessThreshold    int           `json:"successThreshold,omitempty"`    // default 1
+	FailureThreshold    int           `json:"failureThreshold,omitempty"`    // default 3
+	HTTPGetAction       HTTPGetAction `json:"httpGet,omitempty"`
+}
+
+type OneTimeInstruction struct {
+	CommonInstruction
+	SaveOutput bool `json:"saveOutput,omitempty"`
+}
+
+type CommonInstruction struct {
+	Name    string   `json:"name,omitempty"`
+	Image   string   `json:"image,omitempty"`
+	Env     []string `json:"env,omitempty"`
+	Args    []string `json:"args,omitempty"`
+	Command string   `json:"command,omitempty"`
+}
+
+type PeriodicInstruction struct {
+	CommonInstruction
+	PeriodSeconds    int  `json:"periodSeconds,omitempty"` // default 600, i.e. 10 minutes
+	SaveStderrOutput bool `json:"saveStderrOutput,omitempty"`
+}
+
+type ProbeStatus struct {
+	Healthy      bool `json:"healthy,omitempty"`
+	SuccessCount int  `json:"successCount,omitempty"`
+	FailureCount int  `json:"failureCount,omitempty"`
+}
+
+type HTTPGetAction struct {
+	URL        string `json:"url,omitempty"`
+	Insecure   bool   `json:"insecure,omitempty"`
+	ClientCert string `json:"clientCert,omitempty"`
+	ClientKey  string `json:"clientKey,omitempty"`
+	CACert     string `json:"caCert,omitempty"`
+}