agent

type Agent interface {
	HTTPDebug() http.Handler
	// TailnetConn may be nil.
	TailnetConn() *tailnet.Conn
	io.Closer
}

type Client interface {
	ConnectRPC26(ctx context.Context) (
		proto.DRPCAgentClient26, tailnetproto.DRPCTailnetClient26, error,
	)
	tailnet.DERPMapRewriter
	agentsdk.RefreshableSessionTokenProvider
}

type HTTPResponseCode = int

type ListeningPortsGetter interface {
	GetListeningPorts() ([]codersdk.WorkspaceAgentListeningPort, error)
}

type Options struct {
	Filesystem             afero.Fs
	LogDir                 string
	TempDir                string
	ScriptDataDir          string
	Client                 Client
	ReconnectingPTYTimeout time.Duration
	EnvironmentVariables   map[string]string
	Logger                 slog.Logger
	// IgnorePorts tells the api handler which ports to ignore when
	// listing all listening ports. This is helpful to hide ports that
	// are used by the agent, that the user does not care about.
	IgnorePorts map[int]string
	// ListeningPortsGetter is used to get the list of listening ports. Only
	// tests should set this. If unset, a default that queries the OS will be used.
	ListeningPortsGetter         ListeningPortsGetter
	SSHMaxTimeout                time.Duration
	TailnetListenPort            uint16
	Subsystems                   []codersdk.AgentSubsystem
	PrometheusRegistry           *prometheus.Registry
	ReportMetadataInterval       time.Duration
	ServiceBannerRefreshInterval time.Duration
	BlockFileTransfer            bool
	Execer                       agentexec.Execer
	Devcontainers                bool
	DevcontainerAPIOptions       []agentcontainers.Option // Enable Devcontainers for these to be effective.
	Clock                        quartz.Clock
	SocketServerEnabled          bool
	SocketPath                   string // Path for the agent socket server socket
}

type PostWorkspaceAgentAppHealth func(context.Context, agentsdk.PostAppHealthsRequest) error

type WorkspaceAppHealthReporter func(ctx context.Context)