@page-scanner/cli 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Byungdon Yoon
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,217 @@
+# page-scanner
+
+Capture a whole web page from the command line, as a PDF whose text is still text.
+
+```bash
+npx @page-scanner/cli pair
+npx @page-scanner/cli scan --url https://en.wikipedia.org/wiki/PDF --out ./pdf.pdf
+```
+
+The capture is done by the **Page Scanner Chrome extension**, in a Chrome you are already signed
+in to. This package is the other half: it listens on loopback for that extension to connect, and
+turns `scan` into a file on your disk. A page behind a login is a page you are logged into, and no
+second browser is started.
+
+It is also the engine behind [`@page-scanner/mcp`](../mcp/README.md), which is the same four
+operations as MCP tools for an agent.
+
+## Requirements
+
+- Node.js 24 or newer.
+- Google Chrome, or another Chromium browser, with the Page Scanner extension installed.
+
+## Install
+
+Three ways, in the order most people want them:
+
+```bash
+npx @page-scanner/cli --help         # no install
+npm install -g @page-scanner/cli     # then just `page-scanner`
+```
+
+Or a standalone binary from the [releases
+page](https://github.com/sbd530/page-scanner/releases), which needs no Node at all. The binaries
+are **not code-signed**. On macOS, Gatekeeper will refuse the first run until you clear the
+quarantine flag:
+
+```bash
+xattr -d com.apple.quarantine ./page-scanner
+```
+
+On Windows, SmartScreen shows "Windows protected your PC"; the binary runs from **More info** then
+**Run anyway**. Verify what you downloaded against `SHA256SUMS` on the same release.
+
+## Pairing
+
+Once per machine:
+
+```bash
+page-scanner pair
+```
+
+It prints a port and a token and saves them to `~/.page-scanner/config.json`. Open the Page
+Scanner settings page in Chrome (the gear in the editor toolbar), paste both into **Local agents**,
+name the browser, and press **Connect**. `pair` waits up to two minutes and tells you when the
+browser arrives.
+
+Chrome runs a separate copy of the extension in every profile, so your work profile and your
+personal profile are two different browsers here. Naming them is how you tell them apart later.
+
+`page-scanner pair --rotate` issues a new token and invalidates the old one. Every browser has to
+be re-paired after that.
+
+## Commands
+
+```
+page-scanner pair     [--port <n>] [--rotate] [--wait <s>=120] [--no-wait] [--json]
+page-scanner status   [--json]
+page-scanner browsers [--json]
+page-scanner tabs     [--browser <id|label>] [--wait <s>=30] [--json]
+page-scanner scan     (--url <u> | --tab <id>) [--window <id>] [--browser <id|label>]
+                      [--format pdf|png|jpeg=pdf] [--page-size auto|a4|letter=a4]
+                      [--quality <0-1>] [--video frame|blank] [--open-editor]
+                      [--out <file|dir>] [--wait <s>=30] [--timeout <s>=120] [--json]
+page-scanner serve    [--daemon] [--idle <min>]
+page-scanner stop
+page-scanner --version | --help
+```
+
+`--browser` takes a browserId or a label, matched without regard to case, and is only needed when
+more than one browser is connected.
+
+`--out` is a file when it ends in a 2 to 5 character extension and is not an existing directory,
+and a directory otherwise, in which case the browser's suggested filename is used inside it.
+Parent directories are created. A relative path is relative to **your** working directory, not the
+daemon's, which is why the daemon hands the bytes back rather than writing them itself.
+
+`--page-size` decides what a PDF is laid onto. `a4` and `letter` slice the capture across printable
+sheets with a half-inch margin; `auto` is one page the exact size of the capture, which is not
+printable and which Acrobat clamps past 200 inches.
+
+`--wait 0` means do not wait at all. Chrome retires the extension's service worker after about
+thirty seconds of silence, so the default wait exists to cover the reconnect that follows.
+
+## What a command prints
+
+- **stdout** carries the answer and nothing else. For `scan` that is one line, the absolute path
+  of the file it wrote. For `tabs` and `browsers` it is a column-aligned table with no separator
+  row, so `awk` can read it.
+- **stderr** carries anything addressed to a person: progress, warnings, the reason something
+  failed.
+- **`--json`** puts exactly one JSON document on stdout, for success and for failure alike, and
+  leaves stderr empty.
+
+```json
+{
+  "ok": true,
+  "path": "/Users/you/pdf.pdf",
+  "width": 1280,
+  "height": 4200,
+  "mode": "vector",
+  "selectableText": true,
+  "truncated": null,
+  "browserId": "b-9f2c41",
+  "fileName": "PDF - Wikipedia.pdf"
+}
+```
+
+```json
+{ "ok": false, "code": 3, "error": "NO_BROWSER", "message": "No browser is connected." }
+```
+
+`truncated` is `null` rather than absent when the capture was whole, so a reader can see the
+question was asked. When it is not null it carries what the page measured, what was captured, and
+a sentence naming the gap.
+
+### Exit codes
+
+| Code | Meaning                                                                       |
+| ---- | ----------------------------------------------------------------------------- |
+| 0    | success                                                                       |
+| 1    | the browser was reached and the work failed                                   |
+| 2    | the arguments were wrong                                                      |
+| 3    | no usable browser: none connected, several connected, or the one named is not |
+| 4    | not paired                                                                    |
+| 5    | the daemon would not start                                                    |
+
+## The daemon
+
+The extension is the WebSocket **client**: nothing outside Chrome can open a connection into a
+service worker, so something has to be listening before Chrome can dial in. That something is a
+background daemon, started on demand by the first command that needs it.
+
+```
+page-scanner scan ──HTTP /rpc──┐
+page-scanner-mcp  ──HTTP /rpc──┼──> page-scanner daemon ──ws :45711──< Chrome extension(s)
+Claude Desktop    ─HTTP /rpc───┘    (127.0.0.1, ephemeral RPC port)
+```
+
+Two ports, deliberately. 45711 is the one the extension dials, and it refuses anything whose
+`Origin` is not a `chrome-extension://`, which is exactly what a local CLI process is. The RPC port
+is ephemeral, carries a bearer secret regenerated on every run, and is what the commands talk to.
+
+`page-scanner serve` runs it in the foreground, which is the way to see why it will not start.
+`page-scanner stop` stops it. It exits on its own after 15 minutes with no browser connected and
+nothing calling (`PAGE_SCANNER_IDLE_MINUTES`, `0` for never), and **never** while a browser is
+attached: the open socket is what keeps Chrome's service worker alive, and dropping it would make
+the next command wait for a reconnect.
+
+## Files
+
+Everything lives in `~/.page-scanner`, or in `$PAGE_SCANNER_HOME` if that is set.
+
+| File          | What it is                                                    |
+| ------------- | ------------------------------------------------------------- |
+| `config.json` | the pairing: `{ port, token }`, mode 0600                     |
+| `daemon.json` | the running daemon: pid, RPC port, secret, version. Mode 0600 |
+| `daemon.log`  | stdout and stderr of a daemon started in the background       |
+
+**Windows**: those 0600 modes are a no-op. NTFS does not implement POSIX permissions, so both files
+are readable by anything running as you. That is usually fine on a personal machine. On a shared
+one, restrict the directory yourself:
+
+```
+icacls %USERPROFILE%\.page-scanner /inheritance:r /grant:r %USERNAME%:F
+```
+
+## Security
+
+The token is the only thing between a local process and a scan of any tab you have open, because a
+loopback port is reachable by everything running as you. So:
+
+- The bridge binds `127.0.0.1` only, never `0.0.0.0`.
+- Every connection must present a `chrome-extension://` Origin **and** the shared token in its
+  first frame. The Origin check alone is not enough: a local process can forge that header.
+- There is no port discovery. Loopback `fetch` is blocked for an extension origin by Local Network
+  Access, so probing for a port would need a host permission the extension does not have.
+- The token is printed by `pair`, on stdout, and never appears in any other output or in the log.
+- The extension refuses tabs Chrome will not let it touch: `chrome://` pages, the Web Store, and
+  the PDF viewer.
+
+## Using it from Node
+
+```js
+import { scan, listTabs } from '@page-scanner/cli';
+
+const { tabs } = await listTabs();
+const result = await scan({ tabId: tabs[0].tabId, out: './out/', format: 'pdf' });
+console.log(result.path, result.selectableText);
+```
+
+The package's main entry point does not load `ws`: the bridge runs in the daemon, which is a
+separate process. `@page-scanner/cli/daemon` is the entry point that starts one in-process, and it is
+the only one that pulls the WebSocket server in.
+
+## Limits
+
+- No raster fallback. The extension can stitch screenshots when Chrome's debugger cannot attach,
+  but that path needs a user gesture, so a scan started from here fails loudly instead.
+- `chrome.debugger` cannot attach while DevTools is open on the same tab. Close it, or scan a
+  different tab.
+- A page larger than 60,000 CSS pixels on a side is captured up to that limit, and the result says
+  so in `truncated`.
+- One pairing per machine, shared by every browser profile that connects to it.
+
+## Licence
+
+Apache-2.0. See [LICENSE](LICENSE).

package/dist/api.d.ts

@@ -0,0 +1,87 @@
+import type { PairingConfig } from './config.js';
+import type { ExportFormatId, PageSizeId, TabSummary, TruncationReport, VideoHandling, WindowSummary } from './protocol.js';
+import { stopDaemon, type ConnectOptions } from './daemon/client.js';
+import type { ConnectedBrowser } from './bridge/server.js';
+export interface CommonOptions extends ConnectOptions {
+    /** Id or label of the browser to act on. Optional when only one is connected. */
+    browser?: string;
+    /** How long to wait for a browser to connect. 0 fails immediately. */
+    waitSeconds?: number;
+}
+export interface ScanOptions extends CommonOptions {
+    url?: string;
+    tabId?: number;
+    windowId?: number;
+    format?: ExportFormatId;
+    pageSize?: PageSizeId;
+    quality?: number;
+    videoHandling?: VideoHandling;
+    openEditor?: boolean;
+    /** A file, or a directory to put the browser's suggested filename in. */
+    out?: string;
+    /** What a relative `out` is relative to. Defaults to process.cwd(). */
+    cwd?: string;
+    /** How long to give the browser to produce the capture. */
+    timeoutSeconds?: number;
+}
+export interface ScanResult {
+    /** Absolute path of the file this wrote. */
+    path: string;
+    width: number;
+    height: number;
+    mode: 'vector' | 'raster';
+    /** True only for a PDF that came out of the vector pipeline. */
+    selectableText: boolean;
+    /** Null rather than absent: the question was asked and answered. */
+    truncated: TruncationReport | null;
+    browserId: string;
+    fileName: string;
+}
+export interface TabsResult {
+    browserId: string;
+    label: string;
+    windows: WindowSummary[];
+    tabs: TabSummary[];
+}
+export interface StatusReport {
+    version: string;
+    paired: boolean;
+    bridgePort: number;
+    configPath: string;
+    /** False on Windows, where the 0600 on the config file is not enforced. */
+    configOwnerOnly: boolean;
+    daemon: {
+        running: false;
+    } | {
+        running: true;
+        pid: number;
+        rpcPort: number;
+        version: string;
+    };
+    browsers: ConnectedBrowser[];
+}
+export interface PairResult extends PairingConfig {
+    configPath: string;
+    /** False on Windows: NTFS does not implement the mode the file is written with. */
+    ownerOnly: boolean;
+}
+/**
+ * Writes (or rotates) the pairing and restarts the daemon so it picks the new
+ * one up. A daemon holding the old token would keep refusing the browser.
+ */
+export declare function pair(options?: {
+    port?: number;
+    rotate?: boolean;
+} & ConnectOptions): Promise<PairResult>;
+export declare function listBrowsers(options?: ConnectOptions): Promise<ConnectedBrowser[]>;
+/** Blocks until a browser is connected, or the wait runs out. */
+export declare function waitForBrowser(options?: CommonOptions): Promise<{
+    browserId: string;
+    label: string;
+}>;
+export declare function listTabs(options?: CommonOptions): Promise<TabsResult>;
+export declare function scan(options: ScanOptions): Promise<ScanResult>;
+/** Everything `page-scanner status` reports, without starting a daemon. */
+export declare function status(): Promise<StatusReport>;
+export { stopDaemon as stop };
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

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

package/dist/api.js

@@ -0,0 +1,132 @@
+/**
+ * The programmatic surface, and what every command is built on.
+ *
+ * Nothing here loads `ws`. The daemon is a separate process reached over
+ * loopback HTTP, so a caller that only wants to take a scan never pays for
+ * the WebSocket server; `@page-scanner/cli/daemon` is the subpath that does.
+ */
+import { ensureConfig, readConfig, configPath, configFileIsOwnerOnly } from './config.js';
+import { PageScannerError } from './errors.js';
+import { resolveOutputPath, writeScanFile } from './output.js';
+import { DEFAULT_PAGE_SIZE } from './protocol.js';
+import { connectDaemon, stopDaemon } from './daemon/client.js';
+import { readDaemonState } from './daemon/state.js';
+import { CLI_VERSION } from './version.js';
+function requirePairing() {
+    const config = readConfig();
+    if (!config.token) {
+        throw new PageScannerError('NOT_PAIRED', 'This machine has no Page Scanner pairing.', 'Run `page-scanner pair`, then paste the port and token into the extension settings page.');
+    }
+    return config;
+}
+/**
+ * Writes (or rotates) the pairing and restarts the daemon so it picks the new
+ * one up. A daemon holding the old token would keep refusing the browser.
+ */
+export async function pair(options = {}) {
+    const previous = readDaemonState();
+    if (previous)
+        await stopDaemon().catch(() => undefined);
+    const config = ensureConfig({
+        ...(options.port !== undefined ? { port: options.port } : {}),
+        rotate: options.rotate ?? false,
+    });
+    return {
+        ...config,
+        configPath: configPath(),
+        ownerOnly: configFileIsOwnerOnly(),
+    };
+}
+export async function listBrowsers(options = {}) {
+    requirePairing();
+    const daemon = await connectDaemon(options);
+    const answer = await daemon.call('listBrowsers');
+    return answer.browsers;
+}
+/** Blocks until a browser is connected, or the wait runs out. */
+export async function waitForBrowser(options = {}) {
+    requirePairing();
+    const daemon = await connectDaemon(options);
+    const waitMs = Math.round((options.waitSeconds ?? 30) * 1000);
+    return daemon.call('waitForBrowser', {
+        ...(options.browser !== undefined ? { browserId: options.browser } : {}),
+        timeoutMs: waitMs,
+    }, waitMs + 30_000);
+}
+export async function listTabs(options = {}) {
+    requirePairing();
+    const daemon = await connectDaemon(options);
+    const waitMs = Math.round((options.waitSeconds ?? 30) * 1000);
+    return daemon.call('listTabs', {
+        ...(options.browser !== undefined ? { browserId: options.browser } : {}),
+        timeoutMs: waitMs,
+    }, waitMs + 30_000);
+}
+export async function scan(options) {
+    requirePairing();
+    if ((options.url === undefined) === (options.tabId === undefined)) {
+        throw new PageScannerError('BAD_REQUEST', 'Give exactly one of url and tabId.');
+    }
+    const waitMs = Math.round((options.waitSeconds ?? 30) * 1000);
+    const scanMs = Math.round((options.timeoutSeconds ?? 120) * 1000);
+    const daemon = await connectDaemon(options);
+    const answer = await daemon.call('scan', {
+        ...(options.browser !== undefined ? { browserId: options.browser } : {}),
+        ...(options.url !== undefined ? { url: options.url } : {}),
+        ...(options.tabId !== undefined ? { tabId: options.tabId } : {}),
+        ...(options.windowId !== undefined ? { windowId: options.windowId } : {}),
+        format: options.format ?? 'pdf',
+        pageSize: options.pageSize ?? DEFAULT_PAGE_SIZE,
+        ...(options.quality !== undefined ? { quality: options.quality } : {}),
+        ...(options.videoHandling !== undefined ? { videoHandling: options.videoHandling } : {}),
+        ...(options.openEditor !== undefined ? { openEditor: options.openEditor } : {}),
+        timeoutMs: waitMs,
+        scanTimeoutMs: scanMs,
+    }, waitMs + scanMs);
+    // The daemon hands back bytes, not a path. It may have been started hours
+    // ago from another directory; only this process knows what a relative
+    // `--out` means.
+    const target = resolveOutputPath(options.out, answer.fileName, options.cwd);
+    writeScanFile(target, answer.bytesBase64);
+    return {
+        path: target,
+        width: answer.width,
+        height: answer.height,
+        mode: answer.mode,
+        selectableText: answer.mode === 'vector' && (options.format ?? 'pdf') === 'pdf',
+        truncated: answer.truncated,
+        browserId: answer.browserId,
+        fileName: answer.fileName,
+    };
+}
+/** Everything `page-scanner status` reports, without starting a daemon. */
+export async function status() {
+    const config = readConfig();
+    const state = readDaemonState();
+    let browsers = [];
+    if (state) {
+        // Best effort. A daemon that has just died should show as stopped rather
+        // than taking the whole command down.
+        try {
+            const daemon = await connectDaemon({ startDaemon: () => undefined, startTimeoutMs: 0 });
+            const answer = await daemon.call('listBrowsers');
+            browsers = answer.browsers;
+        }
+        catch {
+            browsers = [];
+        }
+    }
+    return {
+        version: CLI_VERSION,
+        paired: config.token.length > 0,
+        bridgePort: config.port,
+        configPath: configPath(),
+        configOwnerOnly: configFileIsOwnerOnly(),
+        daemon: state
+            ? { running: true, pid: state.pid, rpcPort: state.rpcPort, version: state.version }
+            : { running: false },
+        browsers,
+    };
+}
+export { stopDaemon as stop };
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}