samagotchi 0.59.0 → 0.61.0

data/lib/samagotchi/web/public/answer_refs.js

@@ -0,0 +1,217 @@
+// The refs a plugin attached to an answer (the message's display_refs,
+// traceable refs P5b): each {match, kind, target, label?, actions} is
+// paired with the answer's bubble, then bound to what it stands for
+// (refs.js bindRef), so its actions join the ref's menu.
+//
+// A bubble knows its message's refs through setAnswerRefs (a reload's
+// render, a turn-end read's re-render); pairAnswerRefs pairs them once per
+// setAnswerRefs. Three passes over all the refs, strongest evidence
+// first, so a weak text match of one ref never takes another's link:
+//   1. a link whose href is one of the ref's action URLs;
+//   2. a link whose text is the match;
+//   3. the match as a whole token inside one plain text node (not in pre,
+//      a link, inline code or another ref), or an inline code that is the
+//      match alone.
+// A ref binds every occurrence its first finding pass finds; a ref no
+// pass finds is dropped. A label that differs from the element's text is
+// its hover title (unless the element has one: a markdown link's).
+// The match and label are a plugin's text: they only ever go through
+// textContent, setAttribute and bindRef, never markup or a RegExp.
+
+import { COPY_SOURCE_ATTR, copySource, showsAnswer } from "./copy.js";
+import { bindRef, boundRef, httpUrl, refKindOk } from "./refs.js";
+
+// bubble → {refs, paired}. A WeakMap: a dropped bubble takes its refs with
+// it; the stage hand-off moves the bubble, so they move along.
+const ANSWER_REFS = new WeakMap();
+
+// Text never paired: code blocks, links (passes 1 and 2 are theirs), a ref
+// already made, inline code (only as the match alone).
+const SKIP = "pre, a, [data-ref-kind]";
+
+// A token boundary, as the `path:line` scanner's (ref_scan.js REF): not
+// after a path-ish character, not before a word character or a slash.
+const BEFORE = /[\w./@+~-]/;
+const AFTER = /[\w/]/;
+
+// +bubble+'s refs are +refs+ (a message's display_refs: entries with a
+// match and a kind bindRef binds); a non-array or one without a usable
+// entry clears them. They pair on the next
+// pairAnswerRefs, even when the same ones were paired before.
+export function setAnswerRefs(bubble, refs) {
+  if (!bubble) return;
+  const list = (Array.isArray(refs) ? refs : []).filter(
+    (ref) => ref && typeof ref === "object" && refKindOk(ref.kind) && typeof ref.match === "string" && ref.match.trim(),
+  );
+  if (list.length) ANSWER_REFS.set(bubble, { refs: list, paired: false });
+  else ANSWER_REFS.delete(bubble);
+}
+
+// +bubble+'s refs (setAnswerRefs'), or null.
+export function answerRefsOf(bubble) {
+  return ANSWER_REFS.get(bubble)?.refs || null;
+}
+
+// The turn's final answer on its bubble (a turn-end read's +messages+):
+// the last assistant message with text, its bubble the last of +bubbles+
+// that shows it (copy.js showsAnswer, with +normalize+). Its rendered html
+// replaces the bubble's when it has one (not with web.markdown off or no
+// renderer: the text stays); its refs are the bubble's either way (a
+// later read without any clears them). The bubble, or null.
+export function applyFinalAnswer(messages, bubbles, normalize) {
+  const message = [...(Array.isArray(messages) ? messages : [])].reverse().find(
+    (item) => item?.role === "assistant" && (typeof item.html === "string" || String(item.content ?? "").trim()),
+  );
+  const bubble = message && [...bubbles].reverse().find((item) => showsAnswer(item, message, normalize));
+  if (!bubble) return null;
+  if (typeof message.html === "string") {
+    bubble.classList.add("markdown");
+    bubble.setAttribute(COPY_SOURCE_ATTR, copySource(message));
+    bubble.innerHTML = message.html;
+  }
+  setAnswerRefs(bubble, message.display_refs);
+  return bubble;
+}
+
+// Pairs +bubble+'s refs with its links and text and binds them (once per
+// setAnswerRefs; again a no-op).
+export function pairAnswerRefs(bubble) {
+  const entry = bubble && ANSWER_REFS.get(bubble);
+  if (!entry || entry.paired) return;
+  entry.paired = true;
+  let left = entry.refs;
+  left = left.filter((ref) => !pairByHref(bubble, ref));
+  left = left.filter((ref) => !pairByLinkText(bubble, ref));
+  pairByText(bubble, left);
+}
+
+// The links a ref may take: not inside a code block or another ref, not
+// bound by a plugin's ref already (a link the regex scanner adopted has
+// attributes only: it may be bound).
+function freeLinks(bubble) {
+  return [...bubble.querySelectorAll("a[href]")].filter((a) => !boundRef(a) && !a.parentElement?.closest("pre, [data-ref-kind]"));
+}
+
+// Pass 1: true when +ref+ took a link to one of its action URLs.
+function pairByHref(bubble, ref) {
+  const urls = new Set((Array.isArray(ref.actions) ? ref.actions : []).map((action) => httpUrl(action?.url)).filter(Boolean));
+  if (!urls.size) return false;
+  const links = freeLinks(bubble).filter((a) => urls.has(httpUrl(a.getAttribute("href"))));
+  return bindAll(links, ref);
+}
+
+// Pass 2: true when +ref+ took a link whose text is its match. The link
+// goes somewhere the ref doesn't name (the model's URL): the ref's actions
+// join its menu, but its label isn't the link's title.
+function pairByLinkText(bubble, ref) {
+  const match = ref.match.trim();
+  return bindAll(freeLinks(bubble).filter((a) => a.textContent.trim() === match), ref, { label: false });
+}
+
+// Pass 3, for all the +refs+ left at once: a ref the path:line scan made
+// (attributes only, no plugin data) whose text is a match is bound in
+// place (the scan ran first on a bubble that wasn't re-rendered: an answer
+// without html); an inline code that is a match alone is wrapped whole;
+// then each text node's hits (refs in list order, a hit overlapping an
+// earlier one dropped) are wrapped in one go.
+function pairByText(bubble, refs) {
+  if (!refs.length) return;
+  const doc = bubble.ownerDocument;
+  const matching = (el) => {
+    const text = el.textContent.trim();
+    return refs.find((candidate) => candidate.match.trim() === text);
+  };
+  for (const scanned of [...bubble.querySelectorAll("[data-ref-kind]:not(a)")]) {
+    if (boundRef(scanned) || scanned.parentElement?.closest("pre, a, [data-ref-kind]")) continue;
+    const ref = matching(scanned);
+    if (ref) bindAll([scanned], ref);
+  }
+  for (const code of [...bubble.querySelectorAll("code")]) {
+    if (code.closest(SKIP)) continue;
+    const ref = matching(code);
+    if (!ref) continue;
+    const span = refSpan(doc, ref);
+    if (!span) continue;
+    code.replaceWith(span);
+    span.append(code);
+    labelOn(span, ref);
+  }
+  const walker = doc.createTreeWalker(bubble, 4 /* NodeFilter.SHOW_TEXT */);
+  const nodes = [];
+  for (let node = walker.nextNode(); node; node = walker.nextNode()) {
+    const skip = node.parentElement?.closest(`${SKIP}, code`);
+    if (!skip || !bubble.contains(skip)) nodes.push(node);
+  }
+  const hits = new Map();
+  for (const ref of refs) {
+    const match = ref.match.trim();
+    for (const node of nodes) {
+      for (const [start, end] of tokenHits(node.data, match)) {
+        const list = hits.get(node) || [];
+        if (list.some(([s, e]) => start < e && end > s)) continue;
+        list.push([start, end, ref]);
+        hits.set(node, list);
+      }
+    }
+  }
+  for (const [node, list] of hits) wrap(node, list.sort((a, b) => a[0] - b[0]));
+}
+
+// [start, end] of each whole-token +match+ in +text+ (indexOf: the match
+// is a plugin's text, never a pattern).
+function tokenHits(text, match) {
+  const found = [];
+  for (let at = text.indexOf(match); at >= 0; at = text.indexOf(match, at + 1)) {
+    const end = at + match.length;
+    if (at > 0 && BEFORE.test(text[at - 1])) continue;
+    if (end < text.length && AFTER.test(text[end])) continue;
+    found.push([at, end]);
+    at = end - 1;
+  }
+  return found;
+}
+
+function wrap(node, hits) {
+  const doc = node.ownerDocument;
+  const frag = doc.createDocumentFragment();
+  let pos = 0;
+  for (const [start, end, ref] of hits) {
+    const span = refSpan(doc, ref);
+    if (!span) continue;
+    if (start > pos) frag.append(node.data.slice(pos, start));
+    span.textContent = node.data.slice(start, end);
+    labelOn(span, ref);
+    frag.append(span);
+    pos = end;
+  }
+  if (!pos) return;
+  if (pos < node.data.length) frag.append(node.data.slice(pos));
+  node.replaceWith(frag);
+}
+
+// A span bound to +ref+, or null when bindRef refuses it (a bad kind).
+function refSpan(doc, ref) {
+  const span = doc.createElement("span");
+  bindRef(span, ref);
+  return boundRef(span) ? span : null;
+}
+
+// Binds each of +els+ to +ref+; true when one took it.
+function bindAll(els, ref, { label = true } = {}) {
+  let bound = false;
+  for (const el of els) {
+    bindRef(el, ref);
+    if (!boundRef(el)) continue;
+    if (label) labelOn(el, ref);
+    bound = true;
+  }
+  return bound;
+}
+
+// The ref's label as the element's hover title, when it says more than
+// the element's text and the element has no title of its own.
+function labelOn(el, ref) {
+  const label = typeof ref.label === "string" ? ref.label.trim() : "";
+  if (!label || label === el.textContent.trim() || el.hasAttribute("title")) return;
+  el.setAttribute("title", label);
+}

data/lib/samagotchi/web/public/app.js

@@ -46,7 +46,7 @@ import { createTaskStopper } from "./task_stop.js";
 import { appendQuote } from "./annotations.js";
 import { parsePresets } from "./annotate_presets.js";
 import { createAnnotateBar } from "./annotate_bar.js";
-import { COPY_SOURCE_ATTR, copySource, copyText, installCopy, showsAnswer } from "./copy.js";
+import { copyText, installCopy } from "./copy.js";
 import { ctxBarText, ctxBarTip, lastSpeedText, speedText } from "./ctx.js";
 import { createQuestionCards } from "./question_cards.js";
 import { cardClass, cardInnerHtml, cardPlace, isCard, isNoticeCard, noticeInnerHtml, splitSnapshotCards, turnNoticePlace } from "./card.js";
@@ -65,6 +65,7 @@ import {
   appendAboveLiveTiming, formatDuration, mergeTiming, normalizeTiming, sessionDurationNow, STOPPED_LINE_CLASS,
 } from "./timing.js";
 import { createLiveTurn } from "./live_turn.js";
+import { applyFinalAnswer, pairAnswerRefs } from "./answer_refs.js";
 import { installRefClicks } from "./refs.js";
 import { linkRefs, touchedFiles } from "./ref_scan.js";
 import { DONE_MS, applyInitEvent, dropDone, initRowHtml, newInitTasks, seedInitTasks } from "./init_row.js";
@@ -904,30 +905,26 @@ async function readTurnEnd() {
   } catch(_){}
 }
 
-// The turn's answer as its rendered markdown, once it is final (the
-// turn-end read, an answer_display re-read); then its refs.
+// The turn's answer as its rendered markdown and with its plugin refs,
+// once it is final (the turn-end read, an answer_display re-read:
+// answer_refs.js applyFinalAnswer); then the refs.
 function applyFinalMarkdown(messages) {
-  const message = [...messages].reverse().find(
-    (item) => item?.role === "assistant" && typeof item.html === "string",
-  );
-  const bubble = message && findInTurnRoots(".bubble.output")
-    .reverse()
-    .find((item) => showsAnswer(item, message, normalize));
-  if (bubble) {
-    bubble.classList.add("markdown");
-    bubble.setAttribute(COPY_SOURCE_ATTR, copySource(message));
-    bubble.innerHTML = message.html;
-  }
+  applyFinalAnswer(messages, findInTurnRoots(".bubble.output"), normalize);
   linkTextRefs();
 }
 
-// The `path:line` refs in the answers' and closed steps' texts that name a
-// file the session's rows (and cards) touched, on this page (ref_scan.js).
-// Not mid-stream: at a turn's end and after a reload's render. A ref
-// already made stays as it is.
+// The refs on the answers' and closed steps' texts, on this page: first
+// each answer's own (a plugin's, answer_refs.js), then the `path:line`
+// refs that name a file the session's rows (and cards) touched
+// (ref_scan.js), which leave a plugin's alone. Not mid-stream: at a
+// turn's end and after a reload's render. A ref already made stays as it
+// is.
 function linkTextRefs() {
   const roots = turnRoots();
   const touched = touchedFiles(roots);
+  for (const root of roots) {
+    for (const el of root.querySelectorAll(".bubble.output")) pairAnswerRefs(el);
+  }
   if (!touched.size) return;
   for (const root of roots) {
     for (const el of root.querySelectorAll(".bubble.output, .gen:not(.live) > .gen-text")) linkRefs(el, touched, current.dir);

data/lib/samagotchi/web/public/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32"><defs><linearGradient id="g" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#7aa5ff"/><stop offset="1" stop-color="#8957e5"/></linearGradient></defs><rect x="1" y="1" width="30" height="30" rx="7.5" fill="url(#g)"/><g fill="none" stroke="#fff" stroke-width="3.2" stroke-linecap="round" stroke-linejoin="round"><path d="M7.8 9.6c2.3-1.3 4-.7 5.2 1.4l6 10.1c1.2 2.1 2.9 2.7 5.2 1.4"/><path d="M22.6 9.2 9.4 22.8"/></g></svg>

data/lib/samagotchi/web/public/index.html

@@ -3,6 +3,7 @@
 <head>
 <meta charset="utf-8">
 <title>Chi</title>
+<link rel="icon" href="/assets/favicon.svg" type="image/svg+xml">
 <meta name="viewport" content="width=device-width,initial-scale=1">
 <style>
 :root{color-scheme:dark;--bg:#0b0d11;--bg-panel:#151821;--bg-inset:#0f1115;--bg-raised:#22262f;--bg-hover:#1b1f27;--border:#1f232b;--border-strong:#2d333f;--text:#e6e8eb;--text-bright:#f0f3f6;--text-2:#c9d1d9;--text-3:#9aa4b2;--text-muted:#8b949e;--text-faint:#6e7681;--accent:#7aa5ff;--accent-strong:#1f6feb;--accent-bg:#1b2336;--accent-ring:rgba(122,165,255,.18);--primary:#2a68d1;--ok:#3fb950;--ok-text:#7ee787;--ok-bg:#1a2e1a;--warn:#d29922;--warn-text:#e3b341;--warn-bright:#f2cc60;--warn-bg:#2b2108;--warn-border:#6b5416;--danger:#f85149;--danger-bg:#da3633;--danger-text:#ff7b72;--danger-bg-dim:#3d1f1f;--think:#8957e5;--think-text:#d2a8ff;--accent-border:#223150;--pick-border:#79c0ff;--accent-tint:color-mix(in srgb,var(--accent) 7%,transparent);--narr:color-mix(in srgb,var(--accent) 38%,var(--text-muted));
@@ -381,16 +382,18 @@ button.task-stop:hover:not(:disabled){background:var(--danger-bg-dim);filter:non
 .diff code{display:block;min-width:max-content}
 .diff-line{display:block;padding:0 10px;white-space:pre;color:var(--text-2)}
 /* Refs (refs.js): text until hovered or focused, and only with a target for this viewer (refs.js marks it: data-ref-main, the main one). A link ref keeps its link look. */
-.ref[data-ref-main]:not(a):is(:hover,:focus-visible){color:var(--accent);text-decoration:underline dotted;text-underline-offset:3px;cursor:pointer}
-.ref[data-ref-main="editor"]:not(a):is(:hover,:focus-visible)::after{content:"\2197";margin-left:.3em;color:var(--text-faint);display:inline-block}
+.ref[data-ref-main]:not(a):is(:hover,:focus-visible,[data-ref-more]){color:var(--accent);text-decoration:underline dotted;text-underline-offset:3px;cursor:pointer}
+.ref[data-ref-main="editor"]:not(a):is(:hover,:focus-visible,[data-ref-more])::after{content:"\2197";margin-left:.3em;color:var(--text-faint);display:inline-block}
 .ref[data-ref-kind]:focus-visible{outline:2px solid var(--accent);outline-offset:2px;border-radius:3px}
 :is(.activity-row,.bubble.approval) .diff-line[data-ref-main]:hover{cursor:pointer;box-shadow:inset 2px 0 var(--accent)}
 :is(.activity-row,.bubble.approval) .diff-line[data-ref-main]:hover::after{content:"\2197  " attr(data-line);float:right;padding-left:12px;color:var(--text-faint)}
 .activity-row .read-line[data-ref-main]:hover{cursor:pointer;box-shadow:inset 2px 0 var(--accent)}
 .activity-row .read-line[data-ref-main]:hover::before{color:var(--accent)}
 /* A ref's ▾ and its menu (ref_menu.js): one each, placed next to the ref. */
-.ref-more{position:fixed;z-index:60;display:inline-flex;align-items:center;justify-content:center;width:20px;height:20px;padding:0;border:1px solid var(--border-strong);border-radius:5px;background:var(--bg-panel);color:var(--text-muted);font-size:12px;line-height:1;cursor:pointer;box-shadow:0 1px 3px var(--shadow-strong)}
+.ref-more{position:fixed;z-index:60;display:inline-flex;align-items:center;justify-content:center;width:16px;height:16px;padding:0;border:1px solid var(--border-strong);border-radius:4px;background:var(--bg-panel);color:var(--text-muted);font-size:12px;line-height:1;cursor:pointer;box-shadow:0 1px 3px var(--shadow-strong)}
 .ref-more[hidden]{display:none}
+/* A ref makes room after itself for its ▾ while it shows (ref_menu.js), and keeps its hover look (its ↗ too) until the ▾ goes: the ▾ never covers what follows it. */
+.ref[data-ref-more]{padding-right:19px}
 .ref-more:hover{color:var(--accent);border-color:var(--accent)}
 .ref-menu{position:fixed;z-index:61;min-width:160px;max-width:calc(100vw - 16px);padding:4px;border:1px solid var(--border-strong);border-radius:8px;background:var(--bg-panel);box-shadow:var(--toast-shadow);animation:fadeIn .12s ease-out}
 .ref-menu [role="menuitem"]{display:block;width:100%;padding:6px 10px;border:0;border-radius:5px;background:none;color:var(--text);font:inherit;font-size:13px;text-align:left;cursor:pointer;white-space:nowrap}

data/lib/samagotchi/web/public/ref_menu.js

@@ -10,6 +10,9 @@
 const HIDE_MS = 300;
 // Kept from the viewport's edges (a phone's width).
 const EDGE = 8;
+// The ▾ sits in room its ref makes after itself while it shows
+// (data-ref-more, index.html), so it never covers what follows the ref:
+// the next words of an answer, a row's duration.
 
 // +doc+'s ▾ and menu. open(el, items, {focus}) shows +items+ ({id, label,
 // run}) under +el+; showMore(el, onOpen) puts the ▾ after +el+, whose click
@@ -50,18 +53,23 @@ export function createRefMenu(doc = globalThis.document) {
   function showMore(el, onOpen) {
     clearTimeout(hideTimer);
     const button = moreButton();
+    if (moreFor && moreFor !== el) delete moreFor.dataset.refMore;
     moreFor = el;
     onMore = onOpen;
+    el.dataset.refMore = "";
     button.hidden = false;
     const rect = lastRect(el);
+    const width = button.offsetWidth || 16;
     const top = rect.top + (rect.height - (button.offsetHeight || rect.height)) / 2;
-    button.style.left = `${Math.min(rect.right + 2, win.innerWidth - (button.offsetWidth || 16) - 2)}px`;
+    const left = rect.right - width - 1;
+    button.style.left = `${Math.min(left, win.innerWidth - width - 2)}px`;
     button.style.top = `${top}px`;
   }
 
   function hideMore() {
     clearTimeout(hideTimer);
     if (more) more.hidden = true;
+    if (moreFor) delete moreFor.dataset.refMore;
     moreFor = null;
   }
 

data/lib/samagotchi/web/public/ref_scan.js

@@ -103,13 +103,15 @@ function resolved(ref, touched, cwd) {
   return path ? { kind: "file", path, line: ref.line, end_line: ref.endLine } : null;
 }
 
-// The absolute paths of the file refs under +roots+ (the session's rows,
-// approval cards): what a text ref may name.
+// The absolute paths of the file refs in the session's rows and approval
+// cards under +roots+: what a text ref may name. Not an answer's own refs
+// (a scanned one repeats a row's; a plugin's file ref names a file the
+// session may not have touched).
 export function touchedFiles(roots) {
   const touched = new Set();
   for (const root of roots) {
     for (const el of root.querySelectorAll('[data-ref-kind="file"][data-ref-path]')) {
-      touched.add(el.dataset.refPath);
+      if (el.closest(".activity-row, .bubble.approval")) touched.add(el.dataset.refPath);
     }
   }
   return touched;

data/lib/samagotchi/web/public/refs.js

@@ -6,6 +6,11 @@
 // an answer or a step's text (ref_scan.js; a link whose text is one too).
 // The DOM carries data-ref-kind and the target's attributes, never what a
 // click does: those are the ref's targets, kept per kind in REF_ACTIONS.
+// A plugin's ref (the server's Ref: {kind, target, label?, actions}) is
+// bound to its element by bindRef: its label and its URL actions live in a
+// WeakMap off the DOM, and refTarget reads them first. Its actions join the
+// kind's own (the `actions` entry); a kind the page has no table for runs
+// only those.
 // A plain click runs the first one available (the main target); a ref
 // with more shows a ▾ on hover that opens a menu of all of them
 // (ref_menu.js), and a tap opens it. A ref with a target is a tab stop
@@ -26,6 +31,77 @@ export function refAttrs(ref) {
   return ` data-ref-kind="${escapeHtml(ref.kind)}"${attr("path", ref.path)}${attr("line", ref.line)}${attr("end-line", ref.end_line)}`;
 }
 
+// A kind, as the server's Ref allows it (Ref::KIND).
+const KIND = /^[a-z][a-z0-9_-]{0,31}$/;
+
+// +kind+ is one bindRef binds.
+export function refKindOk(kind) {
+  return typeof kind === "string" && KIND.test(kind);
+}
+
+// A plugin's ref data per element (bindRef): {kind, target, label,
+// actions}. A WeakMap, so a redrawn element takes its data with it.
+const REF_DATA = new WeakMap();
+
+// The longest URL the page opens: the server's RefAction::MAX_URL.
+const MAX_URL = 2000;
+
+// +url+ as the page opens it when it is an http(s) one with no userinfo
+// and at most MAX_URL characters (trimmed), else null. The server's
+// RefAction.http_url? checks it too; the page is at least as strict on
+// userinfo, and the URL parser refuses an http(s) URL without a host. The
+// page never opens another scheme a plugin gave (javascript:, data:, an
+// editor's), nor a "https://github.com@evil.example/" (one host shown,
+// another opened).
+export function httpUrl(url) {
+  if (typeof url !== "string") return null;
+  const trimmed = url.trim();
+  if (trimmed.length > MAX_URL) return null;
+  try {
+    const parsed = new URL(trimmed);
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") return null;
+    if (parsed.username || parsed.password) return null;
+    return parsed.href;
+  } catch {
+    return null;
+  }
+}
+
+// Makes +el+ the ref +ref+ (the server's Ref#to_h): the ref class and the
+// data attributes every ref carries (a file's path and lines, as refAttrs),
+// its label and its actions in the WeakMap. An action without an id, a
+// label or an http(s) URL is dropped; a kind the server's Ref refuses binds
+// nothing. A rebind replaces the target attributes. +el+, or null without one.
+export function bindRef(el, ref) {
+  if (!el) return null;
+  if (!refKindOk(ref?.kind)) return el;
+  const target = ref.target || {};
+  el.classList.add("ref");
+  el.dataset.refKind = ref.kind;
+  for (const [name, value] of [["refPath", target.path], ["refLine", target.line], ["refEndLine", target.end_line]]) {
+    if (value) el.dataset[name] = String(value);
+    else delete el.dataset[name];
+  }
+  const actions = (Array.isArray(ref.actions) ? ref.actions : []).flatMap((action) => {
+    const url = httpUrl(action?.url);
+    return url && action.id && action.label ? [{ id: String(action.id), label: String(action.label), url }] : [];
+  });
+  REF_DATA.set(el, { kind: ref.kind, target, label: ref.label || null, actions });
+  return el;
+}
+
+// The plugin ref bound to +el+ (bindRef's data), or null: a row title or
+// a scanned ref (attributes only) has none.
+export function boundRef(el) {
+  return (el && REF_DATA.get(el)) || null;
+}
+
+// The same URL either way (a link's href against an action's URL).
+function sameUrl(a, b) {
+  const url = httpUrl(a);
+  return !!url && url === httpUrl(b);
+}
+
 // The URL +template+ ({path}, {line}; web.editor) opens +path+ at +line+
 // (1 when none) with: each path segment encoded, the slashes kept. "" with
 // no template or path.
@@ -41,16 +117,38 @@ export function editorUrl(template, path, line) {
 // editorUrl}, the server's capabilities.editor and editor_url) and
 // +target+ (refTarget's). A secondary one (copy) joins a ref that has
 // another, never alone. A line (a diff or read line) has its click only.
+// A link whose text is the ref (github-pr's PR diff): its href stays the
+// plain click's, which the browser follows. Its label is the ref's action
+// with the same URL (the menu shows them once), else the old guess from
+// the URL (an old session's link has no ref data).
+const LINK = Object.freeze({
+  id: "link",
+  label: (target) => target.actions?.find((action) => sameUrl(action.url, target.href))?.label ||
+    (/\/pull\/\d+\/files\b/.test(target.href) ? "PR diff" : "Open link"),
+  available: (_viewer, target) => !!target.href,
+  run: (target, _viewer, env) => env.openLink(target.href),
+});
+
+// The ref's own actions (a plugin's, bindRef), one target each, for every
+// viewer (a URL opens on a phone too): a new tab with no opener and no
+// referrer. One with the link's URL, or an earlier one's, isn't repeated.
+// Not on a diff or read line (its click only), which shares its title's data.
+const URL_ACTIONS = Object.freeze({
+  id: "actions",
+  expand: (target) => (target.actions || [])
+    .filter((action, at, all) => !sameUrl(action.url, target.href) && all.findIndex((other) => sameUrl(other.url, action.url)) === at)
+    .map((action) => Object.freeze({
+      id: `url:${action.id}`,
+      label: () => action.label,
+      available: (_viewer, target) => !target.isLine,
+      run: (_target, _viewer, env) => env.openLink(action.url),
+      hint: () => action.url,
+    })),
+});
+
 export const REF_ACTIONS = Object.freeze({
   file: Object.freeze([
-    // A link whose text is the ref (github-pr's PR diff): its href stays
-    // the plain click's, which the browser follows.
-    Object.freeze({
-      id: "link",
-      label: (target) => (/\/pull\/\d+\/files\b/.test(target.href) ? "PR diff" : "Open link"),
-      available: (_viewer, target) => !!target.href,
-      run: (target, _viewer, env) => env.openLink(target.href),
-    }),
+    LINK,
     Object.freeze({
       id: "editor",
       label: () => "Open in editor",
@@ -63,6 +161,7 @@ export const REF_ACTIONS = Object.freeze({
       // The hover hint: it opens the file as it is now.
       hint: (target) => `Open the current file in your editor${target.line ? ` at line ${target.line}` : ""}`,
     }),
+    URL_ACTIONS,
     // The row that touched the file, in the turn: not for a row's own
     // title or lines (they are in the turn already).
     Object.freeze({
@@ -80,13 +179,18 @@ export const REF_ACTIONS = Object.freeze({
       run: (target, _viewer, env) => env.copy(target.path),
     }),
   ]),
+  // Any other kind (a plugin's issue, commit, …): its link, then its actions.
+  "*": Object.freeze([LINK, URL_ACTIONS]),
 });
 
 // The targets +viewer+ has for +target+ (refTarget's), in order; none
 // when only a secondary one is.
 export function refActions(target, viewer, actions = REF_ACTIONS) {
   if (!target) return [];
-  const found = (actions[target.kind] || []).filter((action) => action.available(viewer, target));
+  // Own keys only: a kind named like an Object property ("constructor") is
+  // any other kind.
+  const table = (Object.hasOwn(actions, target.kind) ? actions[target.kind] : actions["*"]) || [];
+  const found = table.flatMap((action) => (action.expand ? action.expand(target) : [action])).filter((action) => action.available(viewer, target));
   return found.some((action) => !action.secondary) ? found : [];
 }
 
@@ -97,8 +201,9 @@ const OWNERS = ".activity-row, .bubble.approval";
 // A line of the owner's file: a diff line, or a read row's numbered line.
 const LINES = ".diff-line[data-line], .read-line[data-line]";
 
-// What a click on +el+ points at: {kind, path, line, owner, el, isLine,
-// href} or null. A row title (or an approval card's path) opens its file
+// What a click on +el+ points at: {kind, path, id, label, actions, line,
+// owner, el, isLine, href} or null (+id+, +label+ and +actions+ a plugin's
+// ref's, bindRef: the WeakMap is read first). A row title (or an approval card's path) opens its file
 // at the lines the call named (an edit without any at its first changed
 // line); a diff line (or a hunk header) or a read row's numbered line, in
 // a row or a card with a ref, opens that file at that line. +el+ is the
@@ -109,7 +214,8 @@ export function refTarget(el) {
   if (title) {
     const owner = title.closest(OWNERS);
     const href = title.matches("a[href]") ? title.getAttribute("href") : null;
-    return { ...targetOf(title), line: Number(title.dataset.refLine) || firstChange(owner), owner: owner || title, el: title, isLine: false, href };
+    const own = targetOf(title);
+    return { ...own, line: own.line || firstChange(owner), owner: owner || title, el: title, isLine: false, href };
   }
   const diffLine = el?.closest?.(LINES);
   const owner = diffLine?.closest(OWNERS);
@@ -119,7 +225,13 @@ export function refTarget(el) {
 }
 
 function targetOf(el) {
-  return { kind: el.dataset.refKind, path: el.dataset.refPath || "" };
+  const data = REF_DATA.get(el);
+  if (!data) return { kind: el.dataset.refKind, path: el.dataset.refPath || "", line: Number(el.dataset.refLine) || null, id: null, label: null, actions: [] };
+  // Bound data is the whole ref: no fallback to the attributes.
+  const { target } = data;
+  return {
+    kind: data.kind, path: target.path || "", line: Number(target.line) || null, id: target.id ?? null, label: data.label, actions: data.actions,
+  };
 }
 
 // An edit/write without a line range opens at its first changed line (its
@@ -235,9 +347,11 @@ function defaultOpen(url) {
   else window.location.href = url;
 }
 
-// A link ref's href from the menu: a new tab, as the answer's links open.
+// A link ref's href or a ref's URL action: a new tab, as the answer's
+// links open, with no opener and no referrer (the page's LAN URL and
+// session id stay here).
 function defaultOpenLink(href) {
-  window.open(href, "_blank", "noopener");
+  window.open(href, "_blank", "noopener,noreferrer");
 }
 
 // One delegated listener set on +root+ for every ref on the page.

data/lib/samagotchi/web/public/stream_handlers.js

@@ -141,12 +141,14 @@ export function createStreamHandlers(deps) {
       if (display) await display.promise;
       turnDom.answerReady?.();
     },
-    // An after_turn hook presented the answer (AnswerDisplay): it comes after
-    // turn_completed, so re-read the answer once that read is done.
+    // An after_turn hook presented the answer (AnswerDisplay) or attached
+    // refs to it (AnswerRefs: refs, a count; display null when only refs):
+    // it comes after turn_completed, so re-read the answer once that read
+    // is done.
     answer_display: async (data) => {
       try {
         await liveTurn.endRead;
-        if (!selected() || !data.display) return;
+        if (!selected() || (!data.display && !data.refs)) return;
         const d = await getSession(selected(), { tail: true, recent: true });
         if (Array.isArray(d.messages)) applyFinalMarkdown(d.messages);
       } catch (_) {