llm-simple-router 1.0.21 → 1.0.23-beta.96c9b98

package/dist/admin/groups.js

@@ -2,7 +2,7 @@ import { Type } from "@sinclair/typebox";
 import { getAllMappingGroups, createMappingGroup, updateMappingGroup, deleteMappingGroup, getProviderById, getMappingGroupById, getAllProviders, } from "../db/index.js";
 import { getSetting } from "../db/settings.js";
 import { serializeProviders } from "./providers.js";
-import { HTTP_BAD_REQUEST, HTTP_CREATED, HTTP_CONFLICT, HTTP_NOT_FOUND } from "./constants.js";
+import { HTTP_BAD_REQUEST, HTTP_CREATED, HTTP_CONFLICT, HTTP_NOT_FOUND } from "../core/constants.js";
 import { parseModels } from "../config/model-context.js";
 import { API_CODE, apiError } from "./api-response.js";
 const CreateGroupSchema = Type.Object({

package/dist/admin/logs.js

@@ -1,7 +1,7 @@
 import { Type } from "@sinclair/typebox";
 import { getRequestLogs, getRequestLogsGrouped, getRequestLogById, getRequestLogChildren, deleteLogsBefore, extractThinkingLevel, getAllProviders, getAllRouterKeys, getAllMappingGroups } from "../db/index.js";
 import { getLogRetentionDays } from "../db/settings.js";
-import { HTTP_NOT_FOUND } from "./constants.js";
+import { HTTP_NOT_FOUND } from "../core/constants.js";
 import { API_CODE, apiError } from "./api-response.js";
 const LogQuerySchema = Type.Object({
     page: Type.Optional(Type.String()),

package/dist/admin/mappings.js

@@ -1,6 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import { getAllMappingGroups, createMappingGroup, updateMappingGroup, deleteMappingGroup, getProviderById, getMappingGroupById, getMappingGroup, } from "../db/index.js";
-import { HTTP_BAD_REQUEST, HTTP_CREATED, HTTP_NOT_FOUND, HTTP_CONFLICT } from "./constants.js";
+import { HTTP_BAD_REQUEST, HTTP_CREATED, HTTP_NOT_FOUND, HTTP_CONFLICT } from "../core/constants.js";
 import { API_CODE, apiError } from "./api-response.js";
 const CreateMappingSchema = Type.Object({
     client_model: Type.String({ minLength: 1 }),

package/dist/admin/monitor.js

@@ -1,5 +1,5 @@
 import { adaptSSEClient } from "../core/sse-client-adapter.js";
-import { HTTP_NOT_FOUND } from "./constants.js";
+import { HTTP_NOT_FOUND } from "../core/constants.js";
 import { API_CODE, apiError } from "./api-response.js";
 const HTTP_OK = 200;
 export const adminMonitorRoutes = (app, options, done) => {

package/dist/admin/providers.d.ts

@@ -4,13 +4,15 @@ import type { Provider } from "../db/index.js";
 import type { StateRegistry } from "../core/registry.js";
 import type { AdaptiveController } from "../core/concurrency/index.js";
 import type { RequestTracker } from "../core/monitor/index.js";
-import type { ProxyAgentFactory } from "../proxy/transport/proxy-agent.js";
+import type { ProviderConnectivityChecker } from "../core/provider-connectivity.js";
+import type { IProxyAgentInvalidator } from "../core/proxy-agent-types.js";
 interface ProviderRoutesOptions {
     db: Database.Database;
     stateRegistry?: StateRegistry;
     tracker?: RequestTracker;
     adaptiveController?: AdaptiveController;
-    proxyAgentFactory?: ProxyAgentFactory;
+    proxyAgentFactory?: IProxyAgentInvalidator;
+    connectivityChecker?: ProviderConnectivityChecker;
 }
 /** 序列化 provider 列表，解密敏感字段、展开 models/endpoints。供多个端点复用 */
 export declare function serializeProviders(db: Database.Database, providers: Provider[], encryptionKey: string, concurrencyStatus?: (id: string) => {
@@ -19,7 +21,7 @@ export declare function serializeProviders(db: Database.Database, providers: Pro
 }): {
     id: string;
     name: string;
-    api_type: "anthropic" | "openai" | "openai-responses";
+    api_type: "openai" | "openai-responses" | "anthropic";
     base_url: string;
     upstream_path: string | null;
     api_key: string;

package/dist/admin/providers.js

@@ -4,12 +4,10 @@ import { parseEndpoints, serializeEndpoints } from "../db/providers.js";
 import { getRecommendedProviders } from "../config/recommended.js";
 import { encrypt, decrypt } from "../utils/crypto.js";
 import { getSetting } from "../db/settings.js";
-import { HTTP_CREATED, HTTP_NOT_FOUND, HTTP_CONFLICT, HTTP_BAD_REQUEST, HTTP_OK } from "./constants.js";
+import { HTTP_CREATED, HTTP_NOT_FOUND, HTTP_CONFLICT, HTTP_BAD_REQUEST, HTTP_OK, HTTP_SERVICE_UNAVAILABLE } from "../core/constants.js";
 import { API_CODE, apiError } from "./api-response.js";
 import { parseModels, buildModelInfoList, normalizePatchName, lookupCapabilities } from "../config/model-context.js";
 import { getModelInfoForProvider, setModelInfoForProvider, deleteAllModelInfoForProvider } from "../db/model-info.js";
-import { buildUpstreamHeaders } from "../proxy/proxy-core.js";
-import { callGet } from "../proxy/transport/http.js";
 const API_KEY_PREVIEW_MIN_LENGTH = 8;
 const FETCH_MODELS_BODY_PREVIEW_LENGTH = 200;
 function cascadeProviderDisable(db, providerId) {
@@ -87,17 +85,7 @@ function extractModelOverrides(models) {
     return { entries, overrides };
 }
 const API_KEY_PREVIEW_PREFIX_LEN = 4;
-const PROVIDER_NAME_RE = /^[a-zA-Z0-9_-]+$/;
-/** 校验 base_url 是否为合法的 HTTP(S) URL */
-function isValidHttpUrl(str) {
-    try {
-        const url = new URL(str);
-        return url.protocol === "http:" || url.protocol === "https:";
-    }
-    catch {
-        return false;
-    }
-}
+import { PROVIDER_NAME_RE, isValidHttpUrl } from "./utils.js";
 /** 校验 endpoints 数组并加密 api_key。成功返回处理后的数组，失败返回错误信息 */
 function validateAndEncryptEndpoints(endpoints, encryptionKey) {
     const apiTypes = endpoints.map(e => e.api_type);
@@ -304,7 +292,7 @@ export function serializeProviders(db, providers, encryptionKey, concurrencyStat
     });
 }
 export const adminProviderRoutes = (app, options, done) => {
-    const { db, stateRegistry, tracker, adaptiveController, proxyAgentFactory } = options;
+    const { db, stateRegistry, tracker, adaptiveController, proxyAgentFactory, connectivityChecker } = options;
     app.get("/admin/api/providers", async (_request, reply) => {
         const encryptionKey = getSetting(db, "encryption_key");
         const providers = getAllProviders(db);
@@ -523,8 +511,11 @@ export const adminProviderRoutes = (app, options, done) => {
         const { base_url, models_endpoint, api_key, api_type } = request.body;
         const backend = { base_url };
         const clientHeaders = {};
+        if (!connectivityChecker) {
+            return reply.code(HTTP_SERVICE_UNAVAILABLE).send(apiError(API_CODE.BAD_REQUEST, "Connectivity checker not available"));
+        }
         try {
-            const result = await callGet(backend, api_key, clientHeaders, models_endpoint, (cliHdrs, key) => buildUpstreamHeaders(cliHdrs, key, undefined, api_type));
+            const result = await connectivityChecker.fetchModels(backend, api_key, clientHeaders, models_endpoint, api_type);
             if (result.statusCode !== HTTP_OK) {
                 return reply.code(HTTP_BAD_REQUEST).send(apiError(API_CODE.BAD_REQUEST, `上游返回 HTTP ${result.statusCode}: ${result.body.substring(0, FETCH_MODELS_BODY_PREVIEW_LENGTH)}`));
             }

package/dist/admin/proxy-enhancement.d.ts

@@ -1,7 +1,9 @@
 import { FastifyPluginCallback } from "fastify";
 import Database from "better-sqlite3";
+import type { StateRegistry } from "../core/registry.js";
 interface ProxyEnhancementOptions {
     db: Database.Database;
+    stateRegistry?: StateRegistry;
 }
 export declare const adminProxyEnhancementRoutes: FastifyPluginCallback<ProxyEnhancementOptions>;
 export {};

package/dist/admin/proxy-enhancement.js

@@ -1,6 +1,5 @@
 import { Type } from "@sinclair/typebox";
 import { getSetting, setSetting } from "../db/settings.js";
-import { clearEnhancementConfigCache } from "../proxy/routing/enhancement-config.js";
 import { getAllProviders } from "../db/index.js";
 import { serializeProviders } from "./providers.js";
 const UpdateProxyEnhancementSchema = Type.Object({
@@ -14,7 +13,7 @@ const UpdateProxyEnhancementSchema = Type.Object({
     ])),
 });
 export const adminProxyEnhancementRoutes = (app, options, done) => {
-    const { db } = options;
+    const { db, stateRegistry } = options;
     app.get("/admin/api/proxy-enhancement", async (_request, reply) => {
         const raw = getSetting(db, "proxy_enhancement");
         const defaults = { tool_call_loop_enabled: false, stream_loop_enabled: false, tool_round_limit_enabled: true, tool_error_logging_enabled: false };
@@ -54,7 +53,7 @@ export const adminProxyEnhancementRoutes = (app, options, done) => {
             tool_error_logging_enabled: enhancementFields.tool_error_logging_enabled,
         };
         setSetting(db, "proxy_enhancement", JSON.stringify(config));
-        clearEnhancementConfigCache();
+        stateRegistry?.clearEnhancementCache();
         // ai_retry_config is stored in a separate settings key
         if (ai_retry_config !== undefined) {
             setSetting(db, "ai_retry_config", ai_retry_config ? JSON.stringify(ai_retry_config) : "");

package/dist/admin/quick-setup.js

@@ -11,9 +11,9 @@ import { getRecommendedProviders, getRecommendedRetryRules } from "../config/rec
 import { lookupCapabilities } from "../config/model-context.js";
 import { getAllMappingGroups, getAllProviders } from "../db/index.js";
 import { serializeProviders } from "./providers.js";
-import { HTTP_CREATED, HTTP_BAD_REQUEST, HTTP_BAD_GATEWAY, HTTP_CONFLICT } from "./constants.js";
+import { HTTP_CREATED, HTTP_BAD_REQUEST, HTTP_BAD_GATEWAY, HTTP_CONFLICT } from "../core/constants.js";
 import { API_CODE, apiError } from "./api-response.js";
-const PROVIDER_NAME_RE = /^[a-zA-Z0-9_-]+$/;
+import { PROVIDER_NAME_RE } from "./utils.js";
 const API_KEY_PREVIEW_MIN_LENGTH = 8;
 const API_KEY_PREVIEW_PREFIX_LEN = 4;
 const NEW_PROVIDER_ID = "__new__";

package/dist/admin/retry-rules.js

@@ -7,7 +7,7 @@ import { getRequestLogById } from "../db/logs.js";
 import { getProviderById } from "../db/providers.js";
 import { getSetting } from "../db/settings.js";
 import { decrypt } from "../utils/crypto.js";
-import { HTTP_OK, HTTP_BAD_REQUEST, HTTP_CREATED, HTTP_NOT_FOUND } from "./constants.js";
+import { HTTP_OK, HTTP_BAD_REQUEST, HTTP_CREATED, HTTP_NOT_FOUND } from "../core/constants.js";
 import { API_CODE, apiError } from "./api-response.js";
 // AI 重试规则的 system prompt 模板（内联避免运行时文件依赖）
 const AI_RETRY_PROMPT_TEMPLATE = `You are an API retry rule expert. Your ONLY job is to analyze the error response and output a JSON retry rule.

package/dist/admin/router-keys.js

@@ -3,7 +3,7 @@ import { Type } from "@sinclair/typebox";
 import { encrypt, decrypt } from "../utils/crypto.js";
 import { getAllRouterKeys, getRouterKeyById, createRouterKey, updateRouterKey, deleteRouterKey, getAvailableModels, } from "../db/index.js";
 import { getSetting } from "../db/settings.js";
-import { HTTP_CREATED, HTTP_NOT_FOUND } from "./constants.js";
+import { HTTP_CREATED, HTTP_NOT_FOUND } from "../core/constants.js";
 import { API_CODE, apiError } from "./api-response.js";
 const KEY_RANDOM_BYTES = 32;
 const KEY_PREFIX_LENGTH = 8;

package/dist/admin/routes.d.ts

@@ -3,7 +3,8 @@ import Database from "better-sqlite3";
 import type { StateRegistry } from "../core/registry.js";
 import type { RequestTracker } from "../core/monitor/index.js";
 import type { AdaptiveController } from "../core/concurrency/index.js";
-import type { ProxyAgentFactory } from "../proxy/transport/proxy-agent.js";
+import type { IProxyAgentInvalidator } from "../core/proxy-agent-types.js";
+import type { ProviderConnectivityChecker } from "../core/provider-connectivity.js";
 interface AdminRoutesOptions {
     db: Database.Database;
     stateRegistry: StateRegistry;
@@ -13,7 +14,8 @@ interface AdminRoutesOptions {
     logsDir?: string;
     pluginRegistry?: import("../proxy/transform/plugin-registry.js").PluginRegistry;
     closeFn?: () => Promise<void>;
-    proxyAgentFactory?: ProxyAgentFactory;
+    proxyAgentFactory?: IProxyAgentInvalidator;
+    connectivityChecker?: ProviderConnectivityChecker;
 }
 export declare const adminRoutes: FastifyPluginCallback<AdminRoutesOptions>;
 export {};

package/dist/admin/routes.js

@@ -19,13 +19,12 @@ import { adminImportExportRoutes } from "./settings-import-export.js";
 import { adminTransformRuleRoutes } from "./transform-rules.js";
 import { adminDashboardRoutes } from "./dashboard.js";
 import { adminScheduleRoutes } from "./schedules.js";
-import { hookRegistry } from "../proxy/pipeline/hook-registry.js";
 export const adminRoutes = (app, options, done) => {
     // Setup 路由不需要 auth
     app.register(adminSetupRoutes, { db: options.db });
     app.register(adminAuthPlugin, { db: options.db });
     app.register(adminLoginRoutes, { db: options.db });
-    app.register(adminProviderRoutes, { db: options.db, stateRegistry: options.stateRegistry, tracker: options.tracker, adaptiveController: options.adaptiveController, proxyAgentFactory: options.proxyAgentFactory });
+    app.register(adminProviderRoutes, { db: options.db, stateRegistry: options.stateRegistry, tracker: options.tracker, adaptiveController: options.adaptiveController, proxyAgentFactory: options.proxyAgentFactory, connectivityChecker: options.connectivityChecker });
     app.register(adminMappingRoutes, { db: options.db });
     app.register(adminGroupRoutes, { db: options.db });
     app.register(adminScheduleRoutes, { db: options.db });
@@ -34,7 +33,7 @@ export const adminRoutes = (app, options, done) => {
     app.register(adminRouterKeyRoutes, { db: options.db });
     app.register(adminStatsRoutes, { db: options.db });
     app.register(adminMetricsRoutes, { db: options.db });
-    app.register(adminProxyEnhancementRoutes, { db: options.db });
+    app.register(adminProxyEnhancementRoutes, { db: options.db, stateRegistry: options.stateRegistry });
     app.register(adminMonitorRoutes, { tracker: options.tracker });
     app.register(adminSettingsRoutes, { db: options.db, logsDir: options.logsDir });
     app.register(adminImportExportRoutes, { db: options.db, stateRegistry: options.stateRegistry, pluginRegistry: options.pluginRegistry });
@@ -46,7 +45,7 @@ export const adminRoutes = (app, options, done) => {
     app.register(adminTransformRuleRoutes, { db: options.db, pluginRegistry: options.pluginRegistry });
     // Pipeline hooks 查询
     app.get("/admin/api/pipeline/hooks", async () => {
-        return { hooks: hookRegistry.getAll() };
+        return { hooks: options.stateRegistry.getPipelineHooks() };
     });
     done();
 };

package/dist/admin/schedules.js

@@ -1,9 +1,9 @@
 import { Type } from "@sinclair/typebox";
 import { getSchedulesByGroup, getAllSchedules, getScheduleById, createSchedule, updateSchedule, deleteSchedule, getAllMappingGroups, getAllProviders, } from "../db/index.js";
-import { getMappingGroupById, getProviderById } from "../db/index.js";
+import { getMappingGroupById } from "../db/index.js";
 import { serializeProviders } from "./providers.js";
 import { getSetting } from "../db/settings.js";
-import { HTTP_BAD_REQUEST, HTTP_CREATED, HTTP_NOT_FOUND } from "./constants.js";
+import { HTTP_BAD_REQUEST, HTTP_CREATED, HTTP_NOT_FOUND } from "../core/constants.js";
 import { API_CODE, apiError } from "./api-response.js";
 const CreateScheduleSchema = Type.Object({
     mapping_group_id: Type.String({ minLength: 1 }),
@@ -25,44 +25,7 @@ const UpdateScheduleSchema = Type.Object({
     concurrency_rule: Type.Optional(Type.String()),
     transform_rule: Type.Optional(Type.String()),
 });
-function validateMappingRule(db, ruleJson) {
-    let rule;
-    try {
-        rule = JSON.parse(ruleJson);
-    }
-    catch {
-        return "Invalid mapping_rule JSON";
-    }
-    if (typeof rule !== "object" || rule === null)
-        return "Invalid mapping_rule";
-    const r = rule;
-    if (!Array.isArray(r.targets) || r.targets.length === 0) {
-        return "mapping_rule.targets must be a non-empty array";
-    }
-    for (let i = 0; i < r.targets.length; i++) {
-        const t = r.targets[i];
-        if (!t.backend_model || !t.provider_id) {
-            return `targets[${i}] missing backend_model or provider_id`;
-        }
-        const p = getProviderById(db, t.provider_id);
-        if (!p)
-            return `targets[${i}] provider_id '${t.provider_id}' not found`;
-        const hasOverflowProvider = !!t.overflow_provider_id;
-        const hasOverflowModel = !!t.overflow_model;
-        if (hasOverflowProvider && !hasOverflowModel) {
-            return `targets[${i}]: overflow_provider_id requires overflow_model`;
-        }
-        if (hasOverflowModel && !hasOverflowProvider) {
-            return `targets[${i}]: overflow_model requires overflow_provider_id`;
-        }
-        if (hasOverflowProvider) {
-            const op = getProviderById(db, t.overflow_provider_id);
-            if (!op)
-                return `targets[${i}]: overflow_provider_id '${t.overflow_provider_id}' not found`;
-        }
-    }
-    return undefined;
-}
+import { validateMappingRule } from "./utils.js";
 /** 解析 week JSON 为数字数组，失败返回 null */
 const MAX_WEEK_DAY = 6;
 function parseWeekSafe(weekJson) {

package/dist/admin/settings.js

@@ -1,7 +1,7 @@
 import { statSync, readdirSync } from "node:fs";
 import { join } from "node:path";
 import { getLogRetentionDays, setLogRetentionDays, getDbMaxSizeMb, setDbMaxSizeMb, getLogTableMaxSizeMb, setLogTableMaxSizeMb, getSetting, getTokenEstimationEnabled, setTokenEstimationEnabled, getClientSessionHeaders, setClientSessionHeaders, getMetricsDetailDays, setMetricsDetailDays, } from "../db/settings.js";
-import { HTTP_BAD_REQUEST } from "./constants.js";
+import { HTTP_BAD_REQUEST } from "../core/constants.js";
 import { API_CODE, apiError } from "./api-response.js";
 export const adminSettingsRoutes = (app, options, done) => {
     const { db, logsDir } = options;

package/dist/admin/setup.js

@@ -3,7 +3,7 @@ import jwt from "jsonwebtoken";
 import { getSetting, setSetting, isInitialized } from "../db/settings.js";
 import { hashPassword } from "../utils/password.js";
 import { isForwardedProtoHttps } from "../utils/cookie-secure.js";
-import { HTTP_BAD_REQUEST, HTTP_CONFLICT } from "./constants.js";
+import { HTTP_BAD_REQUEST, HTTP_CONFLICT } from "../core/constants.js";
 import { API_CODE, apiError } from "./api-response.js";
 const CRYPTO_BYTES_LENGTH = 32;
 const MIN_PASSWORD_LENGTH = 6;

package/dist/admin/utils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * admin 层共享校验工具函数和常量。
+ * 各 admin 文件统一从此模块导入，消除重复定义。
+ */
+import type Database from "better-sqlite3";
+/** Provider 名称合法字符：英文、数字、横线、下划线 */
+export declare const PROVIDER_NAME_RE: RegExp;
+/** 校验 base_url 是否为合法的 HTTP(S) URL */
+export declare function isValidHttpUrl(str: string): boolean;
+/** 校验 mapping_rule JSON 结构和引用完整性 */
+export declare function validateMappingRule(db: Database.Database, ruleJson: string): string | undefined;

package/dist/admin/utils.js

@@ -0,0 +1,57 @@
+/**
+ * admin 层共享校验工具函数和常量。
+ * 各 admin 文件统一从此模块导入，消除重复定义。
+ */
+import { getProviderById } from "../db/index.js";
+/** Provider 名称合法字符：英文、数字、横线、下划线 */
+export const PROVIDER_NAME_RE = /^[a-zA-Z0-9_-]+$/;
+/** 校验 base_url 是否为合法的 HTTP(S) URL */
+export function isValidHttpUrl(str) {
+    try {
+        const url = new URL(str);
+        return url.protocol === "http:" || url.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+/** 校验 mapping_rule JSON 结构和引用完整性 */
+export function validateMappingRule(db, ruleJson) {
+    let rule;
+    try {
+        rule = JSON.parse(ruleJson);
+    }
+    catch {
+        return "Invalid mapping_rule JSON";
+    }
+    if (typeof rule !== "object" || rule === null)
+        return "Invalid mapping_rule";
+    const r = rule;
+    if (!Array.isArray(r.targets) || r.targets.length === 0) {
+        return "mapping_rule.targets must be a non-empty array";
+    }
+    for (let i = 0; i < r.targets.length; i++) {
+        const t = r.targets[i];
+        if (!t.backend_model || !t.provider_id) {
+            return `targets[${i}] missing backend_model or provider_id`;
+        }
+        const p = getProviderById(db, t.provider_id);
+        if (!p)
+            return `targets[${i}] provider_id '${t.provider_id}' not found`;
+        const hasOverflowProvider = !!t.overflow_provider_id;
+        const hasOverflowModel = !!t.overflow_model;
+        if (hasOverflowProvider && !hasOverflowModel) {
+            return `targets[${i}]: overflow_provider_id requires overflow_model`;
+        }
+        if (hasOverflowModel && !hasOverflowProvider) {
+            return `targets[${i}]: overflow_model requires overflow_provider_id`;
+        }
+        if (hasOverflowProvider) {
+            const op = getProviderById(db, t.overflow_provider_id);
+            if (!op) {
+                return `targets[${i}]: overflow_provider_id '${t.overflow_provider_id}' not found`;
+            }
+        }
+    }
+    return undefined;
+}

package/dist/app/compose-container.d.ts

@@ -0,0 +1,19 @@
+import type { FastifyInstance } from "fastify";
+import type Database from "better-sqlite3";
+import { ServiceContainer } from "../core/container.js";
+import { LogFileWriter } from "../storage/log-file-writer.js";
+import type { Config } from "../config/index.js";
+export interface ComposeContainerResult {
+    container: ServiceContainer;
+    logFileWriter: LogFileWriter | null;
+    logsDir: string;
+    isMemoryDb: boolean;
+}
+export interface ComposeContainerOptions {
+    config: Config;
+}
+/**
+ * 注册所有服务到 ServiceContainer。
+ * 返回 container 及 logFileWriter（close 时需要 flush）。
+ */
+export declare function composeContainer(db: Database.Database, opts: ComposeContainerOptions, app: FastifyInstance): ComposeContainerResult;

package/dist/app/compose-container.js

@@ -0,0 +1,84 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { ServiceContainer, SERVICE_KEYS } from "../core/container.js";
+import { RetryRuleMatcher } from "../proxy/orchestration/retry-rules.js";
+import { PluginRegistry } from "../proxy/transform/plugin-registry.js";
+import { FormatRegistry } from "../proxy/format/registry.js";
+import { openaiAdapter } from "../proxy/format/adapters/openai.js";
+import { anthropicAdapter } from "../proxy/format/adapters/anthropic.js";
+import { responsesAdapter } from "../proxy/format/adapters/responses.js";
+import { openaiToAnthropicConverter } from "../proxy/format/converters/openai-anthropic.js";
+import { anthropicToOpenAIConverter } from "../proxy/format/converters/anthropic-openai.js";
+import { openaiToResponsesConverter } from "../proxy/format/converters/openai-responses.js";
+import { responsesToOpenAIConverter } from "../proxy/format/converters/responses-openai.js";
+import { responsesToAnthropicConverter } from "../proxy/format/converters/responses-anthropic.js";
+import { anthropicToResponsesConverter } from "../proxy/format/converters/anthropic-responses.js";
+import { SemaphoreManager, AdaptiveController } from "../core/concurrency/index.js";
+import { RequestTracker } from "../core/monitor/index.js";
+import { UsageWindowTracker } from "../proxy/routing/usage-window-tracker.js";
+import { SessionTracker, DEFAULT_LOOP_PREVENTION_CONFIG } from "../core/loop-prevention/index.js";
+import { LogFileWriter } from "../storage/log-file-writer.js";
+import { ProxyAgentFactory } from "../proxy/transport/proxy-agent.js";
+import { getDetailLogEnabled } from "../db/settings.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * 注册所有服务到 ServiceContainer。
+ * 返回 container 及 logFileWriter（close 时需要 flush）。
+ */
+export function composeContainer(db, opts, app) {
+    const { config } = opts;
+    const container = new ServiceContainer();
+    container.register(SERVICE_KEYS.db, () => db);
+    container.register(SERVICE_KEYS.matcher, (c) => {
+        const m = new RetryRuleMatcher();
+        m.load(c.resolve(SERVICE_KEYS.db));
+        return m;
+    });
+    container.register(SERVICE_KEYS.semaphoreManager, () => new SemaphoreManager());
+    container.register(SERVICE_KEYS.tracker, (c) => {
+        const t = new RequestTracker({ semaphoreManager: c.resolve(SERVICE_KEYS.semaphoreManager), logger: app.log });
+        t.startPushInterval();
+        return t;
+    });
+    container.register(SERVICE_KEYS.usageWindowTracker, (c) => {
+        const uwt = new UsageWindowTracker(c.resolve(SERVICE_KEYS.db));
+        uwt.reconcileOnStartup();
+        return uwt;
+    });
+    container.register(SERVICE_KEYS.sessionTracker, () => new SessionTracker(DEFAULT_LOOP_PREVENTION_CONFIG.sessionTracker));
+    // 文件日志写入器
+    const isMemoryDb = config.DB_PATH === ":memory:";
+    const logsDir = isMemoryDb ? "" : join(dirname(config.DB_PATH), "logs");
+    const logFileWriter = isMemoryDb
+        ? null
+        : new LogFileWriter(logsDir, { enabled: getDetailLogEnabled(db) });
+    container.register(SERVICE_KEYS.logFileWriter, () => logFileWriter);
+    // AdaptiveController（依赖已注册的 semaphoreManager）
+    container.register(SERVICE_KEYS.adaptiveController, (c) => {
+        const ac = new AdaptiveController(c.resolve(SERVICE_KEYS.semaphoreManager), app.log);
+        return ac;
+    });
+    // PluginRegistry
+    const pluginRegistry = new PluginRegistry();
+    pluginRegistry.loadFromDB(db);
+    const pluginsDir = path.resolve(__dirname, "../../plugins/transform");
+    pluginRegistry.scanPluginsDir(pluginsDir);
+    container.register(SERVICE_KEYS.pluginRegistry, () => pluginRegistry);
+    // FormatRegistry（3 adapters + 6 converters）
+    const formatRegistry = new FormatRegistry();
+    formatRegistry.registerAdapter(openaiAdapter);
+    formatRegistry.registerAdapter(anthropicAdapter);
+    formatRegistry.registerAdapter(responsesAdapter);
+    formatRegistry.registerConverter(openaiToAnthropicConverter);
+    formatRegistry.registerConverter(anthropicToOpenAIConverter);
+    formatRegistry.registerConverter(openaiToResponsesConverter);
+    formatRegistry.registerConverter(responsesToOpenAIConverter);
+    formatRegistry.registerConverter(responsesToAnthropicConverter);
+    formatRegistry.registerConverter(anthropicToResponsesConverter);
+    container.register(SERVICE_KEYS.formatRegistry, () => formatRegistry);
+    // ProxyAgentFactory
+    container.register(SERVICE_KEYS.proxyAgentFactory, () => new ProxyAgentFactory());
+    return { container, logFileWriter, logsDir, isMemoryDb };
+}

package/dist/app/create-app.d.ts

@@ -0,0 +1,14 @@
+import { type FastifyInstance } from "fastify";
+import type { CheckerOptions } from "../upgrade/checker.js";
+import type { Config } from "../config/index.js";
+import type Database from "better-sqlite3";
+export interface CreateAppOptions {
+    config: Config;
+    db: Database.Database;
+    upgradeCheckerOptions?: CheckerOptions;
+}
+/**
+ * 创建 Fastify 实例并注册全局 hooks（errorHandler、onSend 信封包装等）。
+ * 纯基础设施层，不涉及业务容器或路由。
+ */
+export declare function createAppInstance(opts: CreateAppOptions): FastifyInstance;