samagotchi 0.134.0 → 0.135.0

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

@@ -105,7 +105,7 @@ export function setBubbleDelivery(bubble, delivery) {
 // @param appendToHistory (el) puts +el+ at the history's end (or the stage's,
 //   while it holds a turn), above the live timing line
 // @param isNearBottom () => whether the history follows its end
-// @param turnDom the running turn's view (stage_view.js / turn_view.js)
+// @param turnDom the running turn's DOM (stage_view.js)
 // @param findInTurnRoots (selector) => the matching elements in the history
 //   and the stage
 // @param shownTexts the running turn's texts on the page (shown_texts.js)
@@ -149,7 +149,7 @@ export function createBubbles({
 
   function addEndBubble(text, { stopped = false } = {}) {
     appendToHistory(elementOf(endBubbleTemplate(text, { stopped })));
-    if (!turnDom.holds?.()) historyEl.scrollTop = historyEl.scrollHeight;
+    if (!turnDom.holds()) historyEl.scrollTop = historyEl.scrollHeight;
   }
 
   // ── Prompt bubbles ───────────────────────────────────────────────────────
@@ -239,7 +239,7 @@ export function createBubbles({
     const details = elementOf(recapTemplate(text, turnsSince, createdAt));
     // A stale one sits where it was written, above the turns it doesn't cover.
     // Never in the stage: a recap is between turns.
-    turnDom.settleFold?.();
+    turnDom.settleFold();
     const prompt = recapPlace(turnPromptBubbles(historyEl), turnsSince);
     // Above that turn's gap divider too: the recap was written before the quiet stretch ended.
     const before = prompt?.previousElementSibling?.matches(`.${TIME_GAP_CLASS}`) ? prompt.previousElementSibling : prompt;

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

@@ -10,9 +10,10 @@
 import { getSession, sendCommand } from "./data.js";
 import { cardPlace, drawCard, isCard, isNoticeCard, refreshCardBody, turnNoticePlace } from "./card.js";
 import { elementOf } from "./turn_html.js";
-import { stepText } from "./turn_view.js";
+import { stepText } from "./turn_block.js";
 import { llmContextNotice, noticeLine } from "./turn_events.js";
 import { hookNoticeTemplate, TURN_PROMPT, turnPromptBubbles } from "./bubbles.js";
+import { stillOn } from "./latest.js";
 
 // The elements of the reloaded turn that ends before +before+ (the next
 // turn's prompt, or null for the last turn), its prompt first.
@@ -145,10 +146,11 @@ export function createCardsPlace({
   function refreshCardBodies() {
     clearTimeout(cardBodiesTimer);
     const id = selected();
+    const still = stillOn(selected, id);
     cardBodiesTimer = setTimeout(async () => {
       try {
         const data = await api.getSession(id, { cards: true });
-        if (id !== selected()) return;
+        if (!still()) return;
         for (const card of data.cards || []) {
           const el = card.type === "card" && cardElement(card.id);
           if (el) refreshCardBody(el, card);

data/lib/samagotchi/web/public/composer.css

@@ -24,6 +24,14 @@ body.no-glass .composer-card{background:var(--bg-panel);-webkit-backdrop-filter:
 body.has-session #composer{flex-wrap:wrap;row-gap:6px}
 #chips{display:flex;flex-wrap:wrap;gap:6px}
 #chips[hidden]{display:none}
+/* The armed Revise (revise_stack.js reviseChipTemplate): "Revising: ‹first line› ✕". */
+#reviseChip{display:flex;min-width:0}
+#reviseChip[hidden]{display:none}
+.revise-chip{display:inline-flex;align-items:center;gap:6px;max-width:100%;min-width:0;padding:2px 4px 2px 10px;border-radius:999px;border:1px solid var(--accent-border);background:var(--accent-bg);color:var(--text-2);font-size:12px;line-height:18px}
+.revise-chip.refused{border-color:var(--warn-border);background:var(--warn-bg);color:var(--warn-text)}
+.revise-chip-text{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.revise-chip-clear{flex:none;display:inline-flex;align-items:center;justify-content:center;width:20px;height:20px;min-height:0;padding:0;border:0;border-radius:999px;background:transparent;color:var(--text-muted);font-size:11px;cursor:pointer}
+.revise-chip-clear:hover{background:var(--bg-raised);color:var(--text-bright);filter:none}
 .chip{display:inline-flex;align-items:center;gap:6px;background:var(--accent-bg);border:1px solid var(--border-strong);border-radius:8px;padding:3px 4px 3px 3px;font-size:12px;max-width:220px}
 .chip img{width:32px;height:32px;object-fit:cover;border-radius:5px}
 .chip .chip-name{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}

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

@@ -11,6 +11,7 @@ import { html, nothing, render } from "./vendor/lit-html.js";
 import { keepFocus } from "./keep_focus.js";
 import { popoverPlace } from "./chip_popover.js";
 import { cantText } from "./format.js";
+import { createLatest, stillOn } from "./latest.js";
 
 // "now", "3m", "2h", "4d" since an ISO time; "" for none.
 export function ageText(iso, now = Date.now()) {
@@ -106,7 +107,8 @@ export function createContextChips({ el, api, toast = () => {}, doc = document,
   let rows = [];
   let canAdd = false;
   let openName = null;
-  let loadSeq = 0;
+  // Only the newest list read for the open session is drawn (latest.js).
+  const latest = createLatest(() => sessionId);
   // The open row's text once read (view text), and the "+ URL" form's
   // state ({error, busy}).
   let text = null;
@@ -140,15 +142,15 @@ export function createContextChips({ el, api, toast = () => {}, doc = document,
   async function refresh() {
     const id = sessionId;
     if (!id) return;
-    const seq = ++loadSeq;
+    const fresh = latest.begin();
     try {
       const data = await api.list(id);
-      if (seq !== loadSeq || id !== sessionId) return;
+      if (!fresh()) return;
       rows = data.sources || [];
       canAdd = data.can_add_url === true;
     } catch {
       // A session the server doesn't know (gone, or an older chi web): no chips.
-      if (seq !== loadSeq || id !== sessionId) return;
+      if (!fresh()) return;
       rows = [];
       canAdd = false;
     }
@@ -234,15 +236,16 @@ export function createContextChips({ el, api, toast = () => {}, doc = document,
     const url = form.elements.url.value.trim();
     const why = form.elements.why.value.trim();
     if (!id || !url) return;
+    const still = stillOn(() => sessionId);
     drawAdd({ busy: true });
     try {
       const data = await api.add(id, { url, why: why || undefined });
-      if (id !== sessionId) return;
+      if (!still()) return;
       close();
       await refresh();
       toast(`Attached ${data.name}: the agent gets a note before your next message`);
     } catch (e) {
-      if (id !== sessionId || openName !== ADD) return;
+      if (!still() || openName !== ADD) return;
       // The same form again: what the user typed stays; the URL gets focus.
       drawAdd({ busy: false, error: e.message });
       pop.querySelector('input[name="url"]')?.focus();

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

@@ -130,7 +130,7 @@ export function uploadImage(id, file, name, opts = {}) {
 // (mergeTiming), and opts.turnId asks for that turn's answer.
 // opts.timing: the whole timing alone (when the merge came up short).
 // opts.parts: each saved message with what it did (thinking, tool calls
-// and their output), for the turn view's reload.
+// and their output), for the turn block's reload.
 export function getSession(id, { tail, recent, turnId, timing, parts, cards, ...opts } = {}) {
   let query = cards ? "?cards=1" : tail ? "?tail=1" : timing ? "?timing=1" : parts ? "?parts=1" : "";
   if (tail && recent) query += "&recent=1";
@@ -144,12 +144,14 @@ export function getSession(id, { tail, recent, turnId, timing, parts, cards, ...
 // image-only send, whose text is only its [image: …] placeholders).
 // delivery: what the message does to a running turn ("cut": /cut TEXT);
 // none = the server's default (the next step).
-export function sendTurn(id, prompt, { clientId, images, history = true, delivery = null, verify = null, ...opts } = {}) {
+export function sendTurn(id, prompt, { clientId, images, history = true, delivery = null, verify = null, revises = null, ...opts } = {}) {
   const body = clientId ? { prompt, client_id: clientId } : { prompt };
   if (images?.length) body.images = images;
   if (delivery) body.delivery = delivery;
   if (history === false) body.history = false;
   if (verify) body.verify = verify;
+  // A Revise turn's draft: {turn_id} of the answer it rewrites.
+  if (revises) body.revises = revises;
   return api(`/api/sessions/${id}/turn`, {
     method: "POST",
     body: JSON.stringify(body),

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

@@ -21,7 +21,7 @@ import { toastBottom } from "./toast_place.js";
 // model panel (toast_place.js); with no card in sight (the start page, all
 // sessions) the CSS's 24 px from the bottom (--toast-bottom unset).
 //
-// +stageEl+: the stage (stage view) or null (turn view). +atHistoryEnd()+:
+// +stageEl+: the stage (stage_view.js). +atHistoryEnd()+:
 // the reader is at the history's end (app.js, scroll.js's threshold).
 // +reduce()+ / +ease+: prefers-reduced-motion and the eased follow
 // (scroll.js), defaults the page's.
@@ -37,7 +37,7 @@ export function createDockReserve({
   const win = doc.defaultView;
 
   function dockReserve() {
-    const shown = stageEl && !stageEl.hidden && !stageEl.classList.contains("leaving");
+    const shown = !stageEl.hidden && !stageEl.classList.contains("leaving");
     return dockEl.offsetHeight + (shown ? stageEl.offsetHeight + STAGE_GAP : 0);
   }
   const historyEnd = () => historyEl.scrollHeight - historyEl.clientHeight;
@@ -48,7 +48,7 @@ export function createDockReserve({
   // counts as at the end.
   function updateReserve({ fromStage = false } = {}) {
     const follow = atHistoryEnd() || historyEl.dataset.following !== undefined;
-    const leaving = !!stageEl?.classList.contains("leaving");
+    const leaving = stageEl.classList.contains("leaving");
     centerEl.classList.toggle("reserve-easing", leaving);
     const reserve = `${dockReserve()}px`;
     const changed = centerEl.style.getPropertyValue("--dock-h") !== reserve;
@@ -83,18 +83,16 @@ export function createDockReserve({
 
   const dockObserver = new win.ResizeObserver((entries) => updateReserve({ fromStage: entries.some((e) => e.target === stageEl) }));
   dockObserver.observe(dockEl);
-  if (stageEl) {
-    dockObserver.observe(stageEl);
-    // Only showing, hiding and leaving change the reserve (not the stage's
-    // other classes: waiting, in-use…).
-    let stageShown = "";
-    new win.MutationObserver(() => {
-      const shown = `${stageEl.hidden}|${stageEl.classList.contains("leaving")}`;
-      if (shown === stageShown) return;
-      stageShown = shown;
-      updateReserve({ fromStage: true });
-    }).observe(stageEl, { attributes: true, attributeFilter: ["class", "hidden"] });
-  }
+  dockObserver.observe(stageEl);
+  // Only showing, hiding and leaving change the reserve (not the stage's
+  // other classes: waiting, in-use…).
+  let stageShown = "";
+  new win.MutationObserver(() => {
+    const shown = `${stageEl.hidden}|${stageEl.classList.contains("leaving")}`;
+    if (shown === stageShown) return;
+    stageShown = shown;
+    updateReserve({ fromStage: true });
+  }).observe(stageEl, { attributes: true, attributeFilter: ["class", "hidden"] });
   win.addEventListener("resize", () => placeToast());
   // The model panel opening, closing or changing height (its list filters).
   new win.ResizeObserver(() => placeToast()).observe(modelPanelEl);

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

@@ -0,0 +1,33 @@
+// The open session's feature gates: a page action that its worker must
+// support (its sidecar features, a live bridge), and the redraw that
+// follows when that flips. Registered with the session store as its
+// `featureGates` redraw (session_store.js ORDER): it runs whenever a field
+// it reads changes, and a gate's own redraw only when its answer flipped.
+//
+// A session switch (forgetSession) and a full load (renderSessionView) draw
+// every card with the gate's answer already: they prime() the gates, so the
+// redraw that follows their write sees no flip. A write anywhere else (a
+// restart's hub event bringing the feature, the worker going) fires it.
+//
+// A new module: the page's modules are cached at unversioned URLs, and a
+// new export of an old module would leave a cached copy without it.
+
+// @param entries [{name, unavailable(current) → bool, redraw()}]
+// @return {prime(current), check(current)}: prime takes each gate's answer
+//   without redrawing; check redraws the gates whose answer flipped since
+export function createFeatureGates(entries) {
+  const last = new Map();
+  return {
+    prime(current) {
+      for (const gate of entries) last.set(gate.name, !!gate.unavailable(current));
+    },
+    check(current) {
+      for (const gate of entries) {
+        const now = !!gate.unavailable(current);
+        const flipped = last.has(gate.name) && last.get(gate.name) !== now;
+        last.set(gate.name, now);
+        if (flipped) gate.redraw();
+      }
+    },
+  };
+}

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

@@ -1,20 +1,24 @@
 // The one way a jump into the history shows what it lands on: whatever
 // hides +el+ unfolds: a closed <details> around it (a turn's steps block, a
 // step, a diff), an answer folded by hand (answer_fold.js: its row follows
-// the bubble's class; the jump's unfold isn't saved). Every jump goes through it (claim_link.js
-// showClaim, refs.js showRow and so the working set's step tags,
-// verdict_card.js "View check"), so a new way to hide history is opened in
-// one place.
+// the bubble's class; the jump's unfold isn't saved), a superseded version
+// of a Revise stack (revise_stack.js: its stub opens, not saved). Every
+// jump goes through it (claim_link.js showClaim, refs.js showRow and so the
+// working set's step tags, verdict_card.js "View check"), so a new way to
+// hide history is opened in one place.
 //
 // Pure DOM, so it runs under `node --test` with happy-dom. A module of its
 // own: static JS is cached at unversioned URLs, and a new export on an old
 // module would blank the page.
 
+import { openStubOver } from "./revise_stack.js";
+
 // Opens each closed <details> that holds +el+ (not +el+ itself: a fold the
 // caller means to open it opens itself) and unfolds the folded answer that
 // is or holds it. +el+, or null.
 export function revealInHistory(el) {
   if (!el) return null;
+  openStubOver(el);
   el.closest?.(".bubble.output.folded")?.classList.remove("folded");
   for (let details = el.parentElement?.closest("details"); details; details = details.parentElement?.closest("details")) {
     details.open = true;

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

@@ -57,9 +57,6 @@ main{flex:1;display:flex;flex-direction:column;gap:16px;padding:16px;overflow:au
 /* A generation opens its answer bubble empty: hidden until text streams (the thinking box shows progress meanwhile). */
 .bubble.output.streaming:empty{display:none}
 /* The answer's pop: the promoted bubble is held at the narration box's height (inline max-height, scrolled to its tail) until the rendered markdown lands, then grows to its content while the content fades in; both classes go 400 ms later. */
-.bubble.output.boxed{overflow:hidden;transition:max-height 360ms ease}
-.bubble.output.revealing>:not(.copy-btn){animation:fadeIn 240ms ease}
-@media (prefers-reduced-motion:reduce){.bubble.output.boxed{transition:none}.bubble.output.revealing>:not(.copy-btn){animation:none}}
 /* A long answer folded by hand (answer_fold.js): the row is the bubble's sibling just before it, styled as a closed turn's steps; folded, the bubble is hidden and the row reads its first line and size; unfolded, a slim "▾ N lines" header close above it. */
 .bubble.output.folded{display:none}
 .answer-fold{display:flex;align-items:baseline;gap:0;align-self:flex-start;max-width:100%;min-width:0;margin:0;padding:3px 10px;font:inherit;font-size:12px;font-weight:500;line-height:1.4;color:var(--text-muted);text-align:left;cursor:pointer;user-select:none;background:transparent;border:1px solid transparent;border-left:3px solid var(--accent-strong);border-radius:6px;transition:background .12s ease}
@@ -71,6 +68,37 @@ main{flex:1;display:flex;flex-direction:column;gap:16px;padding:16px;overflow:au
 .answer-fold-label{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--text-2);font-size:13px}
 .answer-fold-label:empty{display:none}
 .answer-fold-size{flex:none;white-space:nowrap;font-variant-numeric:tabular-nums}
+/* Revise stacks (revise_stack.js): a superseded version folds to its stub; the Revise row under a final answer
+   (zero height: its button sits on the bubble's bottom edge, clear of the copy button, shown on hover) and a stack
+   top's version chip. */
+.stack-hidden,.time-gap.stack-gap{display:none!important}
+.stack-stub{display:flex;align-items:baseline;gap:8px;align-self:stretch;max-width:100%;min-width:0;margin:0;padding:4px 10px;font:inherit;font-size:12px;line-height:1.4;color:var(--text-muted);text-align:left;cursor:pointer;user-select:none;background:transparent;border:1px dashed var(--border-strong);border-radius:8px;transition:background .12s ease}
+.stack-stub:hover{background:var(--bg-panel)}
+.stack-stub:focus-visible{outline:2px solid var(--accent-ring);outline-offset:1px}
+.stack-stub::before{content:"▸";color:var(--accent);flex:none}
+.stack-stub.open::before{content:"▾"}
+.stack-stub.open{border-style:solid;border-color:transparent;border-left:3px solid var(--border-strong);border-radius:6px}
+.stack-stub-text{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.stack-stub-gap{flex:none;margin-left:auto;color:var(--time-gap);white-space:nowrap;font-variant-numeric:tabular-nums}
+.revise-row{position:relative;height:0;margin-top:-12px;display:flex;justify-content:flex-end;align-items:center;gap:8px}
+.revise-row.stacked{height:auto;margin-top:-6px;justify-content:flex-start}
+.revise-btn{min-height:0;height:22px;padding:0 8px;border-radius:6px;font-size:11px;line-height:20px;background:var(--bg-raised);border:1px solid var(--border-strong);color:var(--text-muted);cursor:pointer;opacity:0;transition:opacity .12s ease,color .12s ease}
+.revise-row:not(.stacked) .revise-btn{position:absolute;right:14px;top:-10px;z-index:1;height:20px;line-height:18px}
+.revise-btn:hover:not(:disabled){color:var(--text-bright);filter:none}
+.revise-btn:disabled{cursor:default}
+.revise-btn.armed,.revise-btn.armed:hover:not(:disabled){opacity:1;color:var(--on-solid);background:var(--accent-strong);border-color:var(--accent-strong)}
+.bubble.output:hover+.revise-row .revise-btn,.revise-row:hover .revise-btn,.revise-row.stacked .revise-btn,.revise-btn:focus-visible{opacity:1}
+@media (hover:none){.revise-btn{opacity:.55}}
+.stack-versions{position:relative;font-size:12px;color:var(--text-muted)}
+.stack-versions>summary{list-style:none;cursor:pointer;padding:1px 8px;border-radius:999px;border:1px solid var(--accent-border);background:var(--accent-bg);color:var(--text-2);white-space:nowrap;font-variant-numeric:tabular-nums}
+.stack-versions>summary::-webkit-details-marker{display:none}
+.stack-versions>summary::after{content:"\00a0▾";color:var(--accent)}
+.stack-versions[open]>summary::after{content:"\00a0▴"}
+.stack-versions-list{position:absolute;z-index:5;top:calc(100% + 4px);left:0;display:flex;flex-direction:column;min-width:240px;max-width:min(520px,calc(100vw - 32px));padding:4px;border-radius:8px;border:1px solid var(--border-strong);background:var(--bg-raised);box-shadow:var(--toast-shadow)}
+.stack-version{display:block;min-height:0;padding:4px 8px;border:0;border-radius:6px;background:transparent;color:var(--text-2);font:inherit;font-size:12px;text-align:left;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;cursor:pointer}
+.stack-version:hover:not(:disabled){background:var(--bg-hover);filter:none}
+.stack-version.current{color:var(--text-muted);cursor:default}
+.stack-version-n{font-weight:600;color:var(--accent);font-variant-numeric:tabular-nums}
 /* A gap divider (time_gaps.js): one centred dim line where a quiet stretch passed, never wrapped (a phone at 360 px keeps it on one line). Not a .bubble. */
 .time-gap{align-self:stretch;text-align:center;color:var(--time-gap);font-size:12px;line-height:1.4;font-variant-numeric:tabular-nums;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;margin:2px 0;user-select:none}
 .turn-timing{margin-top:8px;color:var(--text-muted);font-size:11px;font-variant-numeric:tabular-nums}
@@ -286,7 +314,7 @@ button.system-one-wrong:hover:not(:disabled){background:var(--bg-hover);color:va
 .bubble.thinking>summary::before{content:"▸ ";color:var(--think)}
 .bubble.thinking[open]>summary::before{content:"▾ "}
 .thinking-body{margin-top:6px;font-size:13px;color:var(--text-3);white-space:pre-wrap;word-break:break-word;font-style:italic;max-height:240px;overflow:auto}
-/* Turn view (web.view: turn, and inside the stage): one block per turn, its steps as collapsed rows, the live one open at the bottom. */
+/* The turn block (the stage's cloud, the history): one block per turn, its steps as collapsed rows, the live one open on top. */
 .turn-work{border:1px solid var(--border);border-left:3px solid var(--accent);border-radius:12px;background:var(--bg-panel);padding:8px 12px;font-size:14px}
 .turn-work>summary{cursor:pointer;color:var(--text-muted);font-size:13px;font-weight:600;user-select:none;list-style:none}
 .turn-work>summary::-webkit-details-marker{display:none}
@@ -303,7 +331,7 @@ button.system-one-wrong:hover:not(:disabled){background:var(--bg-hover);color:va
 .gen>summary::-webkit-details-marker{display:none}
 .gen>summary::before{content:"▸ ";color:var(--text-faint)}
 .gen[open]>summary::before{content:"▾ "}
-/* Open, a step whose label starts with its body's first words (turn_view.js labelParts) says only its calls. */
+/* Open, a step whose label starts with its body's first words (turn_block.js labelParts) says only its calls. */
 .gen[open]>summary.repeats>:is(.gen-head,.gen-sep){display:none}
 /* A step with a failed call (status error): its chevron in the danger colour. */
 .gen.has-failed>summary::before{color:var(--danger)}
@@ -327,7 +355,7 @@ button.system-one-wrong:hover:not(:disabled){background:var(--bg-hover);color:va
 .gen details.thinking summary.thinking-fade{animation:thinking-fade 120ms ease-out}
 @keyframes thinking-fade{from{opacity:.4}to{opacity:1}}
 @media (prefers-reduced-motion:reduce){.gen details.thinking summary.thinking-fade{animation:none}}
-/* A finished block's outline (turn_view.js outlineBlock): open on its narrated steps' rows; a run of steps that said
+/* A finished block's outline (turn_block.js outlineBlock): open on its narrated steps' rows; a run of steps that said
    nothing is one "· N steps" fold, a row like a step's, that shows them. */
 .turn-work.outline{--step-indent:14px}
 .turn-work.outline>.gen.folded:not(.unfolded){display:none}
@@ -676,9 +704,9 @@ body.has-session.fresh-link #composer .actions-col .model-pick:not([hidden]){dis
 #commandList .command-desc{flex:1;min-width:0;font-size:13px;color:var(--text-2);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
 #commandList .command-note{font-size:11px;color:var(--text-faint);white-space:nowrap}
 @media(max-width:600px){#commandList{left:6px;width:calc(100% - 12px)}#commandList .command-option{flex-wrap:wrap;row-gap:0;padding:8px 10px}#commandList .command-desc{flex-basis:100%;order:3}}
-/* The stage view (web.view: stage, stage_view.js): the running turn as the dock card's top section, pinned above the composer.
+/* The stage (stage_view.js): the running turn as the dock card's top section, pinned above the composer.
    Fixed slots (status row, prompt line, a two-line headline, the tool row, a one-line trail) never change height while the
-   turn runs; cards and rows that arrive meanwhile go in their own capped scroller (extras); the cloud is the turn view's
+   turn runs; cards and rows that arrive meanwhile go in their own capped scroller (extras); the cloud is the turn
    block behind a chip of ticks. --stage-max (stage_view.js fitCap) keeps it inside the session panel. */
 /* D2: its own glass card above the composer card (as a section of one card the composer's focus ring wrapped the turn too):
    in the stage view #dock is a clear column holding the stage and .dock-card (the composer and its footer, stage_view.js). */
@@ -791,7 +819,7 @@ body.stage-view .turn-stage{position:absolute;left:0;right:0;bottom:100%;margin-
 .ts-answer{display:flex;flex-direction:column;gap:8px}
 .ts-answer>.bubble.output{border-left:0;background:transparent;border:0;padding:0}
 .ts-answer>.bubble.output>.copy-btn{top:0;right:0}
-/* The cloud: one chip (steps, calls, a tick per call), the turn view's block behind it. */
+/* The cloud: one chip (steps, calls, a tick per call), the turn block behind it. */
 /* The footer: the chip at the stage's bottom edge (the cloud's steps open above it, the scroller's last slot). */
 .ts-foot{position:relative;flex:none;padding:0 14px 10px}
 /* The question room's jump pill (stage_view.js drawPill): at the scroller's bottom edge, above the chip, while the waiting
@@ -1654,6 +1682,7 @@ a{color:var(--accent)}
         </div>
         <div id="deliveryLine" class="composer-line" aria-live="off" hidden></div>
         <div class="compose-col">
+          <div id="reviseChip" hidden></div>
           <div id="chips" hidden></div>
           <textarea id="prompt" placeholder="Ask chi anything…" aria-controls="commandList" aria-autocomplete="list" aria-expanded="false"></textarea>
         </div>

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

@@ -0,0 +1,46 @@
+// Stale-answer guards: an answer that comes back after an await is applied
+// only while what it was asked for is still what the page shows. The page
+// switches sessions, reopens a popover or asks again while a fetch is out;
+// an answer for the old ask must be dropped, not drawn over the new one.
+//
+// Two shapes (docs/internals/web-frontend.md, "Stale answers"):
+// - stillOn(get): the thing asked about (the open session's id) hasn't
+//   changed. For a one-off read: the same session may ask twice and both
+//   answers are good.
+// - createLatest(get): also only the newest ask counts. For a list that is
+//   re-read (a refresh while a refresh is out): an older answer landing
+//   last would draw the older list.
+//
+//   const latest = createLatest(() => sessionId);
+//   async function refresh() {
+//     const fresh = latest.begin();
+//     const data = await api.list(sessionId);
+//     if (!fresh()) return;
+//     …
+//   }
+
+// @param get () => the key the answer is for (the open session's id)
+// @param at the key asked for (default: get() now)
+// @return () => true while get() is still +at+
+export function stillOn(get, at = get()) {
+  return () => get() === at;
+}
+
+// @param get () => the key the asks are for (default: none, the newest ask
+//   alone decides)
+// @return {begin(), drop()}: begin() starts an ask and gives its guard,
+//   () => true while it is the newest ask and get() is unchanged; drop()
+//   makes every ask out stale (a reset)
+export function createLatest(get = () => null) {
+  let seq = 0;
+  return {
+    begin() {
+      const mine = ++seq;
+      const same = stillOn(get);
+      return () => mine === seq && same();
+    },
+    drop() {
+      seq += 1;
+    },
+  };
+}

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

@@ -19,7 +19,7 @@
 //   refresh()             fetch the list (no events stream)
 //   select(id)            open a session
 //   confirmDelete(id), setArchived(id, archive), archiveOne(id, archive)
-//   updateInfoBar(), updateSessionTitle(), showToast(text, action)
+//   updateSessionTitle(), showToast(text, action)
 //   allViewOpen(), openAllView(), leaveAllView(hash)
 //   renameShown(owner)    whether a card's title has its ✎ (session_title.js)
 //   onRename()            the active card's ✎ clicked (session_rename.js open)
@@ -231,7 +231,7 @@ function draw(el, template) {
 export function createListsView(deps) {
   const {
     doc, win, topStripEl, allListEl, sessions, selected, scope, scopeError, eventsLive, refresh, select,
-    confirmDelete, setArchived, archiveOne, updateInfoBar, updateSessionTitle, showToast,
+    confirmDelete, setArchived, archiveOne, updateSessionTitle, showToast,
     allViewOpen, openAllView, leaveAllView, renameShown = () => false, onRename = () => {}, renaming = () => false,
   } = deps;
   const $ = (s) => doc.querySelector(s);
@@ -302,18 +302,25 @@ export function createListsView(deps) {
   // is the cards drawn, which select mode picks from.
   const drawnOrder = new Map(); // list element → card ids in the order last drawn
   const heldLists = new Set(); // lists drawn in a held order
+  // Lists whose last draw was hidden (the strip under the all view, which
+  // the store's list write draws as the view opens): that order was never
+  // seen, so a hover that stuck on the strip doesn't hold it afterwards.
+  const drawnHidden = new Set();
   const canHover = win.matchMedia?.("(hover: hover)").matches ?? false;
   function listOrder(el, next, idOf = (s) => s.id) {
     // The strip's popover holds it too (the pointer leaves the strip for it,
     // and a touch screen has no hover at all), and so does a rename typed
     // over its active card (the card doesn't jump away under the input).
-    const holding = el.getClientRects().length > 0
+    const shown = el.getClientRects().length > 0;
+    const holding = shown
       && ((canHover && el.matches(":hover")) || (el === topStripEl && (familyPop.isOpen() || renaming())) || chainPopIn(el));
-    const held = holding ? drawnOrder.get(el) : null;
+    const held = holding && !drawnHidden.has(el) ? drawnOrder.get(el) : null;
     const ordered = held ? heldOrder(held, next, idOf) : next;
     if (held && ordered.some((x, i) => idOf(x) !== idOf(next[i]))) heldLists.add(el);
     else heldLists.delete(el);
     drawnOrder.set(el, ordered.map(idOf));
+    if (shown) drawnHidden.delete(el);
+    else drawnHidden.add(el);
     return ordered;
   }
 
@@ -498,7 +505,7 @@ export function createListsView(deps) {
     noteChainFamilies(cards);
     const refused = scopeError();
     if (refused) {
-      draw(topStripEl, html`<div class="hint scope-error">${refused} · <a href=${allScopeHref("", null, win.location.search)}>show every session</a></div>`);
+      draw(topStripEl, html`<div class="hint scope-error">${refused} · <a href=${allScopeHref("")}>show every session</a></div>`);
       lastDrawn.delete(topStripEl);
       familyPop.close();
       chainPop.close();
@@ -727,14 +734,9 @@ export function createListsView(deps) {
     selecting.running = { done: 0, total: ids.length, archive };
     updateSelectBar();
     try {
-      const outcome = await runBatch(ids, async (id) => {
-        const answer = await archiveOne(id, archive);
-        if (answer.ok) {
-          render();
-          updateInfoBar();
-        }
-        return answer;
-      }, (done) => {
+      // An archived one flips in the store's list (archiveOne): the lists
+      // and the bar redraw from there.
+      const outcome = await runBatch(ids, (id) => archiveOne(id, archive), (done) => {
         selecting.running.done = done;
         updateSelectBar();
       });

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

@@ -105,6 +105,8 @@ export function createLiveTiming({
 
     start(startedAt = new Date(now()).toISOString(), id = null) {
       stopTicker();
+      // In place, on purpose: the running turn's own clock in the session
+      // store's timing (session_fields.js, D8).
       timing().activeTurn = id ? { id, started_at: startedAt } : { started_at: startedAt };
       turnId = id || null;
       // The turns ended so far, so this one comes next.

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

@@ -8,7 +8,7 @@
 // steps' texts.
 const TEXTS = ".bubble.output, .gen:not(.live) > .gen-text";
 // The closed steps' texts still shown raw: a live turn's (a reload's come
-// rendered, turn_view.js textTemplate).
+// rendered, turn_block.js textTemplate).
 const RAW_STEPS = ".gen:not(.live) > .gen-text:not(.markdown)";
 
 export function createMarkdownPlace({

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

@@ -0,0 +1,14 @@
+// chi web's JSON as notifications.js and push_devices.js call it:
+// (method, path, body). Over the page's api (data.js), so a signed-out
+// proxy answer (a 401, a redirect, HTML) reports auth_lost as every other
+// read does, and a refusal throws api()'s Error (the server's words, .status,
+// .code).
+
+import { api as pageApi } from "./data.js";
+
+// @param body the JSON body (undefined: none)
+// @param opts api()'s fetch options (specs: fetchImpl); api: another client
+// @return a Promise of the answer's JSON ({} for an empty one)
+export function methodApi(method, path, body, { api = pageApi, ...opts } = {}) {
+  return api(path, { ...opts, method, ...(body === undefined ? {} : { body: JSON.stringify(body) }) });
+}

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

@@ -36,6 +36,7 @@ import {
   isWaitingTag, openPushKeys, pushSupported, subscribe as pushSubscribe, unsubscribe as pushUnsubscribe,
 } from "./push.js";
 import { createPushDevices } from "./push_devices.js";
+import { methodApi } from "./method_api.js";
 
 export const NOTIFY_KEY = "chi_notify";
 // The device id chi web gave this app's subscription (POST subscribe's
@@ -64,17 +65,9 @@ const PUSH_TITLES = {
   denied: "Notifications are blocked for this app in the phone's settings",
 };
 
-// fetch's JSON, or an Error with chi web's detail.
-async function defaultApi(method, path, body) {
-  const res = await fetch(path, {
-    method,
-    headers: body === undefined ? {} : { "Content-Type": "application/json" },
-    body: body === undefined ? undefined : JSON.stringify(body),
-  });
-  const data = res.status === 204 ? null : await res.json().catch(() => null);
-  if (!res.ok) throw new Error(data?.detail || `HTTP ${res.status}`);
-  return data;
-}
+// chi web's JSON, or api()'s Error; a signed-out answer reports auth_lost
+// (method_api.js).
+const defaultApi = (method, path, body) => methodApi(method, path, body);
 
 // How a presence report goes: a beacon when the page is leaving (it
 // outlives the page; same origin, so the cookie goes), else the api's

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

@@ -171,6 +171,16 @@ function scheduleReload() {
   reloadTimer = setTimeout(load, 120);
 }
 
+// The types the participant stream sends: exactly Web::ParticipantView::EVENTS
+// (spec/web/participant_view_spec.rb reads this list), so a type the server
+// starts sending isn't dropped here unseen.
+const STREAM_EVENTS = [
+  "generation_chunk", "generation_retrying", "tool_call_started", "tool_call_completed",
+  "turn_started", "turn_completed", "turn_canceled", "turn_failed", "turn_enqueued", "turn_dequeued", "input_merged",
+  "question_requested", "question_answered", "question_cancelled", "continue_offered", "continue_resolved",
+  "snapshot", "reset", "verdict_recorded",
+];
+
 // The stream from the review data's cursor; a closed or refused stream is
 // opened again from fresh data (a worker may have started or restarted).
 function connect() {
@@ -203,12 +213,7 @@ function connect() {
       renderLive();
     }
   };
-  for (const type of ["generation_chunk", "generation_retrying", "tool_call_started", "tool_call_completed",
-    "turn_started", "turn_completed", "turn_canceled", "turn_failed", "turn_enqueued", "turn_dequeued", "input_merged",
-    "question_requested", "question_answered", "question_cancelled", "continue_offered", "continue_resolved",
-    "snapshot", "reset", "verdict_recorded"]) {
-    source.addEventListener(type, onEvent);
-  }
+  for (const type of STREAM_EVENTS) source.addEventListener(type, onEvent);
   source.onerror = () => {
     if (source.readyState !== EventSource.CLOSED) return;
     scheduleRetry(retryDelay(failures));

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

@@ -1,6 +1,6 @@
 // The open session's participants by author ("p:<id>" → name), for the
 // author badges on their prompts (turn_events.js promptOps, a reload's
-// turn_view.js): the participants panel sets it when it reads the list. A
+// turn_block.js): the participants panel sets it when it reads the list. A
 // prompt's own author_name (a saved message, turn_started) comes first; a
 // badge drawn before the list came, with neither, says UNNAMED until
 // nameUnnamedBadges names it.