appserver

package

Go to main page

Versions in this module

v0

v0.11.0

Aug 25, 2026

Changes in this version

+ const AIHostThreadSettingsMissingReasonCode

+ const AIReadinessContractErrorReasonCode

+ const AIServiceStartupErrorReasonCode

+ const AIServiceUnavailableErrorCode

+ var ErrAIRetryInProgress = errors.New("AI readiness check is already in progress")

+ var ErrAIServiceUnavailable = errors.New("AI service is unavailable")

+ type AIOrphanRootMaintenanceProvider interface

+ AdoptOrphanCanonicalRoot func(context.Context, ai.AdoptOrphanCanonicalRootRequest) (int, error)

+ DeleteOrphanCanonicalRoot func(context.Context, ai.DeleteOrphanCanonicalRootRequest) (int, error)

+ ReviewOrphanCanonicalRoots func(context.Context) (ai.OrphanCanonicalRootReview, error)

+ type AIReadinessSnapshot struct

+ Committed bool

+ IssueCount int

+ ReasonCode string

+ RetryReason string

+ Retryable bool

+ RolledBack bool

+ SafeToRetry bool

+ StartupPhase string

+ State AIReadinessState

+ TraceID string

+ type AIReadinessState string

+ const AIReadinessBlocked

+ const AIReadinessDegraded

+ const AIReadinessInspecting

+ const AIReadinessMigrating

+ const AIReadinessReady

+ const AIReadinessRecovering

+ const AIReadinessUnavailable

+ const AIReadinessVerifying

+ type AIServiceProvider interface

+ AIReadiness func() AIReadinessSnapshot

+ AcquireAIService func(context.Context) (*ai.Service, context.Context, uint64, func(), error)

+ RetryAIReadiness func() error

+ UpdateAIServiceStartupOptions func(AIServiceStartupOptions)

+ type AIServiceStartupOptions struct

+ AgentHomeDir string

+ Config *config.AIConfig

+ FilesystemScope *filesystemscope.Registry

+ Shell string

type Options

+ AIServiceProvider AIServiceProvider

+ AcquirePluginSession func(channelID string) (*session.Meta, func(), bool)

+ EndPluginSession func(channelID string)

+ PluginMarketDetail func(context.Context, string) (pluginmarket.PluginDetail, int64, error)

+ PluginMarketIcon func(context.Context, string, string) (pluginmarket.IconAsset, error)

+ PluginMarketSnapshot func() (pluginmarket.Snapshot, bool)

type PortForwardBackend

+ OpenForwardSession func(ctx context.Context, req portforward.OpenForwardSessionRequest) (*portforward.ForwardSession, error)

+ SaveForwardSession func(ctx context.Context, forwardID string, ...) (*pfregistry.Forward, error)

type Server

+ func (g *Server) ClosePluginSessionConnections(channelID string)

v0.10.0

Jul 20, 2026

Changes in this version

type Backend

+ AppendCodeRuntimeSetupChunk func(ctx context.Context, operationID string, chunkIndex int64, body io.Reader) (CodeRuntimeSetupChunkResult, error)

+ CancelCodeRuntimeSetupOperation func(ctx context.Context, operationID string) (CodeRuntimeStatus, error)

+ CompleteCodeRuntimeSetupOperation func(ctx context.Context, operationID string) (CodeRuntimeStatus, error)

+ CreateCodeRuntimeSetupOperation func(ctx context.Context, operationID string, ...) (CodeRuntimeSetupOperation, error)

+ type CodeRuntimeSetupChunkResult = codeserver.WorkspaceEngineSetupChunkResult

+ type CodeRuntimeSetupOperation = codeserver.WorkspaceEngineSetupOperation

+ type CodeRuntimeSetupOperationRequest struct

+ InstallMethod codeserver.BrowserEditorInstallMethod

+ Manifest *CodeRuntimeArtifactManifest

+ OperationID string

v0.9.0

Jul 15, 2026

v0.8.2

Jul 15, 2026

v0.8.1

Jul 15, 2026

v0.8.0

Jul 14, 2026

v0.7.2

Jul 14, 2026

Changes in this version

+ const LocalUIChannelID

+ func LocalEnvSessionMeta(configPath string) *session.Meta

+ func WithLocalUIPluginRoute(r *http.Request) *http.Request

type Options

+ PluginPlatform http.Handler

type Server

+ func (g *Server) PluginPlatformEnabled() bool

v0.7.1

Jun 21, 2026

Changes in this version

+ func WithLocalUICodeSpaceRoute(r *http.Request, codeSpaceID string) *http.Request

+ func WithLocalUIEnvRoute(r *http.Request) *http.Request

+ func WithLocalUIPortForwardRoute(r *http.Request, forwardID string) *http.Request

+ type Backend interface

+ AppendCodeRuntimeImportChunk func(ctx context.Context, uploadID string, chunkIndex int64, body io.Reader) (CodeRuntimeImportChunkResult, error)

+ CancelCodeRuntimeOperation func(ctx context.Context) (CodeRuntimeStatus, error)

+ CodeRuntimeStatus func(ctx context.Context) (CodeRuntimeStatus, error)

+ CompleteCodeRuntimeImportSession func(ctx context.Context, uploadID string) (CodeRuntimeStatus, error)

+ CreateCodeRuntimeImportSession func(ctx context.Context, manifest CodeRuntimeArtifactManifest) (CodeRuntimeImportSession, error)

+ CreateSpace func(ctx context.Context, req CreateSpaceRequest) (*SpaceStatus, error)

+ DeleteSpace func(ctx context.Context, codeSpaceID string) error

+ ListSpaces func(ctx context.Context) ([]SpaceStatus, error)

+ RemoveCodeRuntimeVersion func(ctx context.Context, version string) (CodeRuntimeStatus, error)

+ ResolveCodeServerPort func(ctx context.Context, codeSpaceID string) (int, error)

+ SelectCodeRuntimeVersion func(ctx context.Context, version string) (CodeRuntimeStatus, error)

+ StartSpace func(ctx context.Context, codeSpaceID string) (*SpaceStatus, error)

+ StopSpace func(ctx context.Context, codeSpaceID string) error

+ UpdateSpace func(ctx context.Context, codeSpaceID string, req UpdateSpaceRequest) (*SpaceStatus, error)

+ type CodeRuntimeArtifactManifest = codeserver.WorkspaceEngineArtifactManifest

+ type CodeRuntimeImportChunkResult = codeserver.WorkspaceEngineImportChunkResult

+ type CodeRuntimeImportSession = codeserver.WorkspaceEngineImportSession

+ type CodeRuntimeImportSessionRequest struct

+ Manifest CodeRuntimeArtifactManifest

+ type CodeRuntimeStatus = codeserver.RuntimeStatus

+ type CodeRuntimeVersionRequest struct

+ Version string

+ type CodexBackend interface

+ ArchiveThread func(ctx context.Context, threadID string) error

+ ForkThread func(ctx context.Context, req codexbridge.ForkThreadRequest) (*codexbridge.ThreadDetail, error)

+ InterruptTurn func(ctx context.Context, req codexbridge.InterruptTurnRequest) error

+ ListThreads func(ctx context.Context, req codexbridge.ListThreadsRequest) ([]codexbridge.Thread, error)

+ ReadCapabilities func(ctx context.Context, cwd string) (*codexbridge.Capabilities, error)

+ ReadThread func(ctx context.Context, threadID string) (*codexbridge.ThreadDetail, error)

+ RespondToRequest func(ctx context.Context, threadID string, requestID string, ...) error

+ StartReview func(ctx context.Context, req codexbridge.StartReviewRequest) (*codexbridge.ThreadDetail, error)

+ StartThread func(ctx context.Context, req codexbridge.StartThreadRequest) (*codexbridge.ThreadDetail, error)

+ StartTurn func(ctx context.Context, req codexbridge.StartTurnRequest) (*codexbridge.Turn, error)

+ Status func(ctx context.Context) codexbridge.Status

+ SteerTurn func(ctx context.Context, req codexbridge.SteerTurnRequest) (*codexbridge.Turn, error)

+ SubscribeThreadEvents func(ctx context.Context, threadID string, afterSeq int64) ([]codexbridge.Event, <-chan codexbridge.Event, error)

+ UnarchiveThread func(ctx context.Context, threadID string) error

+ type CreateSpaceRequest struct

+ Description string

+ Name string

+ Path string

+ type Options struct

+ AI *ai.Service

+ AgentHomeDir string

+ Audit *auditlog.Store

+ Backend Backend

+ Codex CodexBackend

+ ConfigPath string

+ Diagnostics *diagnostics.Store

+ DistFS fs.FS

+ FilesystemScope *filesystemscope.Registry

+ ListenAddr string

+ Logger *slog.Logger

+ Notes *notes.Service

+ PortForward PortForwardBackend

+ ResolveSessionMeta func(channelID string) (*session.Meta, bool)

+ ResolveSessionTunnelURL func(channelID string) (string, bool)

+ SecretsStore *settings.SecretsStore

+ Terminal *terminal.Manager

+ ThreadReadStateStore *threadreadstate.Store

+ WorkbenchLayout *workbenchlayout.Service

+ type PortForwardBackend interface

+ CreateForward func(ctx context.Context, req portforward.CreateForwardRequest) (*pfregistry.Forward, error)

+ DeleteForward func(ctx context.Context, forwardID string) error

+ GetForward func(ctx context.Context, forwardID string) (*pfregistry.Forward, error)

+ ListForwards func(ctx context.Context) ([]pfregistry.Forward, error)

+ TouchLastOpened func(ctx context.Context, forwardID string) (*pfregistry.Forward, error)

+ UpdateForward func(ctx context.Context, forwardID string, req portforward.UpdateForwardRequest) (*pfregistry.Forward, error)

+ type Server struct

+ func New(opts Options) (*Server, error)

+ func (g *Server) AppendCodeRuntimeImportChunk(ctx context.Context, uploadID string, chunkIndex int64, body io.Reader) (CodeRuntimeImportChunkResult, error)

+ func (g *Server) Close() error

+ func (g *Server) CodeRuntimeStatus(ctx context.Context) (CodeRuntimeStatus, error)

+ func (g *Server) CompleteCodeRuntimeImportSession(ctx context.Context, uploadID string) (CodeRuntimeStatus, error)

+ func (g *Server) CreateCodeRuntimeImportSession(ctx context.Context, manifest CodeRuntimeArtifactManifest) (CodeRuntimeImportSession, error)

+ func (g *Server) EnvAppShellReadinessError() error

+ func (g *Server) EnvAppShellReady() bool

+ func (g *Server) ServeHTTP(w http.ResponseWriter, r *http.Request)

+ func (g *Server) Start(ctx context.Context) error

+ func (g *Server) URL() string

+ type SpaceStatus struct

+ CodePort int

+ CodeSpaceID string

+ CreatedAtUnixMs int64

+ Description string

+ LastOpenedAtUnixMs int64

+ Name string

+ PID int

+ Running bool

+ UpdatedAtUnixMs int64

+ WorkspacePath string

+ type UpdateSpaceRequest struct

+ Description *string

+ Name *string

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL