docker

type AgentConfigMode string

type ContainerConfig struct {
	BaseImage   string // e.g., golang:1.22 (The toolchain)
	AgentBundle string // Required path to agent bundle archive (.tar.gz)
	Workspace   string
	InputPath   string // Path to input directory (contains spec.yaml, context/, prompts/)
	OutDir      string
	StateDir    string // Path to state directory for cross-run skill caches (optional)
	AgentHome   string // Path to agent home mounted to /root (optional, persistent agent identity/state)
	Env         map[string]string
	Cmd         []string // Optional command override

	// Workspace preparation options
	WorkspaceStrategy    string                // Workspace preparation strategy (e.g., "git-clone", "snapshot")
	WorkspaceHistory     workspace.HistoryMode // How much git history to include
	WorkspaceRef         string                // Git ref to checkout (optional)
	WorkspaceIsTemporary bool                  // true when workspace should be used directly (already prepared, no extra snapshot)

	// Agent config mount mode
	AgentConfigMode string // Agent config mount mode: "auto", "yes", "no"

	// Git configuration (already resolved by caller)
	// These values are pre-resolved using git.ResolveConfig() with proper priority:
	// host git config > ProjectConfig > env vars > defaults
	GitAuthorName  string // Git author name for commits
	GitAuthorEmail string // Git author email for commits

	// Skills configuration
	Skills []string // Paths to skill directories to include

	// Builtin skills configuration (optional, overrides embedded skills)
	BuiltinSkillsSource string // Remote source URL for builtin skills (e.g., "https://github.com/holon-run/holon/releases/download/v1.0.0/holon-skills-v1.0.0.zip")
	BuiltinSkillsRef    string // Version/ref tag for builtin skills (e.g., "v1.0.0")

	// Skill mode configuration
	UseSkillMode bool // True if using skill mode (agent handles collect/publish)

	// Runtime mode configuration
	RuntimeMode       string // Runtime mode: "prod" (default) or "dev"
	DevAgentSourceDir string // Local agent source directory for runtime-mode=dev (expects dist/)

	// Extra same-path host mounts configured by agent-home runtime policy.
	ExtraMounts []ExtraMount
}

type EnvConfig struct {
	UserEnv map[string]string
	HostUID int
	HostGID int
}

type ExtraMount struct {
	Path     string
	ReadOnly bool
}

type HostConfigOptions struct {
	Mounts []mount.Mount
}

type MountConfig struct {
	SnapshotDir          string
	InputPath            string // Path to input directory (contains spec.yaml, context/, prompts/)
	OutDir               string
	StateDir             string // Path to state directory for cross-run skill caches (optional, for mounting)
	AgentHome            string // Path to agent home mounted to /root (optional, for persistent persona/state)
	LocalClaudeConfigDir string // Path to host ~/.claude directory (optional, for mounting)
	LocalSkillsDir       string // Path to skills staging directory (optional, for mounting)
	LocalAgentDistDir    string // Path to local agent dist directory for dev runtime mode (optional, for mounting)
	ExtraMounts          []ExtraMount
}

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

type RuntimeMode string

type SessionHandle struct {
	ContainerID     string
	SnapshotDir     string
	OwnsSnapshotDir bool
	SkillsDir       string
	// contains filtered or unexported fields
}