runner

type Client struct {
	BaseURL    string
	Creds      Credentials
	HTTPClient *http.Client
}

type ContainerLauncher struct {
	Image string
	// Docker is the CLI to run; "docker" when empty.
	Docker string
}

type Credentials struct {
	RunnerID string `json:"runner_id"`
	APIKey   string `json:"api_key"`
}

type DeviceStart struct {
	DeviceCode              string `json:"device_code"`
	UserCode                string `json:"user_code"`
	VerificationURI         string `json:"verification_uri"`
	VerificationURIComplete string `json:"verification_uri_complete"`
	Interval                int    `json:"interval"`
	ExpiresIn               int    `json:"expires_in"`
}

type Heartbeat struct {
	Status        string   `json:"status"`
	RunningTasks  int      `json:"running_tasks"`
	Mode          string   `json:"mode"`
	Sandbox       string   `json:"sandbox"`
	RunnerVersion string   `json:"runner_version"`
	Toolchains    []string `json:"toolchains,omitempty"`
	// DirectURL is where the platform reaches the host server now; empty
	// for a relayed runner.
	DirectURL string `json:"direct_url,omitempty"`
	// Relayed reports that the runner serves the platform over its tunnel.
	Relayed bool `json:"relayed,omitempty"`
}

type HostLauncher struct {
	Sandboxed bool
	// Writable are extra paths native mode may write (toolchain caches).
	Writable []string
	// SproutBin is the binary that serves the workspace daemon.
	SproutBin string
	// contains filtered or unexported fields
}

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

type Launcher interface {
	Start(ctx context.Context, task WorkspaceTask) (*Workspace, error)
	Stop(ctx context.Context, ws *Workspace) error
	Destroy(ctx context.Context, workspaceID string, ws *Workspace) error
}

type Runner struct {
	State    *State
	Client   *Client
	Launcher Launcher
	Host     *HostServer
	// Sandbox and Version are reported in heartbeats.
	Sandbox string
	Version string
	Log     *slog.Logger
	// contains filtered or unexported fields
}

type State struct {
	PlatformURL string `json:"platform_url"`
	RunnerID    string `json:"runner_id"`
	Name        string `json:"name"`
	Mode        string `json:"mode"`
	// PublicURL is the HTTPS base the platform reaches the host server at
	// (direct mode). Empty means the relay tunnel, once the platform offers it.
	PublicURL  string `json:"public_url,omitempty"`
	ListenAddr string `json:"listen_addr,omitempty"`
	Image      string `json:"image,omitempty"`
	// Writable are extra paths native mode may write (toolchain caches).
	Writable []string `json:"writable,omitempty"`
}

type Workspace struct {
	ID   string
	Port int
	// Handle identifies it to its launcher (a container name, or a pid).
	Handle string
}

type WorkspaceResult struct {
	WorkspaceID   string `json:"workspace_id"`
	ContainerID   string `json:"container_id"`
	Port          int    `json:"port"`
	ConnectionURL string `json:"connection_url,omitempty"`
	Status        string `json:"status"`
}

type WorkspaceTask struct {
	WorkspaceID    string            `json:"workspace_id"`
	UserID         string            `json:"user_id"`
	RepoURL        string            `json:"repo_url"`
	Action         string            `json:"action"`
	ContainerID    string            `json:"container_id"`
	TxnSecret      string            `json:"txn_secret,omitempty"`
	GitToken       string            `json:"git_token,omitempty"`
	LLMProvider    string            `json:"llm_provider,omitempty"`
	LLMKey         string            `json:"llm_key,omitempty"`
	UserEnv        map[string]string `json:"user_env,omitempty"`
	PlatformAPIURL string            `json:"platform_api_url,omitempty"`
}