@juspay/neurolink 9.87.3 → 9.88.0

package/dist/lib/utils/fileDetector.js

@@ -1823,23 +1823,47 @@ class ExtensionStrategy {
         };
     }
     getExtension(input) {
-        if (this.isURL(input)) {
-            const url = new URL(input);
-            const match = url.pathname.match(/\.([^.]+)$/);
-            return match ? match[1] : null;
+        const normalizedInput = input.trim();
+        let extensionSource = normalizedInput;
+        if (this.isURL(normalizedInput)) {
+            try {
+                const url = new URL(normalizedInput);
+                extensionSource = url.pathname;
+                try {
+                    extensionSource = decodeURIComponent(extensionSource);
+                }
+                catch {
+                    // Keep the original pathname if the URL contains malformed escapes.
+                }
+            }
+            catch {
+                extensionSource = normalizedInput;
+            }
         }
-        const match = input.match(/\.([^.]+)$/);
-        return match ? match[1] : null;
+        const match = extensionSource.trim().match(/\.([^.]+)$/);
+        if (!match) {
+            return null;
+        }
+        const ext = match[1].split(/[?#]/)[0].toLowerCase();
+        return /^[a-z0-9]+$/.test(ext) ? ext : null;
     }
     isURL(str) {
-        return str.startsWith("http://") || str.startsWith("https://");
+        const normalized = str.trim();
+        return (normalized.startsWith("http://") || normalized.startsWith("https://"));
     }
     detectSource(input) {
-        if (input.startsWith("data:")) {
+        const normalized = input.trim();
+        if (normalized.startsWith("data:")) {
             return "datauri";
         }
-        if (this.isURL(input)) {
-            return "url";
+        if (this.isURL(normalized)) {
+            try {
+                new URL(normalized);
+                return "url";
+            }
+            catch {
+                return "path";
+            }
         }
         return "path";
     }

package/dist/neurolink.d.ts

@@ -14,6 +14,7 @@ import { MCPToolRegistry } from "./mcp/toolRegistry.js";
 import type { DynamicOptions } from "./types/index.js";
 import { SkillsManager } from "./skills/skillsManager.js";
 import { TaskManager } from "./tasks/taskManager.js";
+import type { SessionExport, SessionListItem } from "./types/index.js";
 /**
  * Curator P2-4 dedup (concurrency-safe): native providers emit
  * `generation:end` on the shared SDK emitter. We attach a fresh
@@ -1631,6 +1632,32 @@ export declare class NeuroLink {
      * Clear all conversation history (public API)
      */
     clearAllConversations(): Promise<void>;
+    /**
+     * List all conversation sessions with metadata (public API)
+     * @param userId - Optional user ID to filter sessions (required for Redis storage)
+     * @returns Array of session list items with metadata
+     */
+    listSessions(userId?: string): Promise<SessionListItem[]>;
+    /**
+     * Export a single session with full history and metadata (public API)
+     * @param sessionId - The session ID to export
+     * @param options - Export options
+     * @returns Session export object with full history
+     */
+    exportSession(sessionId: string, options?: {
+        includeMetadata?: boolean;
+        format?: "json" | "csv";
+    }): Promise<SessionExport | null>;
+    /**
+     * Export all sessions for a user (public API)
+     * @param userId - Optional user ID (required for Redis storage)
+     * @param options - Export options
+     * @returns Array of session exports
+     */
+    exportAllSessions(userId?: string, options?: {
+        includeMetadata?: boolean;
+        format?: "json" | "csv";
+    }): Promise<SessionExport[]>;
     /**
      * Store tool executions in conversation memory if enabled and Redis is configured
      * @param sessionId - Session identifier

package/dist/neurolink.js

@@ -10504,6 +10504,139 @@ Current user's request: ${currentInput}`;
         this.lastCompactionMessageCount.clear();
         await this.conversationMemory.clearAllSessions();
     }
+    /**
+     * List all conversation sessions with metadata (public API)
+     * @param userId - Optional user ID to filter sessions (required for Redis storage)
+     * @returns Array of session list items with metadata
+     */
+    async listSessions(userId) {
+        // First ensure memory is initialized
+        const initId = `list-sessions-init-${Date.now()}`;
+        await this.initializeConversationMemoryForGeneration(initId, Date.now(), process.hrtime.bigint());
+        if (!this.conversationMemory) {
+            throw new Error("Conversation memory is not enabled");
+        }
+        // Check if listSessions is available on the memory manager
+        if (!this.conversationMemory.listSessions) {
+            logger.warn("listSessions not available on current memory manager");
+            return [];
+        }
+        const MEMORY_OPERATION_TIMEOUT = 30000; // 30 seconds
+        try {
+            const sessions = await withTimeout(this.conversationMemory.listSessions(userId), MEMORY_OPERATION_TIMEOUT, new Error("listSessions operation timed out after 30s"));
+            logger.debug("Listed conversation sessions", {
+                userId,
+                sessionCount: sessions.length,
+            });
+            return sessions;
+        }
+        catch (error) {
+            logger.error("Failed to list conversation sessions", {
+                userId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return [];
+        }
+    }
+    /**
+     * Export a single session with full history and metadata (public API)
+     * @param sessionId - The session ID to export
+     * @param options - Export options
+     * @returns Session export object with full history
+     */
+    async exportSession(sessionId, options = {}) {
+        // First ensure memory is initialized
+        const initId = `export-session-init-${Date.now()}`;
+        await this.initializeConversationMemoryForGeneration(initId, Date.now(), process.hrtime.bigint());
+        if (!this.conversationMemory) {
+            throw new Error("Conversation memory is not enabled");
+        }
+        if (!sessionId || typeof sessionId !== "string") {
+            throw new Error("Session ID must be a non-empty string");
+        }
+        const MEMORY_OPERATION_TIMEOUT = 30000; // 30 seconds
+        try {
+            const messages = await withTimeout(this.conversationMemory.buildContextMessages(sessionId), MEMORY_OPERATION_TIMEOUT, new Error("buildContextMessages operation timed out after 30s"));
+            if (messages.length === 0) {
+                logger.debug("No messages found for session export", { sessionId });
+                return null;
+            }
+            const sessionResult = this.conversationMemory.getSession(sessionId);
+            const session = await withTimeout(sessionResult instanceof Promise
+                ? sessionResult
+                : Promise.resolve(sessionResult), MEMORY_OPERATION_TIMEOUT, new Error("getSession operation timed out after 30s"));
+            const now = new Date().toISOString();
+            const exportData = {
+                sessionId,
+                title: sessionId, // Use sessionId as title if not available
+                userId: session?.userId,
+                createdAt: session?.createdAt
+                    ? new Date(session.createdAt).toISOString()
+                    : now,
+                updatedAt: session?.lastActivity
+                    ? new Date(session.lastActivity).toISOString()
+                    : now,
+                messages,
+            };
+            if (options.includeMetadata) {
+                exportData.exportMetadata = {
+                    exportedAt: now,
+                    exportFormat: options.format || "json",
+                };
+            }
+            logger.debug("Exported conversation session", {
+                sessionId,
+                messageCount: messages.length,
+            });
+            return exportData;
+        }
+        catch (error) {
+            logger.error("Failed to export conversation session", {
+                sessionId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return null;
+        }
+    }
+    /**
+     * Export all sessions for a user (public API)
+     * @param userId - Optional user ID (required for Redis storage)
+     * @param options - Export options
+     * @returns Array of session exports
+     */
+    async exportAllSessions(userId, options = {}) {
+        // First ensure memory is initialized
+        const initId = `export-all-init-${Date.now()}`;
+        await this.initializeConversationMemoryForGeneration(initId, Date.now(), process.hrtime.bigint());
+        if (!this.conversationMemory) {
+            throw new Error("Conversation memory is not enabled");
+        }
+        const MEMORY_OPERATION_TIMEOUT = 30000; // 30 seconds
+        const EXPORT_SESSION_TIMEOUT = 60000; // 60 seconds for full export
+        try {
+            // Get all session IDs
+            const sessions = await withTimeout(this.listSessions(userId), MEMORY_OPERATION_TIMEOUT, new Error("listSessions operation timed out after 30s"));
+            const exports = [];
+            for (const session of sessions) {
+                const exportData = await withTimeout(this.exportSession(session.id, options), EXPORT_SESSION_TIMEOUT, new Error(`exportSession operation timed out after 60s for session ${session.id}`));
+                if (exportData) {
+                    exports.push(exportData);
+                }
+            }
+            logger.debug("Exported all conversation sessions", {
+                userId,
+                sessionCount: exports.length,
+            });
+            return exports;
+        }
+        catch (error) {
+            logger.error("Failed to export all conversation sessions", {
+                userId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return [];
+        }
+    }
     /**
      * Store tool executions in conversation memory if enabled and Redis is configured
      * @param sessionId - Session identifier

package/dist/proxy/globalInstaller.d.ts

@@ -0,0 +1,5 @@
+import type { GlobalInstallerKind, GlobalInstallerResolution, ResolveGlobalInstallerOptions } from "../types/index.js";
+/** Resolve a package manager that can update the installation currently running. */
+export declare function resolveGlobalInstaller(options?: ResolveGlobalInstallerOptions): GlobalInstallerResolution;
+export declare function getGlobalInstallArgs(kind: GlobalInstallerKind, packageSpec: string): string[];
+export declare function describeInstallFailure(error: unknown): string;

package/dist/proxy/globalInstaller.js

@@ -0,0 +1,155 @@
+import { execFileSync as nodeExecFileSync } from "node:child_process";
+import { accessSync, constants, existsSync, realpathSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, dirname, join, resolve } from "node:path";
+function runText(execFileSync, bin, args) {
+    return String(execFileSync(bin, args, {
+        encoding: "utf8",
+        timeout: 10_000,
+        stdio: ["ignore", "pipe", "pipe"],
+    })).trim();
+}
+function writableDirectory(path) {
+    try {
+        if (!existsSync(path)) {
+            return false;
+        }
+        accessSync(path, constants.W_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isPathInside(path, parent) {
+    if (!path) {
+        return false;
+    }
+    try {
+        const candidate = realpathSync(path);
+        const root = realpathSync(parent);
+        return candidate === root || candidate.startsWith(`${root}/`);
+    }
+    catch {
+        const candidate = resolve(path);
+        const root = resolve(parent);
+        return candidate === root || candidate.startsWith(`${root}/`);
+    }
+}
+function probeInstaller(kind, bin, entryScript, execFileSync) {
+    const base = {
+        kind,
+        bin,
+        working: false,
+        installable: false,
+        matchesCurrentInstall: false,
+    };
+    try {
+        base.version = runText(execFileSync, bin, ["--version"]);
+        base.working = base.version.length > 0;
+        base.globalRoot = runText(execFileSync, bin, ["root", "-g"]);
+        base.globalBinDir =
+            kind === "pnpm"
+                ? runText(execFileSync, bin, ["bin", "-g"])
+                : join(runText(execFileSync, bin, ["prefix", "-g"]), "bin");
+        if (!base.globalRoot || !writableDirectory(base.globalRoot)) {
+            base.reason = "global package root is missing or not writable";
+            return base;
+        }
+        if (!base.globalBinDir || !writableDirectory(base.globalBinDir)) {
+            base.reason = "global executable directory is missing or not writable";
+            return base;
+        }
+        base.installable = true;
+        base.matchesCurrentInstall = isPathInside(entryScript, base.globalRoot);
+        return base;
+    }
+    catch (error) {
+        base.reason = error instanceof Error ? error.message : String(error);
+        return base;
+    }
+}
+function resolveFromPath(command, execFileSync) {
+    try {
+        const result = runText(execFileSync, "which", [command]);
+        return result || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Resolve a package manager that can update the installation currently running. */
+export function resolveGlobalInstaller(options = {}) {
+    const env = options.env ?? process.env;
+    const homeDir = options.homeDir ?? homedir();
+    const entryScript = options.entryScript ?? process.argv[1];
+    const execFileSync = options.execFileSync ?? nodeExecFileSync;
+    const candidates = [];
+    if (env.NEUROLINK_PACKAGE_MANAGER_PATH) {
+        const configuredKind = env.NEUROLINK_PACKAGE_MANAGER?.toLowerCase();
+        const inferredName = basename(env.NEUROLINK_PACKAGE_MANAGER_PATH);
+        const kind = configuredKind === "npm" || configuredKind === "pnpm"
+            ? configuredKind
+            : inferredName.startsWith("npm")
+                ? "npm"
+                : "pnpm";
+        candidates.push({ kind, bin: env.NEUROLINK_PACKAGE_MANAGER_PATH });
+    }
+    if (env.NEUROLINK_PNPM_PATH) {
+        candidates.push({ kind: "pnpm", bin: env.NEUROLINK_PNPM_PATH });
+    }
+    if (env.PNPM_HOME) {
+        candidates.push({ kind: "pnpm", bin: join(env.PNPM_HOME, "pnpm") });
+    }
+    const nodeBinDir = dirname(process.execPath);
+    candidates.push({ kind: "npm", bin: join(nodeBinDir, "npm") });
+    const pathPnpm = resolveFromPath("pnpm", execFileSync);
+    const pathNpm = resolveFromPath("npm", execFileSync);
+    if (pathPnpm) {
+        candidates.push({ kind: "pnpm", bin: pathPnpm });
+    }
+    if (pathNpm) {
+        candidates.push({ kind: "npm", bin: pathNpm });
+    }
+    candidates.push({ kind: "pnpm", bin: join(homeDir, ".local", "share", "pnpm", "pnpm") }, { kind: "pnpm", bin: join(homeDir, "Library", "pnpm", "pnpm") }, { kind: "npm", bin: "/opt/homebrew/bin/npm" }, { kind: "npm", bin: "/usr/local/bin/npm" });
+    const seen = new Set();
+    const tried = candidates
+        .filter(({ kind, bin }) => {
+        const key = `${kind}:${bin}`;
+        if (!bin || seen.has(key)) {
+            return false;
+        }
+        seen.add(key);
+        return true;
+    })
+        .map(({ kind, bin }) => probeInstaller(kind, bin, entryScript, execFileSync));
+    const matchingInstaller = tried.find((probe) => probe.installable && probe.matchesCurrentInstall);
+    // When the running entry script is known, installing into a different
+    // global root cannot update that process and may shadow another install.
+    const installer = entryScript
+        ? matchingInstaller
+        : (matchingInstaller ?? tried.find((probe) => probe.installable));
+    return { installer, tried };
+}
+export function getGlobalInstallArgs(kind, packageSpec) {
+    return kind === "pnpm"
+        ? ["add", "-g", packageSpec]
+        : ["install", "--global", "--no-audit", "--no-fund", packageSpec];
+}
+function capturedOutput(error, key) {
+    if (!error || typeof error !== "object" || !(key in error)) {
+        return "";
+    }
+    const raw = error[key];
+    return String(raw ?? "")
+        .trim()
+        .slice(0, 1_000);
+}
+export function describeInstallFailure(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const stdout = capturedOutput(error, "stdout");
+    const stderr = capturedOutput(error, "stderr");
+    return [message, stdout && `stdout: ${stdout}`, stderr && `stderr: ${stderr}`]
+        .filter(Boolean)
+        .join("\n");
+}

package/dist/proxy/openaiFormat.d.ts

@@ -134,4 +134,6 @@ export declare function convertClaudeToOpenAIResponse(claude: ClaudeResponse, re
  *  - message_delta       -> captures stop_reason and output token usage
  *  - message_stop        -> emits the final `finish_reason` chunk + `[DONE]`
  */
-export declare function createClaudeToOpenAIStreamTransform(requestModel: string): TransformStream<Uint8Array, Uint8Array>;
+export declare function createClaudeToOpenAIStreamTransform(requestModel: string, options?: {
+    onError?: (message: string) => void;
+}): TransformStream<Uint8Array, Uint8Array>;

package/dist/proxy/openaiFormat.js

@@ -651,7 +651,7 @@ export function convertClaudeToOpenAIResponse(claude, requestModel) {
  *  - message_delta       -> captures stop_reason and output token usage
  *  - message_stop        -> emits the final `finish_reason` chunk + `[DONE]`
  */
-export function createClaudeToOpenAIStreamTransform(requestModel) {
+export function createClaudeToOpenAIStreamTransform(requestModel, options = {}) {
     const serializer = new OpenAIStreamSerializer(requestModel);
     const encoder = new TextEncoder();
     const decoder = new TextDecoder();
@@ -677,6 +677,9 @@ export function createClaudeToOpenAIStreamTransform(requestModel) {
         catch {
             return;
         }
+        if (finished) {
+            return;
+        }
         switch (eventName) {
             case "message_start": {
                 const message = (data.message ?? {});
@@ -749,8 +752,18 @@ export function createClaudeToOpenAIStreamTransform(requestModel) {
                 }
                 return;
             }
+            case "error": {
+                const error = (data.error ?? {});
+                const message = typeof error.message === "string"
+                    ? error.message
+                    : "Anthropic stream failed";
+                finished = true;
+                options.onError?.(message);
+                emit(controller, serializer.emitError(message));
+                return;
+            }
             default:
-                // ping, error, and unknown events are ignored.
+                // ping and unknown events are ignored.
                 return;
         }
     };
@@ -790,10 +803,12 @@ export function createClaudeToOpenAIStreamTransform(requestModel) {
             // closing `\n\n` is not silently lost.
             buffer += decoder.decode();
             drainBufferedEvents(controller);
-            // If the upstream closed without a message_stop, still finalize.
+            // Closing without message_stop is an interrupted stream, not success.
             if (!finished) {
                 finished = true;
-                emit(controller, serializer.finish(stopReason, usage));
+                const message = "Anthropic stream ended before message_stop";
+                options.onError?.(message);
+                emit(controller, serializer.emitError(message));
             }
         },
     });

package/dist/proxy/proxyActivity.d.ts

@@ -0,0 +1,8 @@
+import type { ProxyActivitySnapshot } from "../types/index.js";
+/** Track one client-facing proxy request until its response body settles. */
+export declare function beginProxyRequest(): () => void;
+export declare function getProxyActivitySnapshot(): ProxyActivitySnapshot;
+export declare function isProxyActivityQuiet(snapshot: ProxyActivitySnapshot, quietThresholdMs: number, nowMs?: number): boolean;
+/** Keep activity open until the response body completes, errors, or is cancelled. */
+export declare function trackProxyResponse(response: Response, finishRequest: () => void): Response;
+export declare function resetProxyActivityForTests(): void;

package/dist/proxy/proxyActivity.js

@@ -0,0 +1,76 @@
+let activeRequests = 0;
+let lastActivityAtMs = null;
+function touchActivity() {
+    lastActivityAtMs = Date.now();
+}
+/** Track one client-facing proxy request until its response body settles. */
+export function beginProxyRequest() {
+    activeRequests += 1;
+    touchActivity();
+    let finished = false;
+    return () => {
+        if (finished) {
+            return;
+        }
+        finished = true;
+        activeRequests = Math.max(0, activeRequests - 1);
+        touchActivity();
+    };
+}
+export function getProxyActivitySnapshot() {
+    return {
+        activeRequests,
+        lastActivityAt: lastActivityAtMs === null ? null : new Date(lastActivityAtMs),
+    };
+}
+export function isProxyActivityQuiet(snapshot, quietThresholdMs, nowMs = Date.now()) {
+    if (snapshot.activeRequests > 0) {
+        return false;
+    }
+    if (snapshot.lastActivityAt === null) {
+        return true;
+    }
+    return nowMs - snapshot.lastActivityAt.getTime() >= quietThresholdMs;
+}
+/** Keep activity open until the response body completes, errors, or is cancelled. */
+export function trackProxyResponse(response, finishRequest) {
+    if (!response.body) {
+        finishRequest();
+        return response;
+    }
+    const reader = response.body.getReader();
+    const trackedBody = new ReadableStream({
+        async pull(controller) {
+            try {
+                const { value, done } = await reader.read();
+                if (done) {
+                    finishRequest();
+                    controller.close();
+                    return;
+                }
+                controller.enqueue(value);
+            }
+            catch (error) {
+                finishRequest();
+                controller.error(error);
+            }
+        },
+        async cancel(reason) {
+            try {
+                await reader.cancel(reason);
+            }
+            finally {
+                finishRequest();
+            }
+        },
+    });
+    return new Response(trackedBody, {
+        status: response.status,
+        statusText: response.statusText,
+        headers: response.headers,
+    });
+}
+export function resetProxyActivityForTests() {
+    activeRequests = 0;
+    lastActivityAtMs = null;
+}

package/dist/server/routes/claudeProxyRoutes.d.ts

@@ -13,7 +13,7 @@ import { buildTranslationOptions } from "../../proxy/proxyTranslationEngine.js";
 import type { ModelRouter } from "../../proxy/modelRouter.js";
 import { ProxyTracer } from "../../proxy/proxyTracer.js";
 import { isPermanentRefreshFailure } from "../../proxy/tokenRefresh.js";
-import type { AccountAllowlist, AccountCooldownPlan, AccountQuota, AnthropicAttemptLogger, AnthropicAuthRetryResult, AnthropicLoopState, AnthropicSuccessResult, AnthropicUpstreamFetchResult, ClaudeFinalRequestLogger, ClaudeRequest, ParsedClaudeError, ProxyBodyCaptureLogger, ProxyPassthroughAccount, RouteGroup, RuntimeAccountState, ServerContext, StreamTerminalOutcome } from "../../types/index.js";
+import type { AccountAllowlist, AccountCooldownPlan, AccountQuota, AnthropicAttemptLogger, AnthropicAuthRetryResult, AnthropicLoopState, AnthropicSuccessResult, AnthropicUpstreamFetchResult, ClaudeFinalRequestLogger, ClaudeLoggedErrorBuilder, ClaudeRequest, ParsedClaudeError, ProxyBodyCaptureLogger, ProxyPassthroughAccount, RouteGroup, RuntimeAccountState, ServerContext, StreamTerminalOutcome } from "../../types/index.js";
 /** Resolve the configured primary's stable key to its current index in the
  *  request's enabledAccounts list. Returns 0 (insertion-order fallback) when
  *  no key is configured or the key cannot be matched (account disabled/
@@ -62,17 +62,24 @@ declare function planCooldownFor429(quota: AccountQuota | null, retryAfterMs: nu
 declare function seedRuntimeQuotasFromDisk(accounts: ProxyPassthroughAccount[]): Promise<void>;
 /**
  * Order accounts to MAXIMIZE quota utilization (fill-first, smart order):
- * spend the account whose window refreshes SOONEST first, so its about-to-reset
+ * spend the window that expires SOONEST first, so its about-to-reset
  * allowance isn't wasted, then move to accounts with longer-dated resets.
  *
  * Priority among usable accounts:
  *   1. no quota data yet — probe first: one request reveals its windows and
  *      self-corrects the ordering. (Ranking unknowns last would starve them
  *      forever: never picked → never observed → never comparable.)
- *   2. soonest WEEKLY (7d) reset  — the scarce, use-it-or-lose-it ceiling
- *   3. soonest SESSION (5h) reset
- *   4. highest weekly utilization — finish off the one closest to done
- *   5. configured primary account, then insertion order
+ *   2. session headroom before session-saturated (>= soft limit or
+ *      "throttled") — saturated accounts then follow the same bucketed
+ *      session ordering below: soonest back in service first, weekly
+ *      deciding same-bucket ties.
+ *   3. soonest SESSION (5h) reset — the capacity expiring soonest; compared
+ *      in tolerance buckets so near-simultaneous resets count as equal.
+ *   4. soonest WEEKLY (7d) reset — decides between same-bucket sessions.
+ *   5. highest weekly utilization — finish off the one closest to done
+ *   6. configured primary account, then insertion order
+ * An account with NO ticking session window (fresh, not yet started) has
+ * nothing expiring and sorts after ticking windows in step 3.
  * Cooling/rejected accounts sort last, soonest-back-to-service first, as
  * last resort.
  */
@@ -81,6 +88,47 @@ declare function trackUpstreamReadableStream(source: ReadableStream<Uint8Array>)
     stream: ReadableStream<Uint8Array>;
     outcome: Promise<StreamTerminalOutcome>;
 };
+declare function executeClaudeFallbackTranslation(args: {
+    ctx: ServerContext;
+    body: ClaudeRequest;
+    tracer?: ProxyTracer;
+    requestStartTime: number;
+    logProxyBody: ProxyBodyCaptureLogger;
+    logFinalRequest: (status: number, accountLabel: string, accountType: string, errorType?: string, errorMessage?: string, extra?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        cacheCreationTokens?: number;
+        cacheReadTokens?: number;
+    }) => void;
+    options: Parameters<ServerContext["neurolink"]["stream"]>[0];
+    providerLabel: string;
+}): Promise<unknown>;
+declare function executeClaudeFallbackWithRetry(args: Parameters<typeof executeClaudeFallbackTranslation>[0]): Promise<unknown>;
+declare function buildClaudeAnthropicFailureResponse(args: {
+    tracer?: ProxyTracer;
+    requestStartTime: number;
+    authFailureMessage: string | null;
+    authCooldownMessage: string | null;
+    invalidRequestFailure: {
+        status: number;
+        body: string;
+        contentType?: string;
+    } | null;
+    sawNetworkError: boolean;
+    sawTransientFailure: boolean;
+    sawRateLimit: boolean;
+    lastError: unknown;
+    fallbackFailureMessage?: string;
+    orderedAccounts: ProxyPassthroughAccount[];
+    buildLoggedClaudeError: ClaudeLoggedErrorBuilder;
+    logProxyBody: ProxyBodyCaptureLogger;
+    logFinalRequest: (status: number, accountLabel: string, accountType: string, errorType?: string, errorMessage?: string, extra?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        cacheCreationTokens?: number;
+        cacheReadTokens?: number;
+    }) => void;
+}): unknown;
 declare function handleAnthropicStreamingSuccessResponse(args: {
     ctx: ServerContext;
     body: ClaudeRequest;
@@ -249,5 +297,7 @@ export declare const __testHooks: {
     waitForTransientAccountAvailability: typeof waitForTransientAccountAvailability;
     describeTransportError: typeof describeTransportError;
     shouldAttemptClaudeFallback: typeof shouldAttemptClaudeFallback;
+    executeClaudeFallbackWithRetry: typeof executeClaudeFallbackWithRetry;
+    buildClaudeAnthropicFailureResponse: typeof buildClaudeAnthropicFailureResponse;
 };
 export {};