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 {
	State        AIReadinessState `json:"state"`
	ReasonCode   string           `json:"reason_code,omitempty"`
	Retryable    bool             `json:"retryable"`
	SafeToRetry  bool             `json:"safe_to_retry"`
	Committed    bool             `json:"committed"`
	RolledBack   bool             `json:"rolled_back"`
	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 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)
	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 Options struct {
	Logger                  *slog.Logger
	ListenAddr              string
	DistFS                  stdfs.FS
	Backend                 Backend
	PortForward             PortForwardBackend
	AIServiceProvider       AIServiceProvider
	Notes                   *notes.Service
	WorkbenchLayout         *workbenchlayout.Service
	Terminal                *terminal.Manager
	Audit                   *auditlog.Store
	Diagnostics             *diagnostics.Store
	ResolveSessionMeta      func(channelID string) (*session.Meta, bool)
	ResolveSessionTunnelURL func(channelID string) (string, 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
	// ThreadReadStateStore persists scoped per-surface thread read watermarks.
	ThreadReadStateStore *threadreadstate.Store
	// PluginPlatform is the released ReDevPlugin HTTP handler mounted behind Redeven routes.
	PluginPlatform       http.Handler
	PluginMarketSnapshot func() (pluginmarket.Snapshot, bool)
	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"`
}