opencode-cursor-proxy 1.0.1

package/dist/lib/utils/fetch.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Fetch Utilities with Retry Support
+ *
+ * Provides robust HTTP request handling with:
+ * - Exponential backoff retry
+ * - Timeout support
+ * - Transient error detection
+ * - Request/response logging
+ */
+import { type Logger } from "./logger";
+export interface RetryOptions {
+    /** Maximum number of retry attempts (default: from config) */
+    maxRetries?: number;
+    /** Base delay for exponential backoff in ms (default: from config) */
+    baseDelayMs?: number;
+    /** Maximum delay between retries in ms (default: from config) */
+    maxDelayMs?: number;
+    /** Request timeout in ms (default: from config) */
+    timeoutMs?: number;
+    /** Custom retry condition (default: retry on 5xx and network errors) */
+    shouldRetry?: (error: Error, attempt: number, response?: Response) => boolean;
+    /** Logger instance for this request */
+    logger?: Logger;
+}
+export interface FetchWithRetryResult {
+    response: Response;
+    attempts: number;
+    totalTimeMs: number;
+}
+export declare class FetchTimeoutError extends Error {
+    constructor(timeoutMs: number);
+}
+export declare class FetchRetryExhaustedError extends Error {
+    lastError: Error;
+    attempts: number;
+    constructor(lastError: Error, attempts: number);
+}
+/**
+ * Sleep for a specified duration
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Calculate delay with exponential backoff and jitter
+ */
+export declare function calculateBackoffDelay(attempt: number, baseDelayMs: number, maxDelayMs: number): number;
+/**
+ * Check if an error is a transient network error that should be retried
+ */
+export declare function isTransientError(error: Error): boolean;
+/**
+ * Check if a response status code indicates a retryable error
+ */
+export declare function isRetryableStatus(status: number): boolean;
+/**
+ * Default retry condition
+ */
+export declare function defaultShouldRetry(error: Error, _attempt: number, response?: Response): boolean;
+/**
+ * Fetch with automatic retry and timeout support
+ *
+ * @example
+ * ```ts
+ * // Basic usage
+ * const { response } = await fetchWithRetry("https://api.example.com/data");
+ *
+ * // With options
+ * const { response, attempts } = await fetchWithRetry("https://api.example.com/data", {
+ *   method: "POST",
+ *   body: JSON.stringify({ data: "value" }),
+ * }, {
+ *   maxRetries: 5,
+ *   timeoutMs: 30000,
+ * });
+ * ```
+ */
+export declare function fetchWithRetry(input: string | URL | Request, init?: RequestInit, options?: RetryOptions): Promise<FetchWithRetryResult>;
+/**
+ * Simple fetch wrapper that respects retry config but returns just the Response
+ */
+export declare function robustFetch(input: string | URL | Request, init?: RequestInit, options?: RetryOptions): Promise<Response>;
+/**
+ * Fetch JSON with retry support
+ */
+export declare function fetchJson<T>(input: string | URL | Request, init?: RequestInit, options?: RetryOptions): Promise<T>;

package/dist/lib/utils/fetch.js

@@ -0,0 +1,261 @@
+/**
+ * Fetch Utilities with Retry Support
+ *
+ * Provides robust HTTP request handling with:
+ * - Exponential backoff retry
+ * - Timeout support
+ * - Transient error detection
+ * - Request/response logging
+ */
+import { config } from "../config";
+import { createLogger, createTimer } from "./logger";
+const logger = createLogger("fetch");
+// --- Error Types ---
+export class FetchTimeoutError extends Error {
+    constructor(timeoutMs) {
+        super(`Request timed out after ${timeoutMs}ms`);
+        this.name = "FetchTimeoutError";
+    }
+}
+export class FetchRetryExhaustedError extends Error {
+    lastError;
+    attempts;
+    constructor(lastError, attempts) {
+        super(`Request failed after ${attempts} attempts: ${lastError.message}`);
+        this.name = "FetchRetryExhaustedError";
+        this.lastError = lastError;
+        this.attempts = attempts;
+    }
+}
+// --- Utility Functions ---
+/**
+ * Sleep for a specified duration
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Calculate delay with exponential backoff and jitter
+ */
+export function calculateBackoffDelay(attempt, baseDelayMs, maxDelayMs) {
+    // Exponential backoff: baseDelay * 2^attempt
+    const exponentialDelay = baseDelayMs * Math.pow(2, attempt);
+    // Add jitter (0-25% of delay)
+    const jitter = exponentialDelay * Math.random() * 0.25;
+    // Cap at max delay
+    return Math.min(exponentialDelay + jitter, maxDelayMs);
+}
+/**
+ * Check if an error is a transient network error that should be retried
+ */
+export function isTransientError(error) {
+    const transientCodes = [
+        "ECONNRESET",
+        "ECONNREFUSED",
+        "ETIMEDOUT",
+        "ENOTFOUND",
+        "EAI_AGAIN",
+        "EPIPE",
+        "EHOSTUNREACH",
+        "ENETUNREACH",
+    ];
+    const message = error.message.toLowerCase();
+    const name = error.name;
+    // Check for known transient error codes
+    if (transientCodes.some((code) => message.includes(code.toLowerCase()))) {
+        return true;
+    }
+    // Check for fetch-specific errors
+    if (name === "FetchError" || name === "AbortError") {
+        return true;
+    }
+    // Check for timeout
+    if (name === "FetchTimeoutError") {
+        return true;
+    }
+    return false;
+}
+/**
+ * Check if a response status code indicates a retryable error
+ */
+export function isRetryableStatus(status) {
+    // Retry on server errors (5xx) except 501 (Not Implemented)
+    if (status >= 500 && status !== 501) {
+        return true;
+    }
+    // Retry on rate limiting
+    if (status === 429) {
+        return true;
+    }
+    // Retry on request timeout
+    if (status === 408) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Default retry condition
+ */
+export function defaultShouldRetry(error, _attempt, response) {
+    // Always retry transient network errors
+    if (isTransientError(error)) {
+        return true;
+    }
+    // Retry on retryable status codes
+    if (response && isRetryableStatus(response.status)) {
+        return true;
+    }
+    return false;
+}
+// --- Main Fetch Function ---
+/**
+ * Fetch with automatic retry and timeout support
+ *
+ * @example
+ * ```ts
+ * // Basic usage
+ * const { response } = await fetchWithRetry("https://api.example.com/data");
+ *
+ * // With options
+ * const { response, attempts } = await fetchWithRetry("https://api.example.com/data", {
+ *   method: "POST",
+ *   body: JSON.stringify({ data: "value" }),
+ * }, {
+ *   maxRetries: 5,
+ *   timeoutMs: 30000,
+ * });
+ * ```
+ */
+export async function fetchWithRetry(input, init, options) {
+    const { maxRetries = config.network.maxRetries, baseDelayMs = config.network.retryBaseDelayMs, maxDelayMs = config.network.retryMaxDelayMs, timeoutMs = config.network.requestTimeoutMs, shouldRetry = defaultShouldRetry, logger: requestLogger = logger, } = options ?? {};
+    const url = typeof input === "string" ? input : input instanceof URL ? input.toString() : input.url;
+    const method = init?.method ?? "GET";
+    const timer = createTimer();
+    let lastError = new Error("No attempts made");
+    let lastResponse;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            requestLogger.debug(`Attempt ${attempt + 1}/${maxRetries + 1}`, {
+                method,
+                url: url.substring(0, 100),
+            });
+            const response = await fetch(input, {
+                ...init,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            // Success - return immediately
+            if (response.ok) {
+                requestLogger.debug(`Request succeeded`, {
+                    method,
+                    status: response.status,
+                    attempts: attempt + 1,
+                    durationMs: timer(),
+                });
+                return {
+                    response,
+                    attempts: attempt + 1,
+                    totalTimeMs: timer(),
+                };
+            }
+            // Non-OK response - check if retryable
+            lastResponse = response;
+            lastError = new Error(`HTTP ${response.status}: ${response.statusText}`);
+            if (!shouldRetry(lastError, attempt, response) || attempt === maxRetries) {
+                // Don't retry - return the response as-is
+                requestLogger.debug(`Request returned non-OK status`, {
+                    method,
+                    status: response.status,
+                    attempts: attempt + 1,
+                    willRetry: false,
+                });
+                return {
+                    response,
+                    attempts: attempt + 1,
+                    totalTimeMs: timer(),
+                };
+            }
+            // Will retry - log and continue
+            requestLogger.warn(`Request failed, will retry`, {
+                method,
+                status: response.status,
+                attempt: attempt + 1,
+                maxRetries,
+            });
+        }
+        catch (err) {
+            clearTimeout(timeoutId);
+            // Handle abort (timeout)
+            if (err instanceof Error && err.name === "AbortError") {
+                lastError = new FetchTimeoutError(timeoutMs);
+            }
+            else {
+                lastError = err instanceof Error ? err : new Error(String(err));
+            }
+            // Check if should retry
+            if (!shouldRetry(lastError, attempt, undefined) || attempt === maxRetries) {
+                requestLogger.error(`Request failed`, {
+                    method,
+                    error: lastError.message,
+                    attempts: attempt + 1,
+                    willRetry: false,
+                });
+                throw new FetchRetryExhaustedError(lastError, attempt + 1);
+            }
+            requestLogger.warn(`Request error, will retry`, {
+                method,
+                error: lastError.message,
+                attempt: attempt + 1,
+                maxRetries,
+            });
+        }
+        // Calculate and wait for backoff delay
+        if (attempt < maxRetries) {
+            const delay = calculateBackoffDelay(attempt, baseDelayMs, maxDelayMs);
+            requestLogger.debug(`Waiting before retry`, { delayMs: Math.round(delay) });
+            await sleep(delay);
+        }
+    }
+    // Should not reach here, but just in case
+    throw new FetchRetryExhaustedError(lastError, maxRetries + 1);
+}
+// --- Convenience Functions ---
+/**
+ * Simple fetch wrapper that respects retry config but returns just the Response
+ */
+export async function robustFetch(input, init, options) {
+    if (!config.network.retryEnabled) {
+        // Retry disabled - use standard fetch with timeout only
+        const timeoutMs = options?.timeoutMs ?? config.network.requestTimeoutMs;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const response = await fetch(input, { ...init, signal: controller.signal });
+            clearTimeout(timeoutId);
+            return response;
+        }
+        catch (err) {
+            clearTimeout(timeoutId);
+            if (err instanceof Error && err.name === "AbortError") {
+                throw new FetchTimeoutError(timeoutMs);
+            }
+            throw err;
+        }
+    }
+    const { response } = await fetchWithRetry(input, init, options);
+    return response;
+}
+/**
+ * Fetch JSON with retry support
+ */
+export async function fetchJson(input, init, options) {
+    const response = await robustFetch(input, init, options);
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`HTTP ${response.status}: ${text}`);
+    }
+    return response.json();
+}
+//# sourceMappingURL=fetch.js.map

package/dist/lib/utils/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../../src/lib/utils/fetch.ts"],"names":[],"mappings":"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"}

package/dist/lib/utils/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Utilities Module Index
+ *
+ * Re-exports all utility modules for convenient importing.
+ */
+export * from "./jwt";
+export * from "./tokenizer";
+export * from "./logger";
+export * from "./fetch";
+export * from "./cache";
+export * from "./model-resolver";
+export * from "./request-pool";
+export * from "./request-transformer";

package/dist/lib/utils/index.js

@@ -0,0 +1,22 @@
+/**
+ * Utilities Module Index
+ *
+ * Re-exports all utility modules for convenient importing.
+ */
+// JWT utilities
+export * from "./jwt";
+// Tokenizer utilities
+export * from "./tokenizer";
+// Logger utilities
+export * from "./logger";
+// Fetch utilities with retry
+export * from "./fetch";
+// Cache utilities
+export * from "./cache";
+// Model resolver utilities
+export * from "./model-resolver";
+// Request pool utilities
+export * from "./request-pool";
+// Request transformer utilities
+export * from "./request-transformer";
+//# sourceMappingURL=index.js.map

package/dist/lib/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gBAAgB;AAChB,cAAc,OAAO,CAAC;AAEtB,sBAAsB;AACtB,cAAc,aAAa,CAAC;AAE5B,mBAAmB;AACnB,cAAc,UAAU,CAAC;AAEzB,6BAA6B;AAC7B,cAAc,SAAS,CAAC;AAExB,kBAAkB;AAClB,cAAc,SAAS,CAAC;AAExB,2BAA2B;AAC3B,cAAc,kBAAkB,CAAC;AAEjC,yBAAyB;AACzB,cAAc,gBAAgB,CAAC;AAE/B,gCAAgC;AAChC,cAAc,uBAAuB,CAAC"}

package/dist/lib/utils/jwt.d.ts

@@ -0,0 +1,40 @@
+/**
+ * JWT Utilities
+ *
+ * Provides functions for decoding and validating JWT tokens.
+ * NOTE: These functions do NOT verify signatures - they are for
+ * expiration checking and display purposes only.
+ */
+export interface JwtPayload {
+    sub?: string;
+    exp?: number;
+    iat?: number;
+    [key: string]: unknown;
+}
+/**
+ * Decode JWT payload without signature verification.
+ * ONLY for expiration checking and display purposes.
+ */
+export declare function decodeJwtPayload(token: string): JwtPayload | null;
+/**
+ * Check if a token is expiring soon (within threshold seconds).
+ * Default threshold is 5 minutes (300 seconds).
+ */
+export declare function isTokenExpiringSoon(token: string, thresholdSeconds?: number): boolean;
+/**
+ * Check if a token has expired.
+ */
+export declare function isTokenExpired(token: string): boolean;
+/**
+ * Get the time remaining until token expiration in seconds.
+ * Returns negative value if expired.
+ */
+export declare function getTokenTimeRemaining(token: string): number;
+/**
+ * Format seconds into human-readable duration.
+ */
+export declare function formatDuration(seconds: number): string;
+/**
+ * Mask sensitive token data for display.
+ */
+export declare function maskToken(token: string | undefined): string;

package/dist/lib/utils/jwt.js

@@ -0,0 +1,102 @@
+/**
+ * JWT Utilities
+ *
+ * Provides functions for decoding and validating JWT tokens.
+ * NOTE: These functions do NOT verify signatures - they are for
+ * expiration checking and display purposes only.
+ */
+/**
+ * Decode JWT payload without signature verification.
+ * ONLY for expiration checking and display purposes.
+ */
+export function decodeJwtPayload(token) {
+    try {
+        const parts = token.split(".");
+        if (parts.length !== 3)
+            return null;
+        const base64Payload = parts[1];
+        if (!base64Payload)
+            return null;
+        // Handle base64url encoding
+        const base64 = base64Payload.replace(/-/g, "+").replace(/_/g, "/");
+        const payloadBuffer = Buffer.from(base64, "base64");
+        return JSON.parse(payloadBuffer.toString("utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if a token is expiring soon (within threshold seconds).
+ * Default threshold is 5 minutes (300 seconds).
+ */
+export function isTokenExpiringSoon(token, thresholdSeconds = 300) {
+    try {
+        const decoded = decodeJwtPayload(token);
+        if (!decoded || typeof decoded.exp !== "number")
+            return true;
+        const currentTime = Math.floor(Date.now() / 1000);
+        const expirationTime = decoded.exp;
+        const timeLeft = expirationTime - currentTime;
+        return timeLeft < thresholdSeconds;
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Check if a token has expired.
+ */
+export function isTokenExpired(token) {
+    try {
+        const decoded = decodeJwtPayload(token);
+        if (!decoded || typeof decoded.exp !== "number")
+            return true;
+        const currentTime = Math.floor(Date.now() / 1000);
+        return decoded.exp < currentTime;
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Get the time remaining until token expiration in seconds.
+ * Returns negative value if expired.
+ */
+export function getTokenTimeRemaining(token) {
+    try {
+        const decoded = decodeJwtPayload(token);
+        if (!decoded || typeof decoded.exp !== "number")
+            return -1;
+        const currentTime = Math.floor(Date.now() / 1000);
+        return decoded.exp - currentTime;
+    }
+    catch {
+        return -1;
+    }
+}
+/**
+ * Format seconds into human-readable duration.
+ */
+export function formatDuration(seconds) {
+    if (seconds < 0)
+        return "expired";
+    if (seconds < 60)
+        return `${seconds}s`;
+    if (seconds < 3600)
+        return `${Math.floor(seconds / 60)}m ${seconds % 60}s`;
+    const hours = Math.floor(seconds / 3600);
+    const mins = Math.floor((seconds % 3600) / 60);
+    return `${hours}h ${mins}m`;
+}
+/**
+ * Mask sensitive token data for display.
+ */
+export function maskToken(token) {
+    if (!token)
+        return "(not set)";
+    if (token.length < 20)
+        return "***";
+    return `${token.substring(0, 10)}...${token.substring(token.length - 10)}`;
+}
+//# sourceMappingURL=jwt.js.map

package/dist/lib/utils/jwt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.js","sourceRoot":"","sources":["../../../src/lib/utils/jwt.ts"],"names":[],"mappings":"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"}

package/dist/lib/utils/logger.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Structured Logger Module
+ *
+ * Provides consistent logging across the application with:
+ * - Log levels (error, warn, info, debug)
+ * - Structured metadata
+ * - Optional JSON output
+ * - Child loggers with context
+ */
+export type LogLevel = "error" | "warn" | "info" | "debug";
+export interface LogMeta {
+    [key: string]: unknown;
+}
+export interface Logger {
+    error(message: string, meta?: LogMeta): void;
+    warn(message: string, meta?: LogMeta): void;
+    info(message: string, meta?: LogMeta): void;
+    debug(message: string, meta?: LogMeta): void;
+    child(bindings: LogMeta): Logger;
+    timing(label: string, durationMs: number, meta?: LogMeta): void;
+}
+/**
+ * Create a new logger instance
+ */
+export declare function createLogger(name?: string, bindings?: LogMeta): Logger;
+/**
+ * Create a child logger with additional context
+ */
+export declare function createChildLogger(parent: Logger, bindings: LogMeta): Logger;
+/**
+ * Default logger instance for general use
+ */
+export declare const logger: Logger;
+/**
+ * Logger for API operations
+ */
+export declare const apiLogger: Logger;
+/**
+ * Logger for authentication operations
+ */
+export declare const authLogger: Logger;
+/**
+ * Logger for OpenAI compatibility layer
+ */
+export declare const openaiLogger: Logger;
+/**
+ * Logger for session management
+ */
+export declare const sessionLogger: Logger;
+/**
+ * Logger for request transformation
+ */
+export declare const transformLogger: Logger;
+export interface TransformLogData {
+    originalCount: number;
+    filteredCount: number;
+    itemReferencesFiltered: number;
+    idsStripped: number;
+    strippedIds?: string[];
+}
+/**
+ * Log request transformation statistics
+ * Only logs when CURSOR_LOG_FILTERED_IDS or CURSOR_DEBUG is enabled
+ */
+export declare function logRequestTransform(data: TransformLogData): void;
+export interface MultimodalLogData {
+    messageIndex: number;
+    imageCount: number;
+    hasBase64: boolean;
+    modelSupportsVision: boolean;
+}
+/**
+ * Log multimodal content detection
+ * Only logs when CURSOR_LOG_MULTIMODAL or CURSOR_DEBUG is enabled
+ */
+export declare function logMultimodalContent(data: MultimodalLogData): void;
+/**
+ * Log incoming request details
+ * Only logs when CURSOR_REQUEST_LOGGING or CURSOR_DEBUG is enabled
+ */
+export declare function logRequest(method: string, path: string, body?: {
+    model?: string;
+    messageCount?: number;
+    hasTools?: boolean;
+    stream?: boolean;
+}): void;
+/**
+ * Log response details
+ * Only logs when CURSOR_REQUEST_LOGGING or CURSOR_DEBUG is enabled
+ */
+export declare function logResponse(status: number, durationMs: number, details?: {
+    model?: string;
+    finishReason?: string;
+    tokenUsage?: {
+        prompt: number;
+        completion: number;
+        total: number;
+    };
+}): void;
+/**
+ * Create a timer for measuring operation duration
+ */
+export declare function createTimer(): () => number;
+/**
+ * Measure and log the duration of an async operation
+ */
+export declare function withTiming<T>(logger: Logger, label: string, operation: () => Promise<T>, meta?: LogMeta): Promise<T>;