container

type AgentOptions struct {
	Name               string            // container name: forge-agent-<project-id>-<session-id>
	Image              string            // agent image
	NetworkName        string            // Docker network to attach to
	ProjectDir         string            // host path to project (mounted at /work)
	SessionDir         string            // host path to session storage
	ClaudeDir          string            // host path to ~/.claude/
	ConfigDir          string            // host path to ~/.config/claude-forge/
	HomeDir            string            // host home dir for CLAUDE.md paths
	Env                map[string]string // environment variables
	Privileged         bool
	Interactive        bool                // allocate TTY and stdin (for docker attach)
	Cmd                []string            // claude args: --dangerously-skip-permissions, --worktree, etc.
	UID                int                 // host user UID (for file ownership mapping)
	GID                int                 // host user GID (for file ownership mapping)
	PluginsDir         string              // host path to forge plugins dir (mounted rw at ~/.claude/plugins)
	CacheDirs          []CacheDir          // host dependency cache directories to mount (rw)
	ExtraMounts        []CacheDir          // additional user-specified bind mounts (rw)
	ResumeWorktreeName string              // worktree name when resuming a worktree session
	ExtraNetworks      []NetworkAttachment // additional networks to connect before starting
}

type CacheDir struct {
	Source string // host path
	Target string // container path
}

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

type ContainerInfo struct {
	Name    string
	ID      string
	Image   string
	Status  string
	Created time.Time
}

type ContainerManager interface {
	CreateNetwork(ctx context.Context, name string) (string, error)
	RemoveNetwork(ctx context.Context, name string) error
	EnsureSharedNetwork(ctx context.Context, name string) (string, error)
	ConnectNetwork(ctx context.Context, networkName, containerName string, aliases []string) error
	StartAgent(ctx context.Context, opts AgentOptions) (string, error)
	StartGateway(ctx context.Context, opts GatewayOptions) (string, error)
	StartGitHubMCP(ctx context.Context, opts GitHubMCPOptions) (string, error)
	StartSharedService(ctx context.Context, opts SharedServiceOptions) (string, error)
	IsContainerRunning(ctx context.Context, name string) (bool, error)
	WaitForReady(ctx context.Context, containerID string, timeout time.Duration) error
	StopContainer(ctx context.Context, name string) error
	RemoveContainer(ctx context.Context, name string) error
	ListForgeContainers(ctx context.Context) ([]ContainerInfo, error)
	PullImage(ctx context.Context, image string) error
	ImageExists(ctx context.Context, image string) (bool, error)
	ContainerLogs(ctx context.Context, containerID string) (string, error)
	Close() error
}

type DockerAPI interface {
	ContainerCreate(ctx context.Context, config *container.Config, hostConfig *container.HostConfig, networkingConfig *network.NetworkingConfig, containerName string) (container.CreateResponse, error)
	ContainerStart(ctx context.Context, containerID string, options container.StartOptions) error
	ContainerStop(ctx context.Context, containerID string, options container.StopOptions) error
	ContainerRemove(ctx context.Context, containerID string, options container.RemoveOptions) error
	ContainerList(ctx context.Context, options container.ListOptions) ([]container.Summary, error)
	ContainerInspect(ctx context.Context, containerID string) (container.InspectResponse, error)
	ContainerLogs(ctx context.Context, containerID string, options container.LogsOptions) (io.ReadCloser, error)
	NetworkCreate(ctx context.Context, name string, options network.CreateOptions) (network.CreateResponse, error)
	NetworkRemove(ctx context.Context, networkID string) error
	NetworkConnect(ctx context.Context, networkID, containerID string, config *network.EndpointSettings) error
	NetworkList(ctx context.Context, options network.ListOptions) ([]network.Inspect, error)
	ImagePull(ctx context.Context, refStr string, options image.PullOptions) (io.ReadCloser, error)
	ImageList(ctx context.Context, options image.ListOptions) ([]image.Summary, error)
	Close() error
}

type GatewayOptions struct {
	Name        string // container name: forge-gateway-<project-id>-<session-id>
	Image       string
	NetworkName string
	SSHDir      string // host ~/.ssh/ (ro)
	GHConfigDir string // host ~/.config/gh/ (ro)
	Owner       string // allowed repo owner
	Repo        string // allowed repo name
	Env         map[string]string
}

type GitHubMCPOptions struct {
	Name        string            // container name: forge-github-mcp-<project-id>-<session-id>
	Image       string            // github-mcp image
	NetworkName string            // Docker network to attach to
	Owner       string            // allowed repo owner
	Repo        string            // allowed repo name
	Env         map[string]string // environment variables (GITHUB_TOKEN)
}

type NetworkAttachment struct {
	NetworkName string   // Docker network name
	Aliases     []string // optional DNS aliases within the network
}

type SharedServiceOptions struct {
	Name        string            // container name, e.g. "forge-k8s-mcp"
	Image       string            // Docker image
	NetworkName string            // shared network name
	Alias       string            // network alias, e.g. "k8s-mcp"
	Env         map[string]string // environment variables
	Mounts      []mount.Mount     // bind mounts
	Cmd         []string          // container command
}