@jackwener/opencli 0.9.8 → 1.0.0

package/dist/daemon.js

@@ -0,0 +1,187 @@
+/**
+ * opencli micro-daemon — HTTP + WebSocket bridge between CLI and Chrome Extension.
+ *
+ * Architecture:
+ *   CLI → HTTP POST /command → daemon → WebSocket → Extension
+ *   Extension → WebSocket result → daemon → HTTP response → CLI
+ *
+ * Lifecycle:
+ *   - Auto-spawned by opencli on first browser command
+ *   - Auto-exits after 5 minutes of idle
+ *   - Listens on localhost:19825
+ */
+import { createServer } from 'node:http';
+import { WebSocketServer, WebSocket } from 'ws';
+const PORT = parseInt(process.env.OPENCLI_DAEMON_PORT ?? '19825', 10);
+const IDLE_TIMEOUT = 5 * 60 * 1000; // 5 minutes
+// ─── State ───────────────────────────────────────────────────────────
+let extensionWs = null;
+const pending = new Map();
+let idleTimer = null;
+const LOG_BUFFER_SIZE = 200;
+const logBuffer = [];
+function pushLog(entry) {
+    logBuffer.push(entry);
+    if (logBuffer.length > LOG_BUFFER_SIZE)
+        logBuffer.shift();
+}
+// ─── Idle auto-exit ──────────────────────────────────────────────────
+function resetIdleTimer() {
+    if (idleTimer)
+        clearTimeout(idleTimer);
+    idleTimer = setTimeout(() => {
+        console.error('[daemon] Idle timeout, shutting down');
+        process.exit(0);
+    }, IDLE_TIMEOUT);
+}
+// ─── HTTP Server ─────────────────────────────────────────────────────
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', (c) => chunks.push(c));
+        req.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+        req.on('error', reject);
+    });
+}
+function jsonResponse(res, status, data) {
+    res.writeHead(status, { 'Content-Type': 'application/json', 'Access-Control-Allow-Origin': '*' });
+    res.end(JSON.stringify(data));
+}
+async function handleRequest(req, res) {
+    res.setHeader('Access-Control-Allow-Origin', '*');
+    res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+    res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+    if (req.method === 'OPTIONS') {
+        res.writeHead(204);
+        res.end();
+        return;
+    }
+    const url = req.url ?? '/';
+    const pathname = url.split('?')[0];
+    if (req.method === 'GET' && pathname === '/status') {
+        jsonResponse(res, 200, {
+            ok: true,
+            extensionConnected: extensionWs?.readyState === WebSocket.OPEN,
+            pending: pending.size,
+        });
+        return;
+    }
+    if (req.method === 'GET' && pathname === '/logs') {
+        const params = new URL(url, `http://localhost:${PORT}`).searchParams;
+        const level = params.get('level');
+        const filtered = level
+            ? logBuffer.filter(e => e.level === level)
+            : logBuffer;
+        jsonResponse(res, 200, { ok: true, logs: filtered });
+        return;
+    }
+    if (req.method === 'DELETE' && pathname === '/logs') {
+        logBuffer.length = 0;
+        jsonResponse(res, 200, { ok: true });
+        return;
+    }
+    if (req.method === 'POST' && url === '/command') {
+        resetIdleTimer();
+        try {
+            const body = JSON.parse(await readBody(req));
+            if (!body.id) {
+                jsonResponse(res, 400, { ok: false, error: 'Missing command id' });
+                return;
+            }
+            if (!extensionWs || extensionWs.readyState !== WebSocket.OPEN) {
+                jsonResponse(res, 503, { id: body.id, ok: false, error: 'Extension not connected. Please install the opencli Browser Bridge extension.' });
+                return;
+            }
+            const result = await new Promise((resolve, reject) => {
+                const timer = setTimeout(() => {
+                    pending.delete(body.id);
+                    reject(new Error('Command timeout (30s)'));
+                }, 30000);
+                pending.set(body.id, { resolve, reject, timer });
+                extensionWs.send(JSON.stringify(body));
+            });
+            jsonResponse(res, 200, result);
+        }
+        catch (err) {
+            jsonResponse(res, err instanceof Error && err.message.includes('timeout') ? 408 : 400, {
+                ok: false,
+                error: err instanceof Error ? err.message : 'Invalid request',
+            });
+        }
+        return;
+    }
+    jsonResponse(res, 404, { error: 'Not found' });
+}
+// ─── WebSocket for Extension ─────────────────────────────────────────
+const httpServer = createServer((req, res) => { handleRequest(req, res).catch(() => { res.writeHead(500); res.end(); }); });
+const wss = new WebSocketServer({ server: httpServer, path: '/ext' });
+wss.on('connection', (ws) => {
+    console.error('[daemon] Extension connected');
+    extensionWs = ws;
+    ws.on('message', (data) => {
+        try {
+            const msg = JSON.parse(data.toString());
+            // Handle log messages from extension
+            if (msg.type === 'log') {
+                const prefix = msg.level === 'error' ? '❌' : msg.level === 'warn' ? '⚠️' : '📋';
+                console.error(`${prefix} [ext] ${msg.msg}`);
+                pushLog({ level: msg.level, msg: msg.msg, ts: msg.ts ?? Date.now() });
+                return;
+            }
+            // Handle command results
+            const p = pending.get(msg.id);
+            if (p) {
+                clearTimeout(p.timer);
+                pending.delete(msg.id);
+                p.resolve(msg);
+            }
+        }
+        catch {
+            // Ignore malformed messages
+        }
+    });
+    ws.on('close', () => {
+        console.error('[daemon] Extension disconnected');
+        if (extensionWs === ws) {
+            extensionWs = null;
+            // Reject all pending requests since the extension is gone
+            for (const [id, p] of pending) {
+                clearTimeout(p.timer);
+                p.reject(new Error('Extension disconnected'));
+            }
+            pending.clear();
+        }
+    });
+    ws.on('error', () => {
+        if (extensionWs === ws)
+            extensionWs = null;
+    });
+});
+// ─── Start ───────────────────────────────────────────────────────────
+httpServer.listen(PORT, '127.0.0.1', () => {
+    console.error(`[daemon] Listening on http://127.0.0.1:${PORT}`);
+    resetIdleTimer();
+});
+httpServer.on('error', (err) => {
+    if (err.code === 'EADDRINUSE') {
+        console.error(`[daemon] Port ${PORT} already in use — another daemon is likely running. Exiting.`);
+        process.exit(0);
+    }
+    console.error('[daemon] Server error:', err.message);
+    process.exit(1);
+});
+// Graceful shutdown
+function shutdown() {
+    // Reject all pending requests so CLI doesn't hang
+    for (const [, p] of pending) {
+        clearTimeout(p.timer);
+        p.reject(new Error('Daemon shutting down'));
+    }
+    pending.clear();
+    if (extensionWs)
+        extensionWs.close();
+    httpServer.close();
+    process.exit(0);
+}
+process.on('SIGTERM', shutdown);
+process.on('SIGINT', shutdown);

package/dist/doctor.d.ts

@@ -1,29 +1,15 @@
-export declare const PLAYWRIGHT_TOKEN_ENV = "PLAYWRIGHT_MCP_EXTENSION_TOKEN";
+/**
+ * opencli doctor — diagnose and fix browser connectivity.
+ *
+ * Simplified for the daemon-based architecture. No more token management,
+ * MCP path discovery, or config file scanning.
+ */
 export type DoctorOptions = {
     fix?: boolean;
     yes?: boolean;
     live?: boolean;
-    shellRc?: string;
-    configPaths?: string[];
-    token?: string;
     cliVersion?: string;
 };
-export type ShellFileStatus = {
-    path: string;
-    exists: boolean;
-    token: string | null;
-    fingerprint: string | null;
-};
-export type McpConfigFormat = 'json' | 'toml';
-export type McpConfigStatus = {
-    path: string;
-    exists: boolean;
-    format: McpConfigFormat;
-    token: string | null;
-    fingerprint: string | null;
-    writable: boolean;
-    parseError?: string;
-};
 export type ConnectivityResult = {
     ok: boolean;
     error?: string;
@@ -31,57 +17,37 @@ export type ConnectivityResult = {
 };
 export type DoctorReport = {
     cliVersion?: string;
-    envToken: string | null;
-    envFingerprint: string | null;
-    extensionToken: string | null;
-    extensionFingerprint: string | null;
-    extensionInstalled: boolean;
-    extensionBrowsers: string[];
-    shellFiles: ShellFileStatus[];
-    configs: McpConfigStatus[];
-    recommendedToken: string | null;
-    recommendedFingerprint: string | null;
+    daemonRunning: boolean;
+    extensionConnected: boolean;
     connectivity?: ConnectivityResult;
-    warnings: string[];
     issues: string[];
 };
-export declare function shortenPath(p: string): string;
-export declare function toolName(p: string): string;
-export declare function getDefaultShellRcPath(): string;
-export declare function getDefaultMcpConfigPaths(cwd?: string): string[];
-export declare function readTokenFromShellContent(content: string): string | null;
-export declare function upsertShellToken(content: string, token: string, filePath?: string): string;
-export declare function upsertJsonConfigToken(content: string, token: string, filePath?: string): string;
-export declare function readTomlConfigToken(content: string): string | null;
-export declare function upsertTomlConfigToken(content: string, token: string): string;
-export declare function fileExists(filePath: string): boolean;
 /**
- * Discover the auth token stored by the Playwright MCP Bridge extension
- * by scanning Chrome's LevelDB localStorage files directly.
- *
- * Reads LevelDB .ldb/.log files as raw binary and searches for the
- * extension ID near base64url token values. This works reliably across
- * platforms because LevelDB's internal encoding can split ASCII strings
- * like "auth-token" and the extension ID across byte boundaries, making
- * text-based tools like `strings` + `grep` unreliable.
+ * Test connectivity by attempting a real browser command.
  */
+export declare function checkConnectivity(opts?: {
+    timeout?: number;
+}): Promise<ConnectivityResult>;
+export declare function runBrowserDoctor(opts?: DoctorOptions): Promise<DoctorReport>;
+export declare function renderBrowserDoctorReport(report: DoctorReport): string;
+export declare const PLAYWRIGHT_TOKEN_ENV = "PLAYWRIGHT_MCP_EXTENSION_TOKEN";
 export declare function discoverExtensionToken(): string | null;
-/**
- * Check whether the Playwright MCP Bridge extension is installed in any browser.
- * Scans Chrome/Chromium/Edge Extensions directories for the known extension ID.
- */
 export declare function checkExtensionInstalled(): {
     installed: boolean;
     browsers: string[];
 };
-/**
- * Test token connectivity by attempting a real MCP connection.
- * Connects, does the JSON-RPC handshake, and immediately closes.
- */
+export declare function applyBrowserDoctorFix(): Promise<string[]>;
+export declare function getDefaultShellRcPath(): string;
+export declare function getDefaultMcpConfigPaths(): string[];
+export declare function readTokenFromShellContent(_content: string): string | null;
+export declare function upsertShellToken(content: string): string;
+export declare function upsertJsonConfigToken(content: string): string;
+export declare function readTomlConfigToken(_content: string): string | null;
+export declare function upsertTomlConfigToken(content: string): string;
+export declare function shortenPath(p: string): string;
+export declare function toolName(_p: string): string;
+export declare function fileExists(filePath: string): boolean;
+export declare function writeFileWithMkdir(_p: string, _c: string): void;
 export declare function checkTokenConnectivity(opts?: {
     timeout?: number;
 }): Promise<ConnectivityResult>;
-export declare function runBrowserDoctor(opts?: DoctorOptions): Promise<DoctorReport>;
-export declare function renderBrowserDoctorReport(report: DoctorReport): string;
-export declare function writeFileWithMkdir(filePath: string, content: string): void;
-export declare function applyBrowserDoctorFix(report: DoctorReport, opts?: DoctorOptions): Promise<string[]>;