Documentation
¶
Index ¶
- func RegisterLauncherAuthRoutes(mux *http.ServeMux, opts LauncherAuthRouteOpts)
- func SaveCatalog(provider, apiBase, apiKey string, models []CatalogModel) error
- type CatalogEntry
- type CatalogModel
- type CatalogStore
- type Handler
- func (h *Handler) EnsureMintClawChannel() (bool, error)
- func (h *Handler) RegisterRoutes(mux *http.ServeMux)
- func (h *Handler) RestartGateway() (int, error)
- func (h *Handler) SetDebug(debug bool)
- func (h *Handler) SetServerAccessOptions(allowLocalhostBypass bool, trustedProxyCIDRs []string)
- func (h *Handler) SetServerBindHost(hostInput string, explicit bool)
- func (h *Handler) SetServerOptions(port int, public bool, publicExplicit bool, allowedCIDRs []string)
- func (h *Handler) Shutdown()
- func (h *Handler) StopGateway()
- func (h *Handler) TryAutoStartGateway()
- type LauncherAuthRouteOpts
- type LogBuffer
- type PasswordStore
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func RegisterLauncherAuthRoutes ¶
func RegisterLauncherAuthRoutes(mux *http.ServeMux, opts LauncherAuthRouteOpts)
RegisterLauncherAuthRoutes registers /api/auth/login|logout|status|setup.
func SaveCatalog ¶
func SaveCatalog(provider, apiBase, apiKey string, models []CatalogModel) error
SaveCatalog persists a fetched model list for a given provider+key combination. If a catalog with the same key already exists, it is updated.
Types ¶
type CatalogEntry ¶
type CatalogEntry struct {
ID string `json:"id"`
Provider string `json:"provider"`
APIBase string `json:"api_base"`
APIKeyMask string `json:"api_key_mask"`
Models []CatalogModel `json:"models"`
FetchedAt string `json:"fetched_at"`
}
CatalogEntry is a saved list of upstream models fetched for a specific provider+key combination.
type CatalogModel ¶
type CatalogModel struct {
ID string `json:"id"`
OwnedBy string `json:"owned_by,omitempty"`
Extra map[string]any `json:"extra,omitempty"`
}
CatalogModel represents a single model entry in a saved catalog.
type CatalogStore ¶
type CatalogStore struct {
Entries map[string]*CatalogEntry `json:"entries"`
}
CatalogStore holds all saved model catalogs.
type Handler ¶
type Handler struct {
// contains filtered or unexported fields
}
Handler serves HTTP API requests.
func NewHandler ¶
NewHandler creates an instance of the API handler.
func (*Handler) EnsureMintClawChannel ¶
EnsureMintClawChannel enables the MintClaw channel with sane defaults if it isn't already configured. Returns true when the config was modified.
func (*Handler) RegisterRoutes ¶
RegisterRoutes binds all API endpoint handlers to the ServeMux.
func (*Handler) RestartGateway ¶
RestartGateway restarts the gateway process. This is a non-blocking operation that stops the current gateway (if running) and starts a new one. Returns the PID of the new gateway process or an error.
func (*Handler) SetServerAccessOptions ¶
func (*Handler) SetServerBindHost ¶
SetServerBindHost stores the launcher's effective bind host. When explicit is true, hostInput is the normalized -host / MINTCLAW_LAUNCHER_HOST value.
func (*Handler) SetServerOptions ¶
func (h *Handler) SetServerOptions(port int, public bool, publicExplicit bool, allowedCIDRs []string)
SetServerOptions stores current backend listen options for fallback behavior.
func (*Handler) Shutdown ¶
func (h *Handler) Shutdown()
Shutdown gracefully shuts down the handler, stopping the gateway if it was started by this handler.
func (*Handler) StopGateway ¶
func (h *Handler) StopGateway()
StopGateway stops the gateway process if it was started by this handler. This method is called during application shutdown to ensure the gateway subprocess is properly terminated. It only stops processes that were started by this handler, not processes that were attached to from existing instances.
func (*Handler) TryAutoStartGateway ¶
func (h *Handler) TryAutoStartGateway()
TryAutoStartGateway checks whether gateway start preconditions are met and starts it when possible. Intended to be called by the backend at startup.
type LauncherAuthRouteOpts ¶
type LauncherAuthRouteOpts struct {
SessionCookie string
SecureCookie func(*http.Request) bool
// PasswordStore enables password login. It must be non-nil for auth to work.
PasswordStore PasswordStore
// StoreError holds the error returned when opening the password store. When
// non-nil and PasswordStore is nil, auth endpoints fail closed with a
// recovery message.
StoreError error
}
LauncherAuthRouteOpts configures dashboard auth handlers.
type LogBuffer ¶
type LogBuffer struct {
// contains filtered or unexported fields
}
LogBuffer is a thread-safe ring buffer that stores the most recent N log lines. It supports incremental reads via LinesSince and tracks a runID that increments whenever the buffer is reset or cleared so clients can detect log history resets.
func NewLogBuffer ¶
NewLogBuffer creates a LogBuffer with the given capacity.
func (*LogBuffer) Append ¶
Append adds a line to the buffer. If the buffer is full, the oldest line is evicted.
func (*LogBuffer) Clear ¶
func (b *LogBuffer) Clear()
Clear removes all buffered lines and increments the runID so clients treat subsequent reads as a new log stream.
func (*LogBuffer) LinesSince ¶
LinesSince returns lines appended after the given offset, the current total count, and the runID. If offset >= total, no lines are returned. If offset is too old (evicted), all buffered lines are returned.
type PasswordStore ¶
type PasswordStore interface {
IsInitialized(ctx context.Context) (bool, error)
SetPassword(ctx context.Context, plain string) error
VerifyPassword(ctx context.Context, plain string) (bool, error)
}
PasswordStore is the interface for dashboard password persistence. Implemented by dashboardauth.Store and launcherconfig.PasswordStore.
Source Files