llm-simple-router 1.0.20 → 1.0.22

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) => {

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/core/log-detail-policy.d.ts

@@ -0,0 +1,12 @@
+export interface RetryMatcher {
+    test: (statusCode: number, body: string) => boolean;
+}
+/**
+ * 判断一条日志是否需要保留全文详情到 DB。
+ * - hasFileWriter=false 时保守保留全文（避免数据丢失）
+ * - status >= 400 → 保留
+ * - matcher 为 null → 保守保留
+ * - matcher 命中 → 保留
+ * - 否则 → 只存摘要（文件已有全文备份）
+ */
+export declare function shouldPreserveDetail(statusCode: number | null, responseBody: string | null, matcher: RetryMatcher | null, hasFileWriter?: boolean): boolean;

package/dist/core/log-detail-policy.js

@@ -0,0 +1,21 @@
+// src/core/log-detail-policy.ts
+const HTTP_ERROR_THRESHOLD = 400;
+/**
+ * 判断一条日志是否需要保留全文详情到 DB。
+ * - hasFileWriter=false 时保守保留全文（避免数据丢失）
+ * - status >= 400 → 保留
+ * - matcher 为 null → 保守保留
+ * - matcher 命中 → 保留
+ * - 否则 → 只存摘要（文件已有全文备份）
+ */
+export function shouldPreserveDetail(statusCode, responseBody, matcher, hasFileWriter = true) {
+    if (!hasFileWriter)
+        return true;
+    if (statusCode !== null && statusCode >= HTTP_ERROR_THRESHOLD)
+        return true;
+    if (!matcher)
+        return true;
+    if (responseBody && matcher.test(statusCode ?? 0, responseBody))
+        return true;
+    return false;
+}

package/dist/core/provider-connectivity.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Provider 连通性检查接口。
+ * admin 层通过此接口检查上游 provider 的模型列表，解耦对 proxy 层的直接依赖。
+ */
+import type { RawHeaders } from "./types.js";
+export interface ProviderConnectivityCheckResult {
+    statusCode: number;
+    body: string;
+}
+export interface ProviderConnectivityChecker {
+    /**
+     * 向上游 provider 发起 GET 请求获取模型列表。
+     * @param backend 包含 base_url 的后端信息
+     * @param apiKey API 密钥
+     * @param clientHeaders 客户端原始请求头
+     * @param upstreamPath 上游路径（如 /v1/models）
+     * @param apiType API 类型，决定 header 构建方式
+     */
+    fetchModels(backend: {
+        base_url: string;
+    }, apiKey: string, clientHeaders: RawHeaders, upstreamPath: string, apiType: "openai" | "openai-responses" | "anthropic"): Promise<ProviderConnectivityCheckResult>;
+}

package/dist/core/provider-connectivity.js

@@ -0,0 +1,5 @@
+/**
+ * Provider 连通性检查接口。
+ * admin 层通过此接口检查上游 provider 的模型列表，解耦对 proxy 层的直接依赖。
+ */
+export {};

package/dist/core/proxy-agent-types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Proxy Agent 缓存失效接口。
+ * admin 层通过此接口在 provider 更新/删除时清除对应的 proxy agent 缓存，
+ * 解耦对 proxy 层的直接类型依赖。
+ */
+export interface IProxyAgentInvalidator {
+    /** 使指定 provider 的代理 agent 缓存失效 */
+    invalidate(providerId: string): void;
+}

package/dist/core/proxy-agent-types.js

@@ -0,0 +1,6 @@
+/**
+ * Proxy Agent 缓存失效接口。
+ * admin 层通过此接口在 provider 更新/删除时清除对应的 proxy agent 缓存，
+ * 解耦对 proxy 层的直接类型依赖。
+ */
+export {};

package/dist/core/registry.d.ts

@@ -29,4 +29,11 @@ export interface StateRegistry {
     getAdaptiveStatus(providerId: string): import("./concurrency/types.js").AdaptiveState | undefined;
     /** 从 DB 重新读取所有 provider 配置，重建信号量/adaptive/tracker 缓存（导入配置后调用） */
     reinitializeProviders(): void;
+    /** 清除代理增强配置缓存（enhancement-config） */
+    clearEnhancementCache(): void;
+    /** 获取已注册的 pipeline hooks（按 phase 分组） */
+    getPipelineHooks(): Record<string, Array<{
+        name: string;
+        priority: number;
+    }>>;
 }

package/dist/db/logs.d.ts

@@ -1,6 +1,6 @@
 import Database from "better-sqlite3";
 import type { LogFileWriter } from "../storage/log-file-writer.js";
-import { type RetryMatcher } from "../proxy/log-detail-policy.js";
+import { type RetryMatcher } from "../core/log-detail-policy.js";
 /** 从 client_request JSON 中提取 thinking_level，按 api_type 分支处理 */
 export declare function extractThinkingLevel(apiType: string, clientRequest: string | null): string;
 export interface RequestLog {

package/dist/db/logs.js

@@ -1,4 +1,4 @@
-import { shouldPreserveDetail } from "../proxy/log-detail-policy.js";
+import { shouldPreserveDetail } from "../core/log-detail-policy.js";
 import { getCachedStmt } from "./helpers.js";
 /** 从 client_request JSON 中提取 thinking_level，按 api_type 分支处理 */
 export function extractThinkingLevel(apiType, clientRequest) {

package/dist/index.js

@@ -42,6 +42,9 @@ import fastifyStatic from "@fastify/static";
 import { ServiceContainer, SERVICE_KEYS } from "./core/container.js";
 import { LogFileWriter } from "./storage/log-file-writer.js";
 import { ProxyAgentFactory } from "./proxy/transport/proxy-agent.js";
+import { ProxyConnectivityChecker } from "./proxy/transport/provider-connectivity.js";
+import { hookRegistry } from "./proxy/pipeline/hook-registry.js";
+import { clearEnhancementConfigCache } from "./proxy/routing/enhancement-config.js";
 import { registerBuiltinHooks } from "./proxy/pipeline/register-hooks.js";
 import { scheduleLogFileMaintenance } from "./storage/log-file-compressor.js";
 import { getDetailLogEnabled, getLogFileRetentionDays } from "./db/settings.js";
@@ -274,6 +277,7 @@ export async function buildApp(options) {
     container.register(SERVICE_KEYS.formatRegistry, () => formatRegistry);
     // 注册 ProxyAgentFactory
     container.register(SERVICE_KEYS.proxyAgentFactory, () => new ProxyAgentFactory());
+    const connectivityChecker = new ProxyConnectivityChecker();
     // 从容器解析所有服务
     const matcher = container.resolve(SERVICE_KEYS.matcher);
     const semaphoreManager = container.resolve(SERVICE_KEYS.semaphoreManager);
@@ -318,11 +322,13 @@ export async function buildApp(options) {
             adaptiveController.removeAll();
             initializeProviderState(db, semaphoreManager, adaptiveController, tracker);
         },
+        clearEnhancementCache: () => clearEnhancementConfigCache(),
+        getPipelineHooks: () => hookRegistry.getAll(),
     };
     // Late-bound close ref — close 函数在 adminRoutes 注册之后才定义，
     // 但 restart API 需要在运行时调用它
     const closeRef = { fn: async () => { } };
-    app.register(adminRoutes, { db, stateRegistry, tracker, adaptiveController, logFileWriter, logsDir, closeFn: () => closeRef.fn(), pluginRegistry, proxyAgentFactory });
+    app.register(adminRoutes, { db, stateRegistry, tracker, adaptiveController, logFileWriter, logsDir, closeFn: () => closeRef.fn(), pluginRegistry, proxyAgentFactory, connectivityChecker });
     // 前端静态文件服务（生产环境）
     const frontendDist = path.resolve(process.env.FRONTEND_DIST || path.join(__dirname, "../frontend-dist"));
     if (existsSync(frontendDist)) {

package/dist/proxy/log-detail-policy.d.ts

@@ -1,12 +1 @@
-export interface RetryMatcher {
-    test: (statusCode: number, body: string) => boolean;
-}
-/**
- * 判断一条日志是否需要保留全文详情到 DB。
- * - hasFileWriter=false 时保守保留全文（避免数据丢失）
- * - status >= 400 → 保留
- * - matcher 为 null → 保守保留
- * - matcher 命中 → 保留
- * - 否则 → 只存摘要（文件已有全文备份）
- */
-export declare function shouldPreserveDetail(statusCode: number | null, responseBody: string | null, matcher: RetryMatcher | null, hasFileWriter?: boolean): boolean;
+export { shouldPreserveDetail, type RetryMatcher } from "../core/log-detail-policy.js";

package/dist/proxy/log-detail-policy.js

@@ -1,21 +1,3 @@
 // src/proxy/log-detail-policy.ts
-const HTTP_ERROR_THRESHOLD = 400;
-/**
- * 判断一条日志是否需要保留全文详情到 DB。
- * - hasFileWriter=false 时保守保留全文（避免数据丢失）
- * - status >= 400 → 保留
- * - matcher 为 null → 保守保留
- * - matcher 命中 → 保留
- * - 否则 → 只存摘要（文件已有全文备份）
- */
-export function shouldPreserveDetail(statusCode, responseBody, matcher, hasFileWriter = true) {
-    if (!hasFileWriter)
-        return true;
-    if (statusCode !== null && statusCode >= HTTP_ERROR_THRESHOLD)
-        return true;
-    if (!matcher)
-        return true;
-    if (responseBody && matcher.test(statusCode ?? 0, responseBody))
-        return true;
-    return false;
-}
+// 策略逻辑已提升到 core 层，此文件保留 re-export 兼容
+export { shouldPreserveDetail } from "../core/log-detail-policy.js";

package/dist/proxy/transport/provider-connectivity.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ProviderConnectivityChecker 的 proxy 层实现。
+ * 组合 proxy 层的 callGet + buildUpstreamHeaders，通过接口暴露给 admin 层。
+ */
+import type { ProviderConnectivityChecker, ProviderConnectivityCheckResult } from "../../core/provider-connectivity.js";
+import type { RawHeaders } from "../../core/types.js";
+export declare class ProxyConnectivityChecker implements ProviderConnectivityChecker {
+    fetchModels(backend: {
+        base_url: string;
+    }, apiKey: string, clientHeaders: RawHeaders, upstreamPath: string, apiType: "openai" | "openai-responses" | "anthropic"): Promise<ProviderConnectivityCheckResult>;
+}

package/dist/proxy/transport/provider-connectivity.js

@@ -0,0 +1,11 @@
+/**
+ * ProviderConnectivityChecker 的 proxy 层实现。
+ * 组合 proxy 层的 callGet + buildUpstreamHeaders，通过接口暴露给 admin 层。
+ */
+import { callGet } from "./http.js";
+import { buildUpstreamHeaders } from "../proxy-core.js";
+export class ProxyConnectivityChecker {
+    fetchModels(backend, apiKey, clientHeaders, upstreamPath, apiType) {
+        return callGet(backend, apiKey, clientHeaders, upstreamPath, (cliHdrs, key) => buildUpstreamHeaders(cliHdrs, key, undefined, apiType));
+    }
+}

package/dist/proxy/transport/proxy-agent.d.ts

@@ -1,4 +1,5 @@
 import type { Agent } from "http";
+import type { IProxyAgentInvalidator } from "../../core/proxy-agent-types.js";
 export interface ProxyConfig {
     id: string;
     proxy_type: string | null;
@@ -6,7 +7,7 @@ export interface ProxyConfig {
     proxy_username: string | null;
     proxy_password: string | null;
 }
-export declare class ProxyAgentFactory {
+export declare class ProxyAgentFactory implements IProxyAgentInvalidator {
     private readonly cache;
     private keepAliveHttpAgent;
     private keepAliveHttpsAgent;

package/frontend-dist/assets/{AuthLayout-BwI_T7qz.js → AuthLayout-BvYyVNay.js}

@@ -1 +1 @@
-import{$ as e,Qt as t,at as n,et as r,jt as i,n as a,nt as o,ot as s,qt as c,vt as l,xt as u}from"./button-DpPvjx0f.js";import{dt as d,ft as f,r as p}from"./index-Di7f6Crg.js";import{t as m}from"./Card-C5jCkE1m.js";import{t as h}from"./CardContent-Dozca7Pu.js";var g={class:`min-h-screen flex items-center justify-center bg-background relative`},_={class:`text-center mb-6`},v={class:`text-sm text-muted-foreground mt-1`},y=s({__name:`AuthLayout`,props:{subtitle:{}},setup(s){let{isDark:y,toggleTheme:b}=p();return(p,x)=>(l(),o(`div`,g,[n(c(a),{variant:`ghost`,size:`icon`,class:`absolute top-4 right-4 text-muted-foreground hover:text-foreground`,onClick:c(b)},{default:i(()=>[c(y)?(l(),r(c(d),{key:1,class:`w-4 h-4`})):(l(),r(c(f),{key:0,class:`w-4 h-4`}))]),_:1},8,[`onClick`]),n(c(m),{class:`w-full max-w-sm shadow-lg`},{default:i(()=>[n(c(h),{class:`pt-6`},{default:i(()=>[e(`div`,_,[x[0]||=e(`div`,{class:`w-12 h-12 bg-primary rounded-lg mx-auto mb-3 flex items-center justify-center`},[e(`svg`,{class:`w-7 h-7 text-white`,fill:`none`,stroke:`currentColor`,viewBox:`0 0 24 24`},[e(`path`,{"stroke-linecap":`round`,"stroke-linejoin":`round`,"stroke-width":`2`,d:`M8 9l3 3-3 3m5 0h3M5 20h14a2 2 0 002-2V6a2 2 0 00-2-2H5a2 2 0 00-2 2v12a2 2 0 002 2z`})])],-1),x[1]||=e(`h1`,{class:`text-xl font-semibold text-foreground`},` LLM Simple Router `,-1),e(`p`,v,t(s.subtitle),1)]),u(p.$slots,`default`)]),_:3})]),_:3})]))}});export{y as t};
+import{$ as e,Qt as t,at as n,et as r,jt as i,n as a,nt as o,ot as s,qt as c,vt as l,xt as u}from"./button-mHNAa2aF.js";import{dt as d,ft as f,r as p}from"./index-Ddg5hheZ.js";import{t as m}from"./Card-CrAceTFb.js";import{t as h}from"./CardContent-otK_vTWx.js";var g={class:`min-h-screen flex items-center justify-center bg-background relative`},_={class:`text-center mb-6`},v={class:`text-sm text-muted-foreground mt-1`},y=s({__name:`AuthLayout`,props:{subtitle:{}},setup(s){let{isDark:y,toggleTheme:b}=p();return(p,x)=>(l(),o(`div`,g,[n(c(a),{variant:`ghost`,size:`icon`,class:`absolute top-4 right-4 text-muted-foreground hover:text-foreground`,onClick:c(b)},{default:i(()=>[c(y)?(l(),r(c(d),{key:1,class:`w-4 h-4`})):(l(),r(c(f),{key:0,class:`w-4 h-4`}))]),_:1},8,[`onClick`]),n(c(m),{class:`w-full max-w-sm shadow-lg`},{default:i(()=>[n(c(h),{class:`pt-6`},{default:i(()=>[e(`div`,_,[x[0]||=e(`div`,{class:`w-12 h-12 bg-primary rounded-lg mx-auto mb-3 flex items-center justify-center`},[e(`svg`,{class:`w-7 h-7 text-white`,fill:`none`,stroke:`currentColor`,viewBox:`0 0 24 24`},[e(`path`,{"stroke-linecap":`round`,"stroke-linejoin":`round`,"stroke-width":`2`,d:`M8 9l3 3-3 3m5 0h3M5 20h14a2 2 0 002-2V6a2 2 0 00-2-2H5a2 2 0 00-2 2v12a2 2 0 002 2z`})])],-1),x[1]||=e(`h1`,{class:`text-xl font-semibold text-foreground`},` LLM Simple Router `,-1),e(`p`,v,t(s.subtitle),1)]),u(p.$slots,`default`)]),_:3})]),_:3})]))}});export{y as t};