llm-simple-router 0.8.2 → 0.9.4

package/README.en.md

@@ -0,0 +1,319 @@
+**[English](README.en.md)** | **[中文](README.md)**
+
+# LLM Simple Router
+
+An LLM API proxy router that receives requests from clients like Claude Code and Cursor, forwards them to configured backend Providers through model mapping and routing strategies, supporting both streaming (SSE) and non-streaming proxying.
+
+**Core problem it solves**: Chinese domestic models have frequent rate limits, switching between multiple providers is cumbersome, and concurrency control is missing.
+
+## Who Is This For
+
+- Developers using Claude Code with Chinese domestic models (Zhipu, Moonshot, Minimax, etc.)
+- Those who want automatic retries for rate-limit errors, time-based model switching, and concurrency queue management
+- Anyone looking for a turnkey solution without the hassle
+
+## Feature Overview
+
+| Feature | Description |
+|---------|-------------|
+| Automatic retries | Exponential backoff retries for 429/400/network timeouts, pre-configured for Zhipu models by default |
+| Multi-provider support | Zhipu, Moonshot, Minimax, Volcano Engine, Alibaba Cloud, Tencent Cloud, etc. Base URL is auto-filled when you select a Coding Plan |
+| Time-based model mapping | Automatically switch backend models by time period (e.g., switch to Kimi during peak hours, back to GLM during off-peak) |
+| Concurrency queue | Per-Provider concurrency limits with queueing for excess requests |
+| Failover | Multiple Providers as backups; automatically switches to the next on failure |
+| Real-time monitoring | SSE-based live view of active requests, queue status, and streaming output |
+| Multi-key management | Independent API keys + model whitelists for multi-user/multi-project setups |
+| Request logs | Full four-stage tracing (client request / upstream request / upstream response / client response) |
+| Performance metrics | TTFT, TPS, Token usage, cache hit rate |
+
+> **API Compatibility:** Supports Anthropic-compatible API (adapted for Claude Code). OpenAI-compatible API (`/v1/chat/completions`) is not yet fully tested.
+
+## Admin Dashboard
+
+| Provider Management + Concurrency Control | Real-time Monitoring |
+|---|---|
+| ![Provider](docs/screenshot/provider_concurrency.png) | ![Monitor](docs/screenshot/monitor.png) |
+
+| Model Mapping | Retry Rules |
+|---|---|
+| ![Mapping](docs/screenshot/model_mapping.png) | ![Retry](docs/screenshot/retry.png) |
+
+| Dashboard | Request Logs |
+|---|---|
+| ![Dashboard](docs/screenshot/dashboard.png) | ![Logs](docs/screenshot/log.png) |
+
+| Proxy Enhancement (Experimental) |
+|----------------------------------|
+| ![Proxy Enhancement](docs/screenshot/proxy_enhance.png) |
+
+## Quick Start
+
+### 1. Start the Router
+
+```bash
+npx llm-simple-router
+```
+
+Visit http://localhost:9981/admin — on first access you'll see the Setup page to set an admin password. Data is stored in `~/.llm-simple-router/`.
+
+### 2. Configure a Provider
+
+Go to Admin Dashboard > Provider page > Add Provider. Select a Coding Plan and the Base URL will be auto-filled — you only need to provide the API Key.
+
+### 3. Configure Model Mapping
+
+Go to Admin Dashboard > Model Mapping page.
+
+**Core concept:** The client sends a request with model name A. The Router replaces it with model name B (supported by the backend Provider) based on mapping rules, then forwards the request:
+
+```
+Claude Code (model A) → Router (A → B) → Provider API (model B)
+```
+
+Simply configure "client model = A, backend model = B, select provider" in the mapping table.
+
+#### Claude Code Default Model Names
+
+When no environment variables are set, Claude Code uses the following default model names: `opus`, `sonnet`, `haiku`. If the backend is Zhipu Coding Plan, the mapping configuration would be:
+
+| Client Model | Backend Model | Provider | Time Window |
+|-------------|---------------|----------|-------------|
+| opus | glm-5.1 | Zhipu Coding Plan | All day |
+| sonnet | glm-5.1 | Zhipu Coding Plan | All day |
+| haiku | glm-5-turbo | Zhipu Coding Plan | All day |
+
+You can also use time-based mapping to auto-switch during peak hours:
+
+| Client Model | Backend Model | Provider | Time Window |
+|-------------|---------------|----------|-------------|
+| sonnet | glm-5.1 | Zhipu Coding Plan | 00:00-14:00 |
+| sonnet | kimi-for-coding | Moonshot | 14:00-18:00 |
+| sonnet | glm-5.1 | Zhipu Coding Plan | 18:00-24:00 |
+
+### 4. Configure Claude Code
+
+Create a Router API key in the admin dashboard, then choose one of the following methods. **You only need one of the two.**
+
+**Method 1: Shell alias (recommended)**
+
+Minimal configuration — Claude Code uses default model names (opus / sonnet / haiku), and the Router converts them via the mapping table:
+
+```bash
+alias clode='\
+export ANTHROPIC_AUTH_TOKEN="<your-router-key>" && \
+export ANTHROPIC_BASE_URL="http://127.0.0.1:9981" && \
+claude'
+```
+
+You can also specify model names directly via environment variables, bypassing Router mapping:
+
+```bash
+alias clode='\
+export ANTHROPIC_AUTH_TOKEN="sk-router-xxxxxxxx" && \
+export ANTHROPIC_BASE_URL="http://192.168.1.111:9981" && \
+export ANTHROPIC_MODEL="glm-5" && \
+export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5.1" && \
+export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5" && \
+export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5-turbo" && \
+export ANTHROPIC_SMALL_FAST_MODEL="glm-5-turbo" && \
+claude'
+```
+
+> For debugging, add flags: `claude --dangerously-skip-permissions --verbose --debug`, or set `export DEBUG=claude:*` for detailed logs.
+
+**Method 2: ~/.claude/settings.json**
+
+Configure in the `env` field of `~/.claude/settings.json` — same effect as exporting environment variables:
+
+Minimal configuration:
+
+```json
+{
+  "env": {
+    "ANTHROPIC_AUTH_TOKEN": "<your-router-key>",
+    "ANTHROPIC_BASE_URL": "http://127.0.0.1:9981"
+  }
+}
+```
+
+Override model names:
+
+```json
+{
+  "env": {
+    "ANTHROPIC_AUTH_TOKEN": "sk-router-xxxxxxxx",
+    "ANTHROPIC_BASE_URL": "http://192.168.1.111:9981",
+    "ANTHROPIC_MODEL": "glm-5",
+    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.1",
+    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5",
+    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5-turbo",
+    "ANTHROPIC_SMALL_FAST_MODEL": "glm-5-turbo"
+  }
+}
+```
+
+> Environment variables in settings.json apply to all projects. To apply only to the current project, place them in `.claude/settings.json` (in the project root).
+
+### 5. Usage
+
+```bash
+# Method 1 (shell alias)
+clode
+
+# Method 2 (settings.json)
+claude
+```
+
+## Docker Deployment
+
+```bash
+docker compose up -d
+```
+
+Environment variables are configured through the Setup page — no `.env` file needed.
+
+## Process Management
+
+After upgrading via the Web UI, the service needs to restart to take effect. Use one of the following deployment methods to ensure automatic recovery after crashes or upgrade restarts.
+
+### PM2 (Recommended)
+
+```bash
+# Install PM2
+npm install -g pm2
+
+# Install Router globally
+npm install -g llm-simple-router
+
+# Start (PM2 auto-restarts crashed processes)
+pm2 start llm-simple-router --name llm-router
+
+# View logs
+pm2 logs llm-router
+
+# Enable startup on boot
+pm2 startup
+pm2 save
+```
+
+Upgrade flow: Web UI one-click upgrade → click restart → PM2 auto-spawns new process (< 1s downtime).
+
+### systemd (Linux Servers)
+
+Create a service file at `/etc/systemd/system/llm-simple-router.service`:
+
+```ini
+[Unit]
+Description=LLM Simple Router
+After=network.target
+
+[Service]
+Type=simple
+ExecStart=/usr/local/bin/llm-simple-router
+Restart=always
+RestartSec=3
+Environment=PORT=9981
+Environment=LOG_LEVEL=info
+# Configure other environment variables as needed
+# Environment=DB_PATH=/var/lib/llm-simple-router/router.db
+
+[Install]
+WantedBy=multi-user.target
+```
+
+> **Note:** The `ExecStart` path depends on how Node.js is installed. Use `which llm-simple-router` to confirm the actual path.
+
+```bash
+# Enable and start
+sudo systemctl enable llm-simple-router
+sudo systemctl start llm-simple-router
+
+# View status and logs
+sudo systemctl status llm-simple-router
+journalctl -u llm-simple-router -f
+```
+
+Upgrade flow: Web UI one-click upgrade → click restart → systemd auto-restarts (< 1s downtime).
+
+### npx / Manual Start
+
+No extra configuration needed. After upgrading via Web UI and clicking restart, the Router automatically spawns a new process and exits the old one. Brief interruption of about 1-2 seconds.
+
+> **Note:** If you directly `Ctrl+C` or close the terminal, the service won't auto-recover. For production, use PM2 or systemd.
+
+## How It Works
+
+```
+Claude Code → Router (model mapping + auto-retry + concurrency control) → Zhipu GLM / Kimi / Other Providers
+```
+
+The Router finds the backend provider via model mapping → forwards the request → auto-retries failed requests → logs and records performance metrics → returns the response.
+
+### Architecture Diagram
+
+**System Context** ([detailed description](docs/system-context.md)):
+
+```mermaid
+graph LR
+    Clients["Claude Code / Cursor / Other Clients"]
+    Admin["Administrator"]
+    Router>"LLM Simple Router"]
+    Providers>"Zhipu / Moonshot / OpenAI / Anthropic / ..."]
+
+    Clients -->|"API Request<br/>Bearer Token"| Router
+    Admin -->|"Admin Dashboard<br/>/admin/"| Router
+    Router -->|"Forwarded Request<br/>SSE Streaming"| Providers
+```
+
+**Request Processing Pipeline** ([detailed description](docs/request-pipeline.md)):
+
+```mermaid
+flowchart LR
+    A[Client Request] --> B[Authentication]
+    B --> C[Model Mapping<br/>+ Routing Strategy]
+    C --> D[Concurrency Queue]
+    D --> E[Call Upstream<br/>Auto-retry on Failure]
+    E --> F[Log Request<br/>+ Metrics]
+    F --> G[Return Response]
+
+    E -.->|Failure| C
+```
+
+When the Router receives a request: Authentication → find backend Provider via mapping rules → queue for concurrency control → forward to upstream (auto-retry on failure; under Failover strategy, switches Provider) → log and record metrics → return response.
+
+## Environment Variables
+
+All secrets are configured through the Setup page. The following are optional configurations:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `PORT` | `9981` | Service port |
+| `DB_PATH` | `~/.llm-simple-router/router.db` | SQLite database path |
+| `LOG_LEVEL` | `info` | Log level |
+| `TZ` | `Asia/Shanghai` | Timezone setting |
+| `STREAM_TIMEOUT_MS` | `3000000` | Streaming proxy idle timeout (ms) |
+| `RETRY_MAX_ATTEMPTS` | `3` | Maximum retry attempts |
+| `RETRY_BASE_DELAY_MS` | `1000` | Retry base delay (ms) |
+
+## Development
+
+```bash
+# Backend (hot reload)
+npm run dev
+
+# Frontend (hot reload, proxies API to backend :9980)
+cd frontend && npm run dev
+
+# Build
+npm run build:full
+
+# Test
+npm test
+
+# Lint
+npm run lint
+```
+
+## License
+
+MIT

package/README.md

@@ -1,3 +1,5 @@
+**[English](README.en.md)** | **[中文](README.md)**
+
 # LLM Simple Router
 
 LLM API 代理路由器。接收 Claude Code / Cursor 等客户端请求，通过模型映射和路由策略转发到配置的后端 Provider，支持流式（SSE）和非流式代理。

package/config/recommended-providers.json

@@ -7,14 +7,20 @@
         "presetName": "deepseek",
         "apiType": "anthropic",
         "baseUrl": "https://api.deepseek.com/anthropic",
-        "models": ["deepseek-chat", "deepseek-reasoner"]
+        "models": [
+          "deepseek-v4-flash",
+          "deepseek-v4-pro"
+        ]
       },
       {
         "plan": "OpenAI",
         "presetName": "deepseek-openai",
         "apiType": "openai",
         "baseUrl": "https://api.deepseek.com",
-        "models": ["deepseek-chat", "deepseek-reasoner"]
+        "models": [
+          "deepseek-v4-flash",
+          "deepseek-v4-pro"
+        ]
       }
     ]
   },
@@ -86,7 +92,12 @@
         "presetName": "zhipu-coding-plan",
         "apiType": "anthropic",
         "baseUrl": "https://open.bigmodel.cn/api/anthropic",
-        "models": ["glm-5.1", "glm-5", "glm-4.7", "glm-4.5-air"]
+        "models": [
+          "glm-5.1",
+          "glm-5",
+          "glm-4.7",
+          "glm-4.5-air"
+        ]
       },
       {
         "plan": "API",
@@ -105,14 +116,17 @@
     ]
   },
   {
-    "group": "KIMI",
+    "group": "月之暗面",
     "presets": [
       {
         "plan": "Coding Plan",
         "presetName": "kimi-coding-plan",
         "apiType": "anthropic",
         "baseUrl": "https://api.kimi.com/coding",
-        "models": ["kimi-for-coding", "kimi-k2.5"]
+        "models": [
+          "kimi-for-coding",
+          "kimi-k2.5"
+        ]
       },
       {
         "plan": "API",
@@ -137,7 +151,9 @@
         "presetName": "minimax-token-plan",
         "apiType": "anthropic",
         "baseUrl": "https://api.minimaxi.com/anthropic",
-        "models": ["MiniMax-M2.7"]
+        "models": [
+          "MiniMax-M2.7"
+        ]
       },
       {
         "plan": "API",
@@ -258,7 +274,12 @@
         "presetName": "opencode-go-anthropic",
         "apiType": "anthropic",
         "baseUrl": "https://opencode.ai/zen/go/v1/messages",
-        "models": ["deepseek-v4-pro", "deepseek-v4-flash", "minimax-m2.7", "minimax-m2.5"]
+        "models": [
+          "deepseek-v4-pro",
+          "deepseek-v4-flash",
+          "minimax-m2.7",
+          "minimax-m2.5"
+        ]
       }
     ]
   },
@@ -270,7 +291,10 @@
         "presetName": "stepfun-step-plan",
         "apiType": "anthropic",
         "baseUrl": "https://api.stepfun.com/step_plan",
-        "models": ["step-3.5-flash-2603", "step-3.5-flash"]
+        "models": [
+          "step-3.5-flash-2603",
+          "step-3.5-flash"
+        ]
       },
       {
         "plan": "API",
@@ -288,4 +312,4 @@
       }
     ]
   }
-]
+]

package/config/recommended-retry-rules.json

@@ -1,10 +1,11 @@
 [
-  { "name": "429 Too Many Requests", "status_code": 429, "body_pattern": ".*", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 10, "max_delay_ms": 60000 },
-  { "name": "503 Service Unavailable", "status_code": 503, "body_pattern": ".*", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 10, "max_delay_ms": 60000 },
-  { "name": "ZAI 网络错误 (code 1234)", "status_code": 400, "body_pattern": "\"type\"\\s*:\\s*\"error\".*\"code\"\\s*:\\s*\"1234\"", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 10, "max_delay_ms": 60000 },
-  { "name": "ZAI 临时不可用", "status_code": 400, "body_pattern": "\"type\"\\s*:\\s*\"error\".*请稍后重试", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 10, "max_delay_ms": 60000 },
-  { "name": "ZAI 操作失败 (code 500)", "status_code": 400, "body_pattern": "\"type\"\\s*:\\s*\"error\".*\"code\"\\s*:\\s*\"500\"", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 10, "max_delay_ms": 60000 },
-  { "name": "ZAI 速率限制 (HTTP 200, code 1302)", "status_code": 200, "body_pattern": "\"error\".*\"code\"\\s*:\\s*\"1302\"", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 10, "max_delay_ms": 60000 },
-  { "name": "ZAI SSE 错误 (HTTP 200, code 500)", "status_code": 200, "body_pattern": "\"error\".*\"code\"\\s*:\\s*\"500\"", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 10, "max_delay_ms": 60000 },
-  { "name": "ZAI SSE 错误 (HTTP 200, code 1234)", "status_code": 200, "body_pattern": "\"error\".*\"code\"\\s*:\\s*\"1234\"", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 10, "max_delay_ms": 60000 }
+  { "name": "429 Too Many Requests", "status_code": 429, "body_pattern": ".*", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 10, "max_delay_ms": 60000, "providers": [] },
+  { "name": "503 Service Unavailable", "status_code": 503, "body_pattern": ".*", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 10, "max_delay_ms": 60000, "providers": [] },
+  { "name": "ZAI 网络错误 (code 1234)", "status_code": 400, "body_pattern": "\"type\"\\s*:\\s*\"error\".*\"code\"\\s*:\\s*\"1234\"", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 10, "max_delay_ms": 60000, "providers": ["智谱"] },
+  { "name": "ZAI 临时不可用", "status_code": 400, "body_pattern": "\"type\"\\s*:\\s*\"error\".*请稍后重试", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 10, "max_delay_ms": 60000, "providers": ["智谱"] },
+  { "name": "ZAI 操作失败 (code 500)", "status_code": 400, "body_pattern": "\"type\"\\s*:\\s*\"error\".*\"code\"\\s*:\\s*\"500\"", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 10, "max_delay_ms": 60000, "providers": ["智谱"] },
+  { "name": "ZAI 速率限制 (HTTP 200, code 1302)", "status_code": 200, "body_pattern": "\"error\".*\"code\"\\s*:\\s*\"1302\"", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 10, "max_delay_ms": 60000, "providers": ["智谱"] },
+  { "name": "ZAI SSE 错误 (HTTP 200, code 500)", "status_code": 200, "body_pattern": "\"error\".*\"code\"\\s*:\\s*\"500\"", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 10, "max_delay_ms": 60000, "providers": ["智谱"] },
+  { "name": "ZAI SSE 错误 (HTTP 200, code 1234)", "status_code": 200, "body_pattern": "\"error\".*\"code\"\\s*:\\s*\"1234\"", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 10, "max_delay_ms": 60000, "providers": ["智谱"] },
+  { "name": "KIMI 401 认证错误", "status_code": 401, "body_pattern": ".*authentication_error.*", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 3, "max_delay_ms": 60000, "providers": ["月之暗面"] }
 ]

package/dist/admin/providers.js

@@ -58,9 +58,11 @@ function cascadeProviderDisable(db, providerId) {
     return result;
 }
 function extractModelOverrides(models) {
-    const names = models.map(m => typeof m === "string" ? m : m.name);
+    const entries = models.map(m => typeof m === "string"
+        ? { name: m, patches: [] }
+        : { name: m.name, context_window: m.context_window, patches: m.patches ?? [] });
     const overrides = models.filter((m) => typeof m !== "string" && m.context_window != null);
-    return { names, overrides };
+    return { entries, overrides };
 }
 const API_KEY_PREVIEW_PREFIX_LEN = 4;
 const PROVIDER_NAME_RE = /^[a-zA-Z0-9_-]+$/;
@@ -71,7 +73,7 @@ const CreateProviderSchema = Type.Object({
     api_key: Type.String({ minLength: 1 }),
     models: Type.Optional(Type.Array(Type.Union([
         Type.String(),
-        Type.Object({ name: Type.String(), context_window: Type.Optional(Type.Number()) })
+        Type.Object({ name: Type.String(), context_window: Type.Optional(Type.Number()), patches: Type.Optional(Type.Array(Type.String())) })
     ]))),
     is_active: Type.Optional(Type.Number()),
     max_concurrency: Type.Optional(Type.Integer({ minimum: 0 })),
@@ -86,7 +88,7 @@ const UpdateProviderSchema = Type.Object({
     api_key: Type.Optional(Type.String({ minLength: 1 })),
     models: Type.Optional(Type.Array(Type.Union([
         Type.String(),
-        Type.Object({ name: Type.String(), context_window: Type.Optional(Type.Number()) })
+        Type.Object({ name: Type.String(), context_window: Type.Optional(Type.Number()), patches: Type.Optional(Type.Array(Type.String())) })
     ]))),
     is_active: Type.Optional(Type.Number()),
     max_concurrency: Type.Optional(Type.Integer({ minimum: 0 })),
@@ -100,7 +102,7 @@ export const adminProviderRoutes = (app, options, done) => {
         const encryptionKey = getSetting(db, "encryption_key");
         const providers = getAllProviders(db);
         return reply.send(providers.map((s) => {
-            const modelNames = parseModels(s.models || "[]");
+            const modelEntries = parseModels(s.models || "[]");
             const overrides = new Map(getModelInfoForProvider(db, s.id).map(m => [m.model_name, m.context_window]));
             return {
                 id: s.id,
@@ -108,7 +110,7 @@ export const adminProviderRoutes = (app, options, done) => {
                 api_type: s.api_type,
                 base_url: s.base_url,
                 api_key: s.api_key ? decrypt(s.api_key, encryptionKey) : "",
-                models: buildModelInfoList(modelNames, overrides),
+                models: buildModelInfoList(modelEntries, overrides),
                 is_active: s.is_active,
                 max_concurrency: s.max_concurrency,
                 queue_timeout_ms: s.queue_timeout_ms,
@@ -130,7 +132,7 @@ export const adminProviderRoutes = (app, options, done) => {
             return reply.code(HTTP_CONFLICT).send(apiError(API_CODE.CONFLICT_NAME, `Provider 名称 '${body.name}' 已存在`));
         }
         const encryptedKey = encrypt(body.api_key, getSetting(db, "encryption_key"));
-        const { names: normalizedModels, overrides: contextOverrides } = extractModelOverrides((body.models ?? []));
+        const { entries: normalizedModels, overrides: contextOverrides } = extractModelOverrides((body.models ?? []));
         const isAdaptiveEnabled = body.adaptive_enabled ?? 0;
         const id = createProvider(db, {
             name: body.name,
@@ -190,8 +192,8 @@ export const adminProviderRoutes = (app, options, done) => {
         if (body.is_active !== undefined)
             fields.is_active = body.is_active;
         if (body.models !== undefined) {
-            const { names, overrides } = extractModelOverrides(body.models);
-            fields.models = JSON.stringify(names);
+            const { entries, overrides } = extractModelOverrides(body.models);
+            fields.models = JSON.stringify(entries);
             if (overrides.length > 0) {
                 setModelInfoForProvider(db, id, overrides.map(o => ({ model_name: o.name, context_window: o.context_window })));
             }

package/dist/admin/quick-setup.d.ts

@@ -0,0 +1,13 @@
+import { FastifyPluginCallback } from "fastify";
+import Database from "better-sqlite3";
+import type { StateRegistry } from "../core/registry.js";
+import type { RequestTracker } from "../monitor/request-tracker.js";
+import type { AdaptiveConcurrencyController } from "../proxy/adaptive-controller.js";
+interface QuickSetupRoutesOptions {
+    db: Database.Database;
+    stateRegistry?: StateRegistry;
+    tracker?: RequestTracker;
+    adaptiveController?: AdaptiveConcurrencyController;
+}
+export declare const adminQuickSetupRoutes: FastifyPluginCallback<QuickSetupRoutesOptions>;
+export {};