samagotchi 0.111.1 → 0.112.0

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

@@ -15,6 +15,8 @@
 :root{--icon-image:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='none' stroke='black' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Crect x='2' y='2.75' width='12' height='10.5' rx='1.5'/%3E%3Ccircle cx='5.75' cy='6.25' r='1.1'/%3E%3Cpath d='m2.5 12.5 3.75-3.75 2.5 2.5 1.75-1.75 3 3'/%3E%3C/svg%3E")}
 :root{--icon-archive:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='none' stroke='black' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Crect x='2' y='2.75' width='12' height='3.5' rx='1'/%3E%3Cpath d='M3.25 6.25v6a1 1 0 0 0 1 1h7.5a1 1 0 0 0 1-1v-6M6.5 9h3'/%3E%3C/svg%3E");--icon-unarchive:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='none' stroke='black' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Crect x='2' y='2.75' width='12' height='3.5' rx='1'/%3E%3Cpath d='M3.25 6.25v6a1 1 0 0 0 1 1h7.5a1 1 0 0 0 1-1v-6M8 11.5V8.25M6.5 9.75 8 8.25l1.5 1.5'/%3E%3C/svg%3E")}
 *{box-sizing:border-box;margin:0;padding:0}
+/* No iOS text autosizing: it grows text in a box sized for the text as written (it clipped the session cards). */
+html{-webkit-text-size-adjust:100%;text-size-adjust:100%}
 body{font-family: ui-sans-serif,system-ui,-apple-system,Segoe UI,Roboto,Helvetica,Arial,sans-serif;background:radial-gradient(1100px 700px at 8% 0%,color-mix(in srgb,var(--accent) 13%,transparent),transparent 70%),radial-gradient(900px 700px at 100% 100%,color-mix(in srgb,var(--think) 9%,transparent),transparent 70%),var(--bg);background-attachment:fixed;color:var(--text);height:100vh;display:flex;flex-direction:column}
 /* Glass: the composer card, the strip cards, the all-sessions cards and the question cards (by selector, so app.js is untouched). */
 #dock,.turn-stage,.dock-card,#topStrip .card,#allList .card,.bubble.question,.bubble.plugin-card{background:var(--glass-bg);-webkit-backdrop-filter:blur(18px) saturate(1.35);backdrop-filter:blur(18px) saturate(1.35);border:1px solid var(--glass-border);box-shadow:inset 0 1px 0 var(--glass-highlight),var(--glass-shadow)}
@@ -710,7 +712,7 @@ body.has-session.fresh-link #composer .actions-col .model-pick:not([hidden]){dis
 #modelList .model-option.unavailable:not(.chosen) .model-id,#modelList .model-option.unavailable .model-host{color:var(--text-faint)}
 #modelList .model-option.unavailable .model-note{color:var(--warn-text)}
 #modelList .model-empty{padding:10px;font-size:13px;color:var(--text-faint)}
-@media(max-width:600px){#modelPanel{left:6px;width:calc(100% - 12px)}#modelSearch{font-size:16px}#modelList .model-option{padding-top:8px;padding-bottom:8px}}
+@media(max-width:600px){#modelPanel{left:6px;width:calc(100% - 12px)}#modelList .model-option{padding-top:8px;padding-bottom:8px}}
 /* The / autocomplete: a list over the composer card's top edge. It wears the glass edge and shadow, but opaque:
    inside the dock's own backdrop-filter a second blur sees nothing, and the history would show through its text. */
 #commandList{position:absolute;left:10px;width:min(640px,calc(100% - 20px));bottom:calc(100% + 8px);max-height:min(260px,40vh);overflow-y:auto;border-radius:12px;padding:4px;z-index:20;display:flex;flex-direction:column;gap:1px;background:var(--bg-panel);border:1px solid var(--glass-border);box-shadow:inset 0 1px 0 var(--glass-highlight),var(--glass-shadow)}
@@ -1105,7 +1107,7 @@ body.has-session.composer-folded #infoBar{border-top-color:transparent}
 .llmctx-form .ctx-pop-head strong{font-family:inherit}
 .llmctx-field{display:flex;align-items:center;gap:8px}
 .llmctx-field>span{flex:0 0 58px;font-size:12px;color:var(--text-muted)}
-.llmctx-field select,.llmctx-field input{flex:1;min-width:0;box-sizing:border-box;padding:5px 8px;border-radius:7px;border:1px solid var(--border-strong);background:var(--bg-inset);color:var(--text);font:13px/1.4 inherit}
+.llmctx-field select,.llmctx-field input{flex:1;min-width:0;box-sizing:border-box;padding:5px 8px;border-radius:7px;border:1px solid var(--border-strong);background:var(--bg-inset);color:var(--text);font:inherit;font-size:13px;line-height:1.4}
 .llmctx-field select:focus,.llmctx-field input:focus{outline:none;border-color:var(--accent-border)}
 /* The settings selects draw their own closed box (each browser's native one differs) with the model picker's drawn caret on the label; the open list stays the OS menu. */
 .llmctx-field select{appearance:none;-webkit-appearance:none;padding-right:26px;cursor:pointer}
@@ -1122,7 +1124,7 @@ body.has-session.composer-folded #infoBar{border-top-color:transparent}
 #infoBar .ctx-chip.ctx-add{border-style:dashed;color:var(--text-muted);background:transparent}
 .ctx-add-form{display:flex;flex-direction:column;gap:6px;margin:0}
 .ctx-add-form .ctx-pop-head strong{font-family:inherit}
-.ctx-add-input{width:100%;box-sizing:border-box;padding:6px 8px;border-radius:7px;border:1px solid var(--border-strong);background:var(--bg-inset);color:var(--text);font:13px/1.4 inherit}
+.ctx-add-input{width:100%;box-sizing:border-box;padding:6px 8px;border-radius:7px;border:1px solid var(--border-strong);background:var(--bg-inset);color:var(--text);font:inherit;font-size:13px;line-height:1.4}
 .ctx-add-input:focus{outline:none;border-color:var(--accent-border)}
 #infoBar .ctx-chip{display:inline-flex;align-items:center;gap:5px;padding:2px 9px;border-radius:999px;font:600 11px/1.5 ui-monospace,monospace;background:color-mix(in srgb,var(--bg-hover) 55%,transparent);color:var(--text-3);border:1px solid var(--border-strong);white-space:nowrap}
 #infoBar .ctx-chip:hover,#infoBar .ctx-chip.open{color:var(--text);border-color:var(--accent-border);background:var(--accent-bg)}
@@ -1300,8 +1302,6 @@ body.has-session #scope .scope-where{display:none}
   #sessionTitleRow{flex-basis:100%;order:10}
   #sessionTitle{font-size:12px}
   .title-rename{font-size:12px;line-height:18px}
-  /* Under 16px iOS Safari zooms the page on focus. */
-  .rename-input{font-size:16px}
   #scope,#stripStatus{flex:1 1 0;min-width:0;max-width:max-content}
   #stripStatus{flex-grow:1000;overflow:hidden;text-overflow:ellipsis}
   #scope .scope-name{flex-shrink:1;min-width:0}
@@ -1471,6 +1471,9 @@ body.all-view #center, body.all-view #topStrip{display:none}
 .card{padding:12px;border-radius:10px;background:var(--bg-panel);border:1px solid var(--border);cursor:pointer;display:flex;flex-direction:column;gap:6px;min-height:72px}
 .card:hover{border-color:var(--border-strong);background:var(--bg-hover)}
 #allList .card{position:relative}
+/* Every row keeps its content's height: a card shorter than its rows (seen on iOS) cut the clamped preview and the
+   single-line title and recap through the middle. */
+#allList .card > *{flex-shrink:0}
 /* A card's tools in the all view: archive (or unarchive) and delete, shown on hover, always under hover:none. */
 #allList .card-tools{position:absolute;top:6px;right:6px;display:flex;gap:2px}
 .card-tools button{padding:2px 7px;border-radius:6px;border:1px solid transparent;background:transparent;color:var(--text-muted);font-size:12px;line-height:1.2;cursor:pointer;opacity:0;transition:opacity .15s}
@@ -1520,6 +1523,14 @@ body.all-view #center, body.all-view #topStrip{display:none}
   #topStrip #allTile{width:auto}
 }
 a{color:var(--accent)}
+/* Under 16px iOS Safari zooms the page on focus (and a Home Screen app never zooms back), at any width: every text
+   field gets 16px on a phone or a touch device. Last in the sheet so it wins over each field's own size; keep new text
+   fields in this list (stage.spec.js's phone step checks the visible ones). */
+@media (max-width:600px),(pointer:coarse){
+  #composer textarea,.question-freeform,.continue-reason,.participants-popover input,.participants-popover select,
+  .rs-form textarea,.pp-link input,.llmctx-field select,.llmctx-field input,.ctx-add-input,.ws-add-in,.rename-input,
+  #modelSearch{font-size:16px}
+}
 </style>
 </head>
 <body>

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

@@ -25,7 +25,7 @@
 //   onRename()            the active card's ✎ clicked (session_rename.js open)
 //   renaming()            whether that rename input is open (the strip holds)
 
-import { ownerBadge, relativeTime, delegatedBy } from "./format.js";
+import { ownerBadge, relativeTime, delegatedBy, cardTitleSource } from "./format.js";
 import { html, nothing, render } from "./vendor/lit-html.js";
 import { cardCtxText, ctxBarTip } from "./ctx.js";
 import { allScopeHref, cardFolder } from "./scope.js";
@@ -172,7 +172,8 @@ export function cardTemplate(s, { deletable = false, archivable = false, selecta
   const preview = renamable
     ? html`<div class="preview-row"><div class="preview">${title}</div><button type="button" class="card-rename" data-rename=${s.id} title="Rename this session" aria-label="Rename this session">\u270e</button></div>`
     : html`<div class="preview">${title}</div>`;
-  const recap = s.recap ? html`<div class="recap" title=${s.recap}>${s.recap}</div>` : nothing;
+  // No recap line when the title is the recap's first sentence (D5).
+  const recap = s.recap && cardTitleSource(s) !== "recap" ? html`<div class="recap" title=${s.recap}>${s.recap}</div>` : nothing;
   return html`<div class=${cls} data-id=${s.id} data-members=${memberIds.length ? memberIds.join(" ") : nothing} style=${anim || nothing} title=${`${tip}${memTitle ? ` · ${memTitle}` : ""}`}>${preview}${recap}<div class="meta"><span class=${`status dot ${s.status}${waiting ? " waiting" : ""}`} title=${dotWord} aria-label=${dotWord}></span>${waitingT}${stoppedT}${time}${ctxT}${folderT}${parentChipTemplate(s, parent)}${chain}${kids}${ownerBadgeTemplate(s)}${archived}</div>${famRows}${skip}${pick}${selectable ? nothing : cardToolsTemplate(s, { deletable, archivable })}</div>`;
 }
 

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

@@ -6,22 +6,29 @@
 // (notify.js, Several tabs).
 //
 // In the Home Screen app (push.js pushSupported) the bell means "push to
-// this device" instead (Web Push): chi web pushes approvals and questions to
-// it while the app is closed. chi web without push (no https public URL)
+// this device" instead (Web Push): chi web pushes what needs the user (an
+// approval, a question, a step-limit continue, a card, a failed turn) to it
+// while the app is closed. chi web without push (no https public URL)
 // leaves the bell as it is in a tab. With the bell on, the app also tidies
 // the device (syncDevice): it closes the pushed notifications whose
-// question isn't open any more and sets the app's badge, as chi web sends
-// no close push (WebKit's silent-push quota).
+// question or card isn't open any more and sets the app's badge, as chi
+// web sends no close push (WebKit's silent-push quota).
+//
+// Every page, in a tab or the app, also tells chi web whether the user is
+// at it (POST /api/push/presence, reportPresence): chi web pushes nothing
+// while one is in front, as the user is looking (the iPhone's service
+// worker can't see the app in front, so chi web decides).
 //
 // The browser parts come in as deps (globals by default) so the specs can
 // drive it without a DOM.
 
 import { sessionHash } from "./route.js";
 import {
-  NOTIFY_CHANNEL, attentionText, createNotifyGate, initialAttentionState, notifyState as bellState, trackAttention,
+  NOTIFY_CHANNEL, attentionText, createNotifyGate, initialAttentionState, notifyState as bellState, randomTabId,
+  trackAttention,
 } from "./notify.js";
 import {
-  isQuestionTag, openPushKeys, pushSupported, subscribe as pushSubscribe, unsubscribe as pushUnsubscribe,
+  isWaitingTag, openPushKeys, pushSupported, subscribe as pushSubscribe, unsubscribe as pushUnsubscribe,
 } from "./push.js";
 
 export const NOTIFY_KEY = "chi_notify";
@@ -32,6 +39,12 @@ export const PUSH_DEVICE_KEY = "chi_push_device";
 // A long-lived Home Screen app checks for a new sw.js at most this often
 // when it comes back in front (reg.update()).
 export const SW_UPDATE_MS = 60 * 60 * 1000;
+// Presence: a page in front reports this often (chi web counts a report
+// 45 s), and is in front only if touched this recently (a tab left focused
+// on a screen nobody watches stops quieting the phone).
+export const PRESENCE_PATH = "/api/push/presence";
+export const PRESENCE_EVERY_MS = 30 * 1000;
+export const TOUCH_FRESH_MS = 2 * 60 * 1000;
 
 const NOTIFY_TITLES = {
   on: "Notifications on: a session that needs you while this tab is in the background. Click to turn off",
@@ -40,8 +53,8 @@ const NOTIFY_TITLES = {
 };
 
 const PUSH_TITLES = {
-  on: "Notifications to this phone: on (approvals and questions, also while the app is closed). Tap to turn off",
-  off: "Notify this phone when a session needs approval or an answer, also while the app is closed",
+  on: "Notifications to this phone: on (a session that needs you or failed, also while the app is closed). Tap to turn off",
+  off: "Notify this phone when a session needs you or a turn fails, also while the app is closed",
   denied: "Notifications are blocked for this app in the phone's settings",
 };
 
@@ -57,6 +70,21 @@ async function defaultApi(method, path, body) {
   return data;
 }
 
+// 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
+// fetch. Errors swallowed: a lost report only means a push or a quiet one.
+// @return (body, leaving) => void
+export function presenceSender({ nav, api, BlobApi = globalThis.Blob }) {
+  return (body, leaving) => {
+    if (leaving && typeof nav?.sendBeacon === "function" && typeof BlobApi === "function") {
+      try {
+        if (nav.sendBeacon(PRESENCE_PATH, new BlobApi([JSON.stringify(body)], { type: "application/json" }))) return;
+      } catch (_) {}
+    }
+    try { api("POST", PRESENCE_PATH, body)?.catch?.(() => {}); } catch (_) {}
+  };
+}
+
 function defaultChannel() {
   try {
     if (typeof globalThis.BroadcastChannel === "function") return new BroadcastChannel(NOTIFY_CHANNEL);
@@ -75,7 +103,11 @@ function defaultChannel() {
 // @param api (method, path, body) => Promise of chi web's JSON
 // @param scoped the page shows one project's sessions (?dir=): it never
 //   tidies the device, as it doesn't see the others'
-// @param now () => ms (the service worker update's spacing; specs)
+// @param now () => ms (the service worker update's spacing, presence's
+//   touch; specs)
+// @param sendPresence (body, leaving) => void (presenceSender's by default)
+// @param every (fn, ms) => void, a repeating timer (presence's tick)
+// @param pageId this page load's id in its presence reports
 // @return {noticeSessions(type, data), noticeList(sessions), setBaseTitle(title), clearBadge()}
 export function createNotifications({
   button,
@@ -89,6 +121,9 @@ export function createNotifications({
   api = defaultApi,
   scoped = false,
   now = () => Date.now(),
+  sendPresence = presenceSender({ nav, api }),
+  every = (fn, ms) => setInterval(fn, ms),
+  pageId = randomTabId(),
 }) {
   let attention = initialAttentionState();
   // Web Push in the Home Screen app: null until chi web says it pushes
@@ -234,7 +269,8 @@ export function createNotifications({
   }
 
   // The Home Screen app with the bell on: closes the pushed notifications
-  // whose question isn't open (chi's own, chi:test, stay) and sets the
+  // whose question or card isn't open (chi's own, chi:test, and a failed
+  // or done turn's stay) and sets the
   // app's badge. Never before the first snapshot (an empty byId would close
   // them all) nor on a project's page (its byId lacks the others). One at a
   // time; asked again meanwhile, it runs once more after.
@@ -250,7 +286,7 @@ export function createNotifications({
         const open = new Set(openPushKeys(attention.byId));
         try {
           const shown = await push.reg.getNotifications();
-          for (const n of shown || []) if (isQuestionTag(n.tag) && !open.has(n.tag)) n.close();
+          for (const n of shown || []) if (isWaitingTag(n.tag) && !open.has(n.tag)) n.close();
         } catch (_) {}
         if (push?.on) setDeviceBadge(open.size);
       } while (syncAgain);
@@ -321,6 +357,31 @@ export function createNotifications({
     syncDevice();
     updateWorker();
   }
+  // ── Presence ──────────────────────────────────────────────────────────
+  // Loading the page counts as a touch.
+  let touchedAt = now();
+  let reportedFront = null;
+  const atPage = () => tabInFront() && now() - touchedAt < TOUCH_FRESH_MS;
+  function reportPresence(front = atPage(), leaving = false) {
+    reportedFront = front;
+    sendPresence({ page: pageId, front }, leaving);
+  }
+  // The first touch that brings the page to the front (after being idle,
+  // or behind) says so at once; the tick has the rest.
+  function touched() {
+    touchedAt = now();
+    if (reportedFront !== true && atPage()) reportPresence(true);
+  }
+  // Every 30 s while in front, and once more when it no longer is (no
+  // touch for 2 min).
+  every(() => { if (reportedFront || atPage()) reportPresence(); }, PRESENCE_EVERY_MS);
+  doc.addEventListener("visibilitychange", () => (doc.visibilityState === "visible" ? reportPresence() : reportPresence(false, true)));
+  win.addEventListener("focus", () => reportPresence());
+  win.addEventListener("blur", () => reportPresence(false));
+  win.addEventListener("pagehide", () => reportPresence(false, true));
+  for (const type of ["pointerdown", "keydown", "touchstart"]) doc.addEventListener(type, touched, { capture: true, passive: true });
+  if (atPage()) reportPresence(true);
+
   doc.addEventListener("visibilitychange", backInFront);
   win.addEventListener("focus", backInFront);
   doc.addEventListener("pointerdown", clearBadge, true);

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

@@ -96,7 +96,7 @@ const cardKey = (sessionId, cardId) => `${sessionId}:card:${cardId}`;
 // @param prev the summary held before (null for a session not seen yet)
 // @param next the new summary (null when the session is gone)
 // @return [String] keys, maybe none
-function closedKeys(prev, next) {
+export function closedKeys(prev, next) {
   const keys = [];
   const q = prev?.pending_question;
   const nq = next?.pending_question;
@@ -152,7 +152,7 @@ export function trackAttention(state, type, data = {}) {
 // The notification's words: a short title (the session) and the reason.
 // No question or answer text (it would show on a lock screen).
 export function attentionText(session, attention) {
-  const name = String(session?.title || session?.first_preview || session?.last_prompt || "chi session").trim();
+  const name = String(session?.title || session?.auto_title || session?.first_preview || session?.last_prompt || "chi session").trim();
   const title = clip(name, 61);
   const seconds = Math.round(Number(session?.last_turn?.seconds) || 0);
   const body = {
@@ -262,7 +262,7 @@ export function createNotifyGate({ channel = null, holdMs = NOTIFY_HOLD_MS, onSe
   };
 }
 
-function randomTabId() {
+export function randomTabId() {
   try {
     if (typeof globalThis.crypto?.randomUUID === "function") return globalThis.crypto.randomUUID();
   } catch (_) {}

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

@@ -11,6 +11,8 @@
    (the Plan): beside the thread on a wide screen, a Plan | Thread toggle on a narrow one (the composer pinned in both).
    The owner's participant view is the same page with no composer. Colours are tokens.css's. */
 *{box-sizing:border-box;margin:0;padding:0}
+/* No iOS text autosizing (index.html's twin). */
+html{-webkit-text-size-adjust:100%;text-size-adjust:100%}
 html,body{height:100%;height:100dvh}
 .p-body{flex:1;min-height:0;display:flex}
 .p-col{flex:1;min-width:0;min-height:0;display:flex;flex-direction:column}
@@ -126,6 +128,8 @@ button.small{font-size:12px;padding:2px 8px}
   .p-bubble{padding:9px 12px}
   .p-hint,.p-note{display:none}
 }
+/* Under 16px iOS Safari zooms the page on focus (and a Home Screen app never zooms back). */
+@media (max-width:600px),(pointer:coarse){.p-compose textarea{font-size:16px}}
 </style>
 </head>
 <body>

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

@@ -6,31 +6,30 @@
 // a browser tab keeps the in-tab notifications). See
 // docs/internals/web-push.md.
 
-import { questionReason } from "./notify.js";
-
-// The reasons chi web pushes (Web::Push::Attention::PUSHED).
-const PUSHED = new Set(["approval", "question"]);
-
-// The keys still open in a byId (notify.js trackAttention's: session id →
-// summary): a pending question with an id, not relayed, of a reason chi
-// web pushes. Attention.open_keys's rule, so the page, the worker's open
-// list and the badge agree.
-// @return [String] "<session id>:<question id>" keys
+// The waiting keys still open in a byId (notify.js trackAttention's:
+// session id → summary): a pending question with an id, not relayed (any
+// reason: a step-limit continue too), and a card with actions.
+// Attention.open_keys's rule, so the page, the worker's open list and the
+// badge agree.
+// @return [String] "<session id>:<question id>" and "<session id>:card:<card id>" keys
 export function openPushKeys(byId) {
   const keys = [];
   for (const summary of Object.values(byId || {})) {
     const q = summary?.pending_question;
-    if (!q || !q.id || q.relayed_to || !PUSHED.has(questionReason(q))) continue;
-    keys.push(`${summary.id}:${q.id}`);
+    if (q && q.id && !q.relayed_to) keys.push(`${summary.id}:${q.id}`);
+    const card = summary?.pending_card;
+    if (card && card.id) keys.push(`${summary.id}:card:${card.id}`);
   }
   return keys;
 }
 
-// A pushed question's tag ("<session id>:<question id>"), not one of chi's
-// own (chi:test, chi:other): only these are ever cleaned up. sw.js keeps
-// the same pattern (a classic script imports nothing).
-export const QUESTION_TAG = /^(?!chi:)[^:]+:[^:]+$/;
-export const isQuestionTag = (tag) => typeof tag === "string" && QUESTION_TAG.test(tag);
+// A pushed waiting key's tag: a question's "<session id>:<question id>" or
+// a card's "<session id>:card:<card id>", not one of chi's own (chi:test,
+// chi:other) nor a failed or done turn's "<session id>:<ended_at>" (its
+// time has colons): only these are ever cleaned up. sw.js keeps the same
+// pattern (a classic script imports nothing).
+export const WAITING_TAG = /^(?!chi:)[^:]+:(?:card:)?[^:]+$/;
+export const isWaitingTag = (tag) => typeof tag === "string" && WAITING_TAG.test(tag);
 
 // A standalone app with a service worker and PushManager, on a secure
 // context (chi web's https public URL; the LAN's plain http has none).

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

@@ -121,12 +121,13 @@ export function sessionStateFrom(data) {
   return state;
 }
 
-// The info bar's title: the session's own title (/title), else the first
-// user message when the payload has messages, else the card's preview, else
+// The info bar's title: the session's own title (/title), else its auto
+// title, else its recap's first sentence (as its card), else the first user message when the payload has messages, else the card's preview, else
 // the first prompt of its history.
 function sessionFirstPreview(data) {
   const s = data.session;
-  if (s.title) return firstPreview(s.title);
+  const named = s.title || s.auto_title || s.recap;
+  if (named) return firstPreview(named);
   let preview = s.first_preview || previewForCard(s);
   if (data.messages && data.messages.length) {
     const first = data.messages.find((m) => m.role === "user");

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

@@ -17,9 +17,10 @@
 
 const ICON = "/icons/chi-192.png";
 const FALLBACK = { title: "chi", body: "open chi", tag: "chi:other", url: "/" };
-// push.js QUESTION_TAG: a pushed question's "<session id>:<question id>",
-// never chi's own (chi:test, chi:other).
-const QUESTION_TAG = /^(?!chi:)[^:]+:[^:]+$/;
+// push.js WAITING_TAG: a pushed question's "<session id>:<question id>" or
+// card's "<session id>:card:<card id>", never chi's own (chi:test,
+// chi:other) nor a failed or done turn's (its time has colons).
+const WAITING_TAG = /^(?!chi:)[^:]+:(?:card:)?[^:]+$/;
 
 function payloadOf(event) {
   try {
@@ -53,7 +54,7 @@ async function show({ title, body, tag, url }) {
   }
 }
 
-// Closes the shown question notifications chi web no longer has open
+// Closes the shown waiting notifications chi web no longer has open
 // (never the new one nor chi's own). The unfiltered list only names the
 // tags: on the iPhone (iOS 26, 2026-10-24) close() on a notification from
 // it did nothing, while one looked up by its tag closes (the probe in
@@ -63,7 +64,7 @@ async function closeAnswered(open, keep) {
     const still = new Set(open.map(String));
     const tags = new Set();
     for (const n of await self.registration.getNotifications()) {
-      if (n.tag !== keep && QUESTION_TAG.test(n.tag || "") && !still.has(n.tag)) tags.add(n.tag);
+      if (n.tag !== keep && WAITING_TAG.test(n.tag || "") && !still.has(n.tag)) tags.add(n.tag);
     }
     for (const tag of tags) {
       for (const n of await self.registration.getNotifications({ tag })) n.close();

data/lib/samagotchi/web/push/attention.rb

@@ -4,12 +4,12 @@ module Samagotchi
   module Web
     module Push
       # When a session needs the user, decided from two of the hub's session
-      # summaries (SessionSummary.build: symbol keys): the server's port of
-      # the page's rules (web/public/notify.js attentionFor, closedKeys,
-      # attentionText), so a push and the tab's notification ring for the
-      # same thing under the same key. P1 pushes approvals and questions
-      # only (the plan's D1): a step-limit question, a card, a failed or
-      # done turn come later. See docs/internals/web-push.md.
+      # summaries (SessionSummary.build: symbol keys, but +last_turn+'s are
+      # strings): the server's port of the page's rules (web/public/notify.js
+      # attentionFor, closedKeys, attentionText), so a push and the tab's
+      # notification ring for the same thing under the same key.
+      # spec/fixtures/attention_cases.json holds the cases both sides answer.
+      # See docs/internals/web-push.md.
       module Attention
         module_function
 
@@ -23,11 +23,20 @@ module Samagotchi
         # (or hook question) waits, as its parent may relay it.
         RELAY_HOLD = 3.5
         RELAYED_KINDS = %w[approval hook].freeze
-        # The reasons P1 pushes.
-        PUSHED = %w[approval question].freeze
+        # The reasons that wait on the user: open until answered, counted in
+        # the badge, cleaned up once answered. A failed or done turn is
+        # neither (nothing to answer).
+        WAITING = %w[approval question continue card].freeze
+        # notify.js DONE_MIN_SECONDS, UNWATCHED_ORIGINS: a finished turn
+        # shorter than this was watched (no "done"), unless nobody started
+        # it (a delegate child's report, a context change, a finished task).
+        DONE_MIN_SECONDS = 10
+        UNWATCHED_ORIGINS = %w[delegate_report context task].freeze
         TITLE_MAX = 61
         BODIES = { "question" => "needs an answer", "approval" => "needs approval", "continue" => "hit its step limit",
-                   "card" => "needs you" }.freeze
+                   "card" => "needs you", "failed" => "turn failed" }.freeze
+
+        def waiting?(reason) = WAITING.include?(reason)
 
         # notify.js questionReason: a hook's question is a question.
         def reason_of(question)
@@ -39,52 +48,81 @@ module Samagotchi
         end
 
         # What +nxt+ newly needs the user for, compared with +prev+ (nil for
-        # a session not seen yet).
+        # a session not seen yet): a new question first, then a new card,
+        # then a finished turn (notify.js attentionFor's order).
         # @return [Event, nil]
         def for(prev, nxt)
           return nil unless nxt && nxt[:id]
 
           question = nxt[:pending_question]
-          return nil unless question && question[:id] && question[:id] != prev&.dig(:pending_question, :id)
-          # Relayed to the parent already: the parent's notifies.
-          return nil if question[:relayed_to]
+          if question.is_a?(Hash) && question[:id] && question[:id] != prev&.dig(:pending_question, :id)
+            # Relayed to the parent already: the parent's notifies.
+            return nil if question[:relayed_to]
 
-          reason = reason_of(question)
-          return nil unless PUSHED.include?(reason)
+            hold = RELAY_HOLD if nxt[:parent_id] && RELAYED_KINDS.include?(question[:kind])
+            return Event.new(reason: reason_of(question), session_id: nxt[:id], key: key(nxt[:id], question[:id]), hold: hold)
+          end
+          card = nxt[:pending_card]
+          if card.is_a?(Hash) && card[:id] && card[:id] != prev&.dig(:pending_card, :id)
+            return Event.new(reason: "card", session_id: nxt[:id], key: card_key(nxt[:id], card[:id]), hold: nil)
+          end
+
+          turn_event(prev, nxt)
+        end
 
-          hold = RELAY_HOLD if nxt[:parent_id] && RELAYED_KINDS.include?(question[:kind])
-          Event.new(reason: reason, session_id: nxt[:id], key: key(nxt[:id], question[:id]), hold: hold)
+        # A top-level turn that ended since +prev+: failed, or done when it
+        # ran long or nobody watched it. A delegated child's turn is
+        # reported by its parent's.
+        def turn_event(prev, nxt)
+          turn = nxt[:last_turn]
+          return nil unless turn.is_a?(Hash) && turn["ended_at"]
+          return nil if turn["ended_at"] == prev&.dig(:last_turn, "ended_at") || nxt[:parent_id]
+
+          reason = case turn["outcome"]
+                   when "failed" then "failed"
+                   when "completed"
+                     "done" if seconds(turn) >= DONE_MIN_SECONDS || UNWATCHED_ORIGINS.include?(turn["origin"])
+                   end
+          reason && Event.new(reason: reason, session_id: nxt[:id], key: key(nxt[:id], turn["ended_at"]), hold: nil)
         end
 
         # The keys of what +prev+ had open and +nxt+ no longer has: its
-        # question answered (anywhere), gone or newly relayed; everything
-        # when the session is gone (+nxt+ nil).
+        # question answered (anywhere), gone or newly relayed, its card
+        # resolved or replaced; everything when the session is gone (+nxt+
+        # nil).
         # @return [Array<String>]
         def closed_keys(prev, nxt)
+          keys = []
           question = prev&.dig(:pending_question)
-          return [] unless question && question[:id]
-
-          now = nxt&.dig(:pending_question)
-          gone = now.nil? || now[:id] != question[:id] || (now[:relayed_to] && !question[:relayed_to])
-          gone ? [key(prev[:id], question[:id])] : []
+          if question.is_a?(Hash) && question[:id]
+            now = nxt&.dig(:pending_question)
+            gone = !now.is_a?(Hash) || now[:id] != question[:id] || (now[:relayed_to] && !question[:relayed_to])
+            keys << key(prev[:id], question[:id]) if gone
+          end
+          card = prev&.dig(:pending_card)
+          keys << card_key(prev[:id], card[:id]) if card.is_a?(Hash) && card[:id] && nxt&.dig(:pending_card, :id) != card[:id]
+          keys
         end
 
-        # Every key still open in +by_id+ (session id → summary): a
-        # pending question with an id, not relayed, of a reason P1 pushes.
-        # The rule push.js openPushKeys keeps, so the show's +open+ list,
-        # the page's cleanup and the badge agree.
+        # Every waiting key still open in +by_id+ (session id → summary): a
+        # pending question with an id, not relayed (any reason: a step-limit
+        # continue too), and a card with actions. The rule push.js
+        # openPushKeys keeps, so the show's +open+ list, the page's cleanup
+        # and the badge agree.
         # @return [Array<String>]
         def open_keys(by_id)
-          by_id.each_value.filter_map do |summary|
+          by_id.each_value.flat_map do |summary|
             question = summary[:pending_question]
-            next unless question.is_a?(Hash) && question[:id] && !question[:relayed_to]
-            next unless PUSHED.include?(reason_of(question))
-
-            key(summary[:id], question[:id])
+            card = summary[:pending_card]
+            keys = []
+            keys << key(summary[:id], question[:id]) if question.is_a?(Hash) && question[:id] && !question[:relayed_to]
+            keys << card_key(summary[:id], card[:id]) if card.is_a?(Hash) && card[:id]
+            keys
           end
         end
 
-        def key(session_id, question_id) = "#{session_id}:#{question_id}"
+        def key(session_id, id) = "#{session_id}:#{id}"
+        def card_key(session_id, card_id) = "#{session_id}:card:#{card_id}"
 
         # notify.js attentionText: the session's name (clipped) and the
         # reason, never the question or the command (a lock screen shows it).
@@ -92,7 +130,14 @@ module Samagotchi
         def text(summary, reason)
           name = (summary && [summary[:title], summary[:first_preview], summary[:last_prompt]].find { |v| present?(v) }) ||
                  "chi session"
-          [clip(name.to_s.strip, TITLE_MAX), BODIES.fetch(reason, "")]
+          body = reason == "done" ? "done in #{seconds(summary&.dig(:last_turn) || {}).round} s" : BODIES.fetch(reason, "")
+          [clip(name.to_s.strip, TITLE_MAX), body]
+        end
+
+        # notify.js Number(turn.seconds): anything that isn't a number is 0.
+        def seconds(turn)
+          value = turn["seconds"]
+          value.is_a?(Numeric) ? value.to_f : Float(value.to_s, exception: false) || 0.0
         end
 
         def present?(value) = !value.nil? && !value.to_s.strip.empty?

data/lib/samagotchi/web/push/client.rb

@@ -11,18 +11,25 @@ module Samagotchi
     module Push
       # One push to one device: the payload encrypted for its keys
       # (Crypto.encrypt), POSTed to its endpoint with chi web's VAPID header,
-      # and the push service's answer as a Result. No retry (P1). See
-      # docs/internals/web-push.md.
+      # and the push service's answer as a Result. It never retries itself:
+      # a Result says when a retry may help (+retry_after+), and the
+      # Notifier keeps it. See docs/internals/web-push.md.
       class Client
         OPEN_TIMEOUT = 5
         READ_TIMEOUT = 10
+        # A 429 or 5xx's Retry-After (delta-seconds) is taken up to this;
+        # without one (or as an HTTP date) a retry waits RETRY_DEFAULT.
+        RETRY_MAX = 60
+        RETRY_DEFAULT = 10
 
         # +status+ :ok (201/200/202), :gone (404/410: the device dropped
         # it), :bad_jwt (403 BadJwtToken: the push service refused chi's
         # VAPID token) or :failed; +code+ the HTTP status (nil when none
-        # came), +error+ a short word for a failure, +ms+ the call's time.
-        Result = Data.define(:status, :code, :ms, :error) do
-          def initialize(error: nil, **) = super
+        # came), +error+ a short word for a failure, +ms+ the call's time,
+        # +retry_after+ the seconds after which one retry may go (a 429 or
+        # 5xx; nil for anything else).
+        Result = Data.define(:status, :code, :ms, :error, :retry_after) do
+          def initialize(error: nil, retry_after: nil, **) = super
           def ok? = status == :ok
         end
 
@@ -93,7 +100,17 @@ module Samagotchi
                    when 403 then response.body.to_s.include?("BadJwtToken") ? :bad_jwt : :failed
                    else :failed
                    end
-          Result.new(status: status, code: code, ms: elapsed, error: status == :failed ? code.to_s : nil)
+          Result.new(status: status, code: code, ms: elapsed, error: status == :failed ? code.to_s : nil,
+                     retry_after: retry_after(response, code))
+        end
+
+        # The push service is busy (429) or failing (5xx): when to try once
+        # more.
+        def retry_after(response, code)
+          return nil unless code == 429 || (500..599).cover?(code)
+
+          value = response["Retry-After"].to_s.strip
+          value.match?(/\A\d+\z/) ? [value.to_i, RETRY_MAX].min : RETRY_DEFAULT
         end
 
         def ms(started) = ((@monotonic.call - started) * 1000).round