api

type AdminReadiness struct {
	AppVersion string `json:"appVersion"`

	// Backup The status of an operator-written backup completion marker. A current marker proves only that the backup command completed; it is not an archive-content verification result.
	Backup           BackupFreshness              `json:"backup"`
	Commit           *string                      `json:"commit,omitempty"`
	DatabaseDriver   AdminReadinessDatabaseDriver `json:"databaseDriver"`
	MigrationDirty   bool                         `json:"migrationDirty"`
	MigrationVersion int                          `json:"migrationVersion"`
	Upstreams        []UpstreamHealth             `json:"upstreams"`
}

type AdminReadinessDatabaseDriver string

type AuthStatus struct {
	Authenticated bool `json:"authenticated"`

	// NeedsSetup True when no users exist yet (first-run bootstrap).
	NeedsSetup bool  `json:"needsSetup"`
	User       *User `json:"user,omitempty"`
}

type BackupFreshness struct {
	CompletedAt *time.Time             `json:"completedAt,omitempty"`
	Driver      *BackupFreshnessDriver `json:"driver,omitempty"`
	State       BackupFreshnessState   `json:"state"`
}

type BackupFreshnessDriver string

type BackupFreshnessState string

type BadRequest = Error

type BadRequestJSONResponse Error

type Chat struct {
	Id openapi_types.UUID `json:"id"`

	// Model The model id the chat was created with (used for continuation).
	Model string `json:"model"`

	// Settings Per-chat model-generation settings. Every field is optional; an omitted field is unset — the provider default applies (temperature / topP / reasoningEffort / maxOutputTokens). maxHistoryTokens defaults to 100000 and caps the complete outbound prompt, including the sticky system message and current user message.
	Settings *ChatSettings `json:"settings,omitempty"`
	Title    string        `json:"title"`
}

type ChatList struct {
	Items  []ChatSummary `json:"items"`
	Limit  int           `json:"limit"`
	Offset int           `json:"offset"`
	Total  int           `json:"total"`
}

type ChatMCPServer struct {
	// Enabled Whether this server's tools are available to this chat.
	Enabled bool               `json:"enabled"`
	Id      openapi_types.UUID `json:"id"`
	Name    string             `json:"name"`

	// Status Live global connection status of the server.
	Status ChatMCPServerStatus `json:"status"`
}

type ChatMCPServerStatus string

type ChatMCPServerUpdate struct {
	// Enabled Enable or disable this server's tools for this chat.
	Enabled bool `json:"enabled"`
}

type ChatSettings struct {
	MaxHistoryTokens *int                         `json:"maxHistoryTokens,omitempty"`
	MaxOutputTokens  *int                         `json:"maxOutputTokens,omitempty"`
	ReasoningEffort  *ChatSettingsReasoningEffort `json:"reasoningEffort,omitempty"`
	Temperature      *float64                     `json:"temperature,omitempty"`
	TopP             *float64                     `json:"topP,omitempty"`
}

type ChatSettingsReasoningEffort string

type ChatSummary struct {
	CreatedAt time.Time          `json:"createdAt"`
	Id        openapi_types.UUID `json:"id"`
	Title     string             `json:"title"`
	UpdatedAt time.Time          `json:"updatedAt"`
}

type Conflict = Error

type ConflictJSONResponse Error

type ContinueChat200TexteventStreamResponse struct {
	Body          io.Reader
	ContentLength int64
}

type ContinueChat400JSONResponse struct{ BadRequestJSONResponse }

type ContinueChat404JSONResponse struct{ NotFoundJSONResponse }

type ContinueChatJSONRequestBody = ContinueChatRequest

type ContinueChatRequest struct {
	Message string `json:"message"`

	// Model Model for this and subsequent turns; switching it updates the chat's model. Omit to keep the chat's current model.
	Model *string `json:"model,omitempty"`
}

type ContinueChatRequestObject struct {
	ChatId openapi_types.UUID `json:"chatId"`
	Body   *ContinueChatJSONRequestBody
}

type ContinueChatResponseObject interface {
	VisitContinueChatResponse(w http.ResponseWriter) error
}

type CreateChat200TexteventStreamResponse struct {
	Body          io.Reader
	ContentLength int64
}

type CreateChat400JSONResponse struct{ BadRequestJSONResponse }

type CreateChatJSONRequestBody = CreateChatRequest

type CreateChatRequest struct {
	Message string `json:"message"`
	Model   string `json:"model"`
}

type CreateChatRequestObject struct {
	Body *CreateChatJSONRequestBody
}

type CreateChatResponseObject interface {
	VisitCreateChatResponse(w http.ResponseWriter) error
}

type CreateMCPServer201JSONResponse MCPServer

type CreateMCPServer400JSONResponse struct{ BadRequestJSONResponse }

type CreateMCPServer409JSONResponse struct{ ConflictJSONResponse }

type CreateMCPServerJSONRequestBody = CreateMCPServerRequest

type CreateMCPServerRequest struct {
	Args      *[]string                       `json:"args,omitempty"`
	Command   *string                         `json:"command,omitempty"`
	Env       *map[string]string              `json:"env,omitempty"`
	Headers   *map[string]string              `json:"headers,omitempty"`
	Name      string                          `json:"name"`
	Transport CreateMCPServerRequestTransport `json:"transport"`
	Url       *string                         `json:"url,omitempty"`
}

type CreateMCPServerRequestObject struct {
	Body *CreateMCPServerJSONRequestBody
}

type CreateMCPServerRequestTransport string

type CreateMCPServerResponseObject interface {
	VisitCreateMCPServerResponse(w http.ResponseWriter) error
}

type CreateUser201JSONResponse User

type CreateUser400JSONResponse struct{ BadRequestJSONResponse }

type CreateUser409JSONResponse struct{ ConflictJSONResponse }

type CreateUserJSONRequestBody = CreateUserRequest

type CreateUserRequest struct {
	IsAdmin  *bool  `json:"isAdmin,omitempty"`
	Password string `json:"password"`
	Username string `json:"username"`
}

type CreateUserRequestObject struct {
	Body *CreateUserJSONRequestBody
}

type CreateUserResponseObject interface {
	VisitCreateUserResponse(w http.ResponseWriter) error
}

type Credentials struct {
	Password string `json:"password"`
	Username string `json:"username"`
}

type DeleteChat204Response struct {
}

type DeleteChat404JSONResponse struct{ NotFoundJSONResponse }

type DeleteChatRequestObject struct {
	ChatId openapi_types.UUID `json:"chatId"`
}

type DeleteChatResponseObject interface {
	VisitDeleteChatResponse(w http.ResponseWriter) error
}

type DeleteMCPServer204Response struct {
}

type DeleteMCPServer404JSONResponse struct{ NotFoundJSONResponse }

type DeleteMCPServerRequestObject struct {
	ServerId openapi_types.UUID `json:"serverId"`
}

type DeleteMCPServerResponseObject interface {
	VisitDeleteMCPServerResponse(w http.ResponseWriter) error
}

type DeleteUser204Response struct {
}

type DeleteUser404JSONResponse struct{ NotFoundJSONResponse }

type DeleteUserRequestObject struct {
	UserId openapi_types.UUID `json:"userId"`
}

type DeleteUserResponseObject interface {
	VisitDeleteUserResponse(w http.ResponseWriter) error
}

type EchoRouter interface {
	CONNECT(path string, h echo.HandlerFunc, m ...echo.MiddlewareFunc) *echo.Route
	DELETE(path string, h echo.HandlerFunc, m ...echo.MiddlewareFunc) *echo.Route
	GET(path string, h echo.HandlerFunc, m ...echo.MiddlewareFunc) *echo.Route
	HEAD(path string, h echo.HandlerFunc, m ...echo.MiddlewareFunc) *echo.Route
	OPTIONS(path string, h echo.HandlerFunc, m ...echo.MiddlewareFunc) *echo.Route
	PATCH(path string, h echo.HandlerFunc, m ...echo.MiddlewareFunc) *echo.Route
	POST(path string, h echo.HandlerFunc, m ...echo.MiddlewareFunc) *echo.Route
	PUT(path string, h echo.HandlerFunc, m ...echo.MiddlewareFunc) *echo.Route
	TRACE(path string, h echo.HandlerFunc, m ...echo.MiddlewareFunc) *echo.Route
}

type Error struct {
	Code    string                  `json:"code"`
	Details *map[string]interface{} `json:"details,omitempty"`
	Message string                  `json:"message"`
}

type GetAdminReadiness200JSONResponse AdminReadiness

type GetAdminReadiness401JSONResponse struct{ UnauthorizedJSONResponse }

type GetAdminReadinessRequestObject struct {
}

type GetAdminReadinessResponseObject interface {
	VisitGetAdminReadinessResponse(w http.ResponseWriter) error
}

type GetAuthStatus200JSONResponse struct {
	Body    AuthStatus
	Headers GetAuthStatus200ResponseHeaders
}

type GetAuthStatus200ResponseHeaders struct {
	SetCookie *string
}

type GetAuthStatusRequestObject struct {
}

type GetAuthStatusResponseObject interface {
	VisitGetAuthStatusResponse(w http.ResponseWriter) error
}

type GetChat200JSONResponse Chat

type GetChat404JSONResponse struct{ NotFoundJSONResponse }

type GetChatRequestObject struct {
	ChatId openapi_types.UUID `json:"chatId"`
}

type GetChatResponseObject interface {
	VisitGetChatResponse(w http.ResponseWriter) error
}

type GetHealth200JSONResponse Health

type GetHealthRequestObject struct {
}

type GetHealthResponseObject interface {
	VisitGetHealthResponse(w http.ResponseWriter) error
}

type GetOrCreateEmptyChat200JSONResponse Chat

type GetOrCreateEmptyChatRequestObject struct {
}

type GetOrCreateEmptyChatResponseObject interface {
	VisitGetOrCreateEmptyChatResponse(w http.ResponseWriter) error
}

type Health struct {
	Status string `json:"status"`
}

type ImportMCP200JSONResponse MCPImportResult

type ImportMCP400JSONResponse struct{ BadRequestJSONResponse }

type ImportMCPJSONRequestBody = ImportMCPRequest

type ImportMCPRequest struct {
	// Content Raw .mcp.json file content (Claude-style).
	Content string `json:"content"`
}

type ImportMCPRequestObject struct {
	Body *ImportMCPJSONRequestBody
}

type ImportMCPResponseObject interface {
	VisitImportMCPResponse(w http.ResponseWriter) error
}

type ListChatMCPServers200JSONResponse []ChatMCPServer

type ListChatMCPServers404JSONResponse struct{ NotFoundJSONResponse }

type ListChatMCPServersRequestObject struct {
	ChatId openapi_types.UUID `json:"chatId"`
}

type ListChatMCPServersResponseObject interface {
	VisitListChatMCPServersResponse(w http.ResponseWriter) error
}

type ListChatMessages200JSONResponse MessageList

type ListChatMessages400JSONResponse struct{ BadRequestJSONResponse }

type ListChatMessages404JSONResponse struct{ NotFoundJSONResponse }

type ListChatMessagesParams struct {
	Limit  *int `form:"limit,omitempty" json:"limit,omitempty"`
	Offset *int `form:"offset,omitempty" json:"offset,omitempty"`
}

type ListChatMessagesRequestObject struct {
	ChatId openapi_types.UUID `json:"chatId"`
	Params ListChatMessagesParams
}

type ListChatMessagesResponseObject interface {
	VisitListChatMessagesResponse(w http.ResponseWriter) error
}

type ListChats200JSONResponse ChatList

type ListChats400JSONResponse struct{ BadRequestJSONResponse }

type ListChats404JSONResponse struct{ NotFoundJSONResponse }

type ListChatsParams struct {
	Limit  *int `form:"limit,omitempty" json:"limit,omitempty"`
	Offset *int `form:"offset,omitempty" json:"offset,omitempty"`

	// Search Case-insensitive literal title search.
	Search *string `form:"search,omitempty" json:"search,omitempty"`
}

type ListChatsRequestObject struct {
	Params ListChatsParams
}

type ListChatsResponseObject interface {
	VisitListChatsResponse(w http.ResponseWriter) error
}

type ListMCPServerTools200JSONResponse []MCPTool

type ListMCPServerTools404JSONResponse struct{ NotFoundJSONResponse }

type ListMCPServerToolsRequestObject struct {
	ServerId openapi_types.UUID `json:"serverId"`
}

type ListMCPServerToolsResponseObject interface {
	VisitListMCPServerToolsResponse(w http.ResponseWriter) error
}

type ListMCPServers200JSONResponse []MCPServer

type ListMCPServersRequestObject struct {
}

type ListMCPServersResponseObject interface {
	VisitListMCPServersResponse(w http.ResponseWriter) error
}

type ListModels200JSONResponse []Model

type ListModelsRequestObject struct {
}

type ListModelsResponseObject interface {
	VisitListModelsResponse(w http.ResponseWriter) error
}

type ListUpstreamHealth200JSONResponse []UpstreamHealth

type ListUpstreamHealth401JSONResponse struct{ UnauthorizedJSONResponse }

type ListUpstreamHealthRequestObject struct {
}

type ListUpstreamHealthResponseObject interface {
	VisitListUpstreamHealthResponse(w http.ResponseWriter) error
}

type ListUsers200JSONResponse []User

type ListUsers401JSONResponse struct{ UnauthorizedJSONResponse }

type ListUsersRequestObject struct {
}

type ListUsersResponseObject interface {
	VisitListUsersResponse(w http.ResponseWriter) error
}

type Login200JSONResponse struct {
	Body    User
	Headers Login200ResponseHeaders
}

type Login200ResponseHeaders struct {
	SetCookie *string
}

type Login401JSONResponse struct{ UnauthorizedJSONResponse }

type LoginJSONRequestBody = Credentials

type LoginRequestObject struct {
	Body *LoginJSONRequestBody
}

type LoginResponseObject interface {
	VisitLoginResponse(w http.ResponseWriter) error
}

type Logout204Response struct {
}

type LogoutRequestObject struct {
}

type LogoutResponseObject interface {
	VisitLogoutResponse(w http.ResponseWriter) error
}

type MCPImportResult struct {
	Imported []MCPServer `json:"imported"`
}

type MCPServer struct {
	// Args Command arguments (stdio transport).
	Args    *[]string `json:"args,omitempty"`
	Command *string   `json:"command,omitempty"`
	Enabled bool      `json:"enabled"`

	// Env Environment variables (stdio transport), decrypted for edit prefill. Admin-only response; sealed at rest, never logged.
	Env *map[string]string `json:"env,omitempty"`

	// Headers HTTP headers (http transport). Authorization values are returned as '<scheme> [SECRET]' for edit prefill; resubmitting that unchanged value preserves the existing sealed credential. Other header values are returned as configured. Admin-only response; sealed at rest and never logged (the request logger records no bodies).
	Headers *map[string]string `json:"headers,omitempty"`
	Id      openapi_types.UUID `json:"id"`

	// LastConnectionAttemptAt UTC time at which the most recent connection attempt started.
	LastConnectionAttemptAt *time.Time `json:"lastConnectionAttemptAt,omitempty"`

	// LastConnectionFailureAt UTC time at which this server most recently failed to connect or disconnected unexpectedly.
	LastConnectionFailureAt *time.Time `json:"lastConnectionFailureAt,omitempty"`

	// LastConnectionLatencyMs Elapsed milliseconds for the most recent completed connection attempt.
	LastConnectionLatencyMs *int `json:"lastConnectionLatencyMs,omitempty"`

	// LastError Most recent connection or unexpected-disconnect error detail. Admin-only and never includes decrypted credentials.
	LastError *string `json:"lastError,omitempty"`

	// LastSuccessfulConnectionAt UTC time at which this server most recently connected successfully.
	LastSuccessfulConnectionAt *time.Time `json:"lastSuccessfulConnectionAt,omitempty"`
	Name                       string     `json:"name"`

	// Status Live connection state of the server.
	Status MCPServerStatus `json:"status"`

	// StatusError Error detail, present when status is failed.
	StatusError *string `json:"statusError,omitempty"`

	// StatusReason Coarse failure classification, present when status is failed.
	StatusReason *MCPServerStatusReason `json:"statusReason,omitempty"`

	// ToolCount Number of tools discovered, present when connected.
	ToolCount *int               `json:"toolCount,omitempty"`
	Transport MCPServerTransport `json:"transport"`
	Url       *string            `json:"url,omitempty"`
}

type MCPServerStatus string

type MCPServerStatusReason string

type MCPServerTransport string

type MCPTool struct {
	Description string `json:"description"`

	// Name Unqualified tool name (no server prefix).
	Name string `json:"name"`

	// Parameters The tool's input JSON Schema.
	Parameters map[string]interface{} `json:"parameters"`
}

type Message struct {
	Content   string             `json:"content"`
	CreatedAt time.Time          `json:"createdAt"`
	Id        openapi_types.UUID `json:"id"`

	// Incomplete True when this is an interrupted turn checkpoint. It is visible on reload but is never replayed into a future model request.
	Incomplete *bool `json:"incomplete,omitempty"`
	IsError    *bool `json:"isError,omitempty"`

	// Model The model that completed this turn. Omitted for messages created before model attribution was introduced.
	Model      *string            `json:"model,omitempty"`
	Role       MessageRole        `json:"role"`
	Thinking   *string            `json:"thinking,omitempty"`
	ToolCallId *string            `json:"toolCallId,omitempty"`
	ToolCalls  *[]MessageToolCall `json:"toolCalls,omitempty"`
}

type MessageList struct {
	Items  []Message `json:"items"`
	Limit  int       `json:"limit"`
	Offset int       `json:"offset"`
	Total  int       `json:"total"`
}

type MessageRole string

type MessageToolCall struct {
	Arguments string `json:"arguments"`
	Id        string `json:"id"`
	Name      string `json:"name"`
}

type Model struct {
	// Alias A friendly instance-local model name for the picker.
	Alias *string `json:"alias,omitempty"`

	// Availability The model was advertised by its upstream during startup discovery.
	Availability  ModelAvailability `json:"availability"`
	ContextWindow *int              `json:"contextWindow,omitempty"`

	// Default Whether this is the instance's configured default model.
	Default bool `json:"default"`

	// ExpectedFirstTokenLatencyMs Instance-configured expected time to first token, in milliseconds.
	ExpectedFirstTokenLatencyMs *int64 `json:"expectedFirstTokenLatencyMs,omitempty"`
	Id                          string `json:"id"`

	// InputPricePerMillionTokens Price for one million tokens. Amount is a decimal string in the currency's smallest unit, avoiding floating-point loss in clients.
	InputPricePerMillionTokens *TokenPrice `json:"inputPricePerMillionTokens,omitempty"`
	MaxOutputTokens            *int        `json:"maxOutputTokens,omitempty"`

	// OutputPricePerMillionTokens Price for one million tokens. Amount is a decimal string in the currency's smallest unit, avoiding floating-point loss in clients.
	OutputPricePerMillionTokens *TokenPrice `json:"outputPricePerMillionTokens,omitempty"`
	SupportsFiles               *bool       `json:"supportsFiles,omitempty"`
	SupportsReasoning           *bool       `json:"supportsReasoning,omitempty"`
	SupportsTools               *bool       `json:"supportsTools,omitempty"`
	SupportsVision              *bool       `json:"supportsVision,omitempty"`
	Upstream                    string      `json:"upstream"`
}

type ModelAvailability string

type NotFound = Error

type NotFoundJSONResponse Error

type PreviewChatContext200JSONResponse PromptContextPreview

type PreviewChatContext400JSONResponse struct{ BadRequestJSONResponse }

type PreviewChatContext404JSONResponse struct{ NotFoundJSONResponse }

type PreviewChatContextJSONRequestBody = PromptContextPreviewRequest

type PreviewChatContextRequestObject struct {
	ChatId openapi_types.UUID `json:"chatId"`
	Body   *PreviewChatContextJSONRequestBody
}

type PreviewChatContextResponseObject interface {
	VisitPreviewChatContextResponse(w http.ResponseWriter) error
}

type PromptContextPreview struct {
	AvailableTokens      int `json:"availableTokens"`
	BudgetTokens         int `json:"budgetTokens"`
	CurrentMessageTokens int `json:"currentMessageTokens"`
	HistoryTokens        int `json:"historyTokens"`
	OmittedMessages      int `json:"omittedMessages"`
	OmittedTurns         int `json:"omittedTurns"`
	RetainedMessages     int `json:"retainedMessages"`
	RetainedTurns        int `json:"retainedTurns"`
	SystemTokens         int `json:"systemTokens"`
	TotalTokens          int `json:"totalTokens"`
}

type PromptContextPreviewRequest struct {
	// Message The unsent user message to include in the preview.
	Message string `json:"message"`
}

type ReconnectMCPServer200JSONResponse MCPServer

type ReconnectMCPServer404JSONResponse struct{ NotFoundJSONResponse }

type ReconnectMCPServerRequestObject struct {
	ServerId openapi_types.UUID `json:"serverId"`
}

type ReconnectMCPServerResponseObject interface {
	VisitReconnectMCPServerResponse(w http.ResponseWriter) error
}

type RegisterHandlersOptions struct {
	// BaseURL is prepended to every registered path so the API can be served
	// under a prefix.
	BaseURL string
	// OperationMiddlewares lets the caller attach per-operation middleware at
	// registration time. The map key is the OpenAPI `operationId` value as it
	// appears in the spec (the raw, un-normalized form). Operations that have
	// no entry are registered with no extra middleware. A nil map disables
	// per-operation middleware entirely.
	OperationMiddlewares map[string][]echo.MiddlewareFunc
}

type RenameChat200JSONResponse ChatSummary

type RenameChat400JSONResponse struct{ BadRequestJSONResponse }

type RenameChat404JSONResponse struct{ NotFoundJSONResponse }

type RenameChatJSONRequestBody = RenameChatRequest

type RenameChatRequest struct {
	Title string `json:"title"`
}

type RenameChatRequestObject struct {
	ChatId openapi_types.UUID `json:"chatId"`
	Body   *RenameChatJSONRequestBody
}

type RenameChatResponseObject interface {
	VisitRenameChatResponse(w http.ResponseWriter) error
}

type ServerInterface interface {
	// GetAdminReadiness Get the redacted operational readiness snapshot (admin).
	// (GET /admin/readiness)
	GetAdminReadiness(ctx echo.Context) error
	// Login Log in with username + password.
	// (POST /auth/login)
	Login(ctx echo.Context) error
	// Logout Revoke the current session.
	// (POST /auth/logout)
	Logout(ctx echo.Context) error
	// Setup Bootstrap the first admin user (one-shot).
	// (POST /auth/setup)
	Setup(ctx echo.Context) error
	// GetAuthStatus Whether setup is needed and whether the caller is authenticated.
	// (GET /auth/status)
	GetAuthStatus(ctx echo.Context) error
	// ListChats List the caller's chats, paginated.
	// (GET /chats)
	ListChats(ctx echo.Context, params ListChatsParams) error
	// CreateChat Create a chat and stream the first assistant turn (SSE).
	// (POST /chats)
	CreateChat(ctx echo.Context) error
	// GetOrCreateEmptyChat Get the caller's reusable "empty chat" (no messages yet), creating one if none exists.
	// (POST /chats/empty)
	GetOrCreateEmptyChat(ctx echo.Context) error
	// DeleteChat Soft-delete one caller-owned chat.
	// (DELETE /chats/{chatId})
	DeleteChat(ctx echo.Context, chatId openapi_types.UUID) error
	// GetChat Get a chat's metadata (settings, model, title) — no messages.
	// (GET /chats/{chatId})
	GetChat(ctx echo.Context, chatId openapi_types.UUID) error
	// RenameChat Rename a chat.
	// (PATCH /chats/{chatId})
	RenameChat(ctx echo.Context, chatId openapi_types.UUID) error
	// ContinueChat Continue a chat and stream the next assistant turn (SSE).
	// (POST /chats/{chatId})
	ContinueChat(ctx echo.Context, chatId openapi_types.UUID) error
	// PreviewChatContext Preview the exact context selected for an unsent chat message.
	// (POST /chats/{chatId}/context-preview)
	PreviewChatContext(ctx echo.Context, chatId openapi_types.UUID) error
	// ListChatMCPServers List the MCP servers with each one's per-chat enablement + status.
	// (GET /chats/{chatId}/mcp-servers)
	ListChatMCPServers(ctx echo.Context, chatId openapi_types.UUID) error
	// UpdateChatMCPServer Enable or disable one MCP server for this chat.
	// (PATCH /chats/{chatId}/mcp-servers/{serverId})
	UpdateChatMCPServer(ctx echo.Context, chatId openapi_types.UUID, serverId openapi_types.UUID) error
	// ListChatMessages List a chat's messages, oldest-first, paginated.
	// (GET /chats/{chatId}/messages)
	ListChatMessages(ctx echo.Context, chatId openapi_types.UUID, params ListChatMessagesParams) error
	// UpdateChatSettings Update a chat's model-generation settings.
	// (PATCH /chats/{chatId}/settings)
	UpdateChatSettings(ctx echo.Context, chatId openapi_types.UUID) error
	// GetHealth Liveness probe.
	// (GET /healthz)
	GetHealth(ctx echo.Context) error
	// ImportMCP Import MCP servers from a Claude-style .mcp.json (admin).
	// (POST /mcp/import)
	ImportMCP(ctx echo.Context) error
	// ListMCPServers List configured MCP servers (admin).
	// (GET /mcp/servers)
	ListMCPServers(ctx echo.Context) error
	// CreateMCPServer Add an MCP server (admin).
	// (POST /mcp/servers)
	CreateMCPServer(ctx echo.Context) error
	// DeleteMCPServer Remove an MCP server (admin).
	// (DELETE /mcp/servers/{serverId})
	DeleteMCPServer(ctx echo.Context, serverId openapi_types.UUID) error
	// UpdateMCPServer Edit an MCP server and reconnect (admin).
	// (PATCH /mcp/servers/{serverId})
	UpdateMCPServer(ctx echo.Context, serverId openapi_types.UUID) error
	// ReconnectMCPServer Reconnect an MCP server in the background (admin).
	// (POST /mcp/servers/{serverId}/reconnect)
	ReconnectMCPServer(ctx echo.Context, serverId openapi_types.UUID) error
	// ListMCPServerTools List a connected MCP server's tools (admin).
	// (GET /mcp/servers/{serverId}/tools)
	ListMCPServerTools(ctx echo.Context, serverId openapi_types.UUID) error
	// ListModels Merged model list across all configured upstreams.
	// (GET /models)
	ListModels(ctx echo.Context) error
	// ListUpstreamHealth List redacted LLM upstream health snapshots (admin).
	// (GET /upstreams)
	ListUpstreamHealth(ctx echo.Context) error
	// ListUsers List users (admin).
	// (GET /users)
	ListUsers(ctx echo.Context) error
	// CreateUser Provision a user (admin).
	// (POST /users)
	CreateUser(ctx echo.Context) error
	// DeleteUser Delete a user (admin).
	// (DELETE /users/{userId})
	DeleteUser(ctx echo.Context, userId openapi_types.UUID) error
}

type ServerInterfaceWrapper struct {
	Handler ServerInterface
}

type Setup200JSONResponse struct {
	Body    User
	Headers Setup200ResponseHeaders
}

type Setup200ResponseHeaders struct {
	SetCookie *string
}

type Setup400JSONResponse struct{ BadRequestJSONResponse }

type Setup409JSONResponse struct{ ConflictJSONResponse }

type SetupJSONRequestBody = Credentials

type SetupRequestObject struct {
	Body *SetupJSONRequestBody
}

type SetupResponseObject interface {
	VisitSetupResponse(w http.ResponseWriter) error
}

type StrictHandlerFunc func(ctx echo.Context, request any) (any, error)

type StrictMiddlewareFunc func(f StrictHandlerFunc, operationID string) StrictHandlerFunc

type StrictServerInterface interface {
	// GetAdminReadiness Get the redacted operational readiness snapshot (admin).
	// (GET /admin/readiness)
	GetAdminReadiness(ctx context.Context, request GetAdminReadinessRequestObject) (GetAdminReadinessResponseObject, error)
	// Login Log in with username + password.
	// (POST /auth/login)
	Login(ctx context.Context, request LoginRequestObject) (LoginResponseObject, error)
	// Logout Revoke the current session.
	// (POST /auth/logout)
	Logout(ctx context.Context, request LogoutRequestObject) (LogoutResponseObject, error)
	// Setup Bootstrap the first admin user (one-shot).
	// (POST /auth/setup)
	Setup(ctx context.Context, request SetupRequestObject) (SetupResponseObject, error)
	// GetAuthStatus Whether setup is needed and whether the caller is authenticated.
	// (GET /auth/status)
	GetAuthStatus(ctx context.Context, request GetAuthStatusRequestObject) (GetAuthStatusResponseObject, error)
	// ListChats List the caller's chats, paginated.
	// (GET /chats)
	ListChats(ctx context.Context, request ListChatsRequestObject) (ListChatsResponseObject, error)
	// CreateChat Create a chat and stream the first assistant turn (SSE).
	// (POST /chats)
	CreateChat(ctx context.Context, request CreateChatRequestObject) (CreateChatResponseObject, error)
	// GetOrCreateEmptyChat Get the caller's reusable "empty chat" (no messages yet), creating one if none exists.
	// (POST /chats/empty)
	GetOrCreateEmptyChat(ctx context.Context, request GetOrCreateEmptyChatRequestObject) (GetOrCreateEmptyChatResponseObject, error)
	// DeleteChat Soft-delete one caller-owned chat.
	// (DELETE /chats/{chatId})
	DeleteChat(ctx context.Context, request DeleteChatRequestObject) (DeleteChatResponseObject, error)
	// GetChat Get a chat's metadata (settings, model, title) — no messages.
	// (GET /chats/{chatId})
	GetChat(ctx context.Context, request GetChatRequestObject) (GetChatResponseObject, error)
	// RenameChat Rename a chat.
	// (PATCH /chats/{chatId})
	RenameChat(ctx context.Context, request RenameChatRequestObject) (RenameChatResponseObject, error)
	// ContinueChat Continue a chat and stream the next assistant turn (SSE).
	// (POST /chats/{chatId})
	ContinueChat(ctx context.Context, request ContinueChatRequestObject) (ContinueChatResponseObject, error)
	// PreviewChatContext Preview the exact context selected for an unsent chat message.
	// (POST /chats/{chatId}/context-preview)
	PreviewChatContext(ctx context.Context, request PreviewChatContextRequestObject) (PreviewChatContextResponseObject, error)
	// ListChatMCPServers List the MCP servers with each one's per-chat enablement + status.
	// (GET /chats/{chatId}/mcp-servers)
	ListChatMCPServers(ctx context.Context, request ListChatMCPServersRequestObject) (ListChatMCPServersResponseObject, error)
	// UpdateChatMCPServer Enable or disable one MCP server for this chat.
	// (PATCH /chats/{chatId}/mcp-servers/{serverId})
	UpdateChatMCPServer(ctx context.Context, request UpdateChatMCPServerRequestObject) (UpdateChatMCPServerResponseObject, error)
	// ListChatMessages List a chat's messages, oldest-first, paginated.
	// (GET /chats/{chatId}/messages)
	ListChatMessages(ctx context.Context, request ListChatMessagesRequestObject) (ListChatMessagesResponseObject, error)
	// UpdateChatSettings Update a chat's model-generation settings.
	// (PATCH /chats/{chatId}/settings)
	UpdateChatSettings(ctx context.Context, request UpdateChatSettingsRequestObject) (UpdateChatSettingsResponseObject, error)
	// GetHealth Liveness probe.
	// (GET /healthz)
	GetHealth(ctx context.Context, request GetHealthRequestObject) (GetHealthResponseObject, error)
	// ImportMCP Import MCP servers from a Claude-style .mcp.json (admin).
	// (POST /mcp/import)
	ImportMCP(ctx context.Context, request ImportMCPRequestObject) (ImportMCPResponseObject, error)
	// ListMCPServers List configured MCP servers (admin).
	// (GET /mcp/servers)
	ListMCPServers(ctx context.Context, request ListMCPServersRequestObject) (ListMCPServersResponseObject, error)
	// CreateMCPServer Add an MCP server (admin).
	// (POST /mcp/servers)
	CreateMCPServer(ctx context.Context, request CreateMCPServerRequestObject) (CreateMCPServerResponseObject, error)
	// DeleteMCPServer Remove an MCP server (admin).
	// (DELETE /mcp/servers/{serverId})
	DeleteMCPServer(ctx context.Context, request DeleteMCPServerRequestObject) (DeleteMCPServerResponseObject, error)
	// UpdateMCPServer Edit an MCP server and reconnect (admin).
	// (PATCH /mcp/servers/{serverId})
	UpdateMCPServer(ctx context.Context, request UpdateMCPServerRequestObject) (UpdateMCPServerResponseObject, error)
	// ReconnectMCPServer Reconnect an MCP server in the background (admin).
	// (POST /mcp/servers/{serverId}/reconnect)
	ReconnectMCPServer(ctx context.Context, request ReconnectMCPServerRequestObject) (ReconnectMCPServerResponseObject, error)
	// ListMCPServerTools List a connected MCP server's tools (admin).
	// (GET /mcp/servers/{serverId}/tools)
	ListMCPServerTools(ctx context.Context, request ListMCPServerToolsRequestObject) (ListMCPServerToolsResponseObject, error)
	// ListModels Merged model list across all configured upstreams.
	// (GET /models)
	ListModels(ctx context.Context, request ListModelsRequestObject) (ListModelsResponseObject, error)
	// ListUpstreamHealth List redacted LLM upstream health snapshots (admin).
	// (GET /upstreams)
	ListUpstreamHealth(ctx context.Context, request ListUpstreamHealthRequestObject) (ListUpstreamHealthResponseObject, error)
	// ListUsers List users (admin).
	// (GET /users)
	ListUsers(ctx context.Context, request ListUsersRequestObject) (ListUsersResponseObject, error)
	// CreateUser Provision a user (admin).
	// (POST /users)
	CreateUser(ctx context.Context, request CreateUserRequestObject) (CreateUserResponseObject, error)
	// DeleteUser Delete a user (admin).
	// (DELETE /users/{userId})
	DeleteUser(ctx context.Context, request DeleteUserRequestObject) (DeleteUserResponseObject, error)
}

type TokenPrice struct {
	Amount   string `json:"amount"`
	Currency string `json:"currency"`
}

type Unauthorized = Error

type UnauthorizedJSONResponse Error

type UpdateChatMCPServer200JSONResponse ChatMCPServer

type UpdateChatMCPServer400JSONResponse struct{ BadRequestJSONResponse }

type UpdateChatMCPServer404JSONResponse struct{ NotFoundJSONResponse }

type UpdateChatMCPServerJSONRequestBody = ChatMCPServerUpdate

type UpdateChatMCPServerRequestObject struct {
	ChatId   openapi_types.UUID `json:"chatId"`
	ServerId openapi_types.UUID `json:"serverId"`
	Body     *UpdateChatMCPServerJSONRequestBody
}

type UpdateChatMCPServerResponseObject interface {
	VisitUpdateChatMCPServerResponse(w http.ResponseWriter) error
}

type UpdateChatSettings200JSONResponse ChatSettings

type UpdateChatSettings400JSONResponse struct{ BadRequestJSONResponse }

type UpdateChatSettings404JSONResponse struct{ NotFoundJSONResponse }

type UpdateChatSettingsJSONRequestBody = ChatSettings

type UpdateChatSettingsRequestObject struct {
	ChatId openapi_types.UUID `json:"chatId"`
	Body   *UpdateChatSettingsJSONRequestBody
}

type UpdateChatSettingsResponseObject interface {
	VisitUpdateChatSettingsResponse(w http.ResponseWriter) error
}

type UpdateMCPServer200JSONResponse MCPServer

type UpdateMCPServer400JSONResponse struct{ BadRequestJSONResponse }

type UpdateMCPServer404JSONResponse struct{ NotFoundJSONResponse }

type UpdateMCPServerJSONRequestBody = UpdateMCPServerRequest

type UpdateMCPServerRequest struct {
	Args    *[]string          `json:"args,omitempty"`
	Command *string            `json:"command,omitempty"`
	Enabled *bool              `json:"enabled,omitempty"`
	Env     *map[string]string `json:"env,omitempty"`

	// Headers HTTP headers to replace. An Authorization value returned as '<scheme> [SECRET]' preserves the existing sealed credential when sent back unchanged; any other value replaces it.
	Headers   *map[string]string               `json:"headers,omitempty"`
	Name      *string                          `json:"name,omitempty"`
	Transport *UpdateMCPServerRequestTransport `json:"transport,omitempty"`
	Url       *string                          `json:"url,omitempty"`
}

type UpdateMCPServerRequestObject struct {
	ServerId openapi_types.UUID `json:"serverId"`
	Body     *UpdateMCPServerJSONRequestBody
}

type UpdateMCPServerRequestTransport string

type UpdateMCPServerResponseObject interface {
	VisitUpdateMCPServerResponse(w http.ResponseWriter) error
}

type UpstreamHealth struct {
	ConsecutiveFailures int                 `json:"consecutiveFailures"`
	LastFailureAt       *time.Time          `json:"lastFailureAt,omitempty"`
	LastFailureClass    *string             `json:"lastFailureClass,omitempty"`
	LastLatencyMs       *int64              `json:"lastLatencyMs,omitempty"`
	LastOperation       *string             `json:"lastOperation,omitempty"`
	LastSuccessAt       *time.Time          `json:"lastSuccessAt,omitempty"`
	State               UpstreamHealthState `json:"state"`
	Upstream            string              `json:"upstream"`
}

type UpstreamHealthState string

type User struct {
	CreatedAt time.Time          `json:"createdAt"`
	Id        openapi_types.UUID `json:"id"`
	IsAdmin   bool               `json:"isAdmin"`
	Username  string             `json:"username"`
}