appserver

type AIOrphanRootMaintenanceProvider interface {
	ReviewOrphanCanonicalRoots(context.Context) (ai.OrphanCanonicalRootReview, error)
	AdoptOrphanCanonicalRoot(context.Context, ai.AdoptOrphanCanonicalRootRequest) (int, error)
	DeleteOrphanCanonicalRoot(context.Context, ai.DeleteOrphanCanonicalRootRequest) (int, error)
}

type AIReadinessSnapshot struct {
	Component    string           `json:"component,omitempty"`
	State        AIReadinessState `json:"state"`
	ReasonCode   string           `json:"reason_code,omitempty"`
	Retryable    bool             `json:"retryable"`
	SafeToRetry  bool             `json:"safe_to_retry"`
	IssueCount   int              `json:"issue_count,omitempty"`
	TraceID      string           `json:"trace_id,omitempty"`
	StartupPhase string           `json:"startup_phase,omitempty"`
	RetryReason  string           `json:"retry_reason,omitempty"`
}

type AIReadinessState string

type AIServiceProvider interface {
	AcquireAIService(context.Context) (*ai.Service, context.Context, uint64, func(), error)
	AIReadiness() AIReadinessSnapshot
	RetryAIReadiness() error
	UpdateAIServiceStartupOptions(AIServiceStartupOptions)
}

type AIServiceStartupOptions struct {
	Config          *config.AIConfig
	AgentHomeDir    string
	Shell           string
	FilesystemScope *filesystemscope.Registry
}

type AIStorageMaintenanceProvider interface {
	ListFlowerSnapshots(context.Context) ([]ai.FlowerSnapshotSummary, error)
	RestoreFlowerSnapshot(string) error
}

type Backend interface {
	ListSpaces(ctx context.Context) ([]SpaceStatus, error)
	CreateSpace(ctx context.Context, req CreateSpaceRequest) (*SpaceStatus, error)
	UpdateSpace(ctx context.Context, codeSpaceID string, req UpdateSpaceRequest) (*SpaceStatus, error)
	DeleteSpace(ctx context.Context, codeSpaceID string) error
	StartSpace(ctx context.Context, codeSpaceID string) (*SpaceStatus, error)
	StopSpace(ctx context.Context, codeSpaceID string) error
	ResolveCodeServerPort(ctx context.Context, codeSpaceID string) (int, error)
	BindRunningCodeSpace(ctx context.Context, codeSpaceID string) (NativeCodeSpaceBinding, error)
	CodeRuntimeStatus(ctx context.Context) (CodeRuntimeStatus, error)
	CreateCodeRuntimeSetupOperation(ctx context.Context, operationID string, installMethod codeserver.BrowserEditorInstallMethod, manifest *CodeRuntimeArtifactManifest) (CodeRuntimeSetupOperation, error)
	AppendCodeRuntimeSetupChunk(ctx context.Context, operationID string, chunkIndex int64, body io.Reader) (CodeRuntimeSetupChunkResult, error)
	CompleteCodeRuntimeSetupOperation(ctx context.Context, operationID string) (CodeRuntimeStatus, error)
	CancelCodeRuntimeSetupOperation(ctx context.Context, operationID string) (CodeRuntimeStatus, error)
	SelectCodeRuntimeVersion(ctx context.Context, version string) (CodeRuntimeStatus, error)
	RemoveCodeRuntimeVersion(ctx context.Context, version string) (CodeRuntimeStatus, error)
	CancelCodeRuntimeOperation(ctx context.Context) (CodeRuntimeStatus, error)
}

type CodeRuntimeArtifactManifest = codeserver.WorkspaceEngineArtifactManifest

type CodeRuntimeSetupChunkResult = codeserver.WorkspaceEngineSetupChunkResult

type CodeRuntimeSetupOperation = codeserver.WorkspaceEngineSetupOperation

type CodeRuntimeSetupOperationRequest struct {
	OperationID   string                                `json:"operation_id"`
	InstallMethod codeserver.BrowserEditorInstallMethod `json:"install_method"`
	Manifest      *CodeRuntimeArtifactManifest          `json:"manifest,omitempty"`
}

type CodeRuntimeStatus = codeserver.RuntimeStatus

type CodeRuntimeVersionRequest struct {
	Version string `json:"version"`
}

type CreateSpaceRequest struct {
	Path        string `json:"path"`
	Name        string `json:"name"`
	Description string `json:"description"`
}

type NativeCodeSpaceBinding struct {
	CodeSpaceID     string
	InstanceID      string
	WorkspacePath   string
	Port            int
	Context         context.Context
	AdmitConnection func() (func(), bool)
}

type Options struct {
	Logger               *slog.Logger
	ListenAddr           string
	DistFS               stdfs.FS
	Backend              Backend
	PortForward          PortForwardBackend
	ManagedWebServices   managedwebservice.Backend
	HostApplications     hostapps.Backend
	ContainerResources   *containerresource.Service
	AIServiceProvider    AIServiceProvider
	BrowserRuntime       *ai.ComputerUseRuntime
	Notes                *notes.Service
	WorkbenchLayout      *workbenchlayout.Service
	Terminal             *terminal.Manager
	Audit                *auditlog.Store
	Diagnostics          *diagnostics.Store
	ResolveSessionMeta   func(channelID string) (*session.Meta, bool)
	AcquirePluginSession func(channelID string) (*session.Meta, func(), bool)
	EndPluginSession     func(channelID string)
	// ConfigPath is the absolute path to the runtime config file.
	// It is used to read and persist settings updates initiated from the Env App UI.
	ConfigPath string
	// SecretsStore holds user-managed secrets (such as AI provider API keys).
	// If nil, the app server will derive a default secrets path from ConfigPath.
	SecretsStore *settings.SecretsStore
	// PluginPlatform is the released ReDevPlugin HTTP handler mounted behind Redeven routes.
	PluginPlatform        http.Handler
	PluginMarketSnapshot  func(context.Context) (pluginmarket.Snapshot, error)
	PluginMarketRefresh   func(context.Context) (pluginmarket.Snapshot, error)
	PluginMarketSubscribe func(context.Context, int64) ([]pluginmarket.RefreshEvent, <-chan pluginmarket.RefreshEvent, error)
	PluginMarketDetail    func(context.Context, string) (pluginmarket.PluginDetail, int64, error)
	PluginMarketIcon      func(context.Context, string, string) (pluginmarket.IconAsset, error)
	// AgentHomeDir is the canonical absolute path to the default home directory.
	AgentHomeDir    string
	FilesystemScope *filesystemscope.Registry
}

type PortForwardBackend interface {
	ListForwards(ctx context.Context) ([]pfregistry.Forward, error)
	GetForward(ctx context.Context, forwardID string) (*pfregistry.Forward, error)
	OpenForwardSession(ctx context.Context, req portforward.OpenForwardSessionRequest) (*portforward.ForwardSession, error)
	SaveForwardSession(ctx context.Context, forwardID string, req portforward.SaveForwardSessionRequest) (*pfregistry.Forward, error)
	CreateForward(ctx context.Context, req portforward.CreateForwardRequest) (*pfregistry.Forward, error)
	UpdateForward(ctx context.Context, forwardID string, req portforward.UpdateForwardRequest) (*pfregistry.Forward, error)
	DeleteForward(ctx context.Context, forwardID string) error
	TouchLastOpened(ctx context.Context, forwardID string) (*pfregistry.Forward, error)
}

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

type SpaceStatus struct {
	CodeSpaceID        string `json:"code_space_id"`
	Name               string `json:"name"`
	Description        string `json:"description"`
	WorkspacePath      string `json:"workspace_path"`
	CodePort           int    `json:"code_port"`
	CreatedAtUnixMs    int64  `json:"created_at_unix_ms"`
	UpdatedAtUnixMs    int64  `json:"updated_at_unix_ms"`
	LastOpenedAtUnixMs int64  `json:"last_opened_at_unix_ms"`

	Running bool `json:"running"`
	PID     int  `json:"pid"`
}

type UpdateSpaceRequest struct {
	Name        *string `json:"name,omitempty"`
	Description *string `json:"description,omitempty"`
}