builder

type BuildOptions struct {
	Stack      string // Stack name used in image identity
	ServerName string // Logical MCP server name used in image identity

	// Source configuration
	SourceType  string // "git" or "local"
	URL         string // Git URL (for git source)
	Ref         string // Git ref/branch (for git source)
	Path        string // Local path (for local source)
	ProjectPath string // Python project subdirectory below a local root
	Runtime     string // Empty for Dockerfile builds, "python" for generated builds
	Package     string // Public PyPI project name
	Python      string // Explicit Python minor version
	Extras      []string
	With        []string
	Packages    []string

	// Build configuration
	Dockerfile string            // Path to Dockerfile within context
	BuildArgs  map[string]string // Build arguments
	Command    []string          // Runtime command that affects the image plan
	Platform   string            // Target OCI platform, empty means runtime default

	// Cache control
	NoCache bool // Force rebuild, ignore cache

	// Auth carries an already-resolved git auth method for private repository
	// clones. Nil means an unauthenticated clone (the public-repo default).
	// Resolution from a declarative SourceAuth happens upstream so that this
	// package never has to know about vaults or credential references.
	Auth transport.AuthMethod

	// Logger for build operations (optional, defaults to discard)
	Logger *slog.Logger
}

type BuildProvenance struct {
	SourceContentDigest string `json:"sourceContentDigest"`
	TargetPlatform      string `json:"targetPlatform,omitempty"`
	GeneratorVersion    string `json:"generatorVersion,omitempty"`
	BaseImage           string `json:"baseImage,omitempty"`
	UVImage             string `json:"uvImage,omitempty"`
}

type BuildResult struct {
	ImageID  string // Docker image ID
	ImageTag string // Image tag
	Cached   bool   // Whether the build was cached
}

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

type PyPIArtifact struct {
	Filename       string `json:"filename"`
	URL            string `json:"url"`
	Packagetype    string `json:"packageType"`
	SHA256         string `json:"sha256"`
	Size           int64  `json:"size"`
	RequiresPython string `json:"requiresPython,omitempty"`
}

type PyPIRelease struct {
	Package        string                `json:"package"`
	Version        string                `json:"version"`
	RequiresPython string                `json:"requiresPython,omitempty"`
	Python         string                `json:"python"`
	Artifact       PyPIArtifact          `json:"artifact"`
	Metadata       PythonPackageMetadata `json:"metadata"`
}

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

type PyPIVersions struct {
	Package  string   `json:"package"`
	Latest   string   `json:"latest"`
	Versions []string `json:"versions"`
}

type PythonBuildSpec struct {
	Python   string
	Package  string
	Version  string
	Extras   []string
	With     []string
	Packages []string
	Command  []string
	Local    bool
	Locked   bool
}

type PythonPackageMetadata struct {
	Name           string   `json:"name"`
	Version        string   `json:"version,omitempty"`
	RequiresPython string   `json:"requiresPython,omitempty"`
	ConsoleScripts []string `json:"consoleScripts,omitempty"`
}

type PythonProjectMetadata struct {
	Name           string   `json:"name"`
	Version        string   `json:"version,omitempty"`
	RequiresPython string   `json:"requiresPython,omitempty"`
	ConsoleScripts []string `json:"consoleScripts,omitempty"`
	HasUVLock      bool     `json:"hasUVLock"`
	SourceFile     string   `json:"sourceFile"`
}

type PythonTemplateConfig struct {
	Version      string            `json:"version"`
	PythonImages map[string]string `json:"pythonImages"`
	UVImage      string            `json:"uvImage"`
	RuntimeUID   int               `json:"runtimeUid"`
	RuntimeGID   int               `json:"runtimeGid"`
}

type ResolvedBuildPlan struct {
	DeclaredIdentity     SourceIdentity  `json:"declaredIdentity"`
	ResolvedIdentity     SourceIdentity  `json:"resolvedIdentity"`
	EffectiveProjectRoot string          `json:"effectiveProjectRoot"`
	Python               string          `json:"python,omitempty"`
	Command              []string        `json:"command,omitempty"`
	Dockerfile           string          `json:"dockerfile"`
	GeneratedDockerfile  string          `json:"generatedDockerfile,omitempty"`
	BuildInputDigest     string          `json:"buildInputDigest"`
	ImageTag             string          `json:"imageTag"`
	Cached               bool            `json:"cached"`
	MutableRef           bool            `json:"mutableRef"`
	Provenance           BuildProvenance `json:"provenance"`
	// contains filtered or unexported fields
}

type SourceIdentity struct {
	Type           string `json:"type"`
	URL            string `json:"url,omitempty"`
	Ref            string `json:"ref,omitempty"`
	Path           string `json:"path,omitempty"`
	ProjectPath    string `json:"projectPath,omitempty"`
	Dockerfile     string `json:"dockerfile,omitempty"`
	Commit         string `json:"commit,omitempty"`
	Package        string `json:"package,omitempty"`
	Version        string `json:"version,omitempty"`
	Artifact       string `json:"artifact,omitempty"`
	ArtifactSHA256 string `json:"artifactSha256,omitempty"`
}