plugins

type BasePlugin struct{}

type Factory func(h framework.Handle, args framework.Args) (Plugin, error)

type Plugin interface {
	// Name returns a unique identifier for this plugin (used in logs).
	Name() string

	// Start is called once during bootstrap, after the host has constructed
	// every plugin but before the reconciler begins processing. Plugins that
	// need their own informers (e.g. a ConfigMap-backed catalog) register
	// them here via the supplied framework.Handle.Cache(). A non-nil error
	// aborts program startup.
	Start(ctx context.Context, h framework.Handle) error

	// PreCreatePool is called after input validation and template resolution,
	// before the SandboxPool is persisted to Kubernetes.
	// The plugin may:
	//   - Mutate pool.Labels / pool.Annotations / pool.Spec
	//   - Read from input for context (auth info, caller-supplied metadata)
	//   - Reject by returning an error (ideally *AdmissionError with status hint)
	PreCreatePool(ctx context.Context, pool *agentsv1alpha1.SandboxPool) *domain.AppError

	// PreUpdatePool is called before the SandboxPool update is persisted.
	// oldPool is the current state; newPool is the state that will be written.
	// The plugin may mutate newPool or reject the operation.
	// Return updated=true if newPool was mutated and must be persisted to Kubernetes.
	PreUpdatePool(ctx context.Context, newPool *agentsv1alpha1.SandboxPool, pods []corev1.Pod) (updated bool, err *domain.AppError)

	// PreDeletePool is called before the SandboxPool is deleted from Kubernetes.
	// The plugin may reject the operation.
	PreDeletePool(ctx context.Context, pool *agentsv1alpha1.SandboxPool) *domain.AppError

	// PreCreatePod is called after the Pod object is fully assembled but BEFORE
	// it is submitted to Kubernetes. Plugins may mutate pod.Spec (e.g. inject
	// NodeAffinity). A non-nil error aborts pod creation for this attempt;
	// the reconciler will retry on the next tick.
	PreCreatePod(ctx context.Context, pod *corev1.Pod, pool *agentsv1alpha1.SandboxPool) *domain.AppError
}

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