samagotchi 0.46.0 → 0.47.0

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

@@ -0,0 +1,234 @@
+// Session chains on the page (docs/sessions.md, Session chains): a session
+// that continues an earlier one (its summary's `continues`), "the next day of
+// the same routine". The chain is derived from the list, never stored: back
+// through `continues`, forward through the session whose `continues` names
+// this one. The lists fold a chain into its latest listed link's card (a
+// `day N` chip, its earlier links in a popover); the session page links the
+// previous and the next link. Pure: app.js places the markup and binds it.
+import { escapeHtml, normalize, previewForCard, relativeTime } from "./format.js";
+import { stoppedBadge, waitingBadge } from "./sessions_list.js";
+import { waitingOn } from "./notify.js";
+
+// The opener a new link's composer is filled with (never sent: the user
+// edits or sends it). The same for every chain.
+export const CONTINUE_OPENER = "Continue where we left off.";
+
+// Whether +text+ (a title or a first message) is the opener and nothing
+// else, trimmed: "Continue where we left off. Then fix X" is a title of its own.
+export function isOpener(text) {
+  return normalize(text) === CONTINUE_OPENER;
+}
+
+// A link's card title (format.js previewForCard), display only: a link
+// whose title is the opener, as every link's first message is once sent,
+// reads its chain's first link's title instead, so the days of a chain
+// keep its name. Its own title when the first link isn't in +byId+ (id →
+// session; deleted, or a walk a missing link cut short) or is the opener too.
+export function chainTitle(s, byId) {
+  const own = previewForCard(s);
+  if (!s?.continues || !isOpener(s.first_preview || s.last_prompt)) return own;
+  const seen = new Set([s.id]);
+  let at = s;
+  while (at.continues) {
+    const prev = byId.get(at.continues);
+    if (!prev || seen.has(prev.id)) return own;
+    seen.add(prev.id);
+    at = prev;
+  }
+  return isOpener(at.first_preview || at.last_prompt) ? own : previewForCard(at);
+}
+
+const createdMs = (s) => {
+  const ms = Date.parse(s?.created_at || "");
+  return Number.isNaN(ms) ? 0 : ms;
+};
+
+// session id → the session that continues it: the first created, as the
+// server's next_of picks (a link is continued once; a hand-edited second
+// one doesn't fork the chain).
+function nextsOf(list) {
+  const nexts = new Map();
+  for (const s of list.slice().sort((a, b) => createdMs(a) - createdMs(b))) {
+    if (s.continues && s.continues !== s.id && !nexts.has(s.continues)) nexts.set(s.continues, s);
+  }
+  return nexts;
+}
+
+// The chain +id+ is in, earliest link first, as far as +list+ holds it (a
+// link that isn't listed ends the walk there). [] for an id not listed; a
+// session in no chain is a chain of one. A loop a hand-edited file could
+// make ends where it started. +nexts+ and +byId+ (id → session): a caller
+// walking many chains of one list builds them once (foldChains).
+export function chainLinks(list, id, nexts = nextsOf(list), byId = new Map(list.map((s) => [s.id, s]))) {
+  const self = byId.get(id);
+  if (!self) return [];
+  const links = [self];
+  const seen = new Set([id]);
+  for (let at = byId.get(self.continues); at && !seen.has(at.id); at = byId.get(at.continues)) {
+    seen.add(at.id);
+    links.unshift(at);
+  }
+  for (let at = nexts.get(id); at && !seen.has(at.id); at = nexts.get(at.id)) {
+    seen.add(at.id);
+    links.push(at);
+  }
+  return links;
+}
+
+// The session page's neighbours of +id+: {prev, next}, each {id, session}
+// or null. +continues+: the open session's own `continues`, when the list
+// may not have caught up with it. A previous link the list doesn't hold
+// (deleted) is null: its link would open a not-found page.
+export function chainNeighbours(list, id, { continues = null } = {}) {
+  const self = list.find((s) => s.id === id);
+  const prevId = self?.continues || continues || null;
+  const prevSession = prevId && prevId !== id ? list.find((s) => s.id === prevId) : null;
+  const prev = prevSession ? { id: prevId, session: prevSession } : null;
+  const nextSession = nextsOf(list).get(id) || null;
+  const next = nextSession ? { id: nextSession.id, session: nextSession } : null;
+  return { prev, next };
+}
+
+// A link's day as the carry note writes it: the local YYYY-MM-DD of its
+// start; "" when it has none.
+export function chainDate(iso) {
+  const d = new Date(iso || "");
+  if (Number.isNaN(d.getTime())) return "";
+  const pad = (n) => String(n).padStart(2, "0");
+  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
+}
+
+// The families (sessions_list.js families) with the chains folded in: a
+// family whose head is an earlier link of a chain whose later link heads a
+// listed family is left out (it is in that card's chain list), whatever
+// its archived state, its delegates with it; a family whose head is in a
+// chain of two or more carries chain: {links, at, folded} (at: the head's
+// index). +all+: every session the page holds, archived ones too (the links
+// the list leaves out). The same array when no chain is in it.
+// @param fold false: every family stays (each link's card carries its
+//   chip, "day 1 of 3"; folded false), for a search or the archived ones
+export function foldChains(fams, all, { fold = true } = {}) {
+  if (!all.some((s) => s.continues)) return fams;
+  const nexts = nextsOf(all);
+  const byId = new Map(all.map((s) => [s.id, s]));
+  const heads = new Set(fams.map((f) => f.head.id));
+  const out = [];
+  let changed = false;
+  for (const f of fams) {
+    const links = chainLinks(all, f.head.id, nexts, byId);
+    if (links.length < 2) {
+      out.push(f);
+      continue;
+    }
+    changed = true;
+    const at = links.findIndex((s) => s.id === f.head.id);
+    if (fold && links.slice(at + 1).some((s) => heads.has(s.id))) continue;
+    out.push({ ...f, chain: { links, at, folded: fold } });
+  }
+  return changed ? out : fams;
+}
+
+// The all view's families: folded (foldChains) unless a search is typed or
+// the archived ones are included. Then every link is a card of its own
+// (with its chip), so a search finds an earlier link, and an earlier
+// link's delegates fold into its own card as anywhere else.
+export function allViewChains(fams, all, { query = "", includeArchived = false } = {}) {
+  return foldChains(fams, all, { fold: !query && !includeArchived });
+}
+
+// The links a family's chain list shows: the chain but its head, newest
+// first, each {session, day} (day: its 1-based place in the chain).
+export function chainOthers(f) {
+  const links = f?.chain?.links || [];
+  return links.map((session, i) => ({ session, day: i + 1 }))
+    .filter(({ session }) => session.id !== f.head.id)
+    .reverse();
+}
+
+// The chip in a chain's card: "day 3" (the head's place; "day 2 of 3" when
+// later links aren't listed), with a live dot / "waiting" when one of the
+// other links has a worker / waits on the user (typing in an archived link
+// brings it back, but it stays folded here). "" for a family in no chain.
+// @param open whether the list is open (aria-expanded)
+export function chainChipHtml(f, { open = false } = {}) {
+  if (!f?.chain) return "";
+  const { links, at } = f.chain;
+  const others = chainOthers(f);
+  const live = others.filter(({ session: s }) => s.owner === "worker").length;
+  const waiting = others.filter(({ session: s }) => waitingOn(s)).length;
+  const day = at + 1;
+  const text = day === links.length ? `day ${day}` : `day ${day} of ${links.length}`;
+  const earlier = at;
+  const later = links.length - 1 - at;
+  const parts = [earlier ? `${earlier} earlier ${earlier === 1 ? "link" : "links"}` : "", later ? `${later} later` : ""].filter(Boolean);
+  const title = `Session chain: day ${day} of ${links.length} (${parts.join(", ")}); open the list`;
+  const liveHtml = live ? `<span class="cc-live"> · <span class="live-dot" aria-hidden="true"></span>${live} live</span>` : "";
+  const waitingHtml = waiting ? ` · <span class="cc-waiting">${waiting} waiting</span>` : "";
+  return `<button type="button" class="chain-chip${waiting ? " waiting" : ""}" aria-expanded="${open ? "true" : "false"}" title="${escapeHtml(title)}"><span class="cc-arrow" aria-hidden="true">↩</span>${escapeHtml(text)}${liveHtml}${waitingHtml}</button>`;
+}
+
+// The chain's list (the chip's popover): one row per other link, newest
+// first: status dot, "day N", its date, its recap's first sentence (else
+// its preview), the waiting / stopped badge, archived. A row's click opens
+// that link (families_view.js's popover binds .family-row[data-id]).
+// @param activeId the open session's id (its row is .active)
+export function chainRowsHtml(f, { activeId = null, now = Date.now() } = {}) {
+  const byId = new Map((f?.chain?.links || []).map((s) => [s.id, s]));
+  const rows = chainOthers(f).map(({ session: s, day }) => {
+    const cls = ["family-row", "chain-row"];
+    if (activeId && s.id === activeId) cls.push("active");
+    if (s.archived) cls.push("archived");
+    const waiting = waitingBadge(s, { inFamily: true });
+    const stopped = waiting ? null : stoppedBadge(s);
+    const dotWord = waiting ? waiting.title : s.status;
+    const date = chainDate(s.created_at);
+    const ago = relativeTime(s.updated_at || s.created_at || "", now);
+    const parts = [
+      `<span class="status dot ${escapeHtml(s.status || "")}${waiting ? " waiting" : ""}" title="${escapeHtml(dotWord || "")}" aria-label="${escapeHtml(dotWord || "")}"></span>`,
+      `<span class="cr-day">day ${day}</span>`,
+      date ? `<span class="cr-date">${escapeHtml(date)}</span>` : "",
+      `<span class="fr-preview">${escapeHtml(s.recap || chainTitle(s, byId))}</span>`,
+      waiting ? `<span class="attn attn-${waiting.kind}" title="${escapeHtml(waiting.title)}">${escapeHtml(waiting.text)}</span>` : "",
+      stopped ? `<span class="stopped-badge" title="${escapeHtml(stopped.title)}">${escapeHtml(stopped.text)}</span>` : "",
+      s.archived ? `<span class="archived-badge" title="Archived: hidden from the lists, kept for good">archived</span>` : "",
+    ].join("");
+    const tip = `${s.id} · ${s.status || ""}${ago ? ` · updated ${ago}` : ""}`;
+    return `<div class="${cls.join(" ")}" data-id="${escapeHtml(s.id)}" style="--depth:1" role="listitem"><button type="button" class="fr-open" title="${escapeHtml(tip)}">${parts}</button></div>`;
+  });
+  return `<div class="family-rows chain-rows" role="list">${rows.join("")}</div>`;
+}
+
+// What the page does with a refused continue (POST /api/sessions
+// continues, api()'s error with the answer's body): "open" the link that
+// continues it already (409 continued, next_id), "children" naming the
+// delegates still open (409 open_children, ids: {id, short, text} each,
+// the text its preview and why it is open: the server's word from its
+// detail, "<short> (running)", else its state here), or "error" with the
+// server's words.
+export function continueRefusal(error, sessions = []) {
+  const body = error?.body || {};
+  if (error?.code === "continued" && body.next_id) return { kind: "open", id: body.next_id };
+  const text = String(error?.message || "refused").replace(/\s*\(\d{3}\)$/, "");
+  if (error?.code === "open_children" && Array.isArray(body.ids) && body.ids.length) {
+    const byId = new Map(sessions.map((s) => [s.id, s]));
+    const children = body.ids.map((id) => {
+      const s = byId.get(id);
+      const short = String(id).slice(0, 8);
+      const said = text.split(short + " (")[1]?.split(")")[0];
+      const why = said || (s ? (waitingOn(s) ? "waiting" : s.status || "") : "");
+      const preview = s ? previewForCard(s) : "";
+      return { id, short, text: [preview, why ? `(${why})` : ""].filter(Boolean).join(" ") };
+    });
+    return { kind: "children", children, text };
+  }
+  return { kind: "error", text };
+}
+
+// The open-children refusal as the toast shows it: the delegates named,
+// each a link to its session.
+// @param hrefFor (id) → its page's href
+export function openChildrenHtml(prevId, children, hrefFor) {
+  const n = children.length;
+  const items = children.map((c) => `<li><a href="${escapeHtml(hrefFor(c.id))}" class="cr-child">${escapeHtml(c.short)}</a>${c.text ? ` ${escapeHtml(c.text)}` : ""}</li>`).join("");
+  return `<div class="continue-refused"><div>Can't continue ${escapeHtml(String(prevId).slice(0, 8))}: ${n} ${n === 1 ? "delegate is" : "delegates are"} still open. Wait for ${n === 1 ? "it" : "them"}, stop or archive ${n === 1 ? "it" : "them"}, then continue.</div><ul>${items}</ul></div>`;
+}

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

@@ -11,6 +11,9 @@ export function api(path, opts = {}) {
       // The server's error code ({error: "owned_by_tui", detail}): what
       // the page matches on, never the message's words.
       error.code = j.error || null;
+      // The whole answer, for what an error carries besides its words (a
+      // refused continue's next_id or ids).
+      error.body = j;
       throw error;
     }
     return j;
@@ -39,6 +42,15 @@ export function createIdleSession({ dir, model, preview, llm_context: llmContext
   return api("/api/sessions", { method: "POST", body: JSON.stringify(body), ...opts });
 }
 
+// The next link of +id+'s chain (docs/sessions.md, Session chains): a new
+// session in its folder, on its model, starting with its recap, idle (the
+// page fills the composer, the user sends); +id+ is archived by it. A
+// refusal is api()'s error: code "continued" with body.next_id (the link
+// that continues it already), "open_children" with body.ids, …
+export function continueSession(id, opts = {}) {
+  return api("/api/sessions", { method: "POST", body: JSON.stringify({ continues: id, idle: true }), ...opts });
+}
+
 // The models a new session can start on: {default, models: [{name, host, id}],
 // warning?} (a host that failed is in the warning, the list has the rest).
 export function listModels(opts = {}) {

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

@@ -69,7 +69,8 @@ export const PHONE_MAX_PX = 600;
 // @param anchorFor (headId) → its chip in the strip, or null
 // @param onPick (id) a row's click
 // @param onClose () after it closed (the strip's held order catches up)
-export function createFamilyPop({ doc, win, rowsFor, anchorFor, onPick, onClose = () => {} }) {
+// @param id the element's id (a chain's popover, chains.js, is another one)
+export function createFamilyPop({ id = "familyPop", doc, win, rowsFor, anchorFor, onPick, onClose = () => {} }) {
   let el = null;
   let headId = null;
   let html = "";
@@ -77,7 +78,7 @@ export function createFamilyPop({ doc, win, rowsFor, anchorFor, onPick, onClose
   const element = () => {
     if (el) return el;
     el = doc.createElement("div");
-    el.id = "familyPop";
+    el.id = id;
     el.className = "family-pop";
     el.hidden = true;
     el.addEventListener("click", (e) => {

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

@@ -494,6 +494,7 @@ body.has-session #composer .actions-col{flex-wrap:nowrap;flex-shrink:0}
 #composer .actions-col .model-pick:hover,#composer .actions-col .model-pick[aria-expanded="true"]{filter:none;background:color-mix(in srgb,var(--bg-hover) 75%,transparent);color:var(--text-2)}
 #composer .actions-col .model-pick[hidden],body.has-session #composer .actions-col .model-pick{display:none}
 .model-pick-name{display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+#composer .actions-col .model-pick.unavailable .model-pick-name{color:var(--text-faint)}
 .model-pick::after{content:"";position:absolute;right:9px;top:50%;width:5px;height:5px;border-right:1.5px solid currentColor;border-bottom:1.5px solid currentColor;transform:translateY(-70%) rotate(45deg);pointer-events:none;transition:transform .12s ease}
 .model-pick[aria-expanded="true"]::after{transform:translateY(-20%) rotate(225deg)}
 @media(max-width:600px){#composer .actions-col .model-pick{max-width:60%}}
@@ -529,6 +530,8 @@ body.has-session #composer .actions-col{flex-wrap:nowrap;flex-shrink:0}
 #modelList mark{background:none;color:var(--accent);font-weight:600}
 #modelList .model-option.chosen mark{color:var(--text-bright)}
 #modelList .model-note{flex:none;font-size:11px;color:var(--text-faint)}
+#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}}
 /* The / autocomplete: a list over the composer card's top edge. It wears the glass edge and shadow, but opaque:
@@ -758,6 +761,8 @@ body.stage-view #dock,body.stage-view #dock:focus-within{background:transparent;
   #infoBar .meta .mem-chip{display:inline;order:-1}
   /* A parent's children chip too: its waiting part is what to see. */
   #infoBar .meta .children-chip{order:-1}
+  /* A chain's ← → links too: the way to the other days. */
+  #infoBar .meta .chain-link{order:-1}
   /* The chips get a second line of their own (only when there are some), scrolling sideways. */
   #infoBar:has(#contextChips:not([hidden])){flex-wrap:wrap;row-gap:4px}
   #contextChips{flex-wrap:nowrap;overflow-x:auto;scrollbar-width:none}
@@ -835,12 +840,32 @@ body.has-session #scope .scope-where{display:none}
 #infoBar .meta a.parent{text-decoration:none}
 #infoBar .meta a.parent:hover{color:var(--accent)}
 /* The strip's family popover (in body, position: fixed: the strip's sideways scroll on a phone would clip it), glass as the cards. */
-#familyPop{position:fixed;z-index:40;max-height:50vh;overflow:auto;padding:6px;border-radius:10px;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)}
-#familyPop[hidden]{display:none}
-#familyPop .family-rows{border-top:0;margin:0;padding-top:0}
-@supports not ((backdrop-filter:blur(1px)) or (-webkit-backdrop-filter:blur(1px))){#familyPop{background:var(--bg-panel)}}
-@media (prefers-reduced-transparency:reduce){#familyPop{background:var(--bg-panel);-webkit-backdrop-filter:none;backdrop-filter:none}}
-body.no-glass #familyPop{background:var(--bg-panel);-webkit-backdrop-filter:none;backdrop-filter:none}
+#familyPop,#chainPop{position:fixed;z-index:40;max-height:50vh;overflow:auto;padding:6px;border-radius:10px;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)}
+#familyPop[hidden],#chainPop[hidden]{display:none}
+:is(#familyPop,#chainPop) .family-rows{border-top:0;margin:0;padding-top:0}
+@supports not ((backdrop-filter:blur(1px)) or (-webkit-backdrop-filter:blur(1px))){#familyPop,#chainPop{background:var(--bg-panel)}}
+@media (prefers-reduced-transparency:reduce){#familyPop,#chainPop{background:var(--bg-panel);-webkit-backdrop-filter:none;backdrop-filter:none}}
+body.no-glass :is(#familyPop,#chainPop){background:var(--bg-panel);-webkit-backdrop-filter:none;backdrop-filter:none}
+/* A chain's chip (chains.js): the card is the latest link of a session chain; a click lists the other links in a popover. */
+.card .meta:has(.chain-chip){flex-wrap:wrap;row-gap:4px}
+.card .chain-chip{font-family:ui-monospace,monospace;font-size:11px;line-height:1.4;white-space:nowrap;flex-shrink:0;padding:1px 7px;border-radius:999px;border:1px solid var(--accent-border);background:var(--accent-tint);color:var(--accent);cursor:pointer}
+.card .chain-chip:hover:not(:disabled){filter:none;border-color:var(--accent);background:var(--accent-bg)}
+.card .chain-chip[aria-expanded="true"]{background:var(--accent-bg);border-color:var(--accent)}
+.card .chain-chip.waiting{color:var(--warn-text);background:var(--warn-bg);border-color:var(--warn-border)}
+.chain-chip .cc-arrow{display:inline-block;margin-right:4px}
+.chain-chip .live-dot{display:inline-block;width:6px;height:6px;border-radius:50%;background:var(--ok);margin-right:3px;vertical-align:1px}
+.chain-chip .cc-waiting{font-family:system-ui,sans-serif;font-weight:600}
+.chain-row .cr-day{font-family:ui-monospace,monospace;font-size:11px;color:var(--accent);white-space:nowrap}
+.chain-row .cr-date{font-family:ui-monospace,monospace;font-size:11px;color:var(--text-muted);white-space:nowrap;font-variant-numeric:tabular-nums}
+/* The session page's links to the previous and the next link of its chain. */
+#infoBar .meta a.chain-link{text-decoration:none;font-family:ui-monospace,monospace;white-space:nowrap;color:var(--accent)}
+#infoBar .meta a.chain-link:hover{background:var(--accent-bg)}
+#infoBar #infoContinueBtn{color:var(--accent);border:1px solid var(--accent-border)}
+#infoBar #infoContinueBtn:hover:not(:disabled){background:var(--accent-bg)}
+#infoBar #infoContinueBtn:disabled{opacity:.7;cursor:progress}
+/* A continue refused for open delegates: the toast names them, each a link. */
+#toast .continue-refused ul{margin:4px 0 0;padding-left:18px}
+#toast .continue-refused a{color:var(--accent);font-family:ui-monospace,monospace}
 /* A parent's family chip: its delegates folded into its card; a click opens or closes their list. */
 /* A card with a family chip lets its meta row wrap: the chip goes to a line of its own when the card is narrow. */
 .card .meta:has(.family-chip){flex-wrap:wrap;row-gap:4px}
@@ -1029,6 +1054,7 @@ a{color:var(--accent)}
       <div id="infoBar">
         <div class="info" id="infoText"></div>
         <div id="contextChips" aria-label="Attached context" hidden></div>
+        <button class="ghost" id="infoContinueBtn" title="Continue: start the next link of this session's chain from its recap (this one is archived)" style="display:none">continue →</button>
         <button class="ghost" id="infoArchiveBtn" title="Archive: hide from the lists, keep for good" style="display:none">archive</button>
         <button class="ghost" id="infoStopBtn" title="Stop session (terminate worker)" style="display:none">stop</button>
         <button class="ghost" id="infoDeleteBtn" title="Delete session (for good)" style="display:none">delete</button>

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

@@ -2,16 +2,19 @@
 
 export const MODEL_KEY = "chi_model";
 
-// The name to preselect: the remembered one when it is still offered (any
-// case), else the server's default, else the first offered, else "".
-export function pickModel(names, defaultName, stored) {
+// The name to preselect from the rows (modelRows): the remembered one when
+// it is still offered (any case), else the server's default, both even
+// when their host is down; else the first row whose host answered, else
+// the first row, else "".
+export function pickModel(rows, defaultName, stored) {
+  const names = rows.map((r) => r.name);
   const want = String(stored || "").trim().toLowerCase();
   if (want) {
     const kept = names.find((n) => n.toLowerCase() === want);
     if (kept) return kept;
   }
   if (defaultName && names.includes(defaultName)) return defaultName;
-  return defaultName || names[0] || "";
+  return defaultName || (rows.find((r) => !r.unavailable) || rows[0])?.name || "";
 }
 
 
@@ -21,7 +24,8 @@ export const RECENT_KEY = "chi_model_recent";
 // sampling (the configured request parameters as /model words them) when
 // the model has some, and llm_context (the LLM context it starts under,
 // LLMContextStrategy::Explained#summary) when the server sent one, and
-// configured when the host declares the id (hosts.<name>.models). The
+// configured when the host declares the id (hosts.<name>.models), and
+// unavailable when that host failed to list its models. The
 // default host's names are bare (name == id); the server's own default,
 // unshifted when no host lists it, has no host and goes with them, shown
 // by its name.
@@ -36,6 +40,7 @@ export function modelRows(payload) {
       const row = { name, host, id, isDefaultHost: !host || name === id };
       if (m.sampling) row.sampling = String(m.sampling);
       if (m.configured === true) row.configured = true;
+      if (m.unavailable === true) row.unavailable = true;
       if (m.llm_context && typeof m.llm_context === "object") row.llm_context = m.llm_context;
       return row;
     });
@@ -44,9 +49,9 @@ export function modelRows(payload) {
 const byId = (a, b) => (b.configured === true) - (a.configured === true) ||
   a.id.localeCompare(b.id, "en", { sensitivity: "base" });
 
-// The rows under their hosts, [{host, isDefault, rows}]: the default host
-// first, the others in the server's order; inside a host the configured
-// ids first, each part A-Z.
+// The rows under their hosts, [{host, isDefault, unavailable, rows}]: the
+// default host first, the others in the server's order; inside a host the
+// configured ids first, each part A-Z. unavailable: every row's host is down.
 export function groupRows(rows) {
   const groups = [];
   const find = (key) => groups.find((g) => g.key === key);
@@ -61,23 +66,25 @@ export function groupRows(rows) {
     group.rows.push(row);
   }
   return groups.map(({ host, isDefault, rows: rs }) => ({
-    host: host || "default", isDefault, rows: [...rs].sort(byId),
+    host: host || "default", isDefault, unavailable: rs.every((r) => r.unavailable === true), rows: [...rs].sort(byId),
   }));
 }
 
-// The word after a row's id: "default" for the default model, else
-// "config" for an id the host declares (hosts.<name>.models), else "".
+// The words after a row's id: "default" for the default model, else
+// "config" for an id the host declares (hosts.<name>.models), else "";
+// then "host down" when its host failed to list its models.
 export function rowNote(row, defaultName) {
-  if (row.name === defaultName) return "default";
-  return row.configured ? "config" : "";
+  const word = row.name === defaultName ? "default" : row.configured ? "config" : "";
+  return [word, row.unavailable ? "host down" : ""].filter(Boolean).join(" · ");
 }
 
-// A row's tooltip: its configured sampling, and where a configured id
-// comes from; "" when neither.
+// A row's tooltip: its configured sampling, where a configured id comes
+// from, and that its host is down; "" when none.
 export function rowTitle(row) {
   const parts = [];
   if (row.sampling) parts.push(`sampling: ${row.sampling}`);
   if (row.configured) parts.push(`served by config (hosts.${row.host}.models)`);
+  if (row.unavailable) parts.push(`host ${row.host} didn't list its models (down?); a chat on it may fail`);
   return parts.join("; ");
 }
 

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

@@ -50,16 +50,19 @@ export function createModelPicker({ button, panel, input, list, composer, center
 
   const isOpen = () => !panel.hidden;
 
+  // Greyed while the chosen row's host is down (the button's tooltip,
+  // app.js', carries the host's warning).
   function setChosen(name) {
     chosen = name;
     button.querySelector(".model-pick-name").textContent = name;
+    button.classList.toggle("unavailable", rows.some((r) => r.name === name && r.unavailable === true));
   }
 
   function rowHtml(row, i, { hostMarks = [], idMarks = [], showHost = !row.isDefaultHost } = {}) {
     const host = showHost ? `<span class="model-host">${markedHtml(row.host, hostMarks)}</span><span class="model-dot"> · </span>` : "";
     const noteText = rowNote(row, defaultName);
     const note = noteText ? `<span class="model-note">${noteText}</span>` : "";
-    const cls = `model-option${i === active ? " active" : ""}${row.name === chosen ? " chosen" : ""}`;
+    const cls = `model-option${i === active ? " active" : ""}${row.name === chosen ? " chosen" : ""}${row.unavailable ? " unavailable" : ""}`;
     const titleText = rowTitle(row);
     const title = titleText ? ` title="${escapeHtml(titleText)}"` : "";
     return `<div class="${cls}" role="option" id="model-option-${i}" aria-selected="${i === active}" data-index="${i}"${title}>` +
@@ -83,7 +86,7 @@ export function createModelPicker({ button, panel, input, list, composer, center
         recent.forEach((row) => add(row));
       }
       for (const group of groupRows(rows)) {
-        html += head(group.host, group.isDefault ? "default host" : "");
+        html += head(group.host, [group.isDefault ? "default host" : "", group.unavailable ? "host down" : ""].filter(Boolean).join(" · "));
         group.rows.forEach((row) => add(row, { showHost: false }));
       }
     }
@@ -217,7 +220,7 @@ export function createModelPicker({ button, panel, input, list, composer, center
       close();
       rows = next;
       defaultName = String(payload.default || "");
-      setChosen(pickModel(rows.map((r) => r.name), payload.default, stored || chosen));
+      setChosen(pickModel(rows, payload.default, stored || chosen));
       return true;
     },
     chosen: () => chosen,

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

@@ -25,6 +25,13 @@ const CONTINUE_CLOSED = {
   replaced: "Asked again",
 };
 
+// A close reason that reads as words on any card, not as "(reason)": a
+// question asked in a --non-interactive run (QuestionDesk's
+// UNANSWERABLE_REASON) had no one to answer it.
+const CLOSED_PLAIN = {
+  non_interactive: "No one could answer (non-interactive run)",
+};
+
 // A delegate's approval relayed to this session's user (the approval
 // relay): who asks (the chain, "ab12 → cd34" for a grandchild's) and its
 // task, or null.
@@ -97,6 +104,7 @@ function relayClosedText(relay, reason) {
 export function resultText(pq, { answer = null, cancelled = false, reason = "" } = {}) {
   const approval = isApproval(pq);
   const relay = relayView(pq);
+  if (cancelled && Object.hasOwn(CLOSED_PLAIN, reason)) return CLOSED_PLAIN[reason];
   if (cancelled && relay && reason !== "dismissed") return relayClosedText(relay, reason);
   if (isContinue(pq)) return continueResultText({ answer, cancelled, reason });
   if (cancelled) {

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

@@ -19,6 +19,8 @@ export function emptySessionState() {
     promptNotes: [],
     // A delegated session's parent (the info bar's "delegated by" chip).
     parentId: null,
+    // The previous link of its chain (its `continues`), or null.
+    continues: null,
     ctxPct: null,
     // Window the kernel resolved for the running generation (:generation_started).
     ctxWindow: null,

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

@@ -125,9 +125,11 @@ export function flattenFamilies(fams) {
   return fams.flatMap((f) => [f.head, ...f.members.map((m) => m.session)]);
 }
 
-// Whether any of a family (its head or a member) waits on the user.
+// Whether any of a family (its head or a member) waits on the user, or
+// another link of its chain folded into its card (chains.js foldChains).
 export function familyWaits(f) {
-  return !!waitingOn(f.head) || f.members.some((m) => waitingOn(m.session));
+  return !!waitingOn(f.head) || f.members.some((m) => waitingOn(m.session))
+    || (!!f.chain?.folded && f.chain.links.some((s) => s.id !== f.head.id && waitingOn(s)));
 }
 
 const WAITING_BADGES = {

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

@@ -208,12 +208,16 @@ export function noticeLine(entry = {}) {
 }
 
 // The live turn's status while the provider is asked again after an error
-// (generation_retrying): "↻ retrying (503) in 4 s, 2/5" (retry 2 of 5).
+// (generation_retrying): "↻ retrying (503) in 4.0s, 2/5" (retry 2 of 5).
+// The TUI words it the same (Formatting#format_generation_retry_line;
+// spec/shared/labels_matrix.json).
 export function retryStatusLine({ attempt, max_retries, next_delay, status, error_class, restarted } = {}) {
   // restarted: a dropped stream's step asked again (the chat loop's).
   const why = restarted ? "stream dropped" : status || String(error_class || "").split("::").pop();
-  const delay = Number(next_delay);
-  const when = Number.isFinite(delay) ? ` in ${delay < 1 ? delay.toFixed(1) : Math.round(delay)} s` : "";
+  // null/"" are no delay (Number would make them 0).
+  const delay = next_delay === null || next_delay === "" ? NaN : Number(next_delay);
+  // Rounded as Ruby's Float#round does (half away from zero), then one decimal.
+  const when = Number.isFinite(delay) ? ` in ${(Math.round(delay * 10) / 10).toFixed(1)}s` : "";
   const count = attempt ? `, ${attempt}${max_retries ? `/${max_retries}` : ""}` : "";
   return `↻ retrying${why ? ` (${why})` : ""}${when}${count}`;
 }
@@ -429,12 +433,16 @@ export function restoreInto(refill, current) {
 // What the composer holds once a /turn ack lands (4.13): the composer still
 // carries the text that was just sent, so that text goes (it is the history's
 // now) — but text typed since the send stays, and a prompt restored before
-// this ack (restoreOnAck's refill) is put back without replacing it.
-// @param sent the composer's text when the turn was sent
+// this ack (restoreOnAck's refill) is put back without replacing it. The
+// sent text is trimmed (turnText), so the composer's is too before they are
+// compared: a trailing newline or space must not keep the message; and an
+// image-only send (placeholders sent) leaves nothing worth keeping.
+// @param sent the text the turn was sent with
 // @param current the composer's text as the ack lands
 // @param refill the prompt an early restore handed back, if any
 export function composerAfterAck({ sent = "", current = "", refill = "" } = {}) {
-  const kept = String(current ?? "") === String(sent ?? "") ? "" : current;
+  const typed = String(current ?? "").trim();
+  const kept = !typed || typed === String(sent ?? "").trim() ? "" : current;
   return restoreInto(refill, kept);
 }
 

data/lib/samagotchi/web/session_summary.rb

@@ -63,6 +63,9 @@ module Samagotchi
           # parent_id too but isn't one. The parent's children chip counts
           # delegates only, as the TUI's segment and /children do.
           delegate: session.delegate?,
+          # The session this one continues (the previous link of its
+          # chain), else nil: the lists draw chains from it.
+          continues: session.continues,
           first_preview: first_preview_for(session),
           owner: owner&.kind,
           # The saved recap's first sentence, for the session card.

data/lib/samagotchi/worker.rb

@@ -850,14 +850,18 @@ module Samagotchi
     # start only, so the reports its loop merged are not in the
     # conversation: their rings stay for the next turn, even when the turn
     # itself stays (a reminder or continue turn). Not one raised after the
-    # turn ended (the Engine's post-turn work): the turn was kept as
-    # completed, the reports in it.
+    # turn ended (the Engine's post-turn work): the turn was kept as it
+    # ended, completed or canceled, the reports in it (a turn TurnFlow
+    # takes back is a restore, above).
     def merges_lost?(error)
       return false if error.nil? || error.is_a?(LLM::FailedTurn)
 
-      @session.last_turn&.dig("outcome") != "completed"
+      !KEPT_TURN_OUTCOMES.include?(@session.last_turn&.dig("outcome"))
     end
 
+    # The Engine's turn endings that keep the turn's conversation (#merges_lost?).
+    KEPT_TURN_OUTCOMES = %w[completed canceled].freeze
+
     # A delegate child's turn that was its parent's (#reports_to_parent?)
     # rings the parent, after the save: the parent reads a settled child.
     # A question it rang about that still waits makes the next turn ring

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: samagotchi
 version: !ruby/object:Gem::Version
-  version: 0.46.0
+  version: 0.47.0
 platform: ruby
 authors:
 - Dmitry Dedov
@@ -395,6 +395,7 @@ files:
 - lib/samagotchi/served_model.rb
 - lib/samagotchi/session.rb
 - lib/samagotchi/session_archive_command.rb
+- lib/samagotchi/session_chain.rb
 - lib/samagotchi/session_commands.rb
 - lib/samagotchi/session_delete_command.rb
 - lib/samagotchi/session_inbox.rb
@@ -499,6 +500,7 @@ files:
 - lib/samagotchi/web/public/annotations.js
 - lib/samagotchi/web/public/app.js
 - lib/samagotchi/web/public/card.js
+- lib/samagotchi/web/public/chains.js
 - lib/samagotchi/web/public/chunk_router.js
 - lib/samagotchi/web/public/command_complete.js
 - lib/samagotchi/web/public/command_list.js