@songsid/agend 2.2.0-beta.1 → 2.2.0-beta.3

package/dist/ui/shared/header-tools.js

@@ -1,13 +1,15 @@
 // #1523 N3 (§3.4, Q2 = A): the controls every page's header has, in one order on Chat, View, Details and Fleet —
 //   Aa  text size, shared per device: S / M / L (View also keeps Fit, its own extra choice);
 //   ◔   AI usage, unless the fleet turned it off (web.usage_panel: false — said by the page itself, no probe read).
+//       #1673: on a wide screen it is a right rail beside the page (shown or hidden per device); ◔ toggles it. On a
+//       narrower one, ◔ opens the dialog.
 // The size is one attribute on the root (data-text-size); CSS turns it into one custom property the chat, Details and
 // Fleet read (#1300: no style attribute). View's terminal multiplies its fitted size by VIEW_SCALE, as its density did.
-import { html, useState } from "./app-html.js";
+import { html, useEffect, useState } from "./app-html.js";
 import { t } from "./app-i18n.js";
 import { createStore, useStore } from "./app-store.js";
 import { Icon } from "./ui-icons.js";
-import { UsageDialog } from "./usage-dialog.js";
+import { UsageBody, UsageDialog } from "./usage-dialog.js";
 
 export const TEXT_SIZE_KEY = "agend_text_size";
 export const VIEW_FIT_KEY = "agend_view_fit";
@@ -73,16 +75,64 @@ export function usageOffered() {
   try { return document.body && document.body.dataset ? document.body.dataset.usagePanel !== "0" : true; } catch { return true; }
 }
 
+// #1673: the rail. Wide enough for it beside the sidebar and the page: RAIL_MEDIA (followed as it changes). Shown or
+// hidden is this device's choice (agend_usage_rail; "0" = hidden, else shown) — a layout choice, not synced (#1665).
+export const RAIL_MEDIA = "(min-width: 1200px)";
+export const RAIL_KEY = "agend_usage_rail";
+/** The pages whose header has ◔ — the rail is theirs. */
+export const RAIL_PANELS = ["chat", "view", "details", "fleet"];
+export const usageRailStore = createStore({ open: true });
+/** A page load: this device's choice. */
+export function initUsageRail() { usageRailStore.set({ open: read(RAIL_KEY) !== "0" }); }
+export function setUsageRail(open) { write(RAIL_KEY, open ? "1" : "0"); usageRailStore.set({ open: !!open }); }
+const railQuery = () => { try { return typeof matchMedia === "function" ? matchMedia(RAIL_MEDIA) : null; } catch { return null; } };
+/** Whether the screen is wide enough for the rail, now and as it changes. */
+export function useRailWidth() {
+  const [wide, setWide] = useState(() => !!railQuery()?.matches);
+  useEffect(() => {
+    const q = railQuery();
+    if (!q) return undefined;
+    const on = () => setWide(!!q.matches);
+    on();
+    if (typeof q.addEventListener === "function") { q.addEventListener("change", on); return () => q.removeEventListener("change", on); }
+    if (typeof q.addListener === "function") { q.addListener(on); return () => q.removeListener(on); }
+    return undefined;
+  }, []);
+  return wide;
+}
+
+/**
+ * The rail: beside the page on a wide screen, on the pages with ◔, while this device shows it. Its reads are its own
+ * lease: they go on across navigation and end when it is hidden, the screen narrows, or it goes.
+ */
+export function UsageRail({ route }) {
+  const wide = useRailWidth();
+  const { open } = useStore(usageRailStore);
+  if (!wide || !open || !route || !RAIL_PANELS.includes(route.panel) || !usageOffered()) return null;
+  return html`<aside class="u-rail" aria-label=${t("view.usage.title_plain")}>
+    <div class="u-rail-head"><h2>${t("view.usage.title")}</h2>
+      <button type="button" class="icon-btn" onClick=${() => setUsageRail(false)} aria-label=${t("app.usageHide")} title=${t("app.usageHide")}><${Icon} name="close" size=${16} /></button></div>
+    <div class="u-rail-body"><${UsageBody} owner="usage-rail" /></div>
+  </aside>`;
+}
+
 /**
- * ◔: the usage dialog (usage-dialog.js). It belongs to the navigation that opened it (`navKey`, #1408 §4; #1563
+ * ◔: on a wide screen, shows or hides the rail (#1673); otherwise the usage dialog (usage-dialog.js). It belongs to the navigation that opened it (`navKey`, #1408 §4; #1563
  * review): another route, the same route again, another tab of the panel or a language switch closes it, and its
  * reads and timer end with it — the dialog's lease is that navigation's.
  */
 export function UsageButton({ navKey }) {
   const [openFor, setOpenFor] = useState(null);
+  const wide = useRailWidth();
+  const rail = useStore(usageRailStore);
+  // Widening ends a dialog opened on the narrower screen — closed for good, not hidden while wide: narrowing again
+  // (after the rail was hidden, or with this device's rail hidden) never brings it back (#1679 review).
+  useEffect(() => { if (wide) setOpenFor(null); }, [wide]);
   if (!usageOffered()) return null;
-  const open = openFor !== null && openFor === navKey;
-  return html`<button type="button" class="btn btn-ghost btn-sm hd-usage" onClick=${() => setOpenFor(navKey)} aria-label=${t("app.usage")} title=${t("app.usage")}>
+  const open = !wide && openFor !== null && openFor === navKey;
+  const click = () => (wide ? setUsageRail(!rail.open) : setOpenFor(navKey));
+  return html`<button type="button" class="btn btn-ghost btn-sm hd-usage" onClick=${click} aria-label=${t("app.usage")} title=${t("app.usage")}
+      aria-pressed=${wide ? (rail.open ? "true" : "false") : undefined}>
       <${Icon} name="chart" size=${16} /><span class="hide-narrow" aria-hidden="true">${t("app.usage")}</span></button>
     ${open ? html`<${UsageDialog} key=${navKey} owner=${navKey} onClose=${() => setOpenFor(null)} />` : null}`;
 }

package/dist/ui/shared/instance-nav.js

@@ -7,13 +7,14 @@
 // - a row opens the view you are in (View → View, everywhere else → Chat);
 // - the list is never remounted on navigation, and only its own scrollTop follows the active row (#1515).
 // Public (/assets/): an anonymous View reader gets the same list, fed by View's roster read instead of status frames.
-import { html, useLayoutEffect, useRef } from "./app-html.js";
+import { html, useLayoutEffect, useRef, useState } from "./app-html.js";
 import { t } from "./app-i18n.js";
 import { appStore, createStore, useStore } from "./app-store.js";
 import { chatPath, detailsPath, viewPath } from "./app-route.js";
 import { Icon } from "./ui-icons.js";
 import { Skeleton } from "./ui-states.js";
 import { viewStore } from "./view-roster-store.js";
+import { onPrefsChanged, prefInForce, prefsWritable, savePref } from "./app-prefs.js";
 import "./view-strings.js";
 
 /** view.* text with named values. */
@@ -23,7 +24,6 @@ function tn(key, values = {}) {
   return s;
 }
 const stored = (k) => { try { return localStorage.getItem(k); } catch { return null; } };
-const store = (k, v) => { try { localStorage.setItem(k, v); } catch { /* this page only */ } };
 /** A row's instance name: `name` (status frames) or `instance_name` (View's roster). */
 const nameOf = (it) => (it && (it.name != null ? it.name : it.instance_name)) || "";
 
@@ -101,14 +101,24 @@ export function instanceTooltip(it) {
   return lines.join("\n");
 }
 
-// ── This browser's order (drag), folded groups and filter ──
+// ── The order (drag), folded groups and filter: host preferences since #1665 (nav.*), cached in this browser ──
 const SIDEBAR_ORDER_KEY = "agend_view_sidebar_order";   // View's key since #999: everyone's arrangement carries over
 const COLLAPSED_KEY = "agend_instance_collapsed";
 const FILTER_KEY = "agend_instance_filter";
+const FAVORITES_KEY = "agend_favorites";   // #1664
+/**
+ * A synced sidebar preference, as the JSON its reader parses: the value in force in memory (app-prefs.js — this
+ * page's own change, else the host's; a full or blocked storage never brings an old one back), else this browser's copy.
+ */
+function inForce(prefKey, lsKey) {
+  const p = prefInForce(prefKey);
+  if (!p) return stored(lsKey);
+  return p.value === undefined ? null : JSON.stringify(p.value);
+}
 function readOrder() {
   const groups = new Map(), insts = new Map();
   try {
-    const rows = JSON.parse(stored(SIDEBAR_ORDER_KEY) || "[]");
+    const rows = JSON.parse(inForce("nav.order", SIDEBAR_ORDER_KEY) || "[]");
     if (Array.isArray(rows)) for (const row of rows) {
       if (row && row.item_type === "group" && typeof row.item_name === "string") groups.set(row.item_name, Number(row.sort_index) || 0);
       else if (row && row.item_type === "instance" && typeof row.item_name === "string") insts.set(row.item_name, Number(row.sort_index) || 0);
@@ -117,15 +127,18 @@ function readOrder() {
   return { groups, insts };
 }
 function readCollapsed() {
-  try { const a = JSON.parse(stored(COLLAPSED_KEY) || "[]"); return new Set(Array.isArray(a) ? a.filter((x) => typeof x === "string") : []); } catch { return new Set(); }
+  try { const a = JSON.parse(inForce("nav.collapsed", COLLAPSED_KEY) || "[]"); return new Set(Array.isArray(a) ? a.filter((x) => typeof x === "string") : []); } catch { return new Set(); }
 }
 const strings = (a) => (Array.isArray(a) ? a.filter((x) => typeof x === "string") : []);
 function readFilter() {
   try {
-    const f = JSON.parse(stored(FILTER_KEY) || "{}");
+    const f = JSON.parse(inForce("nav.filter", FILTER_KEY) || "{}");
     return { q: f && typeof f.q === "string" ? f.q : "", status: strings(f && f.status).filter((s) => STATUS_FACETS.includes(s)), cli: strings(f && f.cli) };
   } catch { return { q: "", status: [], cli: [] }; }
 }
+function readFavorites() {
+  try { const a = JSON.parse(inForce("nav.favorites", FAVORITES_KEY) || "[]"); return Array.isArray(a) ? [...new Set(a.filter((x) => typeof x === "string"))] : []; } catch { return []; }
+}
 /** Display order: this browser's saved order first, then new groups/instances by tag and name. */
 export function computeOrder(roster, order) {
   const groups = new Map();
@@ -159,29 +172,121 @@ function moveIn(arr, moving, target, before) {
 }
 
 /** The list's state for the page's life: this browser's order, folded groups and filter (each also kept in storage). */
-export const navStore = createStore({ order: readOrder(), collapsed: readCollapsed(), filter: readFilter() });
+export const navStore = createStore({ order: readOrder(), collapsed: readCollapsed(), filter: readFilter(), favorites: readFavorites() });
 /** Read them again from this browser's storage — what a page load does (the store above is made that way). */
-export function loadNavPrefs() { navStore.set({ order: readOrder(), collapsed: readCollapsed(), filter: readFilter() }); }
+export function loadNavPrefs() { navStore.set({ order: readOrder(), collapsed: readCollapsed(), filter: readFilter(), favorites: readFavorites() }); }
 /** Change the filter ({ q?, status?, cli? }): the same on every page, and kept by this browser. */
 export function setNavFilter(patch) {
   const filter = { ...navStore.get().filter, ...patch };
   navStore.set({ filter });
-  store(FILTER_KEY, JSON.stringify(filter));
+  savePref("nav.filter", { q: filter.q, status: filter.status, cli: filter.cli });
+}
+function setCollapsed(collapsed) { navStore.set({ collapsed }); savePref("nav.collapsed", [...collapsed]); }
+// Another device rearranged, folded or filtered: this page's list follows (its cache is already updated).
+onPrefsChanged((keys) => { if (keys.has("nav.order") || keys.has("nav.collapsed") || keys.has("nav.filter") || keys.has("nav.favorites")) loadNavPrefs(); });
+
+// ── #1664: favorites — starred instances, pinned at the top in the order they were starred (or moved) ──
+export const MAX_FAVORITES = 50;
+/** The favorites that are instances now (`known`: the names listed): what is shown, and the base of every change — so
+ *  a deleted instance is dropped, never sent back to the host (which would refuse it). */
+function liveFavorites(known) { return navStore.get().favorites.filter((n) => known.has(n)); }
+function setFavorites(next) { navStore.set({ favorites: next }); savePref("nav.favorites", next); }
+/** Star or unstar `name`. False: not done (the list is full). */
+export function toggleFavorite(name, known) {
+  const cur = liveFavorites(known);
+  if (cur.includes(name)) { setFavorites(cur.filter((n) => n !== name)); return true; }
+  if (cur.length >= MAX_FAVORITES || !known.has(name)) return false;
+  setFavorites([...cur, name]);
+  return true;
+}
+/** Move a favorite one place up (-1) or down (+1). */
+export function moveFavorite(name, delta, known) {
+  const cur = liveFavorites(known);
+  const from = cur.indexOf(name), to = from + delta;
+  if (from < 0 || to < 0 || to >= cur.length) return;
+  cur.splice(to, 0, cur.splice(from, 1)[0]);
+  setFavorites(cur);
 }
-function setCollapsed(collapsed) { navStore.set({ collapsed }); store(COLLAPSED_KEY, JSON.stringify([...collapsed])); }
+/** The Favorites group's key among the tag groups: no tag can be it (a group name is never a control character). */
+const FAV_GROUP = "\u0000favorites";
 function persistOrder(groupNames, instByGroup) {
   const rows = [];
   groupNames.forEach((g, i) => rows.push({ item_type: "group", item_name: g, sort_index: i, group_name: null }));
   for (const g of groupNames) (instByGroup.get(g) || []).forEach((n, j) => rows.push({ item_type: "instance", item_name: n, sort_index: j, group_name: g }));
-  store(SIDEBAR_ORDER_KEY, JSON.stringify(rows));
+  savePref("nav.order", rows);
   navStore.set({ order: { groups: new Map(groupNames.map((g, i) => [g, i])), insts: new Map(rows.filter((r) => r.item_type === "instance").map((r) => [r.item_name, r.sort_index])) } });
 }
 
+// ── #1630: what stands for an instance (design: the comment on #1630) ──
+// The server decides (the status frame's `avatar` / `accent`); the page only draws it. The anonymous View roster has
+// neither: its rows get the first character. A picture is only ever a same-origin /ui/img/ path — never a platform's
+// CDN (CSP img-src stays 'self'); one that fails to load falls back to the first character, never a broken image.
+
+const GRAPHEMES = typeof Intl !== "undefined" && typeof Intl.Segmenter === "function" ? new Intl.Segmenter(undefined, { granularity: "grapheme" }) : null;
+/** The first user-perceived character, upper-cased where that means anything. */
+export function firstCharacter(text) {
+  const s = String(text == null ? "" : text).trim();
+  if (!s) return "?";
+  if (GRAPHEMES) for (const { segment } of GRAPHEMES.segment(s)) return segment.toLocaleUpperCase();
+  return Array.from(s)[0].toLocaleUpperCase();
+}
+/** What a row is called: the display name when it has one, else the instance name (shown on hover and in Details). */
+export function labelOf(it) {
+  const d = it && typeof it.display_name === "string" ? it.display_name.trim() : "";
+  return d || nameOf(it);
+}
+// One path segment under /ui/img/<kind>/ — no further slash or backslash, and not a dot segment ("." / ".." or their
+// %2e spellings, which a browser resolves too): the picture can only ever be one of those routes (#1642 review).
+const sameOrigin = (src) => typeof src === "string"
+  && /^\/ui\/img\/(bot|avatar|emoji)\/(?!(?:\.|%2[eE]){1,2}(?:\?|$))[^/\\?#\s]+(\?v=[0-9A-Za-z%._-]*)?$/.test(src);
+/** The avatar to draw: the server's, if it is one the page may load; else the first character. */
+export function avatarOf(it) {
+  const a = it && it.avatar;
+  if (a && a.kind === "image" && sameOrigin(a.src)) return { kind: "image", src: a.src };
+  if (a && a.kind === "emoji" && sameOrigin(a.src)) return { kind: "emoji", src: a.src, alt: typeof a.alt === "string" ? a.alt : "" };
+  if (a && a.kind === "emoji" && typeof a.text === "string" && a.text.trim()) return { kind: "emoji", text: a.text.trim() };
+  return { kind: "initial", text: a && a.kind === "initial" && typeof a.text === "string" && a.text ? a.text : firstCharacter(labelOf(it)) };
+}
+const ACCENT = /^#[0-9a-f]{6}$/i;
+/** The status dot on the avatar: needs you, crashed, paused, stopped, looks stuck, working, idle — colour AND a label. */
+export function dotState(it, exec, awaiting) {
+  if (awaiting != null) return "needs";
+  if (!it || it.status === "crashed") return "crashed";
+  if (it.status === "paused") return "paused";
+  if (it.status !== "running") return "stopped";
+  return exec === "stuck" ? "stuck" : exec === "working" ? "working" : "idle";
+}
+const DOT = {
+  needs: ["warn", () => t("app.needsYou")], crashed: ["bad", () => t("app.statusCrashed")], paused: ["off hollow", () => t("app.statusPaused")],
+  stopped: ["off", () => t("app.statusStopped")], stuck: ["warn", () => t("app.statusStuck")], working: ["busy", () => t("app.statusWorking")],
+  idle: ["ok", () => t("app.statusIdle")],
+};
+export function dotLabel(state) { return (DOT[state] || DOT.stopped)[1](); }
+
+/** An instance's avatar with its status dot. The ring (its bot's colour) is a CSS custom property set through the CSSOM. */
+export function InstanceAvatar({ it, state }) {
+  const a = avatarOf(it);
+  const [broken, setBroken] = useState("");
+  const el = useRef(null);
+  const accent = typeof it.accent === "string" && ACCENT.test(it.accent) && a.kind === "image" ? it.accent : "";
+  useLayoutEffect(() => {
+    const node = el.current;
+    if (!node || !node.style) return;
+    if (accent) node.style.setProperty("--ring", accent); else node.style.removeProperty("--ring");
+  }, [accent]);
+  const src = a.kind !== "initial" && a.src && broken !== a.src ? a.src : "";
+  const text = a.kind === "emoji" && a.text ? a.text : a.kind === "initial" ? a.text : firstCharacter(labelOf(it));
+  const [cls] = DOT[state] || DOT.stopped;
+  const label = dotLabel(state);
+  return html`<span ref=${el} class=${`av${accent ? " ring" : ""}${a.kind === "emoji" ? " av-emoji" : ""}`}>
+    ${src ? html`<img src=${src} alt="" decoding="async" onError=${() => setBroken(src)} />` : html`<span class="av-text" aria-hidden="true">${text}</span>`}
+    <span class=${`av-dot dot ${cls}`} role="img" aria-label=${label} title=${label}></span></span>`;
+}
+
 // ── The list ──
 
 const statusText = (facet) => (facet === "needs" ? t("app.needsYou") : facet === "working" ? t("app.statusWorking") : facet === "idle" ? t("app.statusIdle")
   : facet === "crashed" ? t("app.statusCrashed") : t("app.statusStopped"));
-const dotClass = (facet, exec) => (facet === "needs" ? "warn" : facet === "crashed" ? "bad" : facet === "stopped" ? "off" : exec === "stuck" ? "warn" : facet === "working" ? "busy" : "ok");
 
 /**
  * The sidebar's instance list. `route`: the page's (which instance is open, and which view a row opens). `items`: the
@@ -194,6 +299,9 @@ export function InstanceNav({ route, items, loaded = true, exec = {}, awaiting =
   const filterRef = useRef(null);
   const list = useRef(null);
   const drag = useRef(null);
+  // #1664: "☆ Edit" — the stars on every row (on a phone the only way to them) and ↑ ↓ on the favorites — only on the
+  // full list, as drag: in a filtered one the row above may not be the one above in the list (#1677 review).
+  const [editing, setEditing] = useState(false);
   // Where a row goes: the view the page is in (#1523 §3.1). View → View; Details, or a Fleet tab (Q4 = A), → Details;
   // everywhere else → Chat. The anonymous reader only ever has View.
   const rowPath = viewOnly || (route && route.panel === "view") ? viewPath
@@ -204,9 +312,22 @@ export function InstanceNav({ route, items, loaded = true, exec = {}, awaiting =
   const byName = new Map(items.map((it) => [nameOf(it), it]));
   const facetOf = (name) => statusFacet(byName.get(name), own(exec, name) ? exec[name] : null, own(awaiting, name) ? awaiting[name] : null);
   const { groupNames, instByGroup } = computeOrder(items, nav.order);
+  // #1664: the favorites that are instances now, as a group of their own on top; the other groups keep the rest, in
+  // their order. Changing them: a signed-in page that may write preferences (not the public link, not the anonymous
+  // reader — they still see the list).
+  const known = new Set(byName.keys());
+  const favs = nav.favorites.filter((n) => known.has(n));
+  const favSet = new Set(favs);
+  const canStar = !viewOnly && prefsWritable();
+  const shownGroups = favs.length ? [FAV_GROUP, ...groupNames] : groupNames;
+  const shownInsts = new Map([...instByGroup].map(([g, names]) => [g, names.filter((n) => !favSet.has(n))]));
+  if (favs.length) shownInsts.set(FAV_GROUP, favs);
   const f = nav.filter;
-  const shown = filterSidebar(groupNames, instByGroup, byName, f.q, backendLabel, { status: f.status, cli: f.cli, statusOf: facetOf });
+  const shown = filterSidebar(shownGroups, shownInsts, byName, f.q, backendLabel, { status: f.status, cli: f.cli, statusOf: facetOf });
   const backends = [...new Set(items.map((it) => it.backend).filter((b) => typeof b === "string" && b))].sort((a, b) => backendLabel(a).localeCompare(backendLabel(b)));
+  // #1630: a display name two rows share would tell them apart from nothing — only then does the row keep its name too.
+  const labelCount = new Map();
+  for (const it of items) { const l = labelOf(it); labelCount.set(l, (labelCount.get(l) || 0) + 1); }
   const toggle = (g) => { const c = new Set(navStore.get().collapsed); if (c.has(g)) c.delete(g); else c.add(g); setCollapsed(c); };
   // From the store, not this render's copy: two clicks before the next render must both count.
   const flip = (key, value) => { const cur = new Set(navStore.get().filter[key]); if (cur.has(value)) cur.delete(value); else cur.add(value); setNavFilter({ [key]: [...cur] }); };
@@ -244,34 +365,50 @@ export function InstanceNav({ route, items, loaded = true, exec = {}, awaiting =
     <div class="nav-facet-list" role="group" aria-label=${label}>${values.map((value) => html`<label key=${value} class="nav-chip">
       <input type="checkbox" checked=${f[key].includes(value)} onChange=${() => flip(key, value)} /><span>${text(value)}</span></label>`)}</div>
   </details>`;
+  const row = (name, g, i, count) => {
+    const it = byName.get(name);
+    const label = labelOf(it);
+    // The instance name under a display name only when another row has the same display name.
+    const twin = label !== name && (labelCount.get(label) || 0) > 1 ? name : "";
+    const facet = facetOf(name);
+    const waiting = own(awaiting, name) ? awaiting[name] : null;
+    const on = name === active;
+    const fav = g === FAV_GROUP, starred = favSet.has(name);
+    const full = !starred && favs.length >= MAX_FAVORITES;
+    return html`<li key=${name} class="v-li"><a class=${`inst v-inst${on ? " active" : ""}`} href=${rowPath(name)} title=${instanceTooltip(it)}
+        aria-current=${on ? "page" : undefined} onClick=${onPick} ...${fav ? {} : dragProps({ type: "instance", name, group: g })}>
+      <${InstanceAvatar} it=${it} state=${dotState(it, own(exec, name) ? exec[name] : null, waiting)} />
+      <span class="inst-text"><span class="inst-name">${label}</span>
+        ${twin || facet === "needs" ? html`<span class="inst-sub">${twin ? html`<span class="inst-alias inst-id">${twin}</span>` : null}
+          ${facet === "needs" ? html`<span class="badge-await" title=${waiting || t("app.approxNote")}>${t("app.needsYou")}</span>` : null}</span>` : null}</span>
+      <span class="v-meta">${it.context_pct != null ? `${Math.round(it.context_pct)}%` : ""}</span>
+      <span class=${`cli-icon cli-${KNOWN_BACKENDS.has(it.backend) ? it.backend : "other"}`} title=${backendLabel(it.backend)} aria-label=${tn("tooltipBackend", { value: backendLabel(it.backend) })}></span>
+    </a>${fav && editing && canStar ? html`<button type="button" class="icon-btn inst-move" aria-label=${tn("favUp", { name: label })}
+        title=${shown.active ? tn("favFiltered") : tn("favUp", { name: label })} disabled=${shown.active || i === 0} onClick=${() => { if (!shown.active) moveFavorite(name, -1, known); }}><${Icon} name="up" size=${14} /></button><button type="button" class="icon-btn inst-move"
+        aria-label=${tn("favDown", { name: label })} title=${shown.active ? tn("favFiltered") : tn("favDown", { name: label })} disabled=${shown.active || i === count - 1}
+        onClick=${() => { if (!shown.active) moveFavorite(name, 1, known); }}><${Icon} name="down" size=${14} /></button>` : null}${canStar
+      ? html`<button type="button" class=${`icon-btn inst-star${starred ? " on" : ""}`} aria-pressed=${starred ? "true" : "false"} disabled=${full}
+          aria-label=${tn(starred ? "favRemove" : "favAdd", { name: label })} title=${full ? tn("favFull", { max: MAX_FAVORITES }) : tn(starred ? "favRemove" : "favAdd", { name: label })}
+          onClick=${() => toggleFavorite(name, known)}><${Icon} name="star" size=${14} /></button>` : null}</li>`;
+  };
   // The list scrolls; the filter under it stays in view (#999), so it sits outside the scrolling section.
-  return html`<div class="view-roster inst-nav">
+  return html`<div class=${`view-roster inst-nav${editing && canStar ? " fav-editing" : ""}`}>
     <div class="side-section" id="instanceList" ref=${list}>
-    <h2 class="side-label">${tn("instancesLabel")}</h2>
+    <div class="inst-head"><h2 class="side-label">${tn("instancesLabel")}</h2>
+      ${canStar && items.length ? html`<button type="button" class="chip-btn fav-edit" aria-pressed=${editing ? "true" : "false"} onClick=${() => setEditing(!editing)}>
+        ${editing ? tn("favDone") : html`<${Icon} name="star" size=${12} />${tn("favEdit")}`}</button>` : null}</div>
     ${!loaded ? html`<${Skeleton} lines=${4} />` : !items.length ? html`<p class="side-empty">${t("app.noInstances")}</p>` : null}
     ${shown.groups.map(({ group: g, names }) => {
+      // #1664: Favorites — always open, not dragged (↑ ↓ in Edit), named in the page's language.
+      if (g === FAV_GROUP) return html`<div key=${g} class="v-group v-fav" role="group" aria-label=${tn("favorites")}>
+        <div class="v-group-head fav-head"><${Icon} name="star" size=${14} cls="fav-mark" /><span class="grow">${tn("favorites")}</span><span class="count">${names.length}</span></div>
+        <ul class="inst-list">${names.map((name, i) => row(name, g, i, names.length))}</ul></div>`;
       const folded = nav.collapsed.has(g);
       return html`<div key=${g} class="v-group">
         <button type="button" class="v-group-head" aria-expanded=${folded ? "false" : "true"} onClick=${() => toggle(g)}
           title=${tn(folded ? "expandGroup" : "collapseGroup", { group: g })} ...${dragProps({ type: "group", name: g })}>
           <${Icon} name="chevron" size=${14} cls=${folded ? "caret folded" : "caret"} /><span class="grow">${g}</span><span class="count">${names.length}</span></button>
-        ${folded ? null : html`<ul class="inst-list">${names.map((name) => {
-          const it = byName.get(name);
-          const alias = typeof it.display_name === "string" && it.display_name.trim() && it.display_name.trim() !== name ? it.display_name.trim() : "";
-          const facet = facetOf(name);
-          const waiting = own(awaiting, name) ? awaiting[name] : null;
-          const on = name === active;
-          return html`<li key=${name}><a class=${`inst v-inst${on ? " active" : ""}`} href=${rowPath(name)} title=${instanceTooltip(it)}
-              aria-current=${on ? "page" : undefined} onClick=${onPick} ...${dragProps({ type: "instance", name, group: g })}>
-            <span class=${`dot ${dotClass(facet, own(exec, name) ? exec[name] : null)}`} aria-hidden="true"></span>
-            <span class="inst-text"><span class="inst-name">${name}</span>
-              ${alias || facet === "needs" ? html`<span class="inst-sub">${alias ? html`<span class="inst-alias">${alias}</span>` : null}
-                ${facet === "needs" ? html`<span class="badge-await" title=${waiting || t("app.approxNote")}>${t("app.needsYou")}</span>` : null}</span>` : null}
-              <span class="sr-only">${statusText(facet)}</span></span>
-            <span class="v-meta">${it.context_pct != null ? `${Math.round(it.context_pct)}%` : ""}</span>
-            <span class=${`cli-icon cli-${KNOWN_BACKENDS.has(it.backend) ? it.backend : "other"}`} title=${backendLabel(it.backend)} aria-label=${tn("tooltipBackend", { value: backendLabel(it.backend) })}></span>
-          </a></li>`;
-        })}</ul>`}
+        ${folded ? null : html`<ul class="inst-list">${names.map((name, i) => row(name, g, i, names.length))}</ul>`}
       </div>`;
     })}
     ${loaded && shown.active && !shown.groups.length ? html`<p class="side-empty">${tn("filterNone")}</p>` : null}

package/dist/ui/shared/panel-view.js

@@ -201,7 +201,13 @@ function Terminal({ name, lease, density }) {
   const term = useRef(null), pre = useRef(null);
   const grid = useRef({ cols: 0, rows: 0, applied: 0, key: "" });
   const [problem, setProblem] = useState(null);
+  // #1674: the text size as of this render. The pane refresh and the resize handlers below are set up once per mount
+  // and keep the fit() of that render; reading the size here, not from that render's props, keeps them on the current
+  // choice (they used to put the mount-time size back within one 800 ms refresh).
+  const dens = useRef(density);
+  dens.current = density;
   const fit = () => {
+    const density = dens.current;
     const g = grid.current, box = term.current, p = pre.current;
     if (!box || !p || g.cols < 1 || g.rows < 1) return;
     const cs = getComputedStyle(box);

package/dist/ui/shared/signin.js

@@ -4,7 +4,7 @@
 // (a SameSite=Strict cookie is not sent on a navigation that came from a chat app), probe the session
 // from *here* — a same-site request does carry the cookie — and carry on to the page that was asked
 // for; (2) otherwise take the one-time code and exchange it. A browser that signed in before with a code from
-// /dashboard (a returning device, #1570) is also offered "Send me a new code": the server sends it privately to the
+// /web (a returning device, #1570) is also offered "Send me a new code": the server sends it privately to the
 // person who received that earlier code — the page never learns who that is.
 (() => {
   "use strict";
@@ -13,24 +13,24 @@
     en: {
       checking: "Checking your session…", title: "Sign in to AgEnD", lead: "Enter the one-time code from your chat channel.",
       label: "One-time code", submit: "Sign in", working: "Signing in…",
-      hint: "Send /dashboard to your AgEnD bot, or run “agend web --code” on the host. A code works once and expires in 5 minutes.",
-      refused: "That code did not work — it may be wrong, expired or already used. Ask for a new one with /dashboard.",
+      hint: "Send /web to your AgEnD bot, or run “agend web --code” on the host. A code works once and expires in 5 minutes.",
+      refused: "That code did not work — it may be wrong, expired or already used. Ask for a new one with /web.",
       paused: "Too many wrong codes — sign-in is paused for a few minutes.",
       network: "Could not reach AgEnD. Check the connection and try again.",
       resend: "Send me a new code", resent: "A new code was sent to you privately in chat. Enter it above.",
       resend_wait: "A code was asked for a moment ago — wait a little and try again.",
-      resend_refused: "A new code could not be sent. Ask for one with /dashboard.",
+      resend_refused: "A new code could not be sent. Ask for one with /web.",
     },
     "zh-TW": {
       checking: "正在確認登入狀態…", title: "登入 AgEnD", lead: "請輸入聊天頻道給你的一次性登入碼。",
       label: "一次性登入碼", submit: "登入", working: "登入中…",
-      hint: "在 AgEnD bot 傳 /dashboard，或在主機執行「agend web --code」。登入碼只能用一次，5 分鐘內有效。",
-      refused: "登入碼無效：可能輸入錯誤、已過期或已使用。請用 /dashboard 再要一個。",
+      hint: "在 AgEnD bot 傳 /web，或在主機執行「agend web --code」。登入碼只能用一次，5 分鐘內有效。",
+      refused: "登入碼無效：可能輸入錯誤、已過期或已使用。請用 /web 再要一個。",
       paused: "錯誤次數過多，登入暫停幾分鐘。",
       network: "連不上 AgEnD，請檢查連線後再試。",
       resend: "傳一組新的登入碼給我", resent: "新的登入碼已私訊給你，請在上方輸入。",
       resend_wait: "剛剛才要過登入碼，請稍候再試。",
-      resend_refused: "無法傳送新的登入碼。請用 /dashboard 再要一個。",
+      resend_refused: "無法傳送新的登入碼。請用 /web 再要一個。",
     },
   };
   const lang = /^zh/i.test(navigator.language || "") ? "zh-TW" : "en";

package/dist/ui/shared/theme.js

@@ -1,29 +1,61 @@
 // Light / dark for a panel (#1307). Loaded from /assets/theme.js in <head>, before the page paints, so a chosen theme
 // never flashes the other one first. "system" (the default) follows the device's prefers-color-scheme through CSS;
-// "light" or "dark" is this browser's own choice and lives in localStorage, like agend_lang.
+// "light" or "dark" lives in localStorage, like agend_lang.
+//
+// #1665: the choice is kept on the host and follows the person between devices. The signed-in app's page carries the
+// host's values in <html data-prefs>: the host's theme is what this page paints and holds, whatever this browser's
+// storage does (the copy kept there is best effort — a full or blocked storage changes nothing on screen). Nothing
+// chosen on the host: a device already in step with it (app-prefs.js's migration done) takes the default; one not yet
+// in step keeps its own until it has uploaded it. Without data-prefs (the sign-in page, the anonymous View reader) this
+// browser's copy decides, as before.
 //
 // A page's tokens follow the pattern: dark under :root, light under @media (prefers-color-scheme: light) for
 // :root:not([data-theme="dark"]), and again under :root[data-theme="light"].
 (function () {
   "use strict";
   var KEY = "agend_theme";
+  var SYNCED_FLAG = "agend_prefs_synced";
   function valid(v) { return v === "light" || v === "dark" ? v : "system"; }
   function read() {
     try { return valid(localStorage.getItem(KEY)); } catch (e) { return "system"; }   // storage blocked: follow the device
   }
+  function cache(v) {
+    try { if (v === "system") localStorage.removeItem(KEY); else localStorage.setItem(KEY, v); } catch (e) { /* this page only */ }
+  }
   function apply(v) {
     var root = document.documentElement;
     if (v === "system") root.removeAttribute("data-theme");
     else root.setAttribute("data-theme", v);
   }
-  apply(read());
+  /** The host's choice for this page: a theme, or null — none known here (no data-prefs, or not in step yet). */
+  function hostChoice() {
+    var d = null;
+    try { d = JSON.parse(document.documentElement.getAttribute("data-prefs") || "null"); } catch (e) { d = null; }
+    if (!d || typeof d !== "object" || !d.values || typeof d.values !== "object") return null;
+    var v = d.values.theme;
+    if (v === "light" || v === "dark" || v === "system") return v;
+    var inStep = false;
+    try { inStep = localStorage.getItem(SYNCED_FLAG) === "1"; } catch (e) { inStep = false; }
+    return inStep ? "system" : null;
+  }
+  var current = hostChoice();
+  if (current !== null) cache(current); else current = read();
+  apply(current);
+  var listeners = [];
   window.AgendTheme = {
-    get: read,
-    /** Choose "system", "light" or "dark" for this browser; applied now even when it cannot be stored. */
+    /** The theme this page shows. */
+    get: function () { return current; },
+    /** Choose "system", "light" or "dark" (this browser's copy; app-prefs.js keeps the host's); applied now even when it cannot be stored. */
     set: function (v) {
-      v = valid(v);
-      try { if (v === "system") localStorage.removeItem(KEY); else localStorage.setItem(KEY, v); } catch (e) { /* this page only */ }
-      apply(v);
+      current = valid(v);
+      cache(current);
+      apply(current);
+      for (var i = 0; i < listeners.length; i++) { try { listeners[i](current); } catch (e) { /* one listener's error stops no other */ } }
+    },
+    /** Call `fn` with the theme whenever it changes on this page (an open Preferences shows it); returns the unsubscribe. */
+    onChange: function (fn) {
+      listeners.push(fn);
+      return function () { var i = listeners.indexOf(fn); if (i >= 0) listeners.splice(i, 1); };
     },
   };
 })();

package/dist/ui/shared/ui-icons.js

@@ -37,6 +37,7 @@ const P = {
   type: () => html`<path d="M4 7V5h16v2M9 19h6M12 5v14"/>`,
   chart: () => html`<path d="M3 20h18M6 16v-4M11 16V8M16 16v-6"/>`,
   up: () => html`<path d="M12 19V5M5 12l7-7 7 7"/>`,
+  star: () => html`<path d="M12 2.5l2.94 5.96 6.56.95-4.75 4.63 1.12 6.54L12 17.5l-5.87 3.08 1.12-6.54L2.5 9.41l6.56-.95L12 2.5z"/>`,
   eye: () => html`<path d="M1 12s4-8 11-8 11 8 11 8-4 8-11 8-11-8-11-8z"/><circle cx="12" cy="12" r="3"/>`,
   check: () => html`<path d="M20 6L9 17l-5-5"/>`,
   inbox: () => html`<path d="M22 12h-6l-2 3h-4l-2-3H2"/><path d="M5.45 5.11L2 12v6a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2v-6l-3.45-6.89A2 2 0 0 0 16.76 4H7.24a2 2 0 0 0-1.79 1.11z"/>`,

package/dist/ui/shared/usage-dialog.js

@@ -1,5 +1,6 @@
 // #1523 N3 (§3.4): the AI usage dialog, opened from every page's header (◔). Moved from panel-view.js. Public
 // (/assets/): View's anonymous reader opens it too. It reads /api/ai-usage every 60 s while open (passive, #1374).
+// #1673: its body (UsageBody) is also the wide screen's right rail (header-tools.js UsageRail) — one read, one view.
 import { html, useEffect, useLayoutEffect, useMemo, useRef, useState } from "./app-html.js";
 import { t } from "./app-i18n.js";
 import { useLease } from "./app-ctx.js";
@@ -73,9 +74,12 @@ export function updatedAgo(fetchedAt, now = Date.now()) {
   return tn("usageUpdatedAgo", { age: min < 60 ? tn("usageMinutes", { n: min }) : tn("usageHours", { n: Math.floor(min / 60) }) });
 }
 
-/** `owner`: the navigation that opened it — its reads and the minute's timer live and end with it. */
-export function UsageDialog({ onClose, owner = "" }) {
-  const lease = useLease(`usage-dialog:${owner}`);
+/**
+ * The usage read and its rows: the dialog's body and the rail's (#1673). `owner`: its lease's key — the reads and the
+ * minute's timer live and end with it.
+ */
+export function UsageBody({ owner }) {
+  const lease = useLease(owner);
   const [data, setData] = useState(undefined);       // undefined: loading; null: failed
   const [order, setOrder] = useState(() => { try { const a = JSON.parse(stored(USAGE_ORDER_KEY) || "[]"); return Array.isArray(a) ? a.filter((x) => typeof x === "string") : []; } catch { return []; } });
   const reads = useMemo(() => readStream(lease), [lease]);
@@ -136,5 +140,10 @@ export function UsageDialog({ onClose, owner = "" }) {
       <div class="u-foot"><span class="note" title=${new Date(data.fetchedAt).toLocaleString()}>${updatedAgo(data.fetchedAt)}${data.refreshing ? html` · <span class="u-refreshing">${tn("usageRefreshing")}</span>` : null}</span>
         <button type="button" class="btn btn-sm" onClick=${() => load(true)}>${tn("usageRefresh")}</button></div>`;
   }
-  return html`<${Dialog} title=${tn("usage.title")} onClose=${onClose} wide=${true}>${content}</${Dialog}>`;
+  return content;
+}
+
+/** `owner`: the navigation that opened it — its reads and the minute's timer live and end with it. */
+export function UsageDialog({ onClose, owner = "" }) {
+  return html`<${Dialog} title=${tn("usage.title")} onClose=${onClose} wide=${true}><${UsageBody} owner=${`usage-dialog:${owner}`} /></${Dialog}>`;
 }

package/dist/ui/shared/view-strings.js

@@ -18,7 +18,7 @@ register("view", {
   "displayName": "Display name",
   "role": "Role",
   "description": "Description",
-  "saveHint": "Saving needs a signed-in session. Send /dashboard to your AgEnD bot for a sign-in code.",
+  "saveHint": "Saving needs a signed-in session. Send /web to your AgEnD bot for a sign-in code.",
   "helpTitle": "📖 Help",
   "help1": "Pick an instance in the list: its live terminal shows here.",
   "help2": "Click a group's name to fold it or open it again.",
@@ -164,7 +164,16 @@ register("view", {
   "profileTitle": "Edit {name}'s profile",
   "avatar": "Avatar",
   "collapseProfile": "Hide the profile",
-  "instancesLabel": "Instances"
+  "instancesLabel": "Instances",
+  "favorites": "Favorites",
+  "favAdd": "Add {name} to favorites",
+  "favRemove": "Remove {name} from favorites",
+  "favEdit": "Edit",
+  "favDone": "Done",
+  "favUp": "Move {name} up",
+  "favDown": "Move {name} down",
+  "favFull": "Favorites are full ({max})",
+  "favFiltered": "Clear the filter to reorder favorites"
  },
  "zh-TW": {
   "editProfile": "編輯個人資料",
@@ -180,7 +189,7 @@ register("view", {
   "displayName": "顯示名稱",
   "role": "角色",
   "description": "描述",
-  "saveHint": "儲存需要已登入的 session。請在 AgEnD bot 傳 /dashboard 取得登入碼。",
+  "saveHint": "儲存需要已登入的 session。請在 AgEnD bot 傳 /web 取得登入碼。",
   "helpTitle": "📖 使用說明",
   "help1": "在清單裡選一個 instance：它的即時終端畫面會顯示在這裡。",
   "help2": "點群組名稱可以收合或展開。",
@@ -326,6 +335,15 @@ register("view", {
   "profileTitle": "編輯 {name} 的個人資料",
   "avatar": "頭像",
   "collapseProfile": "隱藏個人資料",
-  "instancesLabel": "Instances"
+  "instancesLabel": "Instances",
+  "favorites": "最愛",
+  "favAdd": "把 {name} 加入最愛",
+  "favRemove": "把 {name} 從最愛移除",
+  "favEdit": "編輯",
+  "favDone": "完成",
+  "favUp": "把 {name} 上移",
+  "favDown": "把 {name} 下移",
+  "favFull": "最愛已滿（{max} 個）",
+  "favFiltered": "清除篩選後才能調整最愛順序"
  }
 });