pipeup 0.6.0 → 0.7.0-beta.2

package/README.md

@@ -2,7 +2,7 @@
 
 Comments and feedback right on any HTML page: documents, slide decks and whole sites.
 
-> **Alpha (0.6.0).** The API and the stored comment format may change before 1.0; pin an exact version.
+> **Alpha (0.7.0-beta.2).** The API and the stored comment format may change before 1.0; pin an exact version.
 > Website and Try pages: https://pipeup-ai.github.io/pipeup/ · Source: https://github.com/pipeup-ai/pipeup
 
 Pipeup: signed comment operations, threads with one-level replies, anchors that survive page changes,
@@ -21,14 +21,14 @@ As a classic script (also works from `file://`), it mounts itself on pages that
 ```html
 <html data-pipeup-doc="<id>:<key>">
   ...
-  <script src="https://cdn.jsdelivr.net/npm/pipeup@0.6.0/dist/pipeup.min.js" integrity="sha384-…" crossorigin="anonymous" defer></script>
+  <script src="https://cdn.jsdelivr.net/npm/pipeup@0.7.0-beta.2/dist/pipeup.min.js" integrity="sha384-…" crossorigin="anonymous" defer></script>
 ```
 
 Each release's notes on GitHub give the `integrity` value
 (`node scripts/sri.mjs` prints it for a local build). Make a document key with
 `await Pipeup.newDocumentAttribute()` and keep it once people have commented.
 
-**Add-ons.** Optional extra scripts add features (`@pipeup/share`, `voice`, `live`, `assist`), and anyone can write their own
+**Add-ons.** Optional extra scripts add features (`@pipeup/share`, `voice`, `live`, `assist`, `agents`, `emoji`, `github`, `updates`, `inbox`), and anyone can write their own
 (a company's, for example) without the Pipeup project's permission: see the
 [guide](https://pipeup-ai.github.io/pipeup/addons-guide.html). Add-ons run with the page's full power, so keep them
 intentional (best effort): pin each script with its `integrity` hash, name the add-ons that may run with

package/cli/check.mjs

@@ -0,0 +1,267 @@
+// pipeup check <page.html>: loads a page with and without Pipeup at phone, tablet and desktop widths and reports what
+// Pipeup changes or covers, and what the page could do better for it. It uses Playwright (yours; Pipeup depends on none).
+import { pathToFileURL } from "node:url";
+import { resolve } from "node:path";
+
+const WIDTHS = [375, 768, 1440];
+const SHIFT_PX = 0.5;
+/** Requests that load Pipeup or one of its add-ons: blocked for the page as it is without Pipeup. */
+const PIPEUP_SCRIPT = /(?:^|\/)pipeup[^/]*\.js(?:\?|$)|\/@pipeup\/|\/pipeup@/i;
+
+async function playwright() {
+  for (const name of ["playwright", "@playwright/test"]) {
+    try {
+      return await import(name);
+    } catch {
+      // try the next
+    }
+  }
+  throw new Error(
+    "pipeup check needs Playwright and a browser: npm i -D playwright && npx playwright install chromium",
+  );
+}
+
+/** Every visible element's box (without Pipeup's own), in document order, so two loads can be compared. */
+const boxes = () =>
+  [...document.body.querySelectorAll("*")]
+    .filter((e) => e.tagName !== "PIPEUP-ROOT" && !e.closest("pipeup-root"))
+    .slice(0, 4000)
+    .map((e) => {
+      const r = e.getBoundingClientRect();
+      const label = e.tagName.toLowerCase() + (e.id ? `#${e.id}` : "");
+      return {
+        label,
+        x: r.x + scrollX,
+        y: r.y + scrollY,
+        w: r.width,
+        h: r.height,
+        shown: r.width > 0 && r.height > 0,
+      };
+    });
+
+/** What is checked once, with Pipeup running at the widest width. */
+const inspect = async () => {
+  const w = window;
+  const out = {
+    scripts: 0,
+    roots: document.querySelectorAll("pipeup-root").length,
+    blocks: 0,
+    doc: document.documentElement.hasAttribute("data-pipeup-doc"),
+    addons: [],
+    appearance: null,
+    tabbable: false,
+    agents: document.documentElement.getAttribute("data-pipeup-agents") || "",
+    viewport: Boolean(document.querySelector('meta[name="viewport"]')),
+  };
+  out.scripts = [...document.querySelectorAll("script[src]")].filter(
+    (s) =>
+      /(?:^|\/)pipeup(?:\.min|\.esm)?(?:@[^/]*)?\.js|\/pipeup@[^/]*\//i.test(s.src) &&
+      !/@pipeup\//i.test(s.src),
+  ).length;
+  const marked = (e) => e.closest("[data-pipeup-id]") !== null;
+  out.blocks = [...document.querySelectorAll("svg, canvas, img, figure, table, video")].filter(
+    (e) => !e.closest("pipeup-root") && !marked(e) && e.getBoundingClientRect().width > 40,
+  ).length;
+  try {
+    const pu = await w.Pipeup.mount();
+    out.addons = (w.Pipeup.addons?.() ?? []).map((a) => ({
+      id: a.id,
+      state: a.state,
+      reason: a.reason ?? "",
+      says: a.network?.says ?? "",
+    }));
+    out.appearance = pu.appearance?.() ?? null;
+  } catch {
+    out.addons = null;
+  }
+  const control = document.querySelector("pipeup-root")?.shadowRoot?.querySelector(".launch .mode");
+  out.tabbable = Boolean(control) && control.tabIndex >= 0;
+  return out;
+};
+
+/** The control's box and the page's interactive and text boxes it could cover, at the current width. */
+const overlaps = () => {
+  const root = document.querySelector("pipeup-root");
+  const mode = root?.shadowRoot?.querySelector(".launch .mode");
+  if (!mode) return { control: null, hits: [] };
+  const c = mode.getBoundingClientRect();
+  const hit = (r) =>
+    r.width > 0 &&
+    r.height > 0 &&
+    r.left < c.right &&
+    r.right > c.left &&
+    r.top < c.bottom &&
+    r.bottom > c.top;
+  const hits = [];
+  for (const e of document.body.querySelectorAll("*")) {
+    if (e.closest("pipeup-root")) continue;
+    const r = e.getBoundingClientRect();
+    if (!hit(r)) continue;
+    const style = getComputedStyle(e);
+    if (style.visibility === "hidden" || style.display === "none" || style.pointerEvents === "none") continue;
+    const interactive = e.matches(
+      "a[href], button, input, select, textarea, summary, [role=button], [role=link], [tabindex]:not([tabindex='-1'])",
+    );
+    const text = !interactive && [...e.childNodes].some((n) => n.nodeType === 3 && n.textContent.trim());
+    if (interactive || text)
+      hits.push({ what: e.tagName.toLowerCase() + (e.id ? `#${e.id}` : ""), interactive });
+  }
+  return { control: { x: c.x, y: c.y, w: c.width, h: c.height }, hits: hits.slice(0, 5) };
+};
+
+/** Runs the check; resolves to { results: [{ status, what, detail }], ok }. */
+export async function check({ page, widths = WIDTHS, log = () => {} }) {
+  const url = /^https?:|^file:/i.test(page) ? page : pathToFileURL(resolve(page)).href;
+  const { chromium } = await playwright();
+  const browser = await chromium.launch();
+  const results = [];
+  const add = (status, what, detail = "") => results.push({ status, what, detail });
+  try {
+    for (const width of widths) {
+      const without = await (await browser.newContext({ viewport: { width, height: 900 } })).newPage();
+      await without.route("**/*", (route) =>
+        PIPEUP_SCRIPT.test(route.request().url()) ? route.abort() : route.continue(),
+      );
+      await without.goto(url);
+      await without.waitForLoadState("load");
+      const before = await without.evaluate(boxes);
+      await without.context().close();
+
+      const withp = await (await browser.newContext({ viewport: { width, height: 900 } })).newPage();
+      const said = [];
+      withp.on("console", (m) => said.push(m.text()));
+      await withp.goto(url);
+      await withp.waitForLoadState("load");
+      let started = await withp.waitForSelector("pipeup-root", { state: "attached", timeout: 3000 }).then(
+        () => true,
+        () => false,
+      );
+      // A page that mounts Pipeup itself (data-pipeup-auto="off") is started the way its author would.
+      if (!started && (await withp.evaluate(() => typeof window.Pipeup?.mount === "function")))
+        started = await withp.evaluate(() =>
+          window.Pipeup.mount().then(
+            () => true,
+            () => false,
+          ),
+        );
+      if (!started) {
+        add(
+          "fail",
+          `Pipeup starts (${width}px)`,
+          "no Pipeup appeared on the page: is its script included, and does it need data-pipeup-doc?",
+        );
+        await withp.context().close();
+        continue;
+      }
+      await withp.waitForTimeout(400);
+      const after = await withp.evaluate(boxes);
+      const moved = [];
+      if (before.length !== after.length)
+        moved.push(`the page has ${after.length} elements with Pipeup and ${before.length} without`);
+      else
+        for (let i = 0; i < before.length; i++) {
+          const a = before[i];
+          const b = after[i];
+          if (
+            a.shown &&
+            b.shown &&
+            Math.max(Math.abs(a.x - b.x), Math.abs(a.y - b.y), Math.abs(a.w - b.w), Math.abs(a.h - b.h)) >
+              SHIFT_PX
+          )
+            moved.push(
+              `${a.label} moved by ${Math.max(Math.abs(a.x - b.x), Math.abs(a.y - b.y)).toFixed(1)}px`,
+            );
+        }
+      if (moved.length)
+        add(
+          "fail",
+          `Pipeup changes nothing on the page (${width}px)`,
+          `${moved.length} difference${moved.length === 1 ? "" : "s"}: ${moved.slice(0, 3).join("; ")}`,
+        );
+      else add("pass", `Pipeup changes nothing on the page (${width}px)`);
+
+      const covered = await withp.evaluate(overlaps);
+      const touching = covered.hits.filter((h) => h.interactive);
+      if (touching.length)
+        add(
+          "fail",
+          `Pipeup's button covers nothing you use (${width}px)`,
+          `it sits over ${touching.map((h) => h.what).join(", ")}`,
+        );
+      else if (covered.hits.length)
+        add(
+          "warn",
+          `Pipeup's button covers nothing you use (${width}px)`,
+          `it sits over text in ${covered.hits.map((h) => h.what).join(", ")}`,
+        );
+      else add("pass", `Pipeup's button covers nothing you use (${width}px)`);
+
+      if (width === widths[widths.length - 1]) {
+        const o = await withp.evaluate(inspect);
+        if (o.scripts > 1 || o.roots > 1)
+          add(
+            "fail",
+            "Pipeup is included once",
+            `the page loads Pipeup ${Math.max(o.scripts, o.roots)} times: remove the extra script`,
+          );
+        else add("pass", "Pipeup is included once");
+        add(
+          o.doc ? "pass" : "warn",
+          "The page has a document identity",
+          o.doc
+            ? ""
+            : "no data-pipeup-doc on <html>: copies of this file on other computers won't share comments",
+        );
+        add(
+          o.blocks ? "warn" : "pass",
+          "Charts, images and tables have stable names",
+          o.blocks
+            ? `${o.blocks} without data-pipeup-id: comments on them may lose their place when the page changes`
+            : "",
+        );
+        add(o.tabbable ? "pass" : "fail", "Pipeup's button can be reached with the keyboard");
+        add(
+          o.viewport ? "pass" : "warn",
+          "The page suits phones",
+          o.viewport
+            ? ""
+            : 'no <meta name="viewport" content="width=device-width, initial-scale=1">: phones show the page zoomed out, and Pipeup with it',
+        );
+        if (o.addons)
+          for (const a of o.addons)
+            add(a.state === "on" ? "pass" : "warn", `Add-on ${a.id} is ${a.state}`, a.reason || a.says);
+        if (o.appearance) {
+          const e = o.appearance.effects;
+          add(
+            e.length || o.appearance.ratio < 3 ? "warn" : "pass",
+            `Pipeup looks right on this page (${o.appearance.look} look, from ${o.appearance.source})`,
+            e.length
+              ? `the page's styles on <html> change it and can't be undone from inside: ${e.join("; ")}`
+              : "",
+          );
+        }
+        if (o.agents && !(o.addons ?? []).some((a) => a.id === "agents"))
+          add(
+            "warn",
+            "A listed agent can answer",
+            "the page lists an agent (data-pipeup-agents) but has no agents add-on",
+          );
+        const unreadable = said.find((t) => /couldn't be read|could not be read/i.test(t));
+        add(unreadable ? "warn" : "pass", "Saved comments can be read", unreadable ?? "");
+      }
+      await withp.context().close();
+    }
+  } finally {
+    await browser.close();
+  }
+  log(results);
+  return { results, ok: !results.some((r) => r.status === "fail") };
+}
+
+/** The report as a table of words for a person. */
+export function table(results) {
+  const mark = { pass: "pass", warn: "WARN", fail: "FAIL" };
+  return results
+    .map((r) => `${mark[r.status].padEnd(5)} ${r.what}${r.detail ? `\n      ${r.detail}` : ""}`)
+    .join("\n");
+}

package/cli/link.d.mts

@@ -0,0 +1,17 @@
+export type Support = "old" | "builtin" | "addon" | "unknown";
+export function served(
+  html: string,
+  o: { base: string; agent: string; key: string; file: string; addon?: boolean },
+): string;
+export function pageSupport(
+  html: string,
+  dir: string,
+): Promise<{ support: Support; version: string; loaded: boolean }>;
+export function watch(o: {
+  page: string;
+  agent: string;
+  key: string;
+  port?: number;
+  log?: (line: string) => void;
+}): Promise<{ url: string; sidecar: string; support: Support; addon: boolean; close(): Promise<void> }>;
+export function comments(o: { page: string; all?: boolean; json?: boolean }): Promise<string>;

package/cli/link.mjs

@@ -4,6 +4,10 @@ import { randomBytes } from "node:crypto";
 import { createServer } from "node:http";
 import { readFile, rename, writeFile } from "node:fs/promises";
 import { basename, dirname, extname, join, resolve, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+
+/** The agents add-on that ships with this install; `watch` serves it to the pages that need it. */
+const ADDON_FILE = fileURLToPath(new URL("../dist/pipeup.agents.js", import.meta.url));
 
 const TYPES = {
   ".html": "text/html; charset=utf-8",
@@ -25,9 +29,9 @@ const TYPES = {
 const MAX_BODY = 8 * 1024 * 1024;
 const attr = (v) => v.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
 
-/** The page for the browser: its own html tag, plus the link's address and the agent it lists, nothing else changed. */
-export function served(html, { base, agent, key, file }) {
-  return html.replace(/<html\b([^>]*)>/i, (_, rest) => {
+/** The page for the browser: its own html tag, plus the link's address and the agent it lists, and the agents add-on when it needs one. */
+export function served(html, { base, agent, key, file, addon = false }) {
+  const out = html.replace(/<html\b([^>]*)>/i, (_, rest) => {
     let tag = rest;
     const listed = /\sdata-pipeup-agents\s*=\s*"([^"]*)"/i.exec(tag);
     if (listed) tag = tag.replace(listed[0], ` data-pipeup-agents="${attr(`${listed[1]} ${key}`.trim())}"`);
@@ -35,6 +39,55 @@ export function served(html, { base, agent, key, file }) {
     tag += ` data-pipeup-link="${base}" data-pipeup-link-agent="${attr(agent)}" data-pipeup-link-file="${attr(file)}"`;
     return `<html${tag}>`;
   });
+  if (!addon) return out;
+  // After the page's own scripts: an add-on registers in any order. The page's file on disk is not touched.
+  const tag = `<script src="${base}/agents.js"></script>`;
+  return /<\/body>/i.test(out) ? out.replace(/<\/body>/i, () => `${tag}</body>`) : out + tag;
+}
+
+/** Which of Pipeup's agent support a version has: before 0.6 none, 0.6.x built in, 0.7 and later in the agents add-on. */
+function byVersion(v) {
+  const m = /^(\d+)\.(\d+)\.\d+/.exec(v);
+  if (!m) return null;
+  const [major, minor] = [Number(m[1]), Number(m[2])];
+  return major > 0 || minor >= 7 ? "addon" : minor === 6 ? "builtin" : "old";
+}
+
+/** The same, read from a Pipeup script's own text: it carries the names of what it supports. */
+function bySignature(text) {
+  if (!text.includes("pipeup-root")) return null;
+  if (text.includes("pipeupReplies")) return "builtin";
+  return text.includes("listnote") ? "addon" : "old";
+}
+
+/**
+ * What the page's Pipeup can do for an agent, found without running the page: "old" (before 0.6, can't take an
+ * agent), "builtin" (0.6.x, agent support is part of it), "addon" (0.7 or later: the agents add-on serves an agent),
+ * or "unknown" (a floating address, or no Pipeup script to read). `loaded` says the page already includes the add-on.
+ */
+export async function pageSupport(html, dir) {
+  const result = { support: "unknown", version: "", loaded: false };
+  for (const [, src] of html.matchAll(/<script\b[^>]*\bsrc\s*=\s*["']([^"']+)["']/gi)) {
+    if (/agents(\.min)?\.js|@pipeup\/agents/i.test(src)) result.loaded = true;
+    const named = /pipeup(?:@|-)(\d+\.\d+\.\d+(?:-[\w.]+)?)\b/.exec(src);
+    if (named && result.support === "unknown") {
+      result.support = byVersion(named[1]) ?? "unknown";
+      result.version = named[1];
+      continue;
+    }
+    if (result.support !== "unknown" || /^(https?:)?\/\//i.test(src)) continue;
+    try {
+      const path = /^file:/i.test(src)
+        ? fileURLToPath(src.split(/[?#]/)[0])
+        : resolve(dir, decodeURIComponent(src.split(/[?#]/)[0]));
+      result.support = bySignature(await readFile(path, "utf8")) ?? "unknown";
+    } catch {
+      // a script that can't be read says nothing about Pipeup
+    }
+  }
+  // A Pipeup carried inside the page itself.
+  if (result.support === "unknown") result.support = bySignature(html) ?? "unknown";
+  return result;
 }
 
 /** Starts the link for a page file. Resolves to { url, close }. */
@@ -47,6 +100,22 @@ export async function watch({ page, agent, key, port = 0, log = console.log }) {
   let origin = "";
   let host = "";
 
+  // Which Pipeup the page uses decides whether the agents add-on is added to what it shows.
+  const found = await pageSupport(await readFile(file, "utf8"), dir);
+  if (found.support === "old")
+    throw new Error(
+      `this page uses ${found.version ? `Pipeup ${found.version}` : "a Pipeup older than 0.6"}, which can't take an agent. Use Pipeup 0.6 or later (pin an exact version) and run this again`,
+    );
+  const addon = found.support !== "builtin" && !found.loaded;
+  let addonCode = "";
+  if (addon) {
+    try {
+      addonCode = await readFile(ADDON_FILE, "utf8");
+    } catch {
+      throw new Error("the agents add-on isn't in this install of pipeup (dist/pipeup.agents.js is missing)");
+    }
+  }
+
   const send = (res, status, body = "", type = "text/plain; charset=utf-8") => {
     res.writeHead(status, {
       "content-type": type,
@@ -62,6 +131,8 @@ export async function watch({ page, agent, key, port = 0, log = console.log }) {
       if (req.headers.host !== host) return send(res, 403, "wrong host");
       const url = new URL(req.url, origin);
       if (url.pathname.startsWith("/__pipeup/")) {
+        if (addon && url.pathname === `${base}/agents.js` && req.method === "GET")
+          return send(res, 200, addonCode, TYPES[".js"]);
         if (url.pathname !== `${base}/comments` || req.method !== "POST") return send(res, 404, "not found");
         if (req.headers.origin !== origin) return send(res, 403, "wrong origin");
         const chunks = [];
@@ -95,7 +166,8 @@ export async function watch({ page, agent, key, port = 0, log = console.log }) {
       } catch {
         return send(res, 404, "not found");
       }
-      if (target === file) bytes = Buffer.from(served(bytes.toString("utf8"), { base, agent, key, file }));
+      if (target === file)
+        bytes = Buffer.from(served(bytes.toString("utf8"), { base, agent, key, file, addon }));
       send(
         res,
         200,
@@ -113,6 +185,8 @@ export async function watch({ page, agent, key, port = 0, log = console.log }) {
   return {
     url: `${origin}/${encodeURIComponent(name)}`,
     sidecar,
+    support: found.support,
+    addon,
     close: () => new Promise((ok) => server.close(ok)),
   };
 }

package/cli/pipeup.mjs

@@ -4,6 +4,7 @@
 import { chmod, mkdir, readFile, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { basename, dirname, join, resolve } from "node:path";
+import { check, table } from "./check.mjs";
 import { comments, watch } from "./link.mjs";
 import * as skills from "./skills.mjs";
 
@@ -18,13 +19,19 @@ const USAGE = `pipeup skills install|remove|list [--project] [--agent claude|cod
   project, or with --project for this folder only. It says what it will write, asks first (--yes to go ahead without
   asking), and never replaces a skill you changed unless you say --replace.
 
+pipeup check <page.html> [--json]
+  Loads the page with and without Pipeup at 375, 768 and 1440 px (with Playwright, which you install) and says what
+  Pipeup changes or covers, and what the page could do better: pass, WARN or FAIL for each. Exits 1 on any FAIL.
+
 pipeup agent [--name <name>]
   Makes this computer's agent key (once) and prints the public key to list on the page:
   <html data-pipeup-agents="<key>">
 
 pipeup watch <page.html> [--agent <name>] [--port <number>]
   Shows the page from this computer, with a live link to the agent: the page offers "Share with my agent"
-  (off until the person switches it on), and the agent is listed for this page while the link runs.
+  (off until the person switches it on), and the agent is listed for this page while the link runs. It adds the
+  agents add-on to the page it shows (the file is not changed), unless the page's Pipeup already has agent support
+  (0.6.x), and refuses a page whose Pipeup is older than 0.6.
 
 pipeup comments <page.html> [--all] [--json]
   Prints the comments the page has shared (open threads, or all with --all), as Markdown or, with --json, as data.
@@ -176,6 +183,16 @@ else if (command === "skills") {
   } catch (e) {
     fail(e.message);
   }
+} else if (command === "check") {
+  const page = args._[0];
+  if (!page) fail(`missing the page\n\n${USAGE}`);
+  try {
+    const { results, ok } = await check({ page });
+    console.log(args.json === true ? JSON.stringify({ ok, results }, null, 2) : table(results));
+    process.exit(ok ? 0 : 1);
+  } catch (e) {
+    fail(e.message);
+  }
 } else if (command === "comments") {
   const page = args._[0];
   if (!page) fail(`missing the page\n\n${USAGE}`);
@@ -189,16 +206,29 @@ else if (command === "skills") {
   if (!page) fail(`missing the page\n\n${USAGE}`);
   await pageDoc(page);
   const { identity, name } = await loadAgent(typeof args.agent === "string" ? args.agent : undefined);
-  const link = await watch({
-    page,
-    agent: name,
-    key: identity.publicKey,
-    port: typeof args.port === "string" ? Number(args.port) : 0,
-  });
+  let link;
+  try {
+    link = await watch({
+      page,
+      agent: name,
+      key: identity.publicKey,
+      port: typeof args.port === "string" ? Number(args.port) : 0,
+    });
+  } catch (e) {
+    fail(e.message);
+  }
   console.log(`Open this page: ${link.url}\n`);
   console.log(
     `While this runs, ${name} is listed for the page and the page offers "Share with my agent" (off until you switch it on).`,
   );
+  if (link.addon)
+    console.log(
+      link.support === "unknown"
+        ? "It couldn't tell which Pipeup the page uses, so it adds the agents add-on to the page it shows (the add-on stays off on a Pipeup that already has agent support). The page's file is not changed."
+        : "It adds the agents add-on to the page it shows. The page's file is not changed.",
+    );
+  else if (link.support === "builtin")
+    console.log("This page's Pipeup (0.6) has agent support built in, so nothing is added to it.");
   console.log(
     `Read:  npx pipeup comments ${page}\nReply: npx pipeup reply --page ${page} --thread <id> "words" --addressed "note"\nStop:  Ctrl-C (comments stay in ${basename(link.sidecar)})`,
   );

package/dist/pipeup.agents.js

@@ -0,0 +1,2 @@
+"use strict";(()=>{function b(e){let t=globalThis;(t.pipeupAddons||=[]).push(e),typeof addEventListener=="function"&&addEventListener("load",()=>{t.Pipeup||console.error(`pipeup: the "${e.id}" add-on needs Pipeup on the page too; load pipeup.min.js.`)},{once:!0})}var re=2n**256n-2n**32n-977n;var L=/^\/__pipeup\/[A-Za-z0-9_-]{16,}$/;function P(e){let t=document.documentElement,n=t.getAttribute("data-pipeup-link")??"",s=L.test(n),o=!1,c=0,y=()=>{};async function r(){let d=!1;try{d=(await fetch(`${n}/comments`,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify(await e.snapshot())})).ok}catch{}if(!d)throw new Error("pipeup: the link to your agent isn't reachable; your comments are safe here")}let u=()=>{window.clearTimeout(c),y(),y=()=>{},o=!1};return{enabled:s,agent:t.getAttribute("data-pipeup-link-agent")??"",file:t.getAttribute("data-pipeup-link-file")??"",on:()=>o,set:async d=>{if(s){if(!d){u(),e.refresh();return}await r(),o=!0,y=e.changes(()=>{window.clearTimeout(c),c=window.setTimeout(()=>{r().catch(h=>{u(),e.refresh(),globalThis.reportError?.(h)})},300)}),e.refresh()}},destroy:u}}function T(e){let t=n=>n.replace(/\s+/g," ").trim();return[`Act on the review comments on this page, which uses Pipeup: ${t(e.title)} (${t(e.url)}).`,"",e.file?`1. Read the comments: \`npx pipeup comments ${e.file}\` (add --all for resolved ones). If it says nothing is shared, ask me to switch on Share with my agent.`:"1. Read the comments. Open the page in a browser and run `await Pipeup.comments()`, then read `.markdown`. If you can't run the page, ask me to paste its Copy as Markdown.","2. Work through the open threads in order. For each, make the change I approved, or say why you didn't. Ask me before changing anything I haven't approved, and answer a question with an answer.",e.replies?`3. Answer in each thread: \`npx pipeup reply --page ${e.file||"<the page's file>"} --thread <Thread id> "what you changed and where" --addressed "short note"\`. That writes ${t(e.replies)}.`+(e.listed?"":" The page doesn't list your key yet: run `npx pipeup agent --name <your name>` and tell me the attribute to add."):"3. Tell me what you would reply in each thread, in words I can paste.","4. Only mark a thread addressed. Never resolve, reopen, edit or delete: I close threads. Keep your key out of the page and its folder, and never answer as me.","","Guide: https://pipeup-ai.github.io/pipeup/skills/pipeup-apply/SKILL.md"].join(`
+`)}var C=/^[A-Za-z0-9_-]{43}$/,_="pipeupReplies";var D=/^AI assistant\s*·?\s*/;function x(e=document.documentElement){let t=e.getAttribute("data-pipeup-agents")??"";return[...new Set(t.split(/[\s,]+/).filter(n=>C.test(n)))]}function k(e=location,t=document.documentElement){let n=t.getAttribute("data-pipeup-replies");try{let s=e.href.split(/[?#]/)[0],o=new URL(n??(/\/$/.test(s)?`${s}index.replies.js`:s.replace(/\.[^./]*$/,"")+".replies.js"),e.href),c=o.protocol==="file:"?e.protocol==="file:":o.origin===e.origin;return c||console.warn("pipeup: the replies file must be on this site or this computer; ignoring it"),c?o.href:null}catch{return null}}function E(e){let t=x(),n=0,s="",o=null;async function c(){let l=globalThis[_];if(!Array.isArray(l))return 0;let p=l.splice(0),g=[];for(let f of p){let m=f;if(!(m?.format!=="pipeup-replies"||m.doc!==e.document.id||!Array.isArray(m.ops)))for(let i of m.ops){let a=i?.body;a&&t.includes(a.author)&&(a.kind==="reply"||a.kind==="addressed"||a.kind==="react"||a.kind==="unreact")?(g.push(i),(a.name==="AI assistant"||a.name.startsWith("AI assistant "))&&(s=a.name.replace(D,""))):n++}}return g.length?e.merge(g):0}function y(){let l=k();return l?(o?.remove(),new Promise((p,g)=>{let f=document.createElement("script");o=f,f.src=`${l}?${Date.now()}`;let m=a=>{window.clearTimeout(i),f.remove(),o===f&&(o=null),a?g(new Error(`pipeup: ${a}`)):p()},i=window.setTimeout(()=>m("the replies file didn't answer"),4e3);f.addEventListener("load",()=>m()),f.addEventListener("error",()=>m("there is no replies file yet")),e.overlay().append(f)})):Promise.reject(new Error("pipeup: the replies file can't be read from here"))}async function r(){if(!t.length)return 0;let l=await c();return await y(),l+await c()}let u=!1,d=()=>{u||document.hidden||(u=!0,r().catch(()=>{}).finally(()=>u=!1))},h=0;return t.length?(d(),h=window.setInterval(d,4e3),document.addEventListener("visibilitychange",d)):c(),{enabled:t.length>0,ignored:()=>n,who:()=>s,check:r,tally:l=>{let p=l.filter(i=>!i.resolved),g=i=>i.root.replies.some(a=>t.includes(a.author)),f=new Set(l.map(i=>i.id));return{stray:new Set(e.document.ops().filter(i=>t.includes(i.body.author)&&!f.has(i.body.thread)).map(i=>i.body.thread)).size,open:p.length,answered:p.filter(g).length,addressed:p.filter(i=>i.addressed).length}},destroy:()=>{window.clearInterval(h),document.removeEventListener("visibilitychange",d),o?.remove()}}}var R=()=>globalThis.Pipeup??{},H=["M10 8h8a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2h-8a2 2 0 0 1-2-2v-8a2 2 0 0 1 2-2z","M16 8V6a2 2 0 0 0-2-2H6a2 2 0 0 0-2 2v8a2 2 0 0 0 2 2h2"],N=["M21 12L3.5 4.5 6.2 12l-2.7 7.5zM6.2 12H13"],z="Reads a replies file next to this page. When the page is shown through pipeup watch, and only after you switch it on, it sends this page's comments to the program running on this computer. Nothing leaves this computer.",S=e=>e instanceof Error?e.message.replace(/^pipeup: /,""):"Something went wrong";async function K(e,t){try{await navigator.clipboard.writeText(e);return}catch{}let n=document.createElement("textarea");n.value=e,n.setAttribute("readonly",""),n.style.cssText="position:fixed;opacity:0;pointer-events:none",t.append(n),n.select();let s=document.execCommand("copy");if(n.remove(),!s)throw new Error("pipeup: your browser blocked copying")}function U(){return{id:"agents",api:1,version:"0.6.0",needs:["menu","status","notify","listnote"],network:{when:"page-configured",to:["page"],says:z},setup(e){let t=E(e),n=P({snapshot:async()=>{let r=R();if(!r.comments)throw new Error("pipeup: this page has no Pipeup to read comments from");let[u,d]=await Promise.all([r.comments(),r.comments({all:!0})]);return{v:1,at:new Date().toISOString(),title:document.title,open:u,all:d}},changes:r=>e.document.onChange(r),refresh:()=>o()}),s=()=>t.who()||n.agent,o=()=>{if(e.setStatus(t.enabled||n.enabled?{text:n.on()?`Sharing comments with ${s()||"your agent"}`:`${s()||"An AI agent"} can answer comments here`}:null),!t.enabled)return e.setListNote(null);let r=t.tally(e.document.threads()),u=s()||"An agent",d=r.answered?`${u} has answered ${r.answered} of ${r.open} open comments${r.addressed?`; ${r.addressed} ${r.addressed===1?"is":"are"} marked addressed`:""}`:"No replies from an agent yet",h=t.ignored(),l=(n.on()?`Sharing with ${n.agent||"your agent"} \xB7 `:"")+d+(h?` \xB7 ${h} from other writers ignored`:"")+(r.stray?` \xB7 replies for ${r.stray} comment${r.stray===1?"":"s"} this page doesn't have`:"");e.setListNote({text:l,action:{label:"Check for replies",run:async()=>{try{let p=await t.check();e.notify(p?`${p} new ${p===1?"reply":"replies"}`:"No new replies")}catch(p){e.notify(S(p))}finally{o()}}}})},c=[e.addMenuItem({id:"prompt",icon:H,label:()=>"Copy a prompt for my agent",hint:()=>"Tells an AI agent where the comments are and how to answer them",select:async()=>{try{await K(T({title:document.title,url:location.href,replies:k(),file:n.enabled?n.file:"",listed:x().length>0}),e.overlay()),e.notify("Copied a prompt for your agent")}catch(r){e.notify(S(r))}}})];n.enabled&&c.push(e.addMenuItem({id:"link",icon:N,label:()=>"Share with my agent",hint:()=>"Sends this page's comments to the program running on this computer, and nothing else",checked:()=>n.on(),select:async()=>{try{await n.set(!n.on())}catch(r){e.notify(S(r))}o()}}));let y=e.document.onChange(o);return o(),()=>{y(),t.destroy(),n.destroy()}}}}b(U());})();