opencode-cursor-proxy 1.0.1

package/dist/lib/config.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Centralized Configuration Module
+ *
+ * All configuration values should be defined here for easy management.
+ * Environment variables are read once at module load time.
+ */
+export declare const config: {
+    /**
+     * Debug and logging settings
+     */
+    readonly debug: {
+        /** Enable verbose debug logging */
+        readonly enabled: boolean;
+        /** Enable performance timing logs */
+        readonly timing: boolean;
+        /** Log level: error, warn, info, debug */
+        readonly level: "error" | "warn" | "info" | "debug";
+        /** Enable request/response logging for debugging */
+        readonly requestLogging: boolean;
+        /** Log filtered IDs and item_references during request transformation */
+        readonly logFilteredIds: boolean;
+        /** Log multimodal content detection */
+        readonly logMultimodal: boolean;
+        /** Output logs in JSON format */
+        readonly jsonFormat: boolean;
+    };
+    /**
+     * Session management settings
+     */
+    readonly session: {
+        /** Enable session reuse for tool calling */
+        readonly reuseEnabled: boolean;
+        /** Session timeout in milliseconds */
+        readonly timeoutMs: number;
+        /** Maximum number of cached sessions */
+        readonly maxSessions: number;
+    };
+    /**
+     * Cache settings
+     */
+    readonly cache: {
+        /** Model cache TTL in milliseconds */
+        readonly modelTtlMs: number;
+        /** Maximum number of cached blobs */
+        readonly maxBlobs: number;
+        /** Maximum blob size in bytes */
+        readonly maxBlobSize: number;
+    };
+    /**
+     * Network request settings
+     */
+    readonly network: {
+        /** Request timeout in milliseconds */
+        readonly requestTimeoutMs: number;
+        /** Maximum retry attempts for failed requests */
+        readonly maxRetries: number;
+        /** Base delay for exponential backoff in milliseconds */
+        readonly retryBaseDelayMs: number;
+        /** Maximum delay between retries in milliseconds */
+        readonly retryMaxDelayMs: number;
+        /** Enable automatic retry on transient errors */
+        readonly retryEnabled: boolean;
+    };
+    /**
+     * Heartbeat detection settings
+     */
+    readonly heartbeat: {
+        /** Idle timeout after progress in milliseconds */
+        readonly idleAfterProgressMs: number;
+        /** Idle timeout before progress in milliseconds */
+        readonly idleBeforeProgressMs: number;
+        /** Maximum heartbeats allowed after progress */
+        readonly maxAfterProgress: number;
+        /** Maximum heartbeats allowed before progress */
+        readonly maxBeforeProgress: number;
+    };
+    /**
+     * Server settings (for standalone proxy)
+     */
+    readonly server: {
+        /** Server port */
+        readonly port: number;
+        /** Server host */
+        readonly host: string;
+    };
+    /**
+     * Cursor API settings
+     */
+    readonly api: {
+        /** Main API base URL */
+        readonly baseUrl: string;
+        /** Agent privacy mode URL */
+        readonly agentPrivacyUrl: string;
+        /** Agent non-privacy mode URL */
+        readonly agentNonPrivacyUrl: string;
+        /** Enable privacy mode */
+        readonly privacyMode: boolean;
+        /** Try API5 fallback endpoints */
+        readonly tryApi5Fallback: boolean;
+        /** Client version override */
+        readonly clientVersion: string;
+    };
+    /**
+     * Security settings
+     */
+    readonly security: {
+        /** Enable shell command validation */
+        readonly validateShellCommands: boolean;
+        /** Maximum shell command execution time in milliseconds */
+        readonly shellTimeoutMs: number;
+    };
+};
+export type Config = typeof config;
+export type DebugConfig = typeof config.debug;
+export type SessionConfig = typeof config.session;
+export type CacheConfig = typeof config.cache;
+export type NetworkConfig = typeof config.network;
+export type HeartbeatConfig = typeof config.heartbeat;
+export type ServerConfig = typeof config.server;
+export type ApiConfig = typeof config.api;
+export type SecurityConfig = typeof config.security;
+/**
+ * Check if debug mode is enabled
+ */
+export declare function isDebugEnabled(): boolean;
+/**
+ * Check if timing logs are enabled
+ */
+export declare function isTimingEnabled(): boolean;
+/**
+ * Check if session reuse is enabled
+ */
+export declare function isSessionReuseEnabled(): boolean;
+/**
+ * Get the effective log level
+ */
+export declare function getLogLevel(): "error" | "warn" | "info" | "debug";
+/**
+ * Check if request logging is enabled
+ */
+export declare function isRequestLoggingEnabled(): boolean;
+/**
+ * Check if filtered IDs should be logged
+ */
+export declare function shouldLogFilteredIds(): boolean;
+/**
+ * Check if multimodal content should be logged
+ */
+export declare function shouldLogMultimodal(): boolean;
+/**
+ * Check if JSON log format is enabled
+ */
+export declare function isJsonLogFormat(): boolean;

package/dist/lib/config.js

@@ -0,0 +1,182 @@
+/**
+ * Centralized Configuration Module
+ *
+ * All configuration values should be defined here for easy management.
+ * Environment variables are read once at module load time.
+ */
+// --- Environment Variable Helpers ---
+function envBool(key, defaultValue) {
+    const value = process.env[key];
+    if (value === undefined)
+        return defaultValue;
+    return value === "1" || value.toLowerCase() === "true";
+}
+function envInt(key, defaultValue) {
+    const value = process.env[key];
+    if (value === undefined)
+        return defaultValue;
+    const parsed = parseInt(value, 10);
+    return isNaN(parsed) ? defaultValue : parsed;
+}
+function envString(key, defaultValue) {
+    return process.env[key] ?? defaultValue;
+}
+// --- Configuration Object ---
+export const config = {
+    /**
+     * Debug and logging settings
+     */
+    debug: {
+        /** Enable verbose debug logging */
+        enabled: envBool("CURSOR_DEBUG", false),
+        /** Enable performance timing logs */
+        timing: envBool("CURSOR_TIMING", false),
+        /** Log level: error, warn, info, debug */
+        level: envString("CURSOR_LOG_LEVEL", "info"),
+        /** Enable request/response logging for debugging */
+        requestLogging: envBool("CURSOR_REQUEST_LOGGING", false),
+        /** Log filtered IDs and item_references during request transformation */
+        logFilteredIds: envBool("CURSOR_LOG_FILTERED_IDS", false),
+        /** Log multimodal content detection */
+        logMultimodal: envBool("CURSOR_LOG_MULTIMODAL", false),
+        /** Output logs in JSON format */
+        jsonFormat: envBool("CURSOR_LOG_JSON", false),
+    },
+    /**
+     * Session management settings
+     */
+    session: {
+        /** Enable session reuse for tool calling */
+        reuseEnabled: envBool("CURSOR_SESSION_REUSE", true),
+        /** Session timeout in milliseconds */
+        timeoutMs: envInt("CURSOR_SESSION_TIMEOUT_MS", 15 * 60 * 1000),
+        /** Maximum number of cached sessions */
+        maxSessions: envInt("CURSOR_MAX_SESSIONS", 100),
+    },
+    /**
+     * Cache settings
+     */
+    cache: {
+        /** Model cache TTL in milliseconds */
+        modelTtlMs: envInt("CURSOR_MODEL_CACHE_TTL_MS", 5 * 60 * 1000),
+        /** Maximum number of cached blobs */
+        maxBlobs: envInt("CURSOR_MAX_BLOBS", 1000),
+        /** Maximum blob size in bytes */
+        maxBlobSize: envInt("CURSOR_MAX_BLOB_SIZE", 10 * 1024 * 1024),
+    },
+    /**
+     * Network request settings
+     */
+    network: {
+        /** Request timeout in milliseconds */
+        requestTimeoutMs: envInt("CURSOR_REQUEST_TIMEOUT_MS", 120000),
+        /** Maximum retry attempts for failed requests */
+        maxRetries: envInt("CURSOR_MAX_RETRIES", 3),
+        /** Base delay for exponential backoff in milliseconds */
+        retryBaseDelayMs: envInt("CURSOR_RETRY_BASE_DELAY_MS", 1000),
+        /** Maximum delay between retries in milliseconds */
+        retryMaxDelayMs: envInt("CURSOR_RETRY_MAX_DELAY_MS", 30000),
+        /** Enable automatic retry on transient errors */
+        retryEnabled: envBool("CURSOR_RETRY_ENABLED", true),
+    },
+    /**
+     * Heartbeat detection settings
+     */
+    heartbeat: {
+        /** Idle timeout after progress in milliseconds */
+        idleAfterProgressMs: envInt("CURSOR_HEARTBEAT_IDLE_PROGRESS_MS", 120000),
+        /** Idle timeout before progress in milliseconds */
+        idleBeforeProgressMs: envInt("CURSOR_HEARTBEAT_IDLE_NOPROGRESS_MS", 180000),
+        /** Maximum heartbeats allowed after progress */
+        maxAfterProgress: envInt("CURSOR_HEARTBEAT_MAX_PROGRESS", 1000),
+        /** Maximum heartbeats allowed before progress */
+        maxBeforeProgress: envInt("CURSOR_HEARTBEAT_MAX_NOPROGRESS", 1000),
+    },
+    /**
+     * Server settings (for standalone proxy)
+     */
+    server: {
+        /** Server port */
+        port: envInt("PORT", 18741),
+        /** Server host */
+        host: envString("HOST", "localhost"),
+    },
+    /**
+     * Cursor API settings
+     */
+    api: {
+        /** Main API base URL */
+        baseUrl: envString("CURSOR_API_URL", "https://api2.cursor.sh"),
+        /** Agent privacy mode URL */
+        agentPrivacyUrl: envString("CURSOR_AGENT_PRIVACY_URL", "https://agent.api5.cursor.sh"),
+        /** Agent non-privacy mode URL */
+        agentNonPrivacyUrl: envString("CURSOR_AGENT_NON_PRIVACY_URL", "https://agentn.api5.cursor.sh"),
+        /** Enable privacy mode */
+        privacyMode: envBool("CURSOR_PRIVACY_MODE", true),
+        /** Try API5 fallback endpoints */
+        tryApi5Fallback: envBool("CURSOR_AGENT_TRY_API5", false),
+        /** Client version override */
+        clientVersion: envString("CURSOR_CLIENT_VERSION", ""),
+    },
+    /**
+     * Security settings
+     */
+    security: {
+        /** Enable shell command validation */
+        validateShellCommands: envBool("CURSOR_VALIDATE_SHELL", false),
+        /** Maximum shell command execution time in milliseconds */
+        shellTimeoutMs: envInt("CURSOR_SHELL_TIMEOUT_MS", 60000),
+    },
+};
+// --- Utility Functions ---
+/**
+ * Check if debug mode is enabled
+ */
+export function isDebugEnabled() {
+    return config.debug.enabled;
+}
+/**
+ * Check if timing logs are enabled
+ */
+export function isTimingEnabled() {
+    return config.debug.timing || config.debug.enabled;
+}
+/**
+ * Check if session reuse is enabled
+ */
+export function isSessionReuseEnabled() {
+    return config.session.reuseEnabled;
+}
+/**
+ * Get the effective log level
+ */
+export function getLogLevel() {
+    if (config.debug.enabled)
+        return "debug";
+    return config.debug.level;
+}
+/**
+ * Check if request logging is enabled
+ */
+export function isRequestLoggingEnabled() {
+    return config.debug.requestLogging || config.debug.enabled;
+}
+/**
+ * Check if filtered IDs should be logged
+ */
+export function shouldLogFilteredIds() {
+    return config.debug.logFilteredIds || config.debug.enabled;
+}
+/**
+ * Check if multimodal content should be logged
+ */
+export function shouldLogMultimodal() {
+    return config.debug.logMultimodal || config.debug.enabled;
+}
+/**
+ * Check if JSON log format is enabled
+ */
+export function isJsonLogFormat() {
+    return config.debug.jsonFormat;
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

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

package/dist/lib/openai-compat/handler.d.ts

@@ -0,0 +1,40 @@
+/**
+ * OpenAI-Compatible Request Handler
+ *
+ * Core request handling logic that can be used by both:
+ * - Plugin's custom fetch function (serverless)
+ * - Standalone server (Bun.serve)
+ */
+/**
+ * Options for the request handler
+ */
+export interface RequestHandlerOptions {
+    /** Access token for Cursor API */
+    accessToken: string;
+    /** Optional logger for debugging */
+    log?: (message: string, ...args: unknown[]) => void;
+}
+/**
+ * Create a request handler function that can be used with custom fetch
+ *
+ * @example
+ * ```ts
+ * const handler = createRequestHandler({ accessToken: "..." });
+ *
+ * // Use in plugin
+ * return {
+ *   fetch: (input, init) => handler(new Request(input, init)),
+ * };
+ *
+ * // Use in server
+ * Bun.serve({ fetch: handler });
+ * ```
+ */
+export declare function createRequestHandler(options: RequestHandlerOptions): (req: Request) => Promise<Response>;
+/**
+ * Create a custom fetch handler for use in OpenCode plugin
+ *
+ * This wraps createRequestHandler to match the FetchInput signature
+ * that OpenCode expects from plugins.
+ */
+export declare function createPluginFetch(options: RequestHandlerOptions): (input: string | URL | Request, init?: RequestInit) => Promise<Response>;