paper-snapshot-cli 0.1.3 → 0.1.5

package/dist/bin.mjs

@@ -54613,7 +54613,7 @@ const NodeInfo = fromJsonString(Struct({
 const layer = succeed$3(Service, Service.of({ connect: fn("Paper.connect")(function* (settings) {
 	const client = new Client({
 		name: "paper-snapshot",
-		version: "0.1.3"
+		version: "0.1.5"
 	});
 	yield* acquireRelease(tryPromise({
 		try: () => client.connect(new StdioClientTransport({
@@ -54889,7 +54889,7 @@ const flags = {
 	json: toggle("json", false, "Print one JSON line per capture on stdout; failures print {\"index\", \"url\", \"error\"}"),
 	quiet: toggle("quiet", false, "Only log warnings and errors (same as --log-level warn)"),
 	failFast: toggle("fail-fast", false, "Stop at the first failed capture"),
-	fileId: optionalString("file-id", "Paper file id (default: the file open in Paper)"),
+	fileId: String$1("file-id").pipe(withDescription$1("Paper file id (default: $PAPER_SNAPSHOT_FILE_ID, else the file in front in Paper)"), withFallbackConfig(String$6("PAPER_SNAPSHOT_FILE_ID")), optional$1),
 	pageId: optionalString("page-id", "Paper page id (default: the active page)"),
 	name: optionalString("name", "Artboard name (default: page title · host)"),
 	x: optionalInteger("x", "Artboard x position on the canvas"),
@@ -55070,6 +55070,13 @@ const target = (job, input, name, layout) => {
 		position
 	});
 };
+/** "Title · host"; a page titled only with its host is named by its URL instead. */
+const defaultName = (title, url) => {
+	const parsed = URL.parse(url);
+	if (parsed === null) return title;
+	const path = parsed.pathname === "/" ? "" : parsed.pathname.replace(/\/$/, "");
+	return title === "" || title === parsed.host ? `${parsed.host}${path}` : `${title} · ${parsed.host}`;
+};
 const slug = (text) => text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 60) || "snapshot";
 const handler = fn("paper-snapshot")(function* (input) {
 	const fs = yield* FileSystem;
@@ -55155,7 +55162,7 @@ const handler = fn("paper-snapshot")(function* (input) {
 			captureTimeout: millis(input.captureTimeout)
 		});
 	})).pipe(flatMap$1((snapshot) => gen(function* () {
-		const name = getOrElse(job.name, () => `${snapshot.title} · ${URL.parse(snapshot.url)?.host ?? snapshot.url}`);
+		const name = getOrElse(job.name, () => defaultName(snapshot.title, snapshot.url));
 		const warned = Object.entries(snapshot.warnings).filter(([, count]) => count > 0);
 		if (warned.length > 0) yield* logWarning(`${name}: ${warned.map(([kind, count]) => `${count} ${kind}`).join(", ")}`);
 		const out = map$9(input.out, (location) => batch ? path.join(location, `${job.index + 1}-${slug(name)}.html`) : location);
@@ -55280,7 +55287,7 @@ const LoggerLive = layer$4([make$6((options) => {
 	process.stderr.write(`${mark} ${text}\n`);
 })]);
 const MainLive = mergeAll(layer$2, layer$1.pipe(provide$2(layer$3)), layer).pipe(provideMerge(layer$5), provideMerge(LoggerLive));
-run$1(command, { version: "0.1.3" }).pipe(tapError((error) => isCliError(error) ? void_ : error$1(`paper-snapshot: ${error.message}`)), tapDefect((defect) => error$1(`paper-snapshot: unexpected error: ${defect instanceof Error ? defect.stack ?? defect.message : String(defect)}`)), provide(MainLive), runMain({
+run$1(command, { version: "0.1.5" }).pipe(tapError((error) => isCliError(error) ? void_ : error$1(`paper-snapshot: ${error.message}`)), tapDefect((defect) => error$1(`paper-snapshot: unexpected error: ${defect instanceof Error ? defect.stack ?? defect.message : String(defect)}`)), provide(MainLive), runMain({
 	disableErrorReporting: true,
 	teardown: (exit, onExit) => defaultTeardown(exit, (code) => {
 		onExit(code);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paper-snapshot-cli",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Paper Snapshot as a CLI. Copy and paste your real site directly into Paper as editable layers. No more screenshots.",
   "keywords": [
     "ai-agents",

package/skills/paper-snapshot/SKILL.md

@@ -31,7 +31,7 @@ description: Snapshot web UI into Paper as editable layers. Use when a URL, loca
 Tell the user before running a command that waits on them, and name what they will see.
 
 - **Chrome "Allow remote debugging?" dialog** (`--source chrome`, and auto without a URL when agent-browser is absent). One-time setup: the user turns on remote debugging at `chrome://inspect/#remote-debugging`; Chrome then shows "Server running at 127.0.0.1:9222". Every run opens a fresh connection, so Chrome shows "Allow remote debugging?" each time, on the machine where Chrome runs. The command blocks until the user clicks **Allow**, for up to `--chrome-approval-timeout` (2 min). **Cancel** fails the run. While attached, Chrome shows a "controlled by automated test software" banner. A batch asks once. On a remote machine, the person at that screen has to click.
-- **Paper app.** It must be running with a file open, or pass `--file-id`. Pushing needs no approval.
+- **Paper app.** It must be running. Without `--file-id` (or `PAPER_SNAPSHOT_FILE_ID`), artboards go to the file in front in Paper, which may not be the one the user means: in scripts and batches, always pass the file id. Pushing needs no approval.
 - **agent-browser / Playwriter.** No prompt, but an agent-browser session must be open (`agent-browser open <url>`), or Playwriter's extension must be connected to its relay.
 - **First run.** paper-snapshot downloads the Paper Snapshot extension once (network required). Without an installed Chrome, Edge, Brave or Chromium it also downloads headless Chromium once.