@page-scanner/cli 0.1.0

package/dist/cli/format.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Turning results into the text a person reads.
+ *
+ * Every function here is pure: data in, a string out, no writing and no
+ * colour. A command can then be tested on what it computed rather than on what
+ * it printed, and the `--json` path skips this file entirely.
+ *
+ * The house style for the tables is "plain enough to pipe". No box drawing, no
+ * separator row, no pipes, and no trailing whitespace on any line, because the
+ * next thing to read this output is as likely to be `awk` as a person.
+ */
+import type { ConnectedBrowser } from '../bridge/server.js';
+import type { TabSummary, TruncationReport, WindowSummary } from '../protocol.js';
+/** A plain column-aligned table. Returns '' for an empty rows array. */
+export declare function table(headers: string[], rows: string[][]): string;
+export declare function formatBrowsers(browsers: ConnectedBrowser[]): string;
+export declare function formatTabs(windows: WindowSummary[], tabs: TabSummary[]): string;
+/** One line, for stderr, when a capture stopped short of the whole page. */
+export declare function formatTruncation(report: TruncationReport): string;
+/** e.g. "3s", "2m 04s". */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/cli/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/cli/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAiBlF,wEAAwE;AACxE,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CA+BjE;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAWnE;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,CAmC/E;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CASjE;AAED,2BAA2B;AAC3B,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CASjD"}

package/dist/cli/format.js

@@ -0,0 +1,152 @@
+/**
+ * How much room a tab title gets.
+ *
+ * The terminal's real width is deliberately not consulted. A piped run has no
+ * width to read (`process.stdout.columns` is undefined when stdout is not a
+ * TTY), so the choice would be between one layout when a person looks at it
+ * and another when a script does, which is both harder to read and harder to
+ * assert on. 60 is a budget in code points, not in terminal columns: a title
+ * of CJK or emoji occupies up to twice its length on screen, so the 80-column
+ * claim below holds for a Latin title and is a guideline for anything else.
+ * Measuring real display width would mean carrying an East Asian Width table,
+ * which is not worth it to keep a tab listing tidy.
+ */
+const TITLE_WIDTH = 60;
+/** A plain column-aligned table. Returns '' for an empty rows array. */
+export function table(headers, rows) {
+    if (rows.length === 0)
+        return '';
+    // A row is allowed to be shorter or longer than the header row, so the
+    // column count is whatever the widest thing passed in has.
+    const columns = Math.max(headers.length, ...rows.map((row) => row.length));
+    const widths = [];
+    for (let index = 0; index < columns; index += 1) {
+        let width = headers[index]?.length ?? 0;
+        for (const row of rows)
+            width = Math.max(width, row[index]?.length ?? 0);
+        widths[index] = width;
+    }
+    const line = (cells) => {
+        const padded = [];
+        for (let index = 0; index < columns; index += 1) {
+            const cell = cells[index] ?? '';
+            // The last column is never padded, and the line is trimmed at the end on
+            // top of that: a row whose tail cells are empty must not leave invisible
+            // whitespace behind for whatever is reading the pipe.
+            padded.push(index === columns - 1 ? cell : cell.padEnd(widths[index] ?? 0));
+        }
+        return padded.join('  ').trimEnd();
+    };
+    // A caller that passes no headers, or only blank ones, wants rows alone
+    // rather than a leading empty line.
+    const body = rows.map(line);
+    return headers.some((header) => header.length > 0)
+        ? [line(headers), ...body].join('\n')
+        : body.join('\n');
+}
+export function formatBrowsers(browsers) {
+    if (browsers.length === 0)
+        return 'No browser is connected.';
+    return table(['LABEL', 'BROWSER ID', 'VERSION', 'CONNECTED'], browsers.map((browser) => [
+        browser.label,
+        browser.browserId,
+        browser.extensionVersion,
+        formatDuration(browser.connectedForMs),
+    ]));
+}
+export function formatTabs(windows, tabs) {
+    if (windows.length === 0 && tabs.length === 0)
+        return 'No tabs are open.';
+    // Seed the groups from the window list so a window with nothing in it still
+    // shows up, then file each tab. A tab whose window was not listed gets a
+    // group of its own rather than being dropped: the two lists come off the
+    // wire separately and the tab is the thing the user asked for.
+    const grouped = new Map();
+    for (const window of windows)
+        grouped.set(window.windowId, []);
+    for (const tab of tabs) {
+        const group = grouped.get(tab.windowId);
+        if (group)
+            group.push(tab);
+        else
+            grouped.set(tab.windowId, [tab]);
+    }
+    const summaries = new Map(windows.map((window) => [window.windowId, window]));
+    const blocks = [];
+    for (const [windowId, group] of grouped) {
+        const lines = [windowHeading(windowId, summaries.get(windowId), group.length)];
+        const body = table(['', 'TAB', 'TITLE', 'URL'], group.map((tab) => [
+            tab.active ? '*' : '',
+            String(tab.tabId),
+            truncate(tab.title.trim() || '(untitled)', TITLE_WIDTH),
+            // The URL is the last column and is never cut. It is the one cell a
+            // person is likely to copy, and a shortened one is worse than a long
+            // line the terminal wraps itself.
+            tab.url,
+        ]));
+        if (body)
+            lines.push(body);
+        blocks.push(lines.join('\n'));
+    }
+    return blocks.join('\n\n');
+}
+/** One line, for stderr, when a capture stopped short of the whole page. */
+export function formatTruncation(report) {
+    const measured = `${px(report.requestedWidth)}x${px(report.requestedHeight)}`;
+    const captured = `${px(report.width)}x${px(report.height)}`;
+    const head = `Truncated: the page measured ${measured} CSS px, captured ${captured}.`;
+    // The sentence is quoted, not paraphrased. The extension owns the ceiling
+    // that caused this and is the only side that knows what it is, so restating
+    // it here would be a second copy of a limit that lives over there.
+    const message = report.message.trim();
+    return message ? `${head} ${message}` : head;
+}
+/** e.g. "3s", "2m 04s". */
+export function formatDuration(ms) {
+    if (!Number.isFinite(ms) || ms <= 0)
+        return '0s';
+    const total = Math.round(ms / 1000);
+    if (total < 60)
+        return `${total}s`;
+    const minutes = Math.floor(total / 60);
+    if (minutes < 60)
+        return `${minutes}m ${pad2(total % 60)}s`;
+    // A browser left connected overnight would otherwise read as "734m 09s".
+    // Past an hour the seconds carry no information anyone acts on.
+    return `${Math.floor(minutes / 60)}h ${pad2(minutes % 60)}m`;
+}
+function windowHeading(windowId, summary, shown) {
+    const parts = [];
+    if (summary?.focused)
+        parts.push('focused');
+    if (summary && summary.windowType)
+        parts.push(summary.windowType);
+    // The window's own figure, which the extension builds in the same loop that
+    // produces the rows, so it should equal them. Printing it rather than the
+    // row count means a disagreement shows up here instead of being hidden.
+    const count = summary?.tabCount ?? shown;
+    parts.push(count === 1 ? '1 tab' : `${count} tabs`);
+    return `Window ${windowId} (${parts.join(', ')})`;
+}
+function truncate(text, width) {
+    // Cut by code point, not by `slice`. A page title with an emoji in it is
+    // ordinary, and slicing UTF-16 code units can land between a surrogate pair
+    // and emit a lone surrogate, which a terminal draws as a replacement glyph.
+    const characters = Array.from(text);
+    if (characters.length <= width)
+        return text;
+    // One character short of the width, so the ellipsis lands inside it, and
+    // trimmed so it is not hung off the end of a space.
+    return `${characters
+        .slice(0, width - 1)
+        .join('')
+        .trimEnd()}…`;
+}
+/** A CSS pixel measurement can be fractional; nobody wants to read that. */
+function px(value) {
+    return String(Math.round(value));
+}
+function pad2(value) {
+    return String(value).padStart(2, '0');
+}
+//# sourceMappingURL=format.js.map

package/dist/cli/format.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+export declare const DEFAULT_PORT = 45711;
+export interface PairingConfig {
+    port: number;
+    token: string;
+}
+/** `PAGE_SCANNER_HOME` exists so a test can point the whole thing at a tmpdir. */
+export declare function configDir(): string;
+export declare function configPath(): string;
+export declare function readConfig(): PairingConfig;
+/** Creates a pairing if there is none, and returns whatever is now on disk. */
+export declare function ensureConfig({ port, rotate, }?: {
+    port?: number;
+    rotate?: boolean;
+}): PairingConfig;
+/** True on every platform that actually enforces the 0600 above. */
+export declare function configFileIsOwnerOnly(): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,YAAY,QAAQ,CAAC;AAElC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,kFAAkF;AAClF,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,UAAU,IAAI,aAAa,CAW1C;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,MAAc,GACf,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,aAAa,CAU1D;AAED,oEAAoE;AACpE,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C"}

package/dist/config.js

@@ -0,0 +1,54 @@
+/**
+ * Where the pairing lives: `~/.page-scanner/config.json`, mode 0600.
+ *
+ * The token is the only thing standing between a local agent and a scan of any
+ * tab the user has open, so the file is owner-readable and nothing else. On
+ * Windows that mode is a no-op: NTFS does not implement it, and the file is
+ * readable by anything running as the user. The README says so rather than the
+ * `pair` output claiming a guarantee the platform does not give.
+ *
+ * The shape is the one page-scanner-mcp 0.1 wrote, so a browser paired against
+ * that version keeps working.
+ */
+import { randomBytes } from 'node:crypto';
+import { chmodSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+export const DEFAULT_PORT = 45711;
+/** `PAGE_SCANNER_HOME` exists so a test can point the whole thing at a tmpdir. */
+export function configDir() {
+    return process.env.PAGE_SCANNER_HOME ?? join(homedir(), '.page-scanner');
+}
+export function configPath() {
+    return join(configDir(), 'config.json');
+}
+export function readConfig() {
+    try {
+        const raw = JSON.parse(readFileSync(configPath(), 'utf8'));
+        const record = typeof raw === 'object' && raw !== null ? raw : {};
+        return {
+            port: Number(record.port) || DEFAULT_PORT,
+            token: typeof record.token === 'string' ? record.token : '',
+        };
+    }
+    catch {
+        return { port: DEFAULT_PORT, token: '' };
+    }
+}
+/** Creates a pairing if there is none, and returns whatever is now on disk. */
+export function ensureConfig({ port, rotate = false, } = {}) {
+    const current = readConfig();
+    const next = {
+        port: port ?? current.port,
+        token: rotate || !current.token ? randomBytes(32).toString('base64url') : current.token,
+    };
+    mkdirSync(configDir(), { recursive: true, mode: 0o700 });
+    writeFileSync(configPath(), `${JSON.stringify(next, null, 2)}\n`, { mode: 0o600 });
+    chmodSync(configPath(), 0o600);
+    return next;
+}
+/** True on every platform that actually enforces the 0600 above. */
+export function configFileIsOwnerOnly() {
+    return process.platform !== 'win32';
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC;AAOlC,kFAAkF;AAClF,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,eAAe,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,aAAa,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC,CAAE,GAA+B,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/F,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,YAAY;YACzC,KAAK,EAAE,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;SAC5D,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,EAC3B,IAAI,EACJ,MAAM,GAAG,KAAK,MACyB,EAAE;IACzC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAkB;QAC1B,IAAI,EAAE,IAAI,IAAI,OAAO,CAAC,IAAI;QAC1B,KAAK,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK;KACxF,CAAC;IACF,SAAS,CAAC,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACzD,aAAa,CAAC,UAAU,EAAE,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACnF,SAAS,CAAC,UAAU,EAAE,EAAE,KAAK,CAAC,CAAC;IAC/B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,qBAAqB;IACnC,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;AACtC,CAAC"}

package/dist/daemon/client.d.ts

@@ -0,0 +1,28 @@
+import { type DaemonState } from './state.js';
+/** How long to wait for a freshly spawned daemon to publish its state and answer. */
+export declare const DAEMON_START_TIMEOUT_MS = 5000;
+export interface DaemonClient {
+    state: DaemonState;
+    call<T>(method: string, params?: Record<string, unknown>, timeoutMs?: number): Promise<T>;
+}
+export interface ConnectOptions {
+    /**
+     * Starts the daemon. Injectable so a test can assert the spawn decision
+     * without putting a process on the machine.
+     */
+    startDaemon?: () => void;
+    startTimeoutMs?: number;
+    /** Injectable so a test does not wait in real time. */
+    sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * Returns a client for a running daemon, starting one if necessary.
+ *
+ * A daemon left behind by an older install is shut down rather than reused:
+ * its RPC surface may not be the one this process expects, and the failure
+ * that produces is much harder to read than a restart.
+ */
+export declare function connectDaemon(options?: ConnectOptions): Promise<DaemonClient>;
+/** Returns true when a daemon was running and has been told to stop. */
+export declare function stopDaemon(): Promise<boolean>;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/daemon/client.ts"],"names":[],"mappings":"AAeA,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,YAAY,CAAC;AAEpB,qFAAqF;AACrF,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAG7C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC3F;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AA4FD;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAoCvF;AAED,wEAAwE;AACxE,wBAAsB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAkBnD"}

package/dist/daemon/client.js

@@ -0,0 +1,139 @@
+/**
+ * Talking to the daemon, and starting one if there is none.
+ *
+ * Every command except `serve` goes through here. The daemon exists because
+ * the extension is the WebSocket *client*: something has to be listening
+ * before Chrome can dial in, and a one-shot listener per command would mean
+ * the browser reconnecting for every invocation, which takes seconds and
+ * wakes a service worker that has just been retired.
+ */
+import { spawn } from 'node:child_process';
+import { openSync } from 'node:fs';
+import { PageScannerError, toPageScannerError } from '../errors.js';
+import { CLI_VERSION } from '../version.js';
+import { selfCommand } from './self.js';
+import { clearDaemonState, daemonLogPath, processAlive, readDaemonState, } from './state.js';
+/** How long to wait for a freshly spawned daemon to publish its state and answer. */
+export const DAEMON_START_TIMEOUT_MS = 5_000;
+const POLL_INTERVAL_MS = 100;
+const realSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+function clientFor(state) {
+    return {
+        state,
+        async call(method, params = {}, timeoutMs = 130_000) {
+            let response;
+            try {
+                response = await fetch(`http://127.0.0.1:${state.rpcPort}/rpc`, {
+                    method: 'POST',
+                    headers: {
+                        'content-type': 'application/json',
+                        authorization: `Bearer ${state.secret}`,
+                    },
+                    body: JSON.stringify({ method, params }),
+                    // The daemon long-polls a scan, so the client's deadline is the real
+                    // one. Five seconds of slack over the daemon's own timeout, so its
+                    // considered answer wins the race against this abort.
+                    signal: AbortSignal.timeout(timeoutMs + 5_000),
+                });
+            }
+            catch (error) {
+                throw new PageScannerError('DAEMON_FAILED', `The daemon on port ${state.rpcPort} did not answer: ${error instanceof Error ? error.message : String(error)}`, 'Run `page-scanner stop` and try again.');
+            }
+            if (response.status === 401) {
+                throw new PageScannerError('DAEMON_FAILED', 'The daemon rejected this process. Its secret changed under us.', 'Run `page-scanner stop` and try again.');
+            }
+            const envelope = (await response.json());
+            if (envelope.ok)
+                return envelope.result;
+            throw new PageScannerError(envelope.error?.code ?? 'SCAN_FAILED', envelope.error?.message ?? 'The daemon failed without saying why.', envelope.error?.hint);
+        },
+    };
+}
+/** A cheap liveness probe that never throws. */
+async function healthy(state) {
+    try {
+        return await clientFor(state).call('health', {}, 2_000);
+    }
+    catch {
+        return null;
+    }
+}
+/** Spawns this same program as `serve --daemon`, detached, and lets go of it. */
+function spawnDaemon() {
+    const { command, args } = selfCommand();
+    let log;
+    try {
+        log = openSync(daemonLogPath(), 'a');
+    }
+    catch (error) {
+        throw new PageScannerError('DAEMON_FAILED', `Could not open the daemon log at ${daemonLogPath()}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const child = spawn(command, [...args, 'serve', '--daemon'], {
+        detached: true,
+        stdio: ['ignore', log, log],
+        windowsHide: true,
+    });
+    child.unref();
+}
+/**
+ * Returns a client for a running daemon, starting one if necessary.
+ *
+ * A daemon left behind by an older install is shut down rather than reused:
+ * its RPC surface may not be the one this process expects, and the failure
+ * that produces is much harder to read than a restart.
+ */
+export async function connectDaemon(options = {}) {
+    const sleep = options.sleep ?? realSleep;
+    const start = options.startDaemon ?? spawnDaemon;
+    const deadlineMs = options.startTimeoutMs ?? DAEMON_START_TIMEOUT_MS;
+    const existing = readDaemonState();
+    if (existing) {
+        const health = await healthy(existing);
+        if (health && health.version === CLI_VERSION)
+            return clientFor(existing);
+        if (health) {
+            // Same machine, different version of this CLI. Replace it.
+            try {
+                await clientFor(existing).call('shutdown', {}, 2_000);
+            }
+            catch {
+                // It is going away either way.
+            }
+            await sleep(POLL_INTERVAL_MS);
+        }
+        clearDaemonState();
+    }
+    start();
+    for (let waited = 0; waited < deadlineMs; waited += POLL_INTERVAL_MS) {
+        await sleep(POLL_INTERVAL_MS);
+        const state = readDaemonState();
+        if (!state)
+            continue;
+        const health = await healthy(state);
+        if (health)
+            return clientFor(state);
+    }
+    throw new PageScannerError('DAEMON_FAILED', `The daemon did not come up within ${Math.round(deadlineMs / 1000)}s.`, `Run \`page-scanner serve\` in another terminal to see why, or read ${daemonLogPath()}.`);
+}
+/** Returns true when a daemon was running and has been told to stop. */
+export async function stopDaemon() {
+    const state = readDaemonState();
+    if (!state) {
+        clearDaemonState();
+        return false;
+    }
+    try {
+        await clientFor(state).call('shutdown', {}, 2_000);
+        return true;
+    }
+    catch (error) {
+        // It may have died without cleaning up after itself. Only report a
+        // failure if the process is genuinely still there.
+        if (!processAlive(state.pid)) {
+            clearDaemonState();
+            return false;
+        }
+        throw toPageScannerError(error);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/daemon/client.js.map

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

package/dist/daemon/rpc-server.d.ts

@@ -0,0 +1,31 @@
+import { type ErrorCode } from '../errors.js';
+import type { BridgeServer } from '../bridge/server.js';
+export interface RpcSuccess {
+    ok: true;
+    result: unknown;
+}
+export interface RpcFailure {
+    ok: false;
+    error: {
+        code: ErrorCode;
+        message: string;
+        hint?: string;
+    };
+}
+export type RpcResponse = RpcSuccess | RpcFailure;
+export interface RpcServerHandle {
+    port: number;
+    close(): Promise<void>;
+}
+export interface RpcServerOptions {
+    bridge: BridgeServer;
+    secret: string;
+    /** Called when a `shutdown` request arrives, after it has been answered. */
+    onShutdown: () => void;
+    /** Called on every authenticated request, so the daemon can stay awake. */
+    onActivity?: () => void;
+    /** 0 asks the OS for a free port, which is the normal case. */
+    port?: number;
+}
+export declare function startRpcServer(options: RpcServerOptions): Promise<RpcServerHandle>;
+//# sourceMappingURL=rpc-server.d.ts.map

package/dist/daemon/rpc-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-server.d.ts","sourceRoot":"","sources":["../../src/daemon/rpc-server.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAUlE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMxD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAoMD,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CA4BlF"}