docker

type Config struct {
	// Image is the container image to use. Required.
	Image string

	// ContainerPathPrefix / HostPathPrefix enable path alignment when anna
	// runs inside a container and talks to the daemon on the host (DooD).
	// Both fields are filled by applyDooDDefaults in the runner; callers
	// outside that path should leave them empty.
	ContainerPathPrefix string
	HostPathPrefix      string

	// UserToolBinaries are manifest-declared, user-configured CLIs that are not
	// baked into the versioned sandbox image. They are installed in a Linux
	// helper container and exposed to sessions through a Docker-managed tool
	// cache, never through host $ANNA_HOME/bin.
	UserToolBinaries []ToolBinary
}

type PreflightConfig struct {
	AnnaHome string
	Docker   Config
}

type ToolBinary struct {
	Name    string
	Tool    string // mise tool key: github:owner/repo, pipx:pkg, npm:pkg, http:name
	URL     string // required for http backend
	Version string

	// Shared asset options (github + http)
	StripComponents int
	BinPath         string
	Bin             string
	RenameExe       string
	Checksum        string

	// GitHub-only
	AssetPattern  string
	VersionPrefix string
	NoApp         bool
	FilterBins    string
	Prerelease    bool
	APIURL        string

	// HTTP-only
	Size            string
	Format          string
	VersionListURL  string
	VersionRegex    string
	VersionJSONPath string
	VersionExpr     string

	// Pipx-only
	Extras   string
	PipxArgs string
	UVX      bool
	UVXArgs  string
}