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"`
	// LocalDirs are the user-named directories (see `sprout runner start
	// --dir`) this runner serves workspaces in place. A start task naming
	// one of them runs against the user's real files, no clone.
	LocalDirs []string `json:"local_dirs,omitempty"`
	// Capabilities lists the optional start-task features this runner
	// serves (Capability* constants). The platform sends workspace_dir or
	// a gateway provider only to runners that advertise them: an older
	// runner ignores workspace_dir and would hand a gateway key to a
	// public provider.
	Capabilities []string `json:"capabilities,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 ImageUnavailableError struct {
	Image  string
	Output string
}

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"`
	// LocalDirs are the directories the user named (with `sprout runner
	// start --workspace`, repeatable) that this runner serves workspaces
	// in place: a start task naming one runs against the user's real
	// files there, with no clone. Explicitly opt-in; never platform-set.
	LocalDirs []string `json:"local_dirs,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"`
	// Error says why a "failed" start was refused or failed, in words safe
	// to show the user (never a secret or a raw launcher error).
	Error string `json:"error,omitempty"`
}

type WorkspaceTask struct {
	WorkspaceID string `json:"workspace_id"`
	UserID      string `json:"user_id"`
	RepoURL     string `json:"repo_url"`
	// WorkspaceDir, when set, names an allowlisted local directory the
	// workspace runs in place: no clone, the directory is the workspace
	// root and the runner writes the user's real files there. The runner
	// refuses any path it was not explicitly configured to serve.
	WorkspaceDir string `json:"workspace_dir,omitempty"`
	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"`
	// Model names the model the workspace starts on (SPROUT_MODEL), for
	// any provider. The platform decides what to send, e.g. the user's
	// last-used model; empty leaves the daemon's normal default for the
	// provider.
	Model          string            `json:"model,omitempty"`
	UserEnv        map[string]string `json:"user_env,omitempty"`
	PlatformAPIURL string            `json:"platform_api_url,omitempty"`
	// GatewayURL is the gateway's OpenAI-compatible base (the URL that
	// /chat/completions and /models hang off) for a gateway task. Empty
	// derives it from PlatformAPIURL plus the platform's gateway path.
	GatewayURL string `json:"gateway_url,omitempty"`
}