runtime

type AgentInfo struct {
	Name          string
	ContainerID   string
	ContainerName string
	Uses          []string // MCP servers this agent depends on
}

type AgentResult struct {
	Name       string     // Logical name
	WorkloadID WorkloadID // Runtime ID
	Uses       []string   // MCP servers this agent depends on
}

type BuildOptions struct {
	SourceType string            // "git" or "local"
	URL        string            // Git URL
	Ref        string            // Git ref/branch
	Path       string            // Local path
	Dockerfile string            // Dockerfile path within context
	Tag        string            // Image tag
	BuildArgs  map[string]string // Build arguments
	NoCache    bool              // Force rebuild
}

type BuildResult struct {
	ImageTag string // Image tag
	Cached   bool   // Whether build was cached
}

type Builder interface {
	Build(ctx context.Context, opts BuildOptions) (*BuildResult, error)
}

type ContainerStatus struct {
	ID            string
	Name          string
	Image         string
	State         string
	Status        string
	Type          string // "mcp-server", "resource", or "agent"
	MCPServerName string // Name of the MCP server, resource, or agent
	Topology      string
}

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

type DockerClientGetter interface {
	Client() dockerclient.DockerClient
}

type LegacyUpResult struct {
	MCPServers []MCPServerInfo
	Agents     []AgentInfo
}

type MCPServerInfo struct {
	Name            string
	ContainerID     string   // Empty for external/local process/SSH servers
	ContainerName   string   // Empty for external/local process/SSH servers
	ContainerPort   int      // 0 for external/local process/SSH servers
	HostPort        int      // 0 for external/local process/SSH servers
	External        bool     // True if external server (no container)
	LocalProcess    bool     // True if local process server (no container)
	SSH             bool     // True if SSH server (remote process over SSH)
	URL             string   // Full URL for external servers
	Command         []string // Command for local process or SSH servers
	SSHHost         string   // SSH hostname (for SSH servers)
	SSHUser         string   // SSH username (for SSH servers)
	SSHPort         int      // SSH port (for SSH servers, 0 = default 22)
	SSHIdentityFile string   // SSH identity file path (for SSH servers)
}

type MCPServerResult struct {
	Name       string     // Logical name
	WorkloadID WorkloadID // Runtime ID (empty for external/local/SSH)
	Endpoint   string     // How to reach it (URL or host:port)
	HostPort   int        // Host port if applicable

	// Server type flags (exactly one should be true for non-container servers)
	External     bool // URL-based external server
	LocalProcess bool // Local stdio process
	SSH          bool // SSH-based remote process

	// For non-container servers
	URL             string   // External server URL
	Command         []string // Local process or SSH command
	SSHHost         string
	SSHUser         string
	SSHPort         int
	SSHIdentityFile string
}

type NetworkOptions struct {
	Driver   string // Network driver (e.g., "bridge")
	Topology string // For labeling/cleanup purposes
}

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

type Runtime = Orchestrator

type UpOptions struct {
	NoCache     bool // Force rebuild of source-based images
	BasePort    int  // Base port for host port allocation (default: 9000)
	GatewayPort int  // Port for MCP gateway (for agent MCP_ENDPOINT injection)
}

type UpResult struct {
	MCPServers []MCPServerResult
	Agents     []AgentResult
}

type WorkloadConfig struct {
	// Identity
	Name     string       // Logical name (e.g., "postgres", "weather-server")
	Topology string       // Topology this workload belongs to
	Type     WorkloadType // Type of workload

	// Image/artifact
	Image string // Container image or artifact reference

	// Execution
	Command []string          // Override entrypoint/command
	Env     map[string]string // Environment variables

	// Networking
	NetworkName string // Network to join
	ExposedPort int    // Port the workload exposes (0 if none)
	HostPort    int    // Desired host port (0 for auto-assign)

	// Storage
	Volumes []string // Volume mounts (format: "host:container" or "host:container:mode")

	// Transport-specific
	Transport string // "http", "stdio", "sse"

	// Labels for identification and filtering
	Labels map[string]string
}

type WorkloadFilter struct {
	Topology string            // Filter by topology name
	Labels   map[string]string // Additional label filters
}

type WorkloadID string

type WorkloadRuntime interface {
	// Start starts a workload and returns its status.
	Start(ctx context.Context, cfg WorkloadConfig) (*WorkloadStatus, error)

	// Stop stops a running workload by its ID.
	Stop(ctx context.Context, id WorkloadID) error

	// Remove removes a stopped workload.
	Remove(ctx context.Context, id WorkloadID) error

	// Status returns the current status of a workload.
	Status(ctx context.Context, id WorkloadID) (*WorkloadStatus, error)

	// Exists checks if a workload exists by name.
	Exists(ctx context.Context, name string) (exists bool, id WorkloadID, err error)

	// List returns all workloads matching the filter.
	List(ctx context.Context, filter WorkloadFilter) ([]WorkloadStatus, error)

	// GetHostPort returns the host port for a workload's exposed port.
	GetHostPort(ctx context.Context, id WorkloadID, exposedPort int) (int, error)

	// EnsureNetwork creates the network if it doesn't exist.
	EnsureNetwork(ctx context.Context, name string, opts NetworkOptions) error

	// ListNetworks returns all managed networks for a topology.
	ListNetworks(ctx context.Context, topology string) ([]string, error)

	// RemoveNetwork removes a network by name.
	RemoveNetwork(ctx context.Context, name string) error

	// EnsureImage ensures the image is available locally.
	EnsureImage(ctx context.Context, imageName string) error

	// Ping checks if the runtime is accessible.
	Ping(ctx context.Context) error

	// Close releases runtime resources.
	Close() error
}

type WorkloadState string

type WorkloadStatus struct {
	// Identity
	ID       WorkloadID   // Runtime-assigned unique identifier
	Name     string       // Logical name from config
	Topology string       // Topology name
	Type     WorkloadType // Type of workload

	// State
	State   WorkloadState // Running, Stopped, Failed, etc.
	Message string        // Human-readable status message (e.g., "Up 5 minutes")

	// Networking
	Endpoint string // How to reach this workload (e.g., "localhost:9000")
	HostPort int    // Actual host port (if port-mapped)

	// Metadata
	Image  string            // Image/artifact that's running
	Labels map[string]string // All labels
}

type WorkloadType string