@page-scanner/cli 0.1.0

package/dist/daemon/rpc-server.js

@@ -0,0 +1,254 @@
+/**
+ * The daemon's control surface: a loopback HTTP endpoint, `POST /rpc`.
+ *
+ * Why a second port rather than reusing 45711: that one has to keep refusing
+ * everything whose `Origin` is not a `chrome-extension://`, which is exactly
+ * what a local CLI process is. Giving the two audiences two doors is cheaper
+ * than weakening the check on the one the browser uses.
+ *
+ * The port is ephemeral and the bearer secret is regenerated every run, both
+ * recorded in `daemon.json` at mode 0600. A loopback port is reachable by
+ * every process on the machine, so the secret is not decoration: without it,
+ * anything running as the user could drive the browser.
+ *
+ * No dependencies. `node:http` is enough for one route.
+ */
+import { createServer } from 'node:http';
+import { toPageScannerError } from '../errors.js';
+import { PageScannerError } from '../errors.js';
+import { DEFAULT_PAGE_SIZE, EXPORT_FORMAT_IDS, PAGE_SIZE_IDS, VIDEO_HANDLINGS, } from '../protocol.js';
+import { CLI_VERSION } from '../version.js';
+import { tokensMatch } from '../bridge/tokens.js';
+/** A body larger than this is not a request we would understand anyway. */
+const MAX_BODY_BYTES = 1_000_000;
+function readBody(request) {
+    return new Promise((resolve, reject) => {
+        let size = 0;
+        const chunks = [];
+        request.on('data', (chunk) => {
+            size += chunk.length;
+            if (size > MAX_BODY_BYTES) {
+                reject(new PageScannerError('BAD_REQUEST', 'Request body too large.'));
+                request.destroy();
+                return;
+            }
+            chunks.push(chunk);
+        });
+        request.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
+        request.on('error', reject);
+    });
+}
+function send(response, status, payload) {
+    const body = JSON.stringify(payload);
+    response.writeHead(status, {
+        'content-type': 'application/json; charset=utf-8',
+        'content-length': Buffer.byteLength(body),
+    });
+    response.end(body);
+}
+function asRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : {};
+}
+function optionalString(params, key) {
+    const value = params[key];
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new PageScannerError('BAD_REQUEST', `${key} must be a non-empty string.`);
+    }
+    return value;
+}
+function optionalInteger(params, key) {
+    const value = params[key];
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'number' || !Number.isInteger(value)) {
+        throw new PageScannerError('BAD_REQUEST', `${key} must be an integer.`);
+    }
+    return value;
+}
+function timeoutFrom(params, fallback) {
+    const value = params.timeoutMs;
+    if (value === undefined)
+        return fallback;
+    if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) {
+        throw new PageScannerError('BAD_REQUEST', 'timeoutMs must be a non-negative number.');
+    }
+    return value;
+}
+function oneOf(params, key, allowed, fallback) {
+    const value = params[key];
+    if (value === undefined)
+        return fallback;
+    if (typeof value !== 'string' || !allowed.includes(value)) {
+        throw new PageScannerError('BAD_REQUEST', `${key} must be one of ${allowed.join(', ')} (got ${JSON.stringify(value)}).`);
+    }
+    return value;
+}
+/**
+ * The daemon's methods.
+ *
+ * `scan` deliberately returns the bytes rather than a path. The daemon may
+ * have been started from a different directory, hours ago; only the calling
+ * process knows what a relative `--out` means, so it does the writing.
+ */
+async function dispatch(method, params, options) {
+    const { bridge } = options;
+    switch (method) {
+        case 'health':
+            return {
+                ok: true,
+                version: CLI_VERSION,
+                pid: process.pid,
+                bridgePort: bridge.port,
+                browsers: bridge.listBrowsers().length,
+            };
+        case 'listBrowsers':
+            return { browsers: bridge.listBrowsers() };
+        case 'waitForBrowser': {
+            const browserId = await bridge.waitForBrowser({
+                timeoutMs: timeoutFrom(params, 30_000),
+                browserId: optionalString(params, 'browserId'),
+            });
+            const found = bridge.listBrowsers().find((b) => b.browserId === browserId);
+            return { browserId, label: found?.label ?? '' };
+        }
+        case 'listTabs': {
+            const browserId = optionalString(params, 'browserId');
+            const waitMs = timeoutFrom(params, 0);
+            const resolved = waitMs > 0
+                ? await bridge.waitForBrowser({ timeoutMs: waitMs, browserId })
+                : bridge.resolveBrowser(browserId);
+            const answer = await bridge.listTabs(resolved);
+            const found = bridge.listBrowsers().find((b) => b.browserId === resolved);
+            return {
+                browserId: resolved,
+                label: found?.label ?? '',
+                windows: answer.windows,
+                tabs: answer.tabs,
+            };
+        }
+        case 'scan': {
+            const browserId = optionalString(params, 'browserId');
+            const waitMs = timeoutFrom(params, 0);
+            const resolved = waitMs > 0
+                ? await bridge.waitForBrowser({ timeoutMs: waitMs, browserId })
+                : bridge.resolveBrowser(browserId);
+            const url = optionalString(params, 'url');
+            const tabId = optionalInteger(params, 'tabId');
+            if ((url === undefined) === (tabId === undefined)) {
+                throw new PageScannerError('BAD_REQUEST', 'Give exactly one of url and tabId.');
+            }
+            const quality = params.quality;
+            if (quality !== undefined && (typeof quality !== 'number' || !(quality > 0) || quality > 1)) {
+                throw new PageScannerError('BAD_REQUEST', 'quality must be a number in (0, 1].');
+            }
+            const answer = await bridge.scan(resolved, {
+                ...(url !== undefined ? { url } : {}),
+                ...(tabId !== undefined ? { tabId } : {}),
+                ...(optionalInteger(params, 'windowId') !== undefined
+                    ? { windowId: optionalInteger(params, 'windowId') }
+                    : {}),
+                format: oneOf(params, 'format', EXPORT_FORMAT_IDS, 'pdf'),
+                pageSize: oneOf(params, 'pageSize', PAGE_SIZE_IDS, DEFAULT_PAGE_SIZE),
+                ...(quality !== undefined ? { quality } : {}),
+                ...(params.videoHandling !== undefined
+                    ? {
+                        videoHandling: oneOf(params, 'videoHandling', VIDEO_HANDLINGS, 'frame'),
+                    }
+                    : {}),
+                ...(params.openEditor !== undefined ? { openEditor: params.openEditor === true } : {}),
+            }, timeoutFrom({ timeoutMs: params.scanTimeoutMs }, 120_000));
+            return {
+                browserId: resolved,
+                width: answer.width,
+                height: answer.height,
+                mode: answer.mode,
+                fileName: answer.fileName,
+                truncated: answer.truncated ?? null,
+                bytesBase64: answer.bytesBase64,
+            };
+        }
+        case 'shutdown':
+            return { ok: true };
+        default:
+            throw new PageScannerError('BAD_REQUEST', `Unknown method ${JSON.stringify(method)}.`);
+    }
+}
+export function startRpcServer(options) {
+    const server = createServer((request, response) => {
+        void handle(request, response, options, server);
+    });
+    // A scan can sit on a long-poll for two minutes. Node's default request
+    // timeout would cut it off at five, and `--wait` plus `--timeout` can
+    // legitimately exceed that; the client sets its own deadline instead.
+    server.requestTimeout = 0;
+    server.headersTimeout = 0;
+    return new Promise((resolve, reject) => {
+        const onError = (error) => reject(error);
+        server.once('error', onError);
+        server.listen(options.port ?? 0, '127.0.0.1', () => {
+            server.off('error', onError);
+            const address = server.address();
+            const port = typeof address === 'object' && address !== null ? address.port : 0;
+            resolve({
+                port,
+                close: () => new Promise((done) => {
+                    server.closeAllConnections();
+                    server.close(() => done());
+                }),
+            });
+        });
+    });
+}
+async function handle(request, response, options, server) {
+    const unauthorised = {
+        ok: false,
+        error: { code: 'BAD_REQUEST', message: 'Unauthorized.' },
+    };
+    const header = request.headers.authorization ?? '';
+    const presented = header.startsWith('Bearer ') ? header.slice('Bearer '.length) : '';
+    if (!tokensMatch(presented, options.secret)) {
+        send(response, 401, unauthorised);
+        return;
+    }
+    if (request.method !== 'POST' || (request.url ?? '') !== '/rpc') {
+        send(response, 404, {
+            ok: false,
+            error: { code: 'BAD_REQUEST', message: 'POST /rpc is the only route.' },
+        });
+        return;
+    }
+    options.onActivity?.();
+    let method = '';
+    try {
+        const raw = await readBody(request);
+        const body = asRecord(JSON.parse(raw || '{}'));
+        if (typeof body.method !== 'string' || body.method.length === 0) {
+            throw new PageScannerError('BAD_REQUEST', 'method is required.');
+        }
+        method = body.method;
+        const result = await dispatch(method, asRecord(body.params), options);
+        send(response, 200, { ok: true, result });
+    }
+    catch (error) {
+        const failure = toPageScannerError(error);
+        send(response, 200, {
+            ok: false,
+            error: {
+                code: failure.code,
+                message: failure.message,
+                ...(failure.hint !== undefined ? { hint: failure.hint } : {}),
+            },
+        });
+    }
+    // Answer first, then go: the caller should see `{ ok: true }` rather than a
+    // dropped connection.
+    if (method === 'shutdown') {
+        server.closeIdleConnections();
+        options.onShutdown();
+    }
+}
+//# sourceMappingURL=rpc-server.js.map

package/dist/daemon/rpc-server.js.map

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

package/dist/daemon/run.d.ts

@@ -0,0 +1,20 @@
+/** How long the daemon stays up with nothing connected and nobody calling. */
+export declare const DEFAULT_IDLE_MINUTES = 15;
+export interface RunDaemonOptions {
+    /** Detached: no interactive output, and the log goes to the file. */
+    detached?: boolean;
+    /** 0 means never exit on idle. Defaults to PAGE_SCANNER_IDLE_MINUTES or 15. */
+    idleMinutes?: number;
+    log?: (message: string) => void;
+    /** Resolves when the daemon has stopped. Awaited by `serve` in the foreground. */
+    onListening?: (info: {
+        bridgePort: number;
+        rpcPort: number;
+    }) => void;
+}
+/**
+ * Runs until something stops it: a `shutdown` call, SIGINT, SIGTERM, or the
+ * idle timer. Resolves when it has shut down cleanly.
+ */
+export declare function runDaemon(options?: RunDaemonOptions): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/daemon/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/daemon/run.ts"],"names":[],"mappings":"AAeA,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAGvC,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,kFAAkF;IAClF,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACvE;AAUD;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyH7E"}

package/dist/daemon/run.js

@@ -0,0 +1,129 @@
+/**
+ * The daemon process: the bridge listener plus its RPC control surface.
+ *
+ * `page-scanner serve` runs it in the foreground; `serve --daemon` is what
+ * `connectDaemon` spawns behind a command that needed one. Both end up here.
+ */
+import { randomBytes } from 'node:crypto';
+import { readConfig } from '../config.js';
+import { PageScannerError } from '../errors.js';
+import { BridgeServer } from '../bridge/server.js';
+import { CLI_VERSION } from '../version.js';
+import { startRpcServer } from './rpc-server.js';
+import { clearDaemonState, readDaemonState, writeDaemonState } from './state.js';
+/** How long the daemon stays up with nothing connected and nobody calling. */
+export const DEFAULT_IDLE_MINUTES = 15;
+const IDLE_CHECK_INTERVAL_MS = 30_000;
+function idleMinutesFrom(explicit) {
+    if (explicit !== undefined)
+        return explicit;
+    const fromEnv = process.env.PAGE_SCANNER_IDLE_MINUTES;
+    if (fromEnv === undefined || fromEnv === '')
+        return DEFAULT_IDLE_MINUTES;
+    const parsed = Number(fromEnv);
+    return Number.isFinite(parsed) && parsed >= 0 ? parsed : DEFAULT_IDLE_MINUTES;
+}
+/**
+ * Runs until something stops it: a `shutdown` call, SIGINT, SIGTERM, or the
+ * idle timer. Resolves when it has shut down cleanly.
+ */
+export async function runDaemon(options = {}) {
+    const log = options.log ?? ((message) => process.stderr.write(`${message}\n`));
+    const existing = readDaemonState();
+    if (existing) {
+        log(`page-scanner is already running (pid ${existing.pid}, rpc port ${existing.rpcPort}).`);
+        return;
+    }
+    const config = readConfig();
+    if (!config.token) {
+        // Refusing beats starting unpaired. An empty token would compare equal to
+        // the empty token any process could send, so an unpaired daemon is not a
+        // daemon with no clients, it is one that accepts everybody.
+        throw new PageScannerError('NOT_PAIRED', 'There is no pairing on this machine, so the bridge has nothing to check against.', 'Run `page-scanner pair` first.');
+    }
+    const bridge = new BridgeServer({ port: config.port, token: config.token, log });
+    try {
+        await bridge.start();
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === 'EADDRINUSE') {
+            throw new PageScannerError('PORT_IN_USE', `Port ${config.port} is already in use, and no page-scanner daemon is registered on it.`, 'An older page-scanner-mcp 0.1 holds this port when it is running; stop it, or pick ' +
+                'another port with `page-scanner pair --port <n>` and re-pair the browser.');
+        }
+        throw new PageScannerError('DAEMON_FAILED', `Could not listen on 127.0.0.1:${config.port}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const secret = randomBytes(32).toString('base64url');
+    let lastActivity = Date.now();
+    let stopping = false;
+    // `stop` can be called from four places (a shutdown call, two signals and the
+    // idle timer) at any point after the RPC server is up, so the promise it
+    // settles has to exist before any of them is wired.
+    let finish = () => { };
+    const stopped = new Promise((resolve) => {
+        finish = resolve;
+    });
+    // Assigned as each one comes up, so a shutdown arriving between two awaits
+    // tears down whatever exists rather than tripping over a binding that is not
+    // initialised yet.
+    let rpc = null;
+    let idleTimer = null;
+    const shutdown = async () => {
+        if (idleTimer)
+            clearInterval(idleTimer);
+        process.off('SIGINT', stop);
+        process.off('SIGTERM', stop);
+        if (rpc)
+            await rpc.close();
+        await bridge.close();
+        clearDaemonState();
+        log('page-scanner daemon stopped.');
+        finish();
+    };
+    const stop = () => {
+        if (stopping)
+            return;
+        stopping = true;
+        void shutdown();
+    };
+    rpc = await startRpcServer({
+        bridge,
+        secret,
+        onShutdown: stop,
+        onActivity: () => {
+            lastActivity = Date.now();
+        },
+    });
+    writeDaemonState({
+        pid: process.pid,
+        rpcPort: rpc.port,
+        secret,
+        bridgePort: bridge.port,
+        version: CLI_VERSION,
+        startedAt: Date.now(),
+    });
+    options.onListening?.({ bridgePort: bridge.port, rpcPort: rpc.port });
+    log(`page-scanner daemon ${CLI_VERSION} ready (pid ${process.pid}, rpc port ${rpc.port}).`);
+    const idleMinutes = idleMinutesFrom(options.idleMinutes);
+    idleTimer =
+        idleMinutes > 0
+            ? setInterval(() => {
+                // Never exit while a browser is attached. The open socket is what
+                // keeps Chrome's service worker alive; dropping it would retire the
+                // worker and make the next command wait for a reconnect.
+                if (bridge.listBrowsers().length > 0) {
+                    lastActivity = Date.now();
+                    return;
+                }
+                if (Date.now() - lastActivity >= idleMinutes * 60_000) {
+                    log(`idle for ${idleMinutes} minutes with nothing connected, stopping.`);
+                    stop();
+                }
+            }, IDLE_CHECK_INTERVAL_MS)
+            : null;
+    idleTimer?.unref();
+    process.on('SIGINT', stop);
+    process.on('SIGTERM', stop);
+    await stopped;
+}
+//# sourceMappingURL=run.js.map

package/dist/daemon/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/daemon/run.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAwB,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAYtC,SAAS,eAAe,CAAC,QAA4B;IACnD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;IACtD,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,oBAAoB,CAAC;IACzE,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/B,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC;AAChF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,UAA4B,EAAE;IAC5D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC;IAEvF,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IACnC,IAAI,QAAQ,EAAE,CAAC;QACb,GAAG,CAAC,wCAAwC,QAAQ,CAAC,GAAG,cAAc,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;QAC5F,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,0EAA0E;QAC1E,yEAAyE;QACzE,4DAA4D;QAC5D,MAAM,IAAI,gBAAgB,CACxB,YAAY,EACZ,kFAAkF,EAClF,gCAAgC,CACjC,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IACjF,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;QACnD,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1B,MAAM,IAAI,gBAAgB,CACxB,aAAa,EACb,QAAQ,MAAM,CAAC,IAAI,qEAAqE,EACxF,qFAAqF;gBACnF,2EAA2E,CAC9E,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,gBAAgB,CACxB,eAAe,EACf,iCAAiC,MAAM,CAAC,IAAI,KAC1C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE,CACH,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACrD,IAAI,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC9B,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,8EAA8E;IAC9E,yEAAyE;IACzE,oDAAoD;IACpD,IAAI,MAAM,GAAe,GAAG,EAAE,GAAE,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAC5C,MAAM,GAAG,OAAO,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,2EAA2E;IAC3E,6EAA6E;IAC7E,mBAAmB;IACnB,IAAI,GAAG,GAA2B,IAAI,CAAC;IACvC,IAAI,SAAS,GAA0B,IAAI,CAAC;IAE5C,MAAM,QAAQ,GAAG,KAAK,IAAmB,EAAE;QACzC,IAAI,SAAS;YAAE,aAAa,CAAC,SAAS,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,GAAG;YAAE,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAC3B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,gBAAgB,EAAE,CAAC;QACnB,GAAG,CAAC,8BAA8B,CAAC,CAAC;QACpC,MAAM,EAAE,CAAC;IACX,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,IAAI,QAAQ;YAAE,OAAO;QACrB,QAAQ,GAAG,IAAI,CAAC;QAChB,KAAK,QAAQ,EAAE,CAAC;IAClB,CAAC,CAAC;IAEF,GAAG,GAAG,MAAM,cAAc,CAAC;QACzB,MAAM;QACN,MAAM;QACN,UAAU,EAAE,IAAI;QAChB,UAAU,EAAE,GAAG,EAAE;YACf,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,CAAC;KACF,CAAC,CAAC;IAEH,gBAAgB,CAAC;QACf,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,OAAO,EAAE,GAAG,CAAC,IAAI;QACjB,MAAM;QACN,UAAU,EAAE,MAAM,CAAC,IAAI;QACvB,OAAO,EAAE,WAAW;QACpB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC,CAAC;IAEH,OAAO,CAAC,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACtE,GAAG,CAAC,uBAAuB,WAAW,eAAe,OAAO,CAAC,GAAG,cAAc,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC;IAE5F,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACzD,SAAS;QACP,WAAW,GAAG,CAAC;YACb,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE;gBACf,kEAAkE;gBAClE,oEAAoE;gBACpE,yDAAyD;gBACzD,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;oBAC1B,OAAO;gBACT,CAAC;gBACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,IAAI,WAAW,GAAG,MAAM,EAAE,CAAC;oBACtD,GAAG,CAAC,YAAY,WAAW,4CAA4C,CAAC,CAAC;oBACzE,IAAI,EAAE,CAAC;gBACT,CAAC;YACH,CAAC,EAAE,sBAAsB,CAAC;YAC5B,CAAC,CAAC,IAAI,CAAC;IACX,SAAS,EAAE,KAAK,EAAE,CAAC;IAEnB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC3B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAE5B,MAAM,OAAO,CAAC;AAChB,CAAC"}

package/dist/daemon/self.d.ts

@@ -0,0 +1,25 @@
+export interface SelfCommand {
+    /** The executable to spawn. */
+    command: string;
+    /** Arguments that come before the subcommand. */
+    args: string[];
+}
+/** True when running inside a `bun build --compile` single-file executable. */
+export declare function isCompiledBinary(argv?: string[]): boolean;
+/**
+ * This package's own `bin`, found from this module's location rather than from
+ * the process. Undefined when there is no file there, which means the code has
+ * been bundled into one file and the caller should fall back to `argv[1]`.
+ */
+export declare function packageEntry(moduleUrl?: string): string | undefined;
+/**
+ * How to run this package's CLI again.
+ * @param argv defaults to process.argv, injectable for tests.
+ * @param execPath defaults to process.execPath, injectable for tests.
+ * @param findEntry how to locate this package's bin, injectable for tests. It
+ *   is a function rather than a value because a default parameter fires on an
+ *   explicit `undefined` too, so a test could not otherwise ask for the
+ *   bundled path where there is no bin at all.
+ */
+export declare function selfCommand(argv?: string[], execPath?: string, findEntry?: () => string | undefined): SelfCommand;
+//# sourceMappingURL=self.d.ts.map

package/dist/daemon/self.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self.d.ts","sourceRoot":"","sources":["../../src/daemon/self.ts"],"names":[],"mappings":"AAwCA,MAAM,WAAW,WAAW;IAC1B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AA0BD,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAMvE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,SAAkB,GAAG,MAAM,GAAG,SAAS,CAW5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,IAAI,GAAE,MAAM,EAAiB,EAC7B,QAAQ,SAAmB,EAC3B,SAAS,GAAE,MAAM,MAAM,GAAG,SAAwB,GACjD,WAAW,CAoBb"}

package/dist/daemon/self.js

@@ -0,0 +1,113 @@
+/**
+ * How this package runs its own CLI again.
+ *
+ * The daemon is not a second program: it is this package's `bin` started with
+ * `serve --daemon`. `ensureDaemon()` has to spawn it, and the only hard part is
+ * working out what "this package's bin" is from inside a running process.
+ *
+ * It is **not** `process.argv[1]`. That is whatever script started the process,
+ * which is this bin only when somebody typed `page-scanner`. Inside
+ * `@page-scanner/mcp` it is the MCP server's bin, and re-running that with
+ * `serve --daemon` starts a second MCP server on stdio: nothing binds 45711,
+ * and every tool call fails with "the daemon did not come up within 5s" for
+ * ever. Inside a library consumer it is the consumer's own entry file, which
+ * then runs again, detached, side effects and all, once every retry. Both were
+ * reproduced against the packed tarballs before this was written.
+ *
+ * This module ships next to the bin it has to spawn, so it can find it without
+ * asking the process anything: `dist/daemon/self.js` sits under `dist/bin.js`,
+ * and `src/daemon/self.ts` under `src/bin.ts` when Node runs the TypeScript
+ * directly. Taking the extension from this module's own path covers both.
+ *
+ * Two layouts have no such file, and each has its own answer:
+ * - A `bun build --compile` executable embeds the script, so the binary is
+ *   spawned on its own. A probe compiled with bun 1.4.2 on darwin-arm64 reports
+ *   `argv = ['bun', '/$bunfs/root/<binary>', ...args]` and `execPath = <the
+ *   binary>`, which is what `isCompiledBinary` reads. The Windows `B:\~BUN\`
+ *   form is still an assumption, because nobody has run the compiled .exe yet.
+ * - A single-file esbuild bundle, which is what the `.mcpb` ships, inlines the
+ *   daemon and everything else into `argv[1]`. Falling back to `argv[1]` is
+ *   right there, and both bundled entry points answer `serve --daemon`.
+ *
+ * Getting any of it wrong is not silent: the spawned process fails to start or
+ * prints usage, and `ensureDaemon()` gives up with DAEMON_FAILED.
+ */
+import { existsSync } from 'node:fs';
+import { dirname, extname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { PageScannerError } from '../errors.js';
+/**
+ * What Bun puts in `argv[1]` inside a compiled binary: a path into the virtual
+ * filesystem it embeds the script in, which exists only inside that process.
+ * Spawning it would fail, so it counts as no script.
+ * Compared case-insensitively with `\` folded to `/`, because the Windows form
+ * is a fake drive letter.
+ */
+const EMBEDDED_SCRIPT_PREFIXES = ['/$bunfs/', 'b:/~bun/', '/~bun/'];
+/**
+ * `process.versions.bun` is not part of @types/node. The interface does carry
+ * an index signature, so the read happens to compile, but that is an accident
+ * of the typings rather than a contract: name the shape we rely on instead.
+ */
+function bunVersion() {
+    const versions = process.versions;
+    return versions.bun;
+}
+function isEmbeddedScriptPath(path) {
+    const normalised = path.replaceAll('\\', '/').toLowerCase();
+    return EMBEDDED_SCRIPT_PREFIXES.some((prefix) => normalised.startsWith(prefix));
+}
+/** True when running inside a `bun build --compile` single-file executable. */
+export function isCompiledBinary(argv = process.argv) {
+    // Running under Bun is necessary but not sufficient: `bun ./src/bin.ts` is
+    // Bun too, and that one does have a script to hand back.
+    if (bunVersion() === undefined)
+        return false;
+    const script = argv[1];
+    return script === undefined || script === '' || isEmbeddedScriptPath(script);
+}
+/**
+ * This package's own `bin`, found from this module's location rather than from
+ * the process. Undefined when there is no file there, which means the code has
+ * been bundled into one file and the caller should fall back to `argv[1]`.
+ */
+export function packageEntry(moduleUrl = import.meta.url) {
+    let here;
+    try {
+        here = fileURLToPath(moduleUrl);
+    }
+    catch {
+        return undefined;
+    }
+    // `bin` carries this module's own extension, so `dist/daemon/self.js` finds
+    // `dist/bin.js` and `src/daemon/self.ts` finds `src/bin.ts` with no branch.
+    const entry = join(dirname(here), '..', `bin${extname(here)}`);
+    return existsSync(entry) ? entry : undefined;
+}
+/**
+ * How to run this package's CLI again.
+ * @param argv defaults to process.argv, injectable for tests.
+ * @param execPath defaults to process.execPath, injectable for tests.
+ * @param findEntry how to locate this package's bin, injectable for tests. It
+ *   is a function rather than a value because a default parameter fires on an
+ *   explicit `undefined` too, so a test could not otherwise ask for the
+ *   bundled path where there is no bin at all.
+ */
+export function selfCommand(argv = process.argv, execPath = process.execPath, findEntry = packageEntry) {
+    if (isCompiledBinary(argv))
+        return { command: execPath, args: [] };
+    const entry = findEntry();
+    if (entry !== undefined)
+        return { command: execPath, args: [entry] };
+    // Bundled into one file: that file is both this module and the entry point,
+    // and `argv[1]` is where it lives.
+    const script = argv[1];
+    if (script === undefined || script === '') {
+        // Node was started with no script — `-e`, `--eval`, a REPL, or an embedder
+        // — and there is no bin on disk to fall back to. Guessing would spawn the
+        // wrong thing.
+        throw new PageScannerError('DAEMON_FAILED', 'page-scanner cannot work out how to restart itself: this process was started without a script path.', 'Start the daemon yourself with `page-scanner serve`, or run the CLI from its installed `page-scanner` command.');
+    }
+    return { command: execPath, args: [script] };
+}
+//# sourceMappingURL=self.js.map

package/dist/daemon/self.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self.js","sourceRoot":"","sources":["../../src/daemon/self.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAShD;;;;;;GAMG;AACH,MAAM,wBAAwB,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAU,CAAC;AAE7E;;;;GAIG;AACH,SAAS,UAAU;IACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAwD,CAAC;IAClF,OAAO,QAAQ,CAAC,GAAG,CAAC;AACtB,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY;IACxC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5D,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AAClF,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB,CAAC,OAAiB,OAAO,CAAC,IAAI;IAC5D,2EAA2E;IAC3E,yDAAyD;IACzD,IAAI,UAAU,EAAE,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACvB,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE,IAAI,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC/E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG;IACtD,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,4EAA4E;IAC5E,4EAA4E;IAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/D,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CACzB,OAAiB,OAAO,CAAC,IAAI,EAC7B,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAC3B,YAAsC,YAAY;IAElD,IAAI,gBAAgB,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAEnE,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;IAErE,4EAA4E;IAC5E,mCAAmC;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;QAC1C,2EAA2E;QAC3E,0EAA0E;QAC1E,eAAe;QACf,MAAM,IAAI,gBAAgB,CACxB,eAAe,EACf,qGAAqG,EACrG,gHAAgH,CACjH,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;AAC/C,CAAC"}

package/dist/daemon/state.d.ts

@@ -0,0 +1,25 @@
+export interface DaemonState {
+    pid: number;
+    /** The loopback HTTP port the daemon answers RPC on. Ephemeral, chosen at start. */
+    rpcPort: number;
+    /** Bearer secret for that port, regenerated every run. */
+    secret: string;
+    /** The WebSocket port the extension dials, from the pairing config. */
+    bridgePort: number;
+    /** The CLI version that started it, so a client can restart a stale one. */
+    version: string;
+    startedAt: number;
+}
+export declare function daemonStatePath(): string;
+export declare function daemonLogPath(): string;
+/**
+ * Reads the record, or null if there is nothing usable to read: no file, bad
+ * JSON, a field missing or of the wrong type, or a pid that no longer exists.
+ * It never throws — it is on the path every command takes before it can do
+ * anything, and a corrupt file there should cost a restart, not a crash.
+ */
+export declare function readDaemonState(): DaemonState | null;
+export declare function writeDaemonState(state: DaemonState): void;
+export declare function clearDaemonState(): void;
+export declare function processAlive(pid: number): boolean;
+//# sourceMappingURL=state.d.ts.map

package/dist/daemon/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/daemon/state.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAWD;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,WAAW,GAAG,IAAI,CAqBpD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAazD;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAQvC;AAQD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAiBjD"}