@rndmjoker/proton-mcp 0.4.13 → 0.5.1

package/dist/browser/client.d.ts

@@ -0,0 +1,50 @@
+/**
+ * This server's end of the browser channel (#59).
+ *
+ * One connection per request: filters are asked about now and then, and a
+ * connection held open would have to notice Chrome going away and coming back,
+ * which a fresh one does for free.
+ *
+ * When the extension cannot be reached, the answer says so plainly and names
+ * the cause wherever it can be found out: no setup, Chrome not running, the
+ * extension missing or switched off, a connector left over from before. Tobi
+ * asked for exactly that on 05.11.2026: "the extension is not active", and
+ * help with it, rather than an error code nobody can act on.
+ */
+import { type BrowserRequest, type BrowserResponse } from './messages.js';
+import { type BrowserPaths } from './paths.js';
+/** The command that sets the connector up, as a user types it. */
+export declare const SETUP_COMMAND = "npx -y @rndmjoker/proton-mcp@latest setup-browser";
+export type Unavailable = 'platform' | 'not-set-up' | 'setup-broken' | 'browser-closed' | 'extension-not-connected' | 'connector-stale' | 'connector-outdated' | 'secret-mismatch' | 'unsafe-socket-dir' | 'no-answer';
+/** The extension cannot be reached. The message says why, the help what to do. */
+export declare class BrowserUnavailable extends Error {
+    readonly reason: Unavailable;
+    readonly help: string[];
+    constructor(reason: Unavailable, message: string, help: string[]);
+}
+/** Whether Chrome is running, or nothing when that cannot be told. */
+export declare function chromeRunning(platform: BrowserPaths['platform']): boolean | undefined;
+/**
+ * Why nothing answers on the socket, as far as it can be told from outside.
+ *
+ * Checked from the cause that needs the most work to the one that needs the
+ * least, so the answer starts where the user has to start.
+ */
+export declare function diagnose(paths: BrowserPaths, running?: boolean | undefined): BrowserUnavailable;
+/** Why a directory is not private enough for the socket, or nothing when it is or does not exist yet. */
+export declare function unsafeDirectory(dir: string): string | undefined;
+export interface AskOptions {
+    paths?: BrowserPaths;
+    /** How long to wait for the answer after the request went out. */
+    timeoutMs?: number;
+    /** Replaces the check for a running Chrome, for tests. */
+    chromeRunning?: () => boolean | undefined;
+}
+/**
+ * Sends one request to the extension and returns its answer.
+ *
+ * Throws BrowserUnavailable whenever the extension cannot be reached, with the
+ * cause and what helps. An answer from the extension that reports a problem,
+ * such as no Proton tab, is returned as an answer: the extension is there.
+ */
+export declare function askBrowser(request: BrowserRequest, options?: AskOptions): Promise<BrowserResponse>;

package/dist/browser/client.js

@@ -0,0 +1,284 @@
+/**
+ * This server's end of the browser channel (#59).
+ *
+ * One connection per request: filters are asked about now and then, and a
+ * connection held open would have to notice Chrome going away and coming back,
+ * which a fresh one does for free.
+ *
+ * When the extension cannot be reached, the answer says so plainly and names
+ * the cause wherever it can be found out: no setup, Chrome not running, the
+ * extension missing or switched off, a connector left over from before. Tobi
+ * asked for exactly that on 05.11.2026: "the extension is not active", and
+ * help with it, rather than an error code nobody can act on.
+ */
+import { connect } from 'node:net';
+import { existsSync, readFileSync, readdirSync, lstatSync } from 'node:fs';
+import { dirname, win32 } from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import { PROTOCOL_VERSION, parseResponse } from './messages.js';
+import { browserPaths, UnsupportedPlatform } from './paths.js';
+import { LineReader, parseLine, newNonce, proof, proofMatches, isNonce, readSecret } from './channel.js';
+/** The command that sets the connector up, as a user types it. */
+export const SETUP_COMMAND = 'npx -y @rndmjoker/proton-mcp@latest setup-browser';
+/** The extension cannot be reached. The message says why, the help what to do. */
+export class BrowserUnavailable extends Error {
+    reason;
+    help;
+    constructor(reason, message, help) {
+        super(message);
+        this.reason = reason;
+        this.help = help;
+    }
+}
+const LOAD_EXTENSION = 'Load the extension in Chrome: open chrome://extensions, switch on Developer mode, choose ' +
+    '"Load unpacked" and pick the unpacked folder of the extension from the release.';
+const RELOAD_EXTENSION = 'Open chrome://extensions, find "Proton MCP Helper" and click its reload arrow. Its popup ' +
+    'shows what it reports about the connector.';
+/** Whether Chrome is running, or nothing when that cannot be told. */
+export function chromeRunning(platform) {
+    try {
+        if (platform === 'linux') {
+            for (const entry of readdirSync('/proc')) {
+                if (!/^\d+$/.test(entry))
+                    continue;
+                try {
+                    if (readFileSync(`/proc/${entry}/comm`, 'utf8').trim() === 'chrome')
+                        return true;
+                }
+                catch {
+                    // A process that ended while the list was read.
+                }
+            }
+            return false;
+        }
+        // Programs by their full path: a bare name is looked up in the current
+        // directory first on Windows, and a project the assistant works in could
+        // carry a tasklist.exe of its own. Found in the review of 06.11.2026.
+        if (platform === 'darwin') {
+            const list = execFileSync('/bin/ps', ['-axo', 'comm'], { encoding: 'utf8', timeout: 3000 });
+            return list.split('\n').some((line) => line.endsWith('/Google Chrome'));
+        }
+        const tasklist = win32.join(process.env.SystemRoot ?? 'C:\\Windows', 'System32', 'tasklist.exe');
+        const list = execFileSync(tasklist, ['/FI', 'IMAGENAME eq chrome.exe', '/NH'], {
+            encoding: 'utf8',
+            timeout: 3000,
+            windowsHide: true,
+        });
+        return /chrome\.exe/i.test(list);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The Node the launcher starts the connector with, read back from the launcher. */
+function launcherNode(paths) {
+    try {
+        const text = readFileSync(paths.launcher, 'utf8');
+        const match = paths.platform === 'win32' ? /^"([^"]+)"/m.exec(text) : /^exec '((?:[^']|'\\'')+)'/m.exec(text);
+        return match?.[1]?.replace(/'\\''/g, "'");
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Why nothing answers on the socket, as far as it can be told from outside.
+ *
+ * Checked from the cause that needs the most work to the one that needs the
+ * least, so the answer starts where the user has to start.
+ */
+export function diagnose(paths, running = chromeRunning(paths.platform)) {
+    if (!existsSync(paths.secretFile) || !existsSync(paths.manifestFile) || !existsSync(paths.launcher)) {
+        return new BrowserUnavailable('not-set-up', 'The browser extension Proton MCP Helper is not active: its connector is not set up on this computer.', [
+            `Run this in a terminal: ${SETUP_COMMAND}`,
+            LOAD_EXTENSION,
+            'Reload any open Proton tab once afterwards.',
+        ]);
+    }
+    const node = launcherNode(paths);
+    if (node && !existsSync(node)) {
+        return new BrowserUnavailable('setup-broken', `The browser extension Proton MCP Helper is not active: its connector was set up with a Node that no longer exists (${node}).`, [`Run the setup again in a terminal: ${SETUP_COMMAND}`, RELOAD_EXTENSION]);
+    }
+    if (running === false) {
+        return new BrowserUnavailable('browser-closed', 'The browser extension Proton MCP Helper is not active: Chrome is not running.', ['Start Chrome and open https://mail.proton.me, signed in to the account.']);
+    }
+    return new BrowserUnavailable('extension-not-connected', 'The browser extension Proton MCP Helper is not active: ' +
+        (running ? 'Chrome is running and the connector is set up, but ' : 'the connector is set up, but ') +
+        'the extension has not started it. It is missing, switched off, or needs a reload.', [
+        RELOAD_EXTENSION,
+        'If it is not listed there: ' + LOAD_EXTENSION,
+    ]);
+}
+/** Why a directory is not private enough for the socket, or nothing when it is or does not exist yet. */
+export function unsafeDirectory(dir) {
+    let stat;
+    try {
+        stat = lstatSync(dir);
+    }
+    catch {
+        return undefined;
+    }
+    if (stat.isSymbolicLink() || !stat.isDirectory())
+        return `${dir} is not a plain directory.`;
+    const uid = process.getuid?.();
+    if (uid !== undefined && stat.uid !== uid)
+        return `${dir} belongs to another user.`;
+    if ((stat.mode & 0o077) !== 0)
+        return `${dir} can be opened by other users.`;
+    return undefined;
+}
+/** Waits for the next message on the socket, or fails when it closes or takes too long. */
+class Conversation {
+    socket;
+    #queue = [];
+    #waiting = [];
+    #closed = false;
+    constructor(socket) {
+        this.socket = socket;
+        const reader = new LineReader();
+        socket.on('data', (chunk) => {
+            let lines;
+            try {
+                lines = reader.push(chunk);
+            }
+            catch {
+                socket.destroy();
+                return;
+            }
+            for (const line of lines)
+                this.#deliver(parseLine(line));
+        });
+        socket.on('close', () => {
+            this.#closed = true;
+            for (const waiter of this.#waiting.splice(0))
+                waiter(undefined);
+        });
+        socket.on('error', () => undefined);
+    }
+    #deliver(message) {
+        const waiter = this.#waiting.shift();
+        if (waiter)
+            waiter(message);
+        else
+            this.#queue.push(message);
+    }
+    next(timeoutMs) {
+        if (this.#queue.length > 0)
+            return Promise.resolve(this.#queue.shift());
+        if (this.#closed)
+            return Promise.resolve(undefined);
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                const index = this.#waiting.indexOf(done);
+                if (index >= 0)
+                    this.#waiting.splice(index, 1);
+                resolve('timeout');
+            }, timeoutMs);
+            const done = (message) => {
+                clearTimeout(timer);
+                resolve(message);
+            };
+            this.#waiting.push(done);
+        });
+    }
+    send(message) {
+        if (!this.socket.destroyed)
+            this.socket.write(`${JSON.stringify(message)}\n`);
+    }
+}
+function open(path) {
+    return new Promise((resolve, reject) => {
+        const socket = connect(path);
+        socket.once('connect', () => {
+            socket.removeAllListeners('error');
+            resolve(socket);
+        });
+        socket.once('error', reject);
+    });
+}
+/**
+ * Sends one request to the extension and returns its answer.
+ *
+ * Throws BrowserUnavailable whenever the extension cannot be reached, with the
+ * cause and what helps. An answer from the extension that reports a problem,
+ * such as no Proton tab, is returned as an answer: the extension is there.
+ */
+export async function askBrowser(request, options = {}) {
+    let paths;
+    try {
+        paths = options.paths ?? browserPaths();
+    }
+    catch (error) {
+        if (error instanceof UnsupportedPlatform)
+            throw new BrowserUnavailable('platform', error.message, []);
+        throw error;
+    }
+    const running = options.chromeRunning ?? (() => chromeRunning(paths.platform));
+    const secret = readSecret(paths.secretFile);
+    if (!secret)
+        throw diagnose(paths, running());
+    // The connector refuses a socket directory somebody else owns or others can
+    // open; the server checks the same before it says anything there, so a name
+    // taken first in /tmp is named as the cause rather than as a wrong secret.
+    if (paths.platform !== 'win32') {
+        const unsafe = unsafeDirectory(dirname(paths.socket));
+        if (unsafe) {
+            throw new BrowserUnavailable('unsafe-socket-dir', `The browser extension Proton MCP Helper cannot be reached safely: ${unsafe}`, [
+                `Remove ${dirname(paths.socket)} if it is not yours, then reload the extension in chrome://extensions.`,
+            ]);
+        }
+    }
+    let socket;
+    try {
+        socket = await open(paths.socket);
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === 'ECONNREFUSED' && paths.platform !== 'win32') {
+            throw new BrowserUnavailable('connector-stale', 'The browser extension Proton MCP Helper is not active: its connector stopped without ' +
+                'closing its socket.', [RELOAD_EXTENSION, 'If that does not help, restart Chrome.']);
+        }
+        throw diagnose(paths, running());
+    }
+    const conversation = new Conversation(socket);
+    try {
+        const hello = await conversation.next(3000);
+        if (hello === 'timeout' || !hello || hello.type !== 'hello' || !isNonce(hello.nonce)) {
+            throw new BrowserUnavailable('connector-stale', 'The browser extension Proton MCP Helper is not active: something answers on its ' +
+                'socket, but not the way its connector does.', [RELOAD_EXTENSION, `If that does not help, run the setup again: ${SETUP_COMMAND}`]);
+        }
+        if (hello.version !== PROTOCOL_VERSION) {
+            throw new BrowserUnavailable('connector-outdated', `The browser extension's connector speaks version ${String(hello.version)} of the channel and this server ` +
+                `version ${PROTOCOL_VERSION}, so they cannot work together.`, [`Run the setup again: ${SETUP_COMMAND}`, 'Update the extension to the release that matches this server.', RELOAD_EXTENSION]);
+        }
+        const mine = newNonce();
+        conversation.send({ type: 'auth', proof: proof(secret, 'client', hello.nonce), nonce: mine });
+        const ready = await conversation.next(3000);
+        if (ready === 'timeout' || !ready || ready.type !== 'ready' || !proofMatches(secret, 'host', mine, ready.proof)) {
+            throw new BrowserUnavailable('secret-mismatch', 'The browser extension is running, but its connector and this server do not share the same secret. ' +
+                'That happens when the setup ran again after Chrome started the connector.', [RELOAD_EXTENSION, `If that does not help, run the setup again: ${SETUP_COMMAND}`]);
+        }
+        const id = randomUUID();
+        conversation.send({ type: 'request', id, body: request });
+        const timeoutMs = options.timeoutMs ?? 90_000;
+        for (;;) {
+            const message = await conversation.next(timeoutMs);
+            if (message === 'timeout' || message === undefined) {
+                throw new BrowserUnavailable('no-answer', 'The browser extension did not answer in time. It may still carry out the request, so look ' +
+                    'with list_filters before asking for it again.', ['Check that Chrome is not stuck.', RELOAD_EXTENSION]);
+            }
+            if (message.type !== 'response' || message.id !== id)
+                continue;
+            const body = parseResponse(message.body);
+            if (!body) {
+                return { ok: false, error: 'internal', message: 'The extension answered in a shape this server does not know.' };
+            }
+            return body;
+        }
+    }
+    finally {
+        socket.destroy();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/browser/client.js.map

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

package/dist/browser/connector.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * The connector's entry point (#59): the file the launcher starts when Chrome
+ * asks for it on behalf of the Proton MCP Helper extension.
+ *
+ * It does one thing, start the connector, and decides nothing about whether it
+ * should. The first version had no file of its own: host.ts checked whether it
+ * was the program being started by comparing its own address with the path it
+ * was started under. On Tobi's machine /home is a link to /var/home, so the
+ * two were spellings of the same file that never compared equal, and the
+ * connector did nothing at all. Chrome showed "Native host has exited", and no
+ * test noticed, because the tests run the connector inside their own process.
+ * Measured on 06.11.2026.
+ */
+export {};

package/dist/browser/connector.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+/**
+ * The connector's entry point (#59): the file the launcher starts when Chrome
+ * asks for it on behalf of the Proton MCP Helper extension.
+ *
+ * It does one thing, start the connector, and decides nothing about whether it
+ * should. The first version had no file of its own: host.ts checked whether it
+ * was the program being started by comparing its own address with the path it
+ * was started under. On Tobi's machine /home is a link to /var/home, so the
+ * two were spellings of the same file that never compared equal, and the
+ * connector did nothing at all. Chrome showed "Native host has exited", and no
+ * test noticed, because the tests run the connector inside their own process.
+ * Measured on 06.11.2026.
+ */
+import { runHost } from './host.js';
+import { browserPaths } from './paths.js';
+const host = await runHost({
+    input: process.stdin,
+    output: process.stdout,
+    origin: process.argv[2],
+    paths: browserPaths(),
+    log: (line) => process.stderr.write(`proton-mcp connector: ${line}\n`),
+});
+await host.done;
+process.exit(host.failure ? 1 : 0);
+//# sourceMappingURL=connector.js.map

package/dist/browser/connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.js","sourceRoot":"","sources":["../../src/browser/connector.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEzC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC,KAAK;IACpB,MAAM,EAAE,OAAO,CAAC,MAAM;IACtB,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,YAAY,EAAE;IACrB,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,IAAI,IAAI,CAAC;CACvE,CAAC,CAAA;AACF,MAAM,IAAI,CAAC,IAAI,CAAA;AACf,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA"}

package/dist/browser/host.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The connector Chrome starts for the extension (#59), in Chrome's words a
+ * native messaging host.
+ *
+ * Chrome starts it when the extension asks for it, hands it the extension's
+ * origin as the first argument, and talks to it over standard input and
+ * output. Chrome starts it only for the extension named in its manifest, and
+ * only from that extension: a web page cannot reach it.
+ *
+ * The connector opens a socket file for this server and relays between the two.
+ * It holds nothing and decides nothing about filters. What it does decide is
+ * who gets through:
+ *
+ * - Chrome's origin has to be the extension's fixed id.
+ * - A connection on the socket has to prove it knows the secret from the
+ *   setup before it may send anything, and the connector proves the same back.
+ * - Every request has to be one of the three kinds in messages.ts, in exactly
+ *   that shape, and every answer from the extension as well.
+ *
+ * It stops when Chrome closes the channel, which happens when the extension
+ * is switched off, reloaded or removed, or when Chrome quits.
+ *
+ * The setup copies this file, with connector.ts, paths.ts, channel.ts and
+ * messages.ts, into the user's configuration directory, and connector.ts
+ * starts it with the Node the setup ran under. So it imports nothing but Node
+ * and those files.
+ */
+import type { Readable, Writable } from 'node:stream';
+import type { BrowserPaths } from './paths.js';
+/** How long a request may wait for the extension. Filling in a confirmation is not waited for. */
+export declare const REQUEST_TIMEOUT_MS = 60000;
+export interface HostOptions {
+    /** What Chrome writes: the extension's messages. */
+    input: Readable;
+    /** What Chrome reads. */
+    output: Writable;
+    /** The first argument Chrome passes: the extension's origin. */
+    origin: string | undefined;
+    paths: BrowserPaths;
+    log?: (line: string) => void;
+    requestTimeoutMs?: number;
+}
+export interface RunningHost {
+    /** Settles once Chrome closed the channel and the socket is gone, or the connector gave up. */
+    done: Promise<void>;
+    /** The reason the connector gave up at start, if it did. */
+    failure?: string;
+    close(): Promise<void>;
+}
+export declare function runHost(options: HostOptions): Promise<RunningHost>;