supersurf-daemon 1.0.0

package/dist/ipc.js

@@ -0,0 +1,192 @@
+"use strict";
+/**
+ * IPC Server — Unix socket server for MCP session connections.
+ *
+ * Accepts connections from MCP servers over a Unix domain socket.
+ * Protocol:
+ *   1. MCP server sends: { type: "session_register", sessionId: "..." }\n
+ *   2. Daemon responds: { type: "session_ack", browser: "...", buildTimestamp: "..." }\n
+ *      or { type: "session_reject", reason: "..." }\n
+ *   3. Post-handshake: NDJSON (newline-delimited JSON-RPC 2.0) for tool calls
+ *
+ * @module ipc
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IPCServer = void 0;
+const net_1 = __importDefault(require("net"));
+const debugLog = (...args) => {
+    const logger = global.DAEMON_LOGGER;
+    if (logger)
+        logger.log('[IPC]', ...args);
+    else if (global.DAEMON_DEBUG)
+        console.error('[IPC]', ...args);
+};
+/**
+ * Unix domain socket server for MCP session connections.
+ * Handles session handshake, NDJSON message routing, and cleanup.
+ */
+class IPCServer {
+    server = null;
+    socketPath;
+    bridge;
+    sessions;
+    scheduler;
+    onSessionCountChange = null;
+    constructor(socketPath, bridge, sessions, scheduler) {
+        this.socketPath = socketPath;
+        this.bridge = bridge;
+        this.sessions = sessions;
+        this.scheduler = scheduler;
+    }
+    /** Set a callback for session count changes (used by idle timeout). */
+    setSessionCountCallback(cb) {
+        this.onSessionCountChange = cb;
+    }
+    /** Start listening on the Unix socket. */
+    async start() {
+        return new Promise((resolve, reject) => {
+            this.server = net_1.default.createServer((socket) => this.handleConnection(socket));
+            this.server.on('error', (error) => {
+                debugLog('IPC server error:', error);
+                reject(error);
+            });
+            this.server.listen(this.socketPath, () => {
+                debugLog(`IPC listening on ${this.socketPath}`);
+                resolve();
+            });
+        });
+    }
+    /** Handle a new connection from an MCP server. */
+    handleConnection(socket) {
+        debugLog('New IPC connection');
+        let buffer = '';
+        let sessionId = null;
+        let handshakeComplete = false;
+        socket.on('data', (data) => {
+            buffer += data.toString();
+            let newlineIdx;
+            while ((newlineIdx = buffer.indexOf('\n')) !== -1) {
+                const line = buffer.slice(0, newlineIdx).trim();
+                buffer = buffer.slice(newlineIdx + 1);
+                if (!line)
+                    continue;
+                try {
+                    const msg = JSON.parse(line);
+                    if (!handshakeComplete) {
+                        // Expecting session_register handshake
+                        if (msg.type === 'session_register' && msg.sessionId) {
+                            sessionId = msg.sessionId;
+                            if (this.sessions.has(sessionId)) {
+                                this.sendLine(socket, {
+                                    type: 'session_reject',
+                                    reason: 'Session ID already in use',
+                                });
+                                socket.end();
+                                return;
+                            }
+                            // Register the session
+                            this.sessions.add(sessionId, socket);
+                            this.scheduler.addSession(sessionId);
+                            this.sendLine(socket, {
+                                type: 'session_ack',
+                                browser: this.bridge.browser,
+                                buildTimestamp: this.bridge.buildTime,
+                            });
+                            handshakeComplete = true;
+                            debugLog(`Session registered: "${sessionId}"`);
+                            if (this.onSessionCountChange) {
+                                this.onSessionCountChange(this.sessions.count);
+                            }
+                        }
+                        else {
+                            this.sendLine(socket, {
+                                type: 'session_reject',
+                                reason: 'Expected session_register handshake',
+                            });
+                            socket.end();
+                        }
+                    }
+                    else {
+                        // Post-handshake: JSON-RPC 2.0 requests
+                        this.handleRequest(sessionId, socket, msg);
+                    }
+                }
+                catch (err) {
+                    debugLog('Parse error:', err.message);
+                    if (handshakeComplete && sessionId) {
+                        this.sendLine(socket, {
+                            jsonrpc: '2.0',
+                            id: null,
+                            error: { code: -32700, message: `Parse error: ${err.message}` },
+                        });
+                    }
+                }
+            }
+        });
+        socket.on('close', () => {
+            if (sessionId) {
+                debugLog(`Session disconnected: "${sessionId}"`);
+                this.scheduler.removeSession(sessionId);
+                this.sessions.remove(sessionId);
+                // Notify extension to ungroup the session's tabs
+                this.bridge.sendCmd('sessionDisconnect', { sessionId }, 5000).catch(() => { });
+                if (this.onSessionCountChange) {
+                    this.onSessionCountChange(this.sessions.count);
+                }
+            }
+        });
+        socket.on('error', (error) => {
+            debugLog('Socket error:', error.message);
+        });
+    }
+    /** Route a JSON-RPC 2.0 request into the scheduler. */
+    async handleRequest(sessionId, socket, msg) {
+        if (msg.jsonrpc !== '2.0' || !msg.method || msg.id === undefined) {
+            this.sendLine(socket, {
+                jsonrpc: '2.0',
+                id: msg.id ?? null,
+                error: { code: -32600, message: 'Invalid JSON-RPC 2.0 request' },
+            });
+            return;
+        }
+        try {
+            const result = await this.scheduler.enqueue(sessionId, msg.method, msg.params || {}, msg.timeout || 30000);
+            this.sendLine(socket, { jsonrpc: '2.0', id: msg.id, result });
+        }
+        catch (error) {
+            this.sendLine(socket, {
+                jsonrpc: '2.0',
+                id: msg.id,
+                error: { code: -32000, message: error.message || String(error) },
+            });
+        }
+    }
+    /** Write an NDJSON line to a socket. */
+    sendLine(socket, data) {
+        if (!socket.writable)
+            return;
+        socket.write(JSON.stringify(data) + '\n');
+    }
+    /** Gracefully shut down the IPC server. */
+    async stop() {
+        return new Promise((resolve) => {
+            if (!this.server) {
+                resolve();
+                return;
+            }
+            // Close all session sockets
+            for (const session of this.sessions.values()) {
+                session.socket.end();
+            }
+            this.server.close(() => {
+                debugLog('IPC server stopped');
+                resolve();
+            });
+        });
+    }
+}
+exports.IPCServer = IPCServer;
+//# sourceMappingURL=ipc.js.map

package/dist/ipc.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+/**
+ * SuperSurf Daemon — standalone coordinator for multiple MCP sessions.
+ *
+ * Manages a single Chrome extension connection (WebSocket) and multiplexes
+ * tool calls from multiple MCP servers (Unix domain socket).
+ *
+ * Usage:
+ *   supersurf-daemon [--port <n>] [--debug]
+ *
+ * Files:
+ *   ~/.supersurf/daemon.pid   — PID file for process detection
+ *   ~/.supersurf/daemon.sock  — Unix domain socket for MCP server IPC
+ *   ~/.supersurf/logs/daemon.log — debug log (when --debug)
+ *
+ * @module main
+ */
+declare const SUPERSURF_DIR: string;
+declare const PID_FILE: string;
+declare const SOCK_FILE: string;
+declare const IDLE_TIMEOUT_MS: number;
+declare function parseArgs(argv: string[]): {
+    port: number;
+    debug: boolean;
+};
+/** Check if a process with the given PID is alive. */
+declare function isProcessAlive(pid: number): boolean;
+/** Clean stale PID/socket files if the referenced process is dead. */
+declare function cleanStaleFiles(): void;
+export { parseArgs, isProcessAlive, cleanStaleFiles, SUPERSURF_DIR, PID_FILE, SOCK_FILE, IDLE_TIMEOUT_MS };
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG;AAWH,QAAA,MAAM,aAAa,QAAwC,CAAC;AAC5D,QAAA,MAAM,QAAQ,QAAyC,CAAC;AACxD,QAAA,MAAM,SAAS,QAA0C,CAAC;AAE1D,QAAA,MAAM,eAAe,QAAiB,CAAC;AAIvC,iBAAS,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAkBnE;AAID,sDAAsD;AACtD,iBAAS,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO5C;AAED,sEAAsE;AACtE,iBAAS,eAAe,IAAI,IAAI,CAmB/B;AAiID,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC"}

package/dist/main.js

@@ -0,0 +1,224 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * SuperSurf Daemon — standalone coordinator for multiple MCP sessions.
+ *
+ * Manages a single Chrome extension connection (WebSocket) and multiplexes
+ * tool calls from multiple MCP servers (Unix domain socket).
+ *
+ * Usage:
+ *   supersurf-daemon [--port <n>] [--debug]
+ *
+ * Files:
+ *   ~/.supersurf/daemon.pid   — PID file for process detection
+ *   ~/.supersurf/daemon.sock  — Unix domain socket for MCP server IPC
+ *   ~/.supersurf/logs/daemon.log — debug log (when --debug)
+ *
+ * @module main
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IDLE_TIMEOUT_MS = exports.SOCK_FILE = exports.PID_FILE = exports.SUPERSURF_DIR = void 0;
+exports.parseArgs = parseArgs;
+exports.isProcessAlive = isProcessAlive;
+exports.cleanStaleFiles = cleanStaleFiles;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const shared_1 = require("./shared");
+const extension_bridge_1 = require("./extension-bridge");
+const session_1 = require("./session");
+const scheduler_1 = require("./scheduler");
+const ipc_1 = require("./ipc");
+const SUPERSURF_DIR = path_1.default.join(os_1.default.homedir(), '.supersurf');
+exports.SUPERSURF_DIR = SUPERSURF_DIR;
+const PID_FILE = path_1.default.join(SUPERSURF_DIR, 'daemon.pid');
+exports.PID_FILE = PID_FILE;
+const SOCK_FILE = path_1.default.join(SUPERSURF_DIR, 'daemon.sock');
+exports.SOCK_FILE = SOCK_FILE;
+const LOG_FILE = path_1.default.join(SUPERSURF_DIR, 'logs', 'daemon.log');
+const IDLE_TIMEOUT_MS = 10 * 60 * 1000; // 10 minutes
+exports.IDLE_TIMEOUT_MS = IDLE_TIMEOUT_MS;
+// ─── CLI Parsing ──────────────────────────────────────────────
+function parseArgs(argv) {
+    let port = 5555;
+    let debug = false;
+    for (let i = 2; i < argv.length; i++) {
+        if (argv[i] === '--port' && argv[i + 1]) {
+            port = parseInt(argv[i + 1], 10);
+            if (isNaN(port)) {
+                console.error('Invalid port number');
+                process.exit(1);
+            }
+            i++;
+        }
+        else if (argv[i] === '--debug') {
+            debug = true;
+        }
+    }
+    return { port, debug };
+}
+// ─── PID File Management ──────────────────────────────────────
+/** Check if a process with the given PID is alive. */
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Clean stale PID/socket files if the referenced process is dead. */
+function cleanStaleFiles() {
+    if (fs_1.default.existsSync(PID_FILE)) {
+        try {
+            const pid = parseInt(fs_1.default.readFileSync(PID_FILE, 'utf8').trim(), 10);
+            if (!isNaN(pid) && !isProcessAlive(pid)) {
+                fs_1.default.unlinkSync(PID_FILE);
+                if (fs_1.default.existsSync(SOCK_FILE)) {
+                    fs_1.default.unlinkSync(SOCK_FILE);
+                }
+            }
+        }
+        catch {
+            // If we can't read the PID file, clean both
+            try {
+                fs_1.default.unlinkSync(PID_FILE);
+            }
+            catch { }
+            try {
+                fs_1.default.unlinkSync(SOCK_FILE);
+            }
+            catch { }
+        }
+    }
+    else if (fs_1.default.existsSync(SOCK_FILE)) {
+        // Orphaned socket file without a PID file — clean it
+        try {
+            fs_1.default.unlinkSync(SOCK_FILE);
+        }
+        catch { }
+    }
+}
+/** Write current PID to the PID file. */
+function writePidFile() {
+    fs_1.default.writeFileSync(PID_FILE, String(process.pid), 'utf8');
+}
+/** Remove PID and socket files on shutdown. */
+function cleanupFiles() {
+    try {
+        fs_1.default.unlinkSync(PID_FILE);
+    }
+    catch { }
+    try {
+        fs_1.default.unlinkSync(SOCK_FILE);
+    }
+    catch { }
+}
+// ─── Main ──────────────────────────────────────────────────────
+async function main() {
+    const { port, debug } = parseArgs(process.argv);
+    // Initialize logger — always create, only enable if --debug
+    const logger = new shared_1.FileLogger(LOG_FILE);
+    if (debug) {
+        logger.enable();
+        global.DAEMON_DEBUG = true;
+        global.DAEMON_LOGGER = logger;
+    }
+    logger.log(`[Daemon] Starting daemon (port=${port}, pid=${process.pid})`);
+    // Ensure ~/.supersurf/ exists
+    if (!fs_1.default.existsSync(SUPERSURF_DIR)) {
+        fs_1.default.mkdirSync(SUPERSURF_DIR, { recursive: true });
+    }
+    // Clean stale files from a crashed previous instance
+    cleanStaleFiles();
+    // Check if daemon is already running
+    if (fs_1.default.existsSync(PID_FILE)) {
+        const existingPid = parseInt(fs_1.default.readFileSync(PID_FILE, 'utf8').trim(), 10);
+        if (!isNaN(existingPid) && isProcessAlive(existingPid)) {
+            console.error(`Daemon already running (pid ${existingPid})`);
+            process.exit(1);
+        }
+    }
+    // Write PID file
+    writePidFile();
+    // Initialize components
+    const bridge = new extension_bridge_1.ExtensionBridge(port, '127.0.0.1');
+    const sessions = new session_1.SessionRegistry();
+    const scheduler = new scheduler_1.RequestScheduler(bridge, sessions);
+    const ipc = new ipc_1.IPCServer(SOCK_FILE, bridge, sessions, scheduler);
+    // Idle timeout: exit after 10 minutes with no sessions
+    let idleTimer = null;
+    function resetIdleTimer() {
+        if (idleTimer) {
+            clearTimeout(idleTimer);
+            idleTimer = null;
+        }
+    }
+    function startIdleTimer() {
+        resetIdleTimer();
+        idleTimer = setTimeout(() => {
+            logger.log('[Daemon] Idle timeout — no sessions for 10 minutes, exiting');
+            shutdown();
+        }, IDLE_TIMEOUT_MS);
+    }
+    ipc.setSessionCountCallback((count) => {
+        logger.log(`[Daemon] Session count: ${count}`);
+        if (count === 0) {
+            startIdleTimer();
+        }
+        else {
+            resetIdleTimer();
+        }
+    });
+    // Graceful shutdown
+    let shuttingDown = false;
+    async function shutdown() {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        logger.log('[Daemon] Shutting down...');
+        resetIdleTimer();
+        scheduler.drainAll();
+        await ipc.stop();
+        await bridge.stop();
+        cleanupFiles();
+        logger.log('[Daemon] Shutdown complete');
+        process.exit(0);
+    }
+    process.on('SIGTERM', shutdown);
+    process.on('SIGINT', shutdown);
+    // Start extension WebSocket server
+    try {
+        await bridge.start();
+        logger.log(`[Daemon] Extension WebSocket listening on port ${port}`);
+    }
+    catch (error) {
+        console.error(`Failed to start extension WebSocket: ${error.message}`);
+        cleanupFiles();
+        process.exit(1);
+    }
+    // Start IPC server
+    try {
+        await ipc.start();
+        logger.log(`[Daemon] IPC listening on ${SOCK_FILE}`);
+    }
+    catch (error) {
+        console.error(`Failed to start IPC server: ${error.message}`);
+        await bridge.stop();
+        cleanupFiles();
+        process.exit(1);
+    }
+    // Start idle timer (no sessions yet)
+    startIdleTimer();
+    logger.log('[Daemon] Daemon ready');
+}
+main().catch((error) => {
+    console.error('Daemon fatal error:', error);
+    cleanupFiles();
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/scheduler.d.ts

@@ -0,0 +1,48 @@
+/**
+ * RequestScheduler — round-robin scheduler with tab ownership enforcement.
+ *
+ * Extracted from the multiplexer's leader-mode logic. Serializes all commands
+ * to the extension through a single drain loop, ensuring fair round-robin
+ * across sessions and automatic tab context-switching.
+ *
+ * @module scheduler
+ */
+import type { ExtensionBridge } from './extension-bridge';
+import type { SessionRegistry } from './session';
+/**
+ * Round-robin request scheduler with tab ownership and auto context-switching.
+ */
+export declare class RequestScheduler {
+    private bridge;
+    private sessions;
+    private requestQueue;
+    private sessionOrder;
+    private currentSessionIdx;
+    private processingQueue;
+    private currentExtensionTabId;
+    private sessionGroupIds;
+    constructor(bridge: ExtensionBridge, sessions: SessionRegistry);
+    /** Register a session in the scheduler. */
+    addSession(sessionId: string): void;
+    /** Remove a session from the scheduler. Rejects queued requests. */
+    removeSession(sessionId: string): void;
+    /** Enqueue a request and return a promise for the result. */
+    enqueue(sessionId: string, method: string, params: Record<string, unknown>, timeout?: number): Promise<any>;
+    /** Process queued requests in round-robin order. Serialized — one at a time. */
+    private drainQueue;
+    private hasQueuedRequests;
+    /** Round-robin pick: advance through sessions, skip empty queues. */
+    private pickNextRequest;
+    /**
+     * Execute a single queued request:
+     * 1. Tab ownership check for tab-management methods
+     * 2. Auto context-switch if this session's tab != current extension tab
+     * 3. Inject _sessionId for extension-side group isolation
+     * 4. Execute the actual command
+     * 5. Track ownership changes
+     */
+    private executeRequest;
+    /** Drain and reject all queued requests. Called during shutdown. */
+    drainAll(): void;
+}
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAsBjD;;GAEG;AACH,qBAAa,gBAAgB;IASzB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,QAAQ;IATlB,OAAO,CAAC,YAAY,CAA2C;IAC/D,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,iBAAiB,CAAa;IACtC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,qBAAqB,CAAuB;IACpD,OAAO,CAAC,eAAe,CAAkC;gBAG/C,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,eAAe;IAGnC,2CAA2C;IAC3C,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKnC,oEAAoE;IACpE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAatC,6DAA6D;IAC7D,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,GAAG,CAAC;IAalH,gFAAgF;YAClE,UAAU;IAexB,OAAO,CAAC,iBAAiB;IAOzB,qEAAqE;IACrE,OAAO,CAAC,eAAe;IAmBvB;;;;;;;OAOG;YACW,cAAc;IA6F5B,oEAAoE;IACpE,QAAQ,IAAI,IAAI;CASjB"}