llm-simple-router 0.9.23 → 0.9.25

package/dist/admin/providers.d.ts

@@ -3,11 +3,13 @@ import Database from "better-sqlite3";
 import type { StateRegistry } from "../core/registry.js";
 import type { AdaptiveController } from "@llm-router/core/concurrency";
 import type { RequestTracker } from "@llm-router/core/monitor";
+import type { ProxyAgentFactory } from "../proxy/transport/proxy-agent.js";
 interface ProviderRoutesOptions {
     db: Database.Database;
     stateRegistry?: StateRegistry;
     tracker?: RequestTracker;
     adaptiveController?: AdaptiveController;
+    proxyAgentFactory?: ProxyAgentFactory;
 }
 export declare const adminProviderRoutes: FastifyPluginCallback<ProviderRoutesOptions>;
 export {};

package/dist/admin/providers.js

@@ -96,6 +96,10 @@ const CreateProviderSchema = Type.Object({
     queue_timeout_ms: Type.Optional(Type.Integer({ minimum: 0 })),
     max_queue_size: Type.Optional(Type.Integer({ minimum: 1 })),
     adaptive_enabled: Type.Optional(Type.Integer({ minimum: 0, maximum: 1 })),
+    proxy_type: Type.Optional(Type.Union([Type.Literal("http"), Type.Literal("socks5")])),
+    proxy_url: Type.Optional(Type.String({ minLength: 1 })),
+    proxy_username: Type.Optional(Type.String()),
+    proxy_password: Type.Optional(Type.String()),
 });
 const UpdateProviderSchema = Type.Object({
     name: Type.Optional(Type.String({ minLength: 1 })),
@@ -113,9 +117,13 @@ const UpdateProviderSchema = Type.Object({
     queue_timeout_ms: Type.Optional(Type.Integer({ minimum: 0 })),
     max_queue_size: Type.Optional(Type.Integer({ minimum: 1 })),
     adaptive_enabled: Type.Optional(Type.Integer({ minimum: 0, maximum: 1 })),
+    proxy_type: Type.Optional(Type.Union([Type.Literal("http"), Type.Literal("socks5")])),
+    proxy_url: Type.Optional(Type.String({ minLength: 1 })),
+    proxy_username: Type.Optional(Type.String()),
+    proxy_password: Type.Optional(Type.String()),
 });
 export const adminProviderRoutes = (app, options, done) => {
-    const { db, stateRegistry, tracker, adaptiveController } = options;
+    const { db, stateRegistry, tracker, adaptiveController, proxyAgentFactory } = options;
     app.get("/admin/api/providers", async (_request, reply) => {
         const encryptionKey = getSetting(db, "encryption_key");
         const providers = getAllProviders(db);
@@ -134,6 +142,10 @@ export const adminProviderRoutes = (app, options, done) => {
                 queue_timeout_ms: s.queue_timeout_ms,
                 max_queue_size: s.max_queue_size,
                 adaptive_enabled: s.adaptive_enabled,
+                proxy_type: s.proxy_type,
+                proxy_url: s.proxy_url,
+                proxy_username: s.proxy_username ? decrypt(s.proxy_username, encryptionKey) : null,
+                proxy_password: s.proxy_password ? decrypt(s.proxy_password, encryptionKey) : null,
                 concurrency_status: stateRegistry?.getProviderStatus(s.id) ?? { active: 0, queued: 0 },
                 created_at: s.created_at,
                 updated_at: s.updated_at,
@@ -152,6 +164,11 @@ export const adminProviderRoutes = (app, options, done) => {
         const encryptedKey = encrypt(body.api_key, getSetting(db, "encryption_key"));
         const { entries: normalizedModels, overrides: contextOverrides } = extractModelOverrides((body.models ?? []));
         const isAdaptiveEnabled = body.adaptive_enabled ?? 0;
+        if (body.proxy_type && !body.proxy_url) {
+            return reply.code(HTTP_BAD_REQUEST).send(apiError(API_CODE.VALIDATION_FAILED, "proxy_url is required when proxy_type is set"));
+        }
+        const encryptedProxyUsername = body.proxy_username ? encrypt(body.proxy_username, getSetting(db, "encryption_key")) : null;
+        const encryptedProxyPassword = body.proxy_password ? encrypt(body.proxy_password, getSetting(db, "encryption_key")) : null;
         const id = createProvider(db, {
             name: body.name,
             api_type: body.api_type,
@@ -165,6 +182,10 @@ export const adminProviderRoutes = (app, options, done) => {
             queue_timeout_ms: body.queue_timeout_ms ?? PROVIDER_CONCURRENCY_DEFAULTS.queue_timeout_ms,
             max_queue_size: body.max_queue_size ?? PROVIDER_CONCURRENCY_DEFAULTS.max_queue_size,
             adaptive_enabled: isAdaptiveEnabled,
+            proxy_type: body.proxy_type ?? null,
+            proxy_url: body.proxy_type ? body.proxy_url : null,
+            proxy_username: encryptedProxyUsername,
+            proxy_password: encryptedProxyPassword,
         });
         if (contextOverrides.length > 0) {
             setModelInfoForProvider(db, id, contextOverrides.map(o => ({ model_name: o.name, context_window: o.context_window })));
@@ -234,7 +255,26 @@ export const adminProviderRoutes = (app, options, done) => {
             fields.api_key = encrypt(body.api_key, getSetting(db, "encryption_key"));
             fields.api_key_preview = body.api_key.length > API_KEY_PREVIEW_MIN_LENGTH ? `${body.api_key.slice(0, API_KEY_PREVIEW_PREFIX_LEN)}...${body.api_key.slice(-API_KEY_PREVIEW_PREFIX_LEN)}` : "****";
         }
+        // Proxy field handling
+        if (body.proxy_type !== undefined) {
+            fields.proxy_type = body.proxy_type || null;
+            if (!body.proxy_type) {
+                fields.proxy_url = null;
+                fields.proxy_username = null;
+                fields.proxy_password = null;
+            }
+        }
+        if (body.proxy_url !== undefined && body.proxy_type) {
+            fields.proxy_url = body.proxy_url;
+        }
+        if (body.proxy_username !== undefined && body.proxy_type) {
+            fields.proxy_username = body.proxy_username ? encrypt(body.proxy_username, getSetting(db, "encryption_key")) : null;
+        }
+        if (body.proxy_password !== undefined && body.proxy_type) {
+            fields.proxy_password = body.proxy_password ? encrypt(body.proxy_password, getSetting(db, "encryption_key")) : null;
+        }
         updateProvider(db, id, fields);
+        proxyAgentFactory?.invalidate(id);
         const updated = getProviderById(db, id);
         let cascade;
         if (existing.is_active === 1 && body.is_active === 0) {
@@ -327,6 +367,7 @@ export const adminProviderRoutes = (app, options, done) => {
                 continue;
             }
         }
+        proxyAgentFactory?.invalidate(id);
         deleteProvider(db, id);
         stateRegistry?.removeProvider(id);
         adaptiveController?.remove(id);

package/dist/admin/proxy-enhancement.js

@@ -4,12 +4,13 @@ const UpdateProxyEnhancementSchema = Type.Object({
     tool_call_loop_enabled: Type.Boolean(),
     stream_loop_enabled: Type.Boolean(),
     tool_round_limit_enabled: Type.Boolean(),
+    tool_error_logging_enabled: Type.Boolean(),
 });
 export const adminProxyEnhancementRoutes = (app, options, done) => {
     const { db } = 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 };
+        const defaults = { tool_call_loop_enabled: false, stream_loop_enabled: false, tool_round_limit_enabled: true, tool_error_logging_enabled: false };
         let config = defaults;
         if (raw) {
             try {
@@ -18,6 +19,7 @@ export const adminProxyEnhancementRoutes = (app, options, done) => {
                     tool_call_loop_enabled: parsed.tool_call_loop_enabled ?? false,
                     stream_loop_enabled: parsed.stream_loop_enabled ?? false,
                     tool_round_limit_enabled: parsed.tool_round_limit_enabled ?? true,
+                    tool_error_logging_enabled: parsed.tool_error_logging_enabled ?? false,
                 };
             }
             catch { /* eslint-disable-line taste/no-silent-catch -- invalid JSON, return defaults */ }
@@ -30,6 +32,7 @@ export const adminProxyEnhancementRoutes = (app, options, done) => {
             tool_call_loop_enabled: body.tool_call_loop_enabled,
             stream_loop_enabled: body.stream_loop_enabled,
             tool_round_limit_enabled: body.tool_round_limit_enabled,
+            tool_error_logging_enabled: body.tool_error_logging_enabled,
         };
         setSetting(db, "proxy_enhancement", JSON.stringify(config));
         return reply.send({ success: true });

package/dist/admin/routes.d.ts

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

package/dist/admin/routes.js

@@ -23,7 +23,7 @@ export const adminRoutes = (app, options, done) => {
     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 });
+    app.register(adminProviderRoutes, { db: options.db, stateRegistry: options.stateRegistry, tracker: options.tracker, adaptiveController: options.adaptiveController, proxyAgentFactory: options.proxyAgentFactory });
     app.register(adminMappingRoutes, { db: options.db });
     app.register(adminGroupRoutes, { db: options.db });
     app.register(adminScheduleRoutes, { db: options.db });

package/dist/core/container.d.ts

@@ -9,6 +9,7 @@ export declare const SERVICE_KEYS: {
     readonly adaptiveController: "adaptiveController";
     readonly pluginRegistry: "pluginRegistry";
     readonly logFileWriter: "logFileWriter";
+    readonly proxyAgentFactory: "proxyAgentFactory";
 };
 export type ServiceKey = (typeof SERVICE_KEYS)[keyof typeof SERVICE_KEYS];
 /**

package/dist/core/container.js

@@ -9,6 +9,7 @@ export const SERVICE_KEYS = {
     adaptiveController: "adaptiveController",
     pluginRegistry: "pluginRegistry",
     logFileWriter: "logFileWriter",
+    proxyAgentFactory: "proxyAgentFactory",
 };
 /**
  * 轻量服务容器 — 懒加载单例工厂注册表。

package/dist/db/log-cleaner.js

@@ -1,5 +1,6 @@
 import { deleteLogsBefore } from "./logs.js";
 import { getLogRetentionDays } from "./settings.js";
+import { deleteToolErrorLogsBefore } from "./tool-error-logs.js";
 const MS_PER_DAY = 86_400_000;
 const CLEANUP_INTERVAL_MS = 3_600_000; // 1 小时
 /** 运行一次清理，返回删除条数 */
@@ -8,7 +9,9 @@ export function runLogCleanup(db) {
     if (days <= 0)
         return 0;
     const cutoff = new Date(Date.now() - days * MS_PER_DAY).toISOString();
-    return deleteLogsBefore(db, cutoff);
+    const logDeleted = deleteLogsBefore(db, cutoff);
+    const toolErrorDeleted = deleteToolErrorLogsBefore(db, cutoff);
+    return logDeleted + toolErrorDeleted;
 }
 /** 启动定时清理，返回 handle 用于停止 */
 export function scheduleLogCleanup(db, log) {

package/dist/db/migrations/041_add_provider_proxy.sql

@@ -0,0 +1,7 @@
+-- 041_add_provider_proxy.sql
+-- Add per-provider proxy support (SOCKS5 / HTTP CONNECT)
+
+ALTER TABLE providers ADD COLUMN proxy_type TEXT DEFAULT NULL;
+ALTER TABLE providers ADD COLUMN proxy_url TEXT DEFAULT NULL;
+ALTER TABLE providers ADD COLUMN proxy_username TEXT DEFAULT NULL;
+ALTER TABLE providers ADD COLUMN proxy_password TEXT DEFAULT NULL;

package/dist/db/migrations/041_create_tool_error_logs.sql

@@ -0,0 +1,28 @@
+CREATE TABLE IF NOT EXISTS tool_error_logs (
+  id TEXT PRIMARY KEY,
+  request_log_id TEXT REFERENCES request_logs(id) ON DELETE SET NULL,
+  provider_id TEXT NOT NULL,
+  backend_model TEXT NOT NULL,
+  client_agent_type TEXT NOT NULL DEFAULT 'unknown'
+    CHECK(client_agent_type IN ('claude-code', 'pi', 'unknown')),
+  tool_name TEXT NOT NULL,
+  tool_use_id TEXT,
+  tool_input TEXT,
+  error_content TEXT,
+  router_key_id TEXT,
+  session_id TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_tool_error_logs_time
+  ON tool_error_logs(created_at);
+CREATE INDEX IF NOT EXISTS idx_tool_error_logs_provider
+  ON tool_error_logs(provider_id, created_at);
+CREATE INDEX IF NOT EXISTS idx_tool_error_logs_model
+  ON tool_error_logs(backend_model, created_at);
+CREATE INDEX IF NOT EXISTS idx_tool_error_logs_tool
+  ON tool_error_logs(tool_name);
+CREATE INDEX IF NOT EXISTS idx_tool_error_logs_agent
+  ON tool_error_logs(client_agent_type);
+CREATE INDEX IF NOT EXISTS idx_tool_error_logs_session
+  ON tool_error_logs(session_id);

package/dist/db/providers.d.ts

@@ -13,6 +13,10 @@ export interface Provider {
     queue_timeout_ms: number;
     max_queue_size: number;
     adaptive_enabled: number;
+    proxy_type: string | null;
+    proxy_url: string | null;
+    proxy_username: string | null;
+    proxy_password: string | null;
     created_at: string;
     updated_at: string;
 }
@@ -41,8 +45,12 @@ export declare function createProvider(db: Database.Database, provider: {
     queue_timeout_ms?: number;
     max_queue_size?: number;
     adaptive_enabled?: number;
+    proxy_type?: string | null;
+    proxy_url?: string | null;
+    proxy_username?: string | null;
+    proxy_password?: string | null;
 }): string;
-export declare function updateProvider(db: Database.Database, id: string, fields: Partial<Pick<Provider, "name" | "api_type" | "base_url" | "upstream_path" | "api_key" | "api_key_preview" | "models" | "is_active" | "max_concurrency" | "queue_timeout_ms" | "max_queue_size" | "adaptive_enabled">>): void;
+export declare function updateProvider(db: Database.Database, id: string, fields: Partial<Pick<Provider, "name" | "api_type" | "base_url" | "upstream_path" | "api_key" | "api_key_preview" | "models" | "is_active" | "max_concurrency" | "queue_timeout_ms" | "max_queue_size" | "adaptive_enabled" | "proxy_type" | "proxy_url" | "proxy_username" | "proxy_password">>): void;
 export declare function deleteProvider(db: Database.Database, id: string): void;
 export declare function getActiveProviderByName(db: Database.Database, name: string): {
     id: string;

package/dist/db/providers.js

@@ -37,7 +37,7 @@ export const PROVIDER_CONCURRENCY_DEFAULTS = {
     max_queue_size: 100,
 };
 const PROVIDER_FIELDS = new Set([
-    "name", "api_type", "base_url", "upstream_path", "api_key", "api_key_preview", "models", "is_active", "max_concurrency", "queue_timeout_ms", "max_queue_size", "adaptive_enabled",
+    "name", "api_type", "base_url", "upstream_path", "api_key", "api_key_preview", "models", "is_active", "max_concurrency", "queue_timeout_ms", "max_queue_size", "adaptive_enabled", "proxy_type", "proxy_url", "proxy_username", "proxy_password",
 ]);
 export function getActiveProviders(db, apiType) {
     return db
@@ -53,8 +53,8 @@ export function getProviderById(db, id) {
 export function createProvider(db, provider) {
     const id = randomUUID();
     const now = new Date().toISOString();
-    db.prepare(`INSERT INTO providers (id, name, api_type, base_url, upstream_path, api_key, api_key_preview, models, is_active, max_concurrency, queue_timeout_ms, max_queue_size, adaptive_enabled, created_at, updated_at)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, provider.name, provider.api_type, provider.base_url, provider.upstream_path ?? null, provider.api_key, provider.api_key_preview ?? null, provider.models ?? "[]", provider.is_active ?? 1, provider.max_concurrency ?? PROVIDER_CONCURRENCY_DEFAULTS.max_concurrency, provider.queue_timeout_ms ?? PROVIDER_CONCURRENCY_DEFAULTS.queue_timeout_ms, provider.max_queue_size ?? PROVIDER_CONCURRENCY_DEFAULTS.max_queue_size, provider.adaptive_enabled ?? 0, now, now);
+    db.prepare(`INSERT INTO providers (id, name, api_type, base_url, upstream_path, api_key, api_key_preview, models, is_active, max_concurrency, queue_timeout_ms, max_queue_size, adaptive_enabled, proxy_type, proxy_url, proxy_username, proxy_password, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, provider.name, provider.api_type, provider.base_url, provider.upstream_path ?? null, provider.api_key, provider.api_key_preview ?? null, provider.models ?? "[]", provider.is_active ?? 1, provider.max_concurrency ?? PROVIDER_CONCURRENCY_DEFAULTS.max_concurrency, provider.queue_timeout_ms ?? PROVIDER_CONCURRENCY_DEFAULTS.queue_timeout_ms, provider.max_queue_size ?? PROVIDER_CONCURRENCY_DEFAULTS.max_queue_size, provider.adaptive_enabled ?? 0, provider.proxy_type ?? null, provider.proxy_url ?? null, provider.proxy_username ?? null, provider.proxy_password ?? null, now, now);
     return id;
 }
 export function updateProvider(db, id, fields) {

package/dist/db/tool-error-logs.d.ts

@@ -0,0 +1,6 @@
+import Database from "better-sqlite3";
+/**
+ * 删除 created_at 早于 beforeDate 的 tool_error_logs 记录。
+ * 外键 ON DELETE SET NULL 确保 request_logs 被删后 tool_error_logs 仍保留。
+ */
+export declare function deleteToolErrorLogsBefore(db: Database.Database, beforeDate: string): number;

package/dist/db/tool-error-logs.js

@@ -0,0 +1,8 @@
+/**
+ * 删除 created_at 早于 beforeDate 的 tool_error_logs 记录。
+ * 外键 ON DELETE SET NULL 确保 request_logs 被删后 tool_error_logs 仍保留。
+ */
+export function deleteToolErrorLogsBefore(db, beforeDate) {
+    const changes = db.prepare("DELETE FROM tool_error_logs WHERE created_at < ?").run(beforeDate).changes;
+    return changes;
+}

package/dist/index.js

@@ -31,6 +31,7 @@ import { startUpgradeChecker, stopUpgradeChecker } from "./admin/upgrade.js";
 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 { scheduleLogFileMaintenance } from "./storage/log-file-compressor.js";
 import { getDetailLogEnabled, getLogFileRetentionDays } from "./db/settings.js";
 import { dirname, join } from "node:path";
@@ -215,12 +216,15 @@ export async function buildApp(options) {
     const pluginsDir = path.resolve(__dirname, "../plugins/transform");
     pluginRegistry.scanPluginsDir(pluginsDir);
     container.register(SERVICE_KEYS.pluginRegistry, () => pluginRegistry);
+    // 注册 ProxyAgentFactory
+    container.register(SERVICE_KEYS.proxyAgentFactory, () => new ProxyAgentFactory());
     // 从容器解析所有服务
     const matcher = container.resolve(SERVICE_KEYS.matcher);
     const semaphoreManager = container.resolve(SERVICE_KEYS.semaphoreManager);
     const tracker = container.resolve(SERVICE_KEYS.tracker);
     const usageWindowTracker = container.resolve(SERVICE_KEYS.usageWindowTracker);
     const adaptiveController = container.resolve(SERVICE_KEYS.adaptiveController);
+    const proxyAgentFactory = container.resolve(SERVICE_KEYS.proxyAgentFactory);
     // Wire adaptive controller to tracker
     tracker.setAdaptiveStatusProvider(adaptiveController);
     // 从 DB 读取已有 provider 的并发配置，初始化信号量/adaptive/tracker（共享逻辑）
@@ -247,7 +251,7 @@ export async function buildApp(options) {
     // 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 });
+    app.register(adminRoutes, { db, stateRegistry, tracker, adaptiveController, logFileWriter, logsDir, closeFn: () => closeRef.fn(), pluginRegistry, proxyAgentFactory });
     // 前端静态文件服务（生产环境）
     const frontendDist = path.resolve(process.env.FRONTEND_DIST || path.join(__dirname, "../frontend-dist"));
     if (existsSync(frontendDist)) {
@@ -287,6 +291,7 @@ export async function buildApp(options) {
         // 关闭所有 SSE 长连接，防止 app.close() 因 hijack 的连接无限等待
         tracker.closeAllClients();
         semaphoreManager.removeAll();
+        proxyAgentFactory.invalidateAll();
         const sessionTracker = container.resolve(SERVICE_KEYS.sessionTracker);
         sessionTracker.stop();
         await app.close();

package/dist/proxy/handler/anthropic.js

@@ -35,7 +35,7 @@ const anthropicProxyRaw = (app, opts, done) => {
             const e = anthropicErrors.providerUnavailable();
             return reply.code(e.statusCode).send(e.body);
         }
-        const deps = { db, orchestrator, container };
+        const deps = { db, orchestrator, container, proxyAgentFactory: container.resolve(SERVICE_KEYS.proxyAgentFactory) };
         return handleProxyRequest(request, reply, "anthropic", MESSAGES_PATH, anthropicErrors, deps);
     });
     done();

package/dist/proxy/handler/openai.js

@@ -41,7 +41,7 @@ const openaiProxyRaw = (app, opts, done) => {
             });
             return sendError(reply, openaiErrors.providerUnavailable());
         }
-        const deps = { db, orchestrator, container };
+        const deps = { db, orchestrator, container, proxyAgentFactory: container.resolve(SERVICE_KEYS.proxyAgentFactory) };
         return handleProxyRequest(request, reply, "openai", CHAT_COMPLETIONS_PATH, openaiErrors, deps, {
             beforeSendProxy: (body, isStream) => {
                 if (isStream && !body.stream_options) {

package/dist/proxy/handler/proxy-handler-utils.d.ts

@@ -1,6 +1,30 @@
 import type { ContentBlock } from "@llm-router/core/monitor";
 import type { ToolCallRecord } from "@llm-router/core/loop-prevention";
 import type { TransportResult } from "../types.js";
+import type { RawHeaders } from "../types.js";
+export type ClientAgentType = "claude-code" | "pi" | "unknown";
+export interface FailedToolResult {
+    toolName: string;
+    toolUseId: string | undefined;
+    toolInput: string | undefined;
+    errorContent: string;
+}
+/**
+ * 根据请求头识别客户端类型。
+ * - Claude Code 独有 x-claude-code-session-id 头
+ * - pi 的 User-Agent 包含 "pi-coding-agent"
+ */
+export declare function detectClientAgentType(headers: RawHeaders): ClientAgentType;
+/**
+ * 从请求体 messages 中提取本条请求新产生的失败 tool_result 块。
+ *
+ * 只扫描最后一条 role = "user" 且有 tool_result 的消息，
+ * 避免重复记录前轮请求已记录的 tool 失败。
+ *
+ * 通过向前扫描 assistant 消息中的 tool_use 块
+ * 关联对应的 tool_name 和 tool_input。
+ */
+export declare function extractFailedToolResults(body: Record<string, unknown>): FailedToolResult[];
 /** 从 TransportResult 中提取最终 HTTP status code */
 export declare function getTransportStatusCode(result: TransportResult): number | null;
 /** 将 tracker blocks 序列化为前端 tryDirectParse 可解析的 JSON */

package/dist/proxy/handler/proxy-handler-utils.js

@@ -1,6 +1,87 @@
 import { createHash } from "crypto";
 import { parseToolArguments } from "../transform/sanitize.js";
 const HASH_DIGEST_LENGTH = 16;
+/**
+ * 根据请求头识别客户端类型。
+ * - Claude Code 独有 x-claude-code-session-id 头
+ * - pi 的 User-Agent 包含 "pi-coding-agent"
+ */
+export function detectClientAgentType(headers) {
+    if (headers["x-claude-code-session-id"])
+        return "claude-code";
+    const ua = String(headers["user-agent"] ?? "").toLowerCase();
+    if (ua.includes("pi-coding-agent"))
+        return "pi";
+    return "unknown";
+}
+/**
+ * 从请求体 messages 中提取本条请求新产生的失败 tool_result 块。
+ *
+ * 只扫描最后一条 role = "user" 且有 tool_result 的消息，
+ * 避免重复记录前轮请求已记录的 tool 失败。
+ *
+ * 通过向前扫描 assistant 消息中的 tool_use 块
+ * 关联对应的 tool_name 和 tool_input。
+ */
+export function extractFailedToolResults(body) {
+    const messages = body.messages;
+    if (!messages || messages.length === 0)
+        return [];
+    // 第一步：向后往前找最后一个包含 tool_result 的 user 消息
+    let lastUserIndex = -1;
+    const resultBlocks = [];
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        if (msg.role !== "user")
+            continue;
+        const content = msg.content;
+        if (!Array.isArray(content))
+            continue;
+        for (const block of content) {
+            if (block.type === "tool_result") {
+                resultBlocks.push(block);
+                lastUserIndex = i;
+            }
+        }
+        if (resultBlocks.length > 0)
+            break;
+    }
+    if (lastUserIndex < 0)
+        return [];
+    // 第二步：在整个 messages 中建立 tool_use_id → { name, input } 映射
+    const toolUseMap = new Map();
+    for (let i = 0; i < lastUserIndex; i++) {
+        const msg = messages[i];
+        if (msg.role !== "assistant")
+            continue;
+        const content = Array.isArray(msg.content) ? msg.content : [];
+        for (const block of content) {
+            if (block.type === "tool_use" && block.id) {
+                const inputText = block.input ? JSON.stringify(block.input) : "";
+                toolUseMap.set(block.id, { name: block.name ?? "unknown", input: inputText });
+            }
+        }
+    }
+    // 第三步：提取 is_error === true 的 tool_result
+    const failures = [];
+    for (const block of resultBlocks) {
+        if (block.is_error !== true)
+            continue;
+        const toolUse = block.tool_use_id && typeof block.tool_use_id === "string"
+            ? toolUseMap.get(block.tool_use_id)
+            : undefined;
+        const errorContent = typeof block.content === "string"
+            ? block.content
+            : JSON.stringify(block.content ?? "");
+        failures.push({
+            toolName: toolUse?.name ?? "unknown",
+            toolUseId: block.tool_use_id,
+            toolInput: toolUse?.input,
+            errorContent,
+        });
+    }
+    return failures;
+}
 /** 从 TransportResult 中提取最终 HTTP status code */
 export function getTransportStatusCode(result) {
     if (result.kind === "success" || result.kind === "error" || result.kind === "stream_error")

package/dist/proxy/handler/proxy-handler.d.ts

@@ -2,10 +2,12 @@ import type { FastifyReply, FastifyRequest } from "fastify";
 import Database from "better-sqlite3";
 import type { ProxyOrchestrator } from "../orchestration/orchestrator.js";
 import type { ProxyErrorFormatter } from "../proxy-core.js";
+import type { ProxyAgentFactory } from "../transport/proxy-agent.js";
 export interface RouteHandlerDeps {
     db: Database.Database;
     orchestrator: ProxyOrchestrator;
     container: ServiceContainer;
+    proxyAgentFactory?: ProxyAgentFactory;
 }
 import type { ServiceContainer } from "../../core/container.js";
 export declare function handleProxyRequest(request: FastifyRequest, reply: FastifyReply, apiType: "openai" | "openai-responses" | "anthropic", upstreamPath: string, errors: ProxyErrorFormatter, deps: RouteHandlerDeps, options?: {

package/dist/proxy/handler/proxy-handler.js

@@ -18,7 +18,8 @@ import { applyProviderPatches } from "../patch/index.js";
 import { PipelineSnapshot } from "../pipeline-snapshot.js";
 import { applyToolRoundLimit } from "../patch/tool-round-limiter.js";
 import { loadEnhancementConfig } from "../routing/enhancement-config.js";
-import { getTransportStatusCode, serializeBlocksForStorage, extractLastToolUse } from "./proxy-handler-utils.js";
+import { getTransportStatusCode, serializeBlocksForStorage, extractLastToolUse, extractFailedToolResults, detectClientAgentType } from "./proxy-handler-utils.js";
+import { logToolErrors } from "../tool-error-logger.js";
 const HTTP_ERROR_THRESHOLD = 400;
 const MAX_LOG_FIELD_LENGTH = 80;
 const UPSTREAM_ERROR_STATUS = 502;
@@ -125,8 +126,10 @@ async function executeFailoverLoop(ctx) {
     const config = getConfig();
     const excludeTargets = [];
     let rootLogId = null;
+    let toolErrorsLogged = false;
     // TransformCoordinator 无状态，只需创建一次
     const coordinator = new TransformCoordinator();
+    const enhancementConfig = loadEnhancementConfig(deps.db);
     while (true) {
         const startTime = Date.now();
         const logId = randomUUID();
@@ -177,6 +180,23 @@ async function executeFailoverLoop(ctx) {
         if (!provider || !provider.is_active) {
             return rejectAndReply(reply, rCtx, errors.providerUnavailable(), `Provider '${resolved.provider_id}' unavailable`, resolved.provider_id);
         }
+        // 工具错误日志记录 — 首次迭代时执行，记录本轮请求中的 is_error tool_result
+        if (enhancementConfig.tool_error_logging_enabled && !toolErrorsLogged) {
+            toolErrorsLogged = true;
+            const failures = extractFailedToolResults(pipelineBody);
+            if (failures.length > 0) {
+                request.log.info({ failures: failures.length, sessionId }, "Tool error results detected");
+                logToolErrors(failures, {
+                    db: deps.db,
+                    providerId: resolved.provider_id,
+                    backendModel: resolved.backend_model ?? effectiveModel,
+                    clientAgentType: detectClientAgentType(cliHdrs),
+                    requestLogId: logId,
+                    routerKeyId,
+                    sessionId,
+                });
+            }
+        }
         // --- 溢出重定向：上下文超出时切换到更大模型（必须在 transform 之前，确保使用正确的 api_type） ---
         const overflowResult = applyOverflowRedirect(resolved, deps.db, currentBody);
         if (overflowResult) {
@@ -283,6 +303,7 @@ async function executeFailoverLoop(ctx) {
             streamTimeoutMs: getModelStreamTimeout(provider, resolved.backend_model), tracker, matcher, request,
             streamLoopEnabled, formatTransform, responseTransform, injectedHeaders,
             timeoutContext: { modelId: resolved.backend_model, providerId: provider.id },
+            proxyAgentFactory: deps.proxyAgentFactory,
         });
         const pipelineSnapshot = iterationSnapshot.toJSON();
         try {

package/dist/proxy/handler/responses.js

@@ -38,7 +38,7 @@ const responsesProxyRaw = (app, opts, done) => {
             });
             return sendError(reply, responsesErrors.providerUnavailable());
         }
-        const deps = { db, orchestrator, container };
+        const deps = { db, orchestrator, container, proxyAgentFactory: container.resolve(SERVICE_KEYS.proxyAgentFactory) };
         return handleProxyRequest(request, reply, "openai-responses", RESPONSES_PATH, responsesErrors, deps);
     };
     app.post(RESPONSES_PATH, handleResponses);

package/dist/proxy/routing/enhancement-config.d.ts

@@ -3,6 +3,7 @@ export interface EnhancementConfig {
     tool_call_loop_enabled: boolean;
     stream_loop_enabled: boolean;
     tool_round_limit_enabled: boolean;
+    tool_error_logging_enabled: boolean;
 }
 /** 集中加载 proxy_enhancement 配置，避免多处重复 getSetting + JSON.parse */
 export declare function loadEnhancementConfig(db: Database.Database): EnhancementConfig;

package/dist/proxy/routing/enhancement-config.js

@@ -3,6 +3,7 @@ const DEFAULT_CONFIG = {
     tool_call_loop_enabled: false,
     stream_loop_enabled: false,
     tool_round_limit_enabled: true,
+    tool_error_logging_enabled: false,
 };
 /** 集中加载 proxy_enhancement 配置，避免多处重复 getSetting + JSON.parse */
 export function loadEnhancementConfig(db) {
@@ -15,6 +16,7 @@ export function loadEnhancementConfig(db) {
             tool_call_loop_enabled: parsed.tool_call_loop_enabled ?? false,
             stream_loop_enabled: parsed.stream_loop_enabled ?? false,
             tool_round_limit_enabled: parsed.tool_round_limit_enabled ?? true,
+            tool_error_logging_enabled: parsed.tool_error_logging_enabled ?? false,
         };
     }
     catch {

package/dist/proxy/tool-error-logger.d.ts

@@ -0,0 +1,16 @@
+import type Database from "better-sqlite3";
+import type { FailedToolResult, ClientAgentType } from "./handler/proxy-handler-utils.js";
+export interface ToolErrorLogContext {
+    db: Database.Database;
+    providerId: string;
+    backendModel: string;
+    clientAgentType: ClientAgentType;
+    requestLogId: string;
+    routerKeyId: string | null;
+    sessionId: string | undefined;
+}
+/**
+ * 将失败的 tool_result 批量写入 tool_error_logs 表。
+ * 每条失败记录独立一行。
+ */
+export declare function logToolErrors(failures: FailedToolResult[], ctx: ToolErrorLogContext): void;