controller

type ClientBuilder interface {
	BuildAgentClient(ctx context.Context, cfg mcp.MCPServerConfig) (mcp.AgentClient, error)
}

type Config struct {
	StackPath   string
	Port        int
	BasePort    int
	Verbose     bool
	Quiet       bool
	NoCache     bool
	NoExpand    bool
	Foreground  bool
	Watch       bool
	DaemonChild bool
	CodeMode    bool   // Enable code mode via CLI flag
	Runtime     string // Explicit runtime selection (docker, podman)
	Replace     bool   // Stop a running stack before deploying (used by plan apply)
	LogFile     string // Path to log file (overrides stack.yaml logging.file)
}

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

type ContainerSpawnerOptions struct {
	Builder   ClientBuilder
	Runtime   runtime.WorkloadRuntime
	Stack     string           // stack.Name
	Server    config.MCPServer // full server config (command, env, port, etc.)
	Network   string           // resolved network name
	Image     string           // pre-built image (source-based workloads pre-tag as gridctl-<stack>-<server>:latest)
	Transport string           // "http" | "stdio" | "sse"
	Ports     PortAllocator
	Logger    *slog.Logger
	InitialID int // next replica id to assign (typically set.Size() at register time)
}

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

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

type GatewayInstance struct {
	Gateway        *mcp.Gateway
	APIServer      *api.Server
	HTTPServer     *http.Server
	LogBuffer      *logging.LogBuffer
	Handler        slog.Handler
	RegistryServer *registry.Server // Internal registry MCP server (nil if empty)
}

type PortAllocator interface {
	Allocate() int
}

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

type ReplicaRuntime struct {
	HostPort    int
	ContainerID string
}

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

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

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

type WebFSFunc func() (fs.FS, error)