sandboxbackend

type AsyncBackend interface {
	// Name identifies the backend for AgentHarness.Status.BackendRef.Backend
	// and logging.
	Name() v1alpha2.AgentHarnessBackendType

	// EnsureAgentHarness creates the sandbox on the backend if it does not
	// already exist. Implementations must be idempotent — if a sandbox
	// matching sbx.Name is already present, return its current handle.
	EnsureAgentHarness(ctx context.Context, ah *v1alpha2.AgentHarness) (EnsureResult, error)

	// GetStatus returns a Ready condition (status, reason, message) for
	// the sandbox identified by h. Used to refresh AgentHarness.Status after
	// each reconcile.
	GetStatus(ctx context.Context, h Handle) (metav1.ConditionStatus, string, string)

	// DeleteAgentHarness releases the sandbox. It performs at most one
	// reconcile-safe delete step and returns done=true once the sandbox is gone.
	// NotFound must be treated as success so the finalizer can be removed
	// idempotently.
	DeleteAgentHarness(ctx context.Context, h Handle) (done bool, err error)

	// OnAgentHarnessReady runs one-time work after the AgentHarness reports
	// Ready (for example ExecSandbox bootstrap inside the VM). Backends that
	// have no post-ready work should return nil.
	OnAgentHarnessReady(ctx context.Context, ah *v1alpha2.AgentHarness, h Handle) error
}

type Backend interface {
	BuildSandbox(ctx context.Context, in BuildInput) ([]client.Object, error)
	GetOwnedResourceTypes() []client.Object
	// OwnedResourceTypesFor returns owned types for the agent's sandbox platform (for reconcile lists).
	OwnedResourceTypesFor(agent v1alpha2.AgentObject) ([]client.Object, error)

	// ComputeReady reflects implementation-specific status into condition pieces for Agent.status.
	ComputeReady(ctx context.Context, cl client.Client, nn types.NamespacedName) (status metav1.ConditionStatus, reason, message string)
}

type BuildInput struct {
	Agent        v1alpha2.AgentObject
	PodTemplate  corev1.PodTemplateSpec
	WorkloadName string
	ExtraLabels  map[string]string
}

type EnsureResult struct {
	Handle   Handle
	Endpoint string
}

type Handle struct {
	ID string
}

type RoutingBackend struct {
	AgentSandbox Backend
	Substrate    Backend
}