firecracker

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

type Config struct {
	// BinaryPath is the path to the firecracker binary.
	// Default: firecracker (uses PATH)
	BinaryPath string

	// KernelPath is the path to the guest kernel.
	// Required for execution.
	KernelPath string

	// RootfsPath is the path to the root filesystem image.
	// Required for execution.
	RootfsPath string

	// SocketPath is the path for the Firecracker API socket.
	// Default: auto-generated per VM
	SocketPath string

	// VCPUCount is the number of virtual CPUs.
	// Default: 1
	VCPUCount int

	// MemSizeMB is the memory size in megabytes.
	// Default: 128
	MemSizeMB int

	// Image is the container image to use for execution when supported.
	// Default: toolruntime-sandbox:latest
	Image string

	// Client executes microVM specs.
	// If nil, Execute() returns ErrClientNotConfigured.
	Client MicroVMRunner

	// HealthChecker optionally verifies Firecracker availability.
	HealthChecker HealthChecker

	// Logger is an optional logger for backend events.
	Logger Logger
}

type HealthChecker interface {
	Ping(ctx context.Context) error
}

type Logger interface {
	Info(msg string, args ...any)
	Warn(msg string, args ...any)
	Error(msg string, args ...any)
}

type MicroVMResult struct {
	ExitCode int
	Stdout   string
	Stderr   string
	Duration time.Duration
}

type MicroVMRunner interface {
	Run(ctx context.Context, spec MicroVMSpec) (MicroVMResult, error)
}

type MicroVMSpec struct {
	Image      string
	Command    []string
	WorkingDir string
	Env        []string
	Resources  VMResourceSpec
	Config     VMConfig
	Timeout    time.Duration
	Labels     map[string]string
}

type VMConfig struct {
	KernelPath string
	RootfsPath string
	SocketPath string
}

type VMResourceSpec struct {
	VCPUCount int
	MemSizeMB int
}