refactor(core): migrate backend backbone from Quart to FastAPI and introduce more OpenAPI (#8688)

* refactor: migrate to fastapi

* structure refactor

* fix: pyright fix

* refactor: improve error handling and public messages in plugin services

* feat(api): refactor API client integration and enhance request handling

- Updated API client configuration to use a dedicated HTTP client.
- Introduced utility functions for generating options, queries, and form data for API requests.
- Refactored multiple API methods to utilize the new utility functions for improved consistency and readability.
- Renamed types for clarity and updated import statements accordingly.

feat(docs): add script to update OpenAPI JSON from YAML spec

- Created a Python script to convert OpenAPI YAML specification to JSON format.
- The script supports customizable input and output paths.
- Ensured the script handles directory creation for output paths and validates the YAML structure.

* fix

* feat(auth): implement rate limiting for v1 login endpoint and enhance request handling

* Refactor dashboard API routers to use legacy_router for backward compatibility

- Changed all instances of dashboard_router to legacy_router across multiple API modules including platform, plugins, providers, sessions, skills, stats, subagents, t2i, tools, updates, and asgi_runtime.
- Updated route definitions to ensure existing endpoints remain functional under the new router structure.
- Introduced support for Quart request context in asgi_runtime to enhance compatibility with existing Quart-based plugins.
- Added a test case to validate the functionality of the new Quart request context handling in plugin extensions.

* chore: remove cli test

* fix: update dashboard tests for fastapi migration

* chore: satisfy ruff checks

* fix: update openapi api key scopes

* fix: sync config scope chip selection

* fix: restore quart dependency

* docs: clarify quart plugin api compatibility

* docs: update openapi scope documentation

* fix: use singular skill openapi scope

* fix: hide update service exception details

* fix: address fastapi review comments

* fix: address dashboard review findings

* docs: revert unrelated package deployment changes

* docs: update agent api generation guidance

* feat: add plugin page web api helpers

* docs: add plugin page bridge demo

* fix: type plugin upload files

* fix: stabilize plugin page uploads

* fix: type plugin web request proxy

* docs: remove plugin page docs example

* fix: authenticate plugin page SSE bridge

dashboard/src/api/generated/openapi-v1/index.ts

@@ -0,0 +1,3 @@
+// This file is auto-generated by @hey-api/openapi-ts
+export * from './sdk.gen';
+export * from './types.gen';

dashboard/src/api/http.ts

@@ -0,0 +1,102 @@
+import axios, {
+  type AxiosError,
+  type AxiosInstance,
+  type InternalAxiosRequestConfig,
+} from 'axios';
+
+const AUTH_HEADER = 'Authorization';
+const LOCALE_HEADER = 'Accept-Language';
+
+let configured = false;
+let originalFetch: typeof window.fetch | null = null;
+
+export const httpClient = axios;
+export const apiV1Client = axios.create({ baseURL: '/api/v1' });
+
+function getToken(): string | null {
+  return localStorage.getItem('token');
+}
+
+function getLocale(): string | null {
+  return localStorage.getItem('astrbot-locale');
+}
+
+function setAxiosHeader(
+  headers: InternalAxiosRequestConfig['headers'],
+  key: string,
+  value: string,
+) {
+  if (typeof headers.set === 'function') {
+    headers.set(key, value);
+    return;
+  }
+  headers[key] = value;
+}
+
+function attachAxiosHeaders(config: InternalAxiosRequestConfig) {
+  const token = getToken();
+  if (token) {
+    setAxiosHeader(config.headers, AUTH_HEADER, `Bearer ${token}`);
+  }
+
+  const locale = getLocale();
+  if (locale) {
+    setAxiosHeader(config.headers, LOCALE_HEADER, locale);
+  }
+
+  return config;
+}
+
+function normalizeAxiosError(error: AxiosError) {
+  if (error.response?.status === 429) {
+    const data = error.response.data as { message?: string } | undefined;
+    if (data?.message) {
+      return Promise.reject(data.message);
+    }
+  }
+  return Promise.reject(error);
+}
+
+function installAxiosInterceptors(instance: AxiosInstance) {
+  instance.interceptors.request.use(attachAxiosHeaders);
+  instance.interceptors.response.use((response) => response, normalizeAxiosError);
+}
+
+export function fetchWithAuth(input: RequestInfo | URL, init?: RequestInit) {
+  const fetchImpl = originalFetch ?? window.fetch.bind(window);
+  const token = getToken();
+  const locale = getLocale();
+
+  if (!token && !locale) {
+    return fetchImpl(input, init);
+  }
+
+  const requestHeaders =
+    typeof input !== 'string' && 'headers' in input
+      ? (input as Request).headers
+      : undefined;
+  const headers = new Headers(init?.headers || requestHeaders);
+
+  if (token && !headers.has(AUTH_HEADER)) {
+    headers.set(AUTH_HEADER, `Bearer ${token}`);
+  }
+  if (locale && !headers.has(LOCALE_HEADER)) {
+    headers.set(LOCALE_HEADER, locale);
+  }
+
+  return fetchImpl(input, { ...init, headers });
+}
+
+export function setupHttpClient() {
+  if (configured) {
+    return;
+  }
+
+  installAxiosInterceptors(axios);
+  installAxiosInterceptors(apiV1Client);
+
+  originalFetch = window.fetch.bind(window);
+  window.fetch = fetchWithAuth;
+
+  configured = true;
+}