localserver

type Handler struct {
	http.Handler
	// contains filtered or unexported fields
}

type LoginLink struct {
	Schema      int       `json:"schema"`
	URL         string    `json:"url"`
	FallbackURL string    `json:"fallback_url"`
	ExpiresAt   time.Time `json:"expires_at"`
}

type LoginLinkRequest struct {
	Next string `json:"next,omitempty"`
}

type Options struct {
	Dirs   paths.Dirs
	Record runtime.Record // this run's server.json content
	Secret string
	// RequestShutdown is called once the shutdown response is written.
	RequestShutdown func()
	Now             func() time.Time // time.Now when nil
	// ErrorLog receives recovered panics; they are redacted before writing.
	ErrorLog io.Writer
	// Console serves the web console and apps to signed-in browsers;
	// web.Handler() when nil.
	Console http.Handler
	// Telemetry sends web console events from this process; a web-channel
	// recorder over Dirs.Home and this process's environment when nil.
	Telemetry *telemetry.Recorder
	// Databases are mounted next to the registry's (tests).
	Databases map[string]*core.Database
	// MountTimeout bounds each registered database's mount;
	// setup.DefaultMountTimeout when zero.
	MountTimeout time.Duration
	// Getenv is the server's environment, for the AI agent skill directories
	// the web console offers; os.Getenv when nil.
	Getenv func(string) string
	// DataTugLookPath resolves whether datatug is on PATH for Explore data
	// (capability row 22); exec.LookPath when nil (tests).
	DataTugLookPath explore.LookPath
}

type RunOptions struct {
	Dirs    paths.Dirs
	Port    int
	Version string
	Listen  runtime.ListenFunc // net.Listen when nil
	Log     io.Writer          // server.log in a detached server
	// FailBeforeReady makes the process exit after taking the lock and
	// before it is ready; tests use it to prove server_start_failed.
	FailBeforeReady bool
}

type TelemetryEvents struct {
	Events []telemetry.Wire `json:"events"`
}

type TelemetryEventsResult struct {
	Schema   int  `json:"schema"`
	Accepted int  `json:"accepted"`
	Sent     bool `json:"sent"`
}