@songsid/agend 2.3.0-beta.2 → 2.3.0-beta.20

package/dist/ui/chat-msg-actions.js

@@ -0,0 +1,176 @@
+// #2272: a chat message's own actions, beyond the hover strip — the message menu (right-click, long-press on a phone),
+// swipe left to reply (as in Telegram), and R on a focused message. One install per thread element.
+//
+// - Right-click on a message opens Reply / Copy text / Copy link. Shift+right-click, a right-click with text selected,
+//   or one on a link, an image or a field keeps the browser's own menu.
+// - A long press (500 ms without moving) opens the same menu; the click and the browser menu it would also cause are
+//   swallowed.
+// - Swipe left on a message: it follows the finger (up to 64 px); let go past 56 px and it is a reply. A mostly
+//   vertical move is scrolling, never a reply. A swipe right is the phone drawer's (app-swipe.js), on a message too: the
+//   two never fight.
+// - R (no modifier) on a focused message replies; ↑/↓ move to the message before or after (one message is in the Tab
+//   order); Escape closes the menu.
+
+const LONG_PRESS_MS = 500, MOVE_TOLERANCE = 10, SWIPE_REPLY_PX = 56, SWIPE_MAX_PX = 64;
+
+/** The message element an event is on (a person's or an agent's message of this thread), or null. */
+function messageEl(list, target) {
+  const el = target && target.closest ? target.closest(".msg[data-key]") : null;
+  return el && list.contains(el) ? el : null;
+}
+/** The browser's own menu stays for: Shift, selected text, a link, an image, a field, code. */
+function keepsNativeMenu(e, doc) {
+  if (e.shiftKey) return true;
+  const sel = doc.getSelection ? doc.getSelection() : null;
+  if (sel && !sel.isCollapsed && String(sel).trim()) return true;
+  return !!(e.target && e.target.closest && e.target.closest("a[href], img, video, input, textarea, select, pre, code, [contenteditable='true']"));
+}
+
+/**
+ * Install the gestures on `list` (the thread element). `deps`:
+ *   messageOf(key) → the row; reply(row); copyText(text) → Promise<boolean>; linkOf(row) → string; notice(text);
+ *   canReply() → boolean (false: no Reply — a page that cannot send); t(key).
+ * Returns a function that removes everything (and closes an open menu).
+ */
+export function installMessageActions(list, deps) {
+  const doc = list.ownerDocument, win = doc.defaultView;
+  let menu = null, press = null, swipe = null, swallowClick = false;
+
+  function closeMenu() {
+    if (!menu) return;
+    menu.remove(); menu = null;
+    doc.removeEventListener("pointerdown", outside, true);
+    doc.removeEventListener("keydown", onMenuKey, true);
+    win?.removeEventListener("scroll", closeMenu, true);
+    win?.removeEventListener("blur", closeMenu);
+  }
+  function outside(e) { if (menu && !menu.contains(e.target)) closeMenu(); }
+  function onMenuKey(e) {
+    if (!menu) return;
+    if (e.key === "Escape") { e.preventDefault(); e.stopPropagation(); closeMenu(); return; }
+    if (e.key === "ArrowDown" || e.key === "ArrowUp") {
+      e.preventDefault();
+      const items = [...menu.querySelectorAll("button")], i = items.indexOf(doc.activeElement);
+      items[(i + (e.key === "ArrowDown" ? 1 : items.length - 1)) % items.length]?.focus();
+    }
+  }
+  /** The message menu at (x, y), within the window; focus on its first item. */
+  function openMenu(row, x, y) {
+    closeMenu();
+    const items = [];
+    if (deps.canReply?.() !== false) items.push(["reply", deps.t("chat.reply"), () => deps.reply(row)]);
+    items.push(["copyText", deps.t("chat.copyText"), async () => { const ok = await deps.copyText(String(row.click?.label ?? row.text ?? "")); deps.notice(deps.t(ok ? "chat.copied" : "chat.copyFailed"), ok); }]);
+    items.push(["copyLink", deps.t("chat.copyLink"), async () => { const ok = await deps.copyText(deps.linkOf(row)); deps.notice(deps.t(ok ? "chat.copied" : "chat.copyFailed"), ok); }]);
+    menu = doc.createElement("div");
+    menu.className = "msg-menu";
+    menu.setAttribute("role", "menu");
+    menu.setAttribute("aria-label", deps.t("chat.msgMenu"));
+    menu.setAttribute("data-trust", "menu");
+    for (const [id, label, run] of items) {
+      const b = doc.createElement("button");
+      b.type = "button"; b.className = "menu-item"; b.setAttribute("role", "menuitem"); b.dataset.item = id; b.textContent = label;
+      b.addEventListener("click", () => { closeMenu(); void run(); });
+      menu.append(b);
+    }
+    doc.body.append(menu);
+    const w = win?.innerWidth ?? 1024, h = win?.innerHeight ?? 768, r = menu.getBoundingClientRect();
+    menu.style.left = `${Math.max(4, Math.min(x, w - r.width - 4))}px`;
+    menu.style.top = `${Math.max(4, Math.min(y, h - r.height - 4))}px`;
+    doc.addEventListener("pointerdown", outside, true);
+    doc.addEventListener("keydown", onMenuKey, true);
+    win?.addEventListener("scroll", closeMenu, true);
+    win?.addEventListener("blur", closeMenu);
+    menu.querySelector("button")?.focus();
+  }
+
+  function onContextMenu(e) {
+    if (swallowClick) { e.preventDefault(); return; }               // the long press already opened ours
+    cancelPress();                                                   // Android's long press fires this itself: one menu
+    const el = messageEl(list, e.target);
+    if (!el || keepsNativeMenu(e, doc)) return;
+    const row = deps.messageOf(el.dataset.key);
+    if (!row) return;
+    e.preventDefault();
+    openMenu(row, e.clientX, e.clientY);
+  }
+  function onKeyDown(e) {
+    // ↑/↓ on a focused message: the one before or after it (one message is in the Tab order: the thread's rove()).
+    if ((e.key === "ArrowUp" || e.key === "ArrowDown") && !e.altKey && !e.ctrlKey && !e.metaKey && !e.shiftKey
+      && e.target && e.target.matches && e.target.matches(".msg[data-key]") && list.contains(e.target)) {
+      const all = [...list.querySelectorAll(".msg[data-key]")], i = all.indexOf(e.target);
+      const to = all[i + (e.key === "ArrowDown" ? 1 : -1)];
+      if (to) { e.preventDefault(); deps.rove?.(to.dataset.key); to.focus(); to.scrollIntoView?.({ block: "nearest" }); }
+      return;
+    }
+    if (e.key !== "r" && e.key !== "R") return;
+    if (e.ctrlKey || e.metaKey || e.altKey || deps.canReply?.() === false) return;
+    const el = e.target && e.target.matches && e.target.matches(".msg[data-key]") && list.contains(e.target) ? e.target : null;
+    const row = el ? deps.messageOf(el.dataset.key) : null;
+    if (!row) return;
+    e.preventDefault();
+    deps.reply(row);
+  }
+
+  function onTouchStart(e) {
+    if (e.touches.length !== 1) { cancelPress(); cancelSwipe(); return; }
+    const el = messageEl(list, e.target);
+    if (!el) return;
+    const t0 = e.touches[0];
+    const native = keepsNativeMenu({ target: e.target, shiftKey: false }, doc);   // a link, an image, code: the browser's
+    press = native ? null : { el, x: t0.clientX, y: t0.clientY, timer: setTimeout(() => {
+      const row = deps.messageOf(el.dataset.key);
+      press = null; cancelSwipe();
+      if (!row) return;
+      swallowClick = true; setTimeout(() => { swallowClick = false; }, 700);
+      openMenu(row, t0.clientX, t0.clientY);
+    }, LONG_PRESS_MS) };
+    swipe = deps.canReply?.() === false || native ? null : { el, x: t0.clientX, y: t0.clientY, dx: 0, locked: null };
+  }
+  function onTouchMove(e) {
+    const p = e.touches[0];
+    if (press && (Math.abs(p.clientX - press.x) > MOVE_TOLERANCE || Math.abs(p.clientY - press.y) > MOVE_TOLERANCE)) cancelPress();
+    if (!swipe) return;
+    const dx = p.clientX - swipe.x, dy = p.clientY - swipe.y;
+    if (swipe.locked === null && (Math.abs(dx) > MOVE_TOLERANCE || Math.abs(dy) > MOVE_TOLERANCE)) swipe.locked = dx < 0 && Math.abs(dy) < -dx / 2 ? "x" : "no";
+    if (swipe.locked !== "x") return;
+    swipe.dx = Math.max(0, Math.min(-dx, SWIPE_MAX_PX));               // how far left, as a positive distance
+    swipe.el.style.transform = `translateX(${-swipe.dx}px)`;
+    swipe.el.classList.toggle("swipe-ready", swipe.dx >= SWIPE_REPLY_PX);
+  }
+  function onTouchEnd() {
+    cancelPress();
+    if (!swipe) return;
+    const { el, dx, locked } = swipe;
+    cancelSwipe();
+    if (locked === "x" && dx >= SWIPE_REPLY_PX) { const row = deps.messageOf(el.dataset.key); if (row) deps.reply(row); }
+  }
+  function cancelPress() { if (press) { clearTimeout(press.timer); press = null; } }
+  function cancelSwipe() {
+    if (!swipe) return;
+    swipe.el.style.transform = ""; swipe.el.classList.remove("swipe-ready");
+    swipe = null;
+  }
+  function onClickCapture(e) { if (swallowClick) { e.preventDefault(); e.stopPropagation(); } }
+
+  // A message focused by a click or a tap becomes the one Tab comes back to.
+  function onFocusIn(e) { const el = e.target && e.target.matches && e.target.matches(".msg[data-key]") ? e.target : null; if (el && list.contains(el)) deps.rove?.(el.dataset.key); }
+  list.addEventListener("focusin", onFocusIn);
+  list.addEventListener("contextmenu", onContextMenu);
+  list.addEventListener("keydown", onKeyDown);
+  list.addEventListener("touchstart", onTouchStart, { passive: true });
+  list.addEventListener("touchmove", onTouchMove, { passive: true });
+  list.addEventListener("touchend", onTouchEnd, { passive: true });
+  list.addEventListener("touchcancel", onTouchEnd, { passive: true });
+  list.addEventListener("click", onClickCapture, true);
+  return () => {
+    closeMenu(); cancelPress(); cancelSwipe();
+    list.removeEventListener("focusin", onFocusIn);
+    list.removeEventListener("contextmenu", onContextMenu);
+    list.removeEventListener("keydown", onKeyDown);
+    list.removeEventListener("touchstart", onTouchStart);
+    list.removeEventListener("touchmove", onTouchMove);
+    list.removeEventListener("touchend", onTouchEnd);
+    list.removeEventListener("touchcancel", onTouchEnd);
+    list.removeEventListener("click", onClickCapture, true);
+  };
+}

package/dist/ui/chat-render.js

@@ -53,11 +53,14 @@
 
   // #1630: a Discord server emoji, `<:name:id>` / `<a:name:id>` — escaped by now — drawn as its picture. Only an id the
   // page knows (the fleet's servers: /ui/emojis) and only from the dashboard's own route; the src is built from the
-  // matched digits, the name (word characters only) goes into alt/title. An unknown id stays the literal text.
+  // matched digits, the name (word characters only) goes into alt/title. Any other — an id the page does not know, or
+  // before the list has come — reads `:name:` (never the raw markup); so does a picture that does not load
+  // (chat-thread.js swaps it: an <img> sized to an emoji showed an empty box, the user's "tofu").
   var EMOJI_RE = /&lt;(a?):([A-Za-z0-9_]{2,32}):(\d{15,25})&gt;/g;
   function emojiImg(id, name) {
     return '<img class="emoji" src="/ui/img/emoji/' + id + '" alt=":' + name + ':" title=":' + name + ':" decoding="async">';
   }
+  function emojiText(name) { return '<span class="emoji-text" title=":' + name + ':">:' + name + ':</span>'; }
 
   // #1682: Discord mentions — `<@id>` / `<@!id>` (a user), `<@&id>` (a role), `<#id>` (a channel) — escaped by now (the
   // role's & too), drawn as a pill: the name the page knows (store.mentions(kind, id), inserted escaped), else @user /
@@ -82,7 +85,7 @@
     // path held its whole column wide.
     s = s.replace(/`([^`\n]+)`/g, function (_m, code) { return stash(store, "<code>" + (store.inCell ? code.replace(/\//g, "/<wbr>") : code) + "</code>"); });
     var known = store.emojis;
-    if (known) s = s.replace(EMOJI_RE, function (m, _a, name, id) { return known(id) ? stash(store, emojiImg(id, name)) : m; });
+    s = s.replace(EMOJI_RE, function (_m, _a, name, id) { return stash(store, known && known(id) ? emojiImg(id, name) : emojiText(name)); });
     var names = store.mentions;
     s = s.replace(MENTION_RE, function (_m, sigil, id) {
       var kind = MENTION_KIND[sigil];
@@ -577,6 +580,21 @@
    * With { htmlCards: true } (a server-marked agent reply, as for renderMarkdown) each .html/.htm file also gets an
    * empty card placeholder <div class="html-card" data-att="<id>"> after the list — the id is 32 hex, nothing else.
    */
+  // The box a photo is drawn in (app.css: .msg .att-img img, max 260 × 220): its own size, scaled down to fit.
+  var PHOTO_MAX_W = 260, PHOTO_MAX_H = 220;
+  /**
+   * #2184: a photo's drawn size as width/height attributes, from the size the server read from its headers: the box is there
+   * before the picture loads, so the text around it never moves when it does (a chat opened cold jittered, as each
+   * photo grew from nothing). Nothing when the size is not known (drawn as before).
+   */
+  function photoBox(a) {
+    var w = a.width, h = a.height;
+    var ok = function (v) { return typeof v === "number" && v >= 1 && v <= 65535 && Math.floor(v) === v; };
+    if (!ok(w) || !ok(h)) return "";
+    var k = Math.min(1, PHOTO_MAX_W / w, PHOTO_MAX_H / h);
+    return ' width="' + Math.max(1, Math.round(w * k)) + '" height="' + Math.max(1, Math.round(h * k)) + '"';
+  }
+
   function attachmentsHtml(attachments, opts) {
     if (!Array.isArray(attachments)) return "";
     var cards = !!(opts && opts.htmlCards);
@@ -599,7 +617,7 @@
       else if (kind) after.push('<div class="text-card" data-att="' + a.id + '" data-type="' + kind + '"></div>');
       var name = escapeHtml(a.name || "file");
       if (a.kind === "photo") {
-        out.push('<a class="att-img" href="' + url + '" target="_blank" rel="noopener noreferrer"><img src="' + url + '" alt="' + name + '" loading="lazy"></a>');
+        out.push('<a class="att-img" href="' + url + '" target="_blank" rel="noopener noreferrer"><img src="' + url + '" alt="' + name + '"' + photoBox(a) + ' loading="lazy"></a>');
       } else {
         out.push('<a class="att-file" href="' + url + '" download="' + name + '">📎 ' + name + ' <span class="att-size">' + escapeHtml(formatSize(a.size)) + "</span></a>");
       }

package/dist/ui/chat-store.js

@@ -42,7 +42,7 @@ const COMPACT_PAGE_LIMIT_MS = 11 * 60_000;
 /** Build a store. `deps` (fetch, toast, announce, t, now) are injected so tests can drive every path. */
 export function createChatStore(deps) {
   const s = {
-    msgs: {}, drafts: {}, failedSends: {}, pendingFiles: {}, sending: {}, inFlightFiles: {},
+    msgs: {}, drafts: {}, replies: {}, failedSends: {}, pendingFiles: {}, sending: {}, inFlightFiles: {}, sendFailures: {}, instanceStatus: {}, waking: {},
     prompts: {}, workingSince: {}, stopping: {}, cancelling: {}, scrollMemo: {}, historyRead: new Set(), rbBusy: new Set(),
     pollMine: readPollMine(),
     // #1823 (#1828 review): the server's clock minus this device's. A poll's deadline is the server's; a page whose clock
@@ -61,9 +61,10 @@ export function createChatStore(deps) {
 
   /** Tell subscribers what changed: `kind` "msgs" (the thread redraws) or "state" (everything else). */
   function changed(instance, kind = "state") { for (const fn of [...subs]) fn(instance, kind); }
-  async function api(method, path, body) {
+  async function api(method, path, body, signal) {
     const o = { method, headers: { "Content-Type": "application/json" } };
     if (body) o.body = JSON.stringify(body);
+    if (signal) o.signal = signal;
     const r = await deps.fetch(path, o);
     return r.json();
   }
@@ -82,6 +83,7 @@ export function createChatStore(deps) {
   function applyStatus(d) {
     if (!d || !Array.isArray(d.instances)) return;
     for (const i of d.instances) {
+      s.instanceStatus[i.name] = i.status;
       noteExec(i.name, (i.execution_state !== undefined ? i.execution_state : i.state) ?? null);
       const waits = i.state === "awaiting_input" ? (typeof i.interaction_summary === "string" ? i.interaction_summary : "") : null;
       if (i.name === s.current && waits != null && s.awaiting[i.name] == null) deps.announce(tf("chat.awaiting", i.name));
@@ -142,12 +144,17 @@ export function createChatStore(deps) {
     if (!r || !r.answered) deps.toast(r && r.error ? r.error : t("chat.disconnected"), false);
   }
 
-  /** Read an instance's history once per page (the first time a person opens its chat). */
-  async function openHistory(name, lease) {
-    if (s.historyRead.has(name)) return false;
+  /**
+   * Read an instance's history once per page (the first time a person opens its chat). #2188: `signal` — the chat was
+   * left before the answer came (clicking down the sidebar): the read is aborted, nothing is merged, and the next visit
+   * reads again.
+   */
+  async function openHistory(name, lease, signal) {
+    if (s.historyRead.has(name) || signal?.aborted) return false;
     s.historyRead.add(name);
     try {
-      const r = await api("GET", `/ui/history?instance=${encodeURIComponent(name)}&limit=200`);
+      const r = await api("GET", `/ui/history?instance=${encodeURIComponent(name)}&limit=200`, undefined, signal);
+      if (signal?.aborted) { s.historyRead.delete(name); return false; }
       if (!r || !Array.isArray(r.messages)) { s.historyRead.delete(name); return true; }
       // Kept even when the person has moved on: the store is page-lived, and the answer belongs to `name`.
       for (const m of r.messages) liveReplies.message(m);
@@ -243,9 +250,12 @@ export function createChatStore(deps) {
   }
   async function send(target) {
     const txt = (s.drafts[target] || "").trim();
+    const quote = s.replies[target];         // #2272: the message this one replies to (its row; the server reads the rest)
     const files = (s.pendingFiles[target] || []).slice();
     if ((!txt && !files.length) || !target || s.sending[target]) return;
     s.sending[target] = true;
+    s.waking[target] = s.instanceStatus[target] === "paused";
+    delete s.sendFailures[target];
     s.drafts[target] = "";
     s.pendingFiles[target] = []; s.inFlightFiles[target] = files;
     changed(target);
@@ -254,20 +264,37 @@ export function createChatStore(deps) {
     try {
       const ids = [];
       for (const f of files) ids.push((await uploadFile(target, f)).id);
-      r = await api("POST", "/ui/send", ids.length ? { instance: target, message: txt, attachments: ids } : { instance: target, message: txt });
+      const body = ids.length ? { instance: target, message: txt, attachments: ids } : { instance: target, message: txt };
+      if (quote) body.replyTo = { boot: quote.boot, id: quote.id };
+      r = await api("POST", "/ui/send", body);
     } catch (err) { r = { error: err && err.message ? err.message : t("chat.disconnected") }; }
     s.sending[target] = false;
+    delete s.waking[target];
     delete s.inFlightFiles[target];
-    if (r && !r.error) { changed(target); return; }
+    if (r && !r.error) { if (s.replies[target] === quote) delete s.replies[target]; changed(target); return; }
+    // #2272: the quoted message is gone: the reply goes, the text and files stay (sent again without it, or re-aimed).
+    if (r && r.reason === "reply_gone" && s.replies[target] === quote) delete s.replies[target];
     if (files.length) s.pendingFiles[target] = R().checkFiles(files, s.pendingFiles[target] || []).kept;
     if (txt) {
       const shown = s.current === target;
       if (R().settleFailedSend(target, s.current, shown, shown ? (s.drafts[target] || "") : "") === "restore") s.drafts[target] = txt;
       else s.failedSends[target] = s.failedSends[target] ? `${s.failedSends[target]}\n${txt}` : txt;
     }
+    const why = r && r.reason;
+    const key = typeof why === "string" ? `chat.sendFailure_${why}` : "";
+    const localized = key ? t(key) : "";
+    const error = localized && localized !== key ? localized : (r && r.error ? r.error : t("chat.disconnected"));
+    s.sendFailures[target] = { error, text: txt, files };
     changed(target);
-    deps.toast(r && r.error ? r.error : t("chat.disconnected"), false);
+    deps.toast(error, false);
   }
+  function canRetrySend(target) {
+    const failed = s.sendFailures[target], files = s.pendingFiles[target] || [];
+    return !!failed && !s.sending[target] && !s.failedSends[target]
+      && (s.drafts[target] || "").trim() === failed.text
+      && files.length === failed.files.length && files.every((f, i) => f === failed.files[i]);
+  }
+  function retrySend(target) { if (canRetrySend(target)) return send(target); }
   function addFiles(target, list) {
     if (!target) return;
     const inFlight = s.inFlightFiles[target] || [];
@@ -307,8 +334,32 @@ export function createChatStore(deps) {
     changed(target);
   }
   function discardFailed(target) { delete s.failedSends[target]; changed(target); }
-  /** Typing: kept for its chat, no redraw (the composer already shows it). */
-  function setDraft(target, value) { s.drafts[target] = value; }
+  /** Typing stays local, except a failed send's Retry button must follow edits too. */
+  function setDraft(target, value) { s.drafts[target] = value; if (s.sendFailures[target]) changed(target); }
+  /**
+   * #2272: reply to a message of this chat — what the bar above the composer shows (its sender and first words); only
+   * its row is sent. One at a time per chat: a new one replaces it.
+   */
+  function startReply(target, m) {
+    if (!target || !m || typeof m.boot !== "string" || typeof m.id !== "number") return;
+    s.replies[target] = { boot: m.boot, id: m.id, sender: String(m.sender || ""), text: String(m.click?.label ?? m.text ?? "").replace(/\s+/g, " ").trim().slice(0, 160),
+      media: (m.attachments || []).length ? ((m.attachments || []).some(a => a.kind === "photo") ? "photo" : "document") : undefined };
+    changed(target);
+  }
+  function clearReply(target) { if (s.replies[target]) { delete s.replies[target]; changed(target); } }
+  /**
+   * #2272: the quoted message, drawn for a jump: in what this chat holds, or after reading the longest history the
+   * server keeps for it (the newest 500). false: no longer kept.
+   */
+  async function findQuoted(name, key) {
+    const has = () => (s.msgs[name] || []).some(m => `${m.boot}-${m.id}` === key);
+    if (has()) return true;
+    try {
+      const r = await api("GET", `/ui/history?instance=${encodeURIComponent(name)}&limit=500`);
+      if (r && Array.isArray(r.messages)) { s.msgs[name] = R().mergeMessages(s.msgs[name], r.messages, 500); changed(name, "msgs"); }
+    } catch { /* the jump says it is not there */ }
+    return has();
+  }
 
   // ── Stop the reply under way (the composer's Stop, or Esc). Set before the request goes, so a held Esc or a second
   // click sends nothing more (#1317); "Stopping…" until the agent goes idle, or a minute passes.
@@ -402,7 +453,8 @@ export function createChatStore(deps) {
     attach, applyStatus, applyActivity, ingest, applyDeliveries, openHistory,
     onPrompt, applyPrompts, resolvePrompt, answerPrompt, answerByNonce, holdPrompt, releasePrompt, promptsFor,
     applyReplyButtons, clickReplyButton,
-    uploadFile, send, addFiles, removeFile, attachPastedText, fileBackAsText, isPasted, putBack, discardFailed, setDraft,
+    uploadFile, send, canRetrySend, retrySend, addFiles, removeFile, attachPastedText, fileBackAsText, isPasted, putBack, discardFailed, setDraft,
+    startReply, clearReply, findQuoted,
     cancelReply, isUser, runCommand, dismissCommand, commandFree,
   };
 }

package/dist/ui/chat-strings.js

@@ -3,14 +3,42 @@ import { register } from "/assets/app-i18n.js";
 
 register("chat", {
   en: {
-    effectTrial: "Effect trial", effectTrialLocal: "Try requires a local admin, enabled previews and custom CSS off.",
-    effectTrialStart: "Try", effectTrialExpired: "This trial offer has expired.", effectTrialUnavailable: "Trial unavailable: access or playback settings may have changed.",
+    waking: "Waking {0}…", retrySend: "Retry send",
+    sendFailure_wake_capacity: "No slot is free to wake this instance. Retry when another instance is idle.",
+    sendFailure_wake_credentials: "The instance could not sign in. Check its account on the host, then retry.",
+    sendFailure_wake_timeout: "The instance did not become ready in time. Retry, or check its status on the host.",
+    sendFailure_instance_stopped: "This instance was stopped or removed. Start it on the host before retrying.",
+    sendFailure_delivery_unavailable: "The instance could not receive this message. Check its status on the host, then retry.",
+    sendFailure_delivery_changed: "The session or instance changed before this message was sent. Sign in again if needed, then retry.",
+    sendFailure_reply_gone: "The message you replied to is no longer in this chat. Your text is still here: send it without the reply, or reply to another message.",
+    reply: "Reply", replyingTo: "Replying to {0}", replyCancel: "Cancel the reply (Esc)", replyHidden: "an earlier message", replyPhoto: "[Photo]", replyFile: "[File]",
+    replyGone: "That message is no longer in this chat.", replyJump: "Show the message this replies to", copyText: "Copy text", copyLink: "Copy link", msgMenu: "Message",
+
+    effectTrialReason_checking: "Checking this session…",
+    effectTrialReason_localAdmin: "Sign in as an admin outside the public link to Try.",
+    effectTrialReason_chatChanged: "Open the chat that offered this trial.",
+    effectTrialReason_busy: "Stop the current trial before starting another.",
+    effectTrialReason_safe: "Turn off safe mode to Try.",
+    effectTrialReason_effectsOff: "Turn on effects to Try.",
+    effectTrialReason_reducedMotion: "Effects follow this device’s reduced-motion setting.",
+    effectTrialReason_saveData: "Your device requests reduced data use.",
+    effectTrialReason_transport: "The isolated effect player is unavailable. Reload this page.",
+    effectTrialReason_unsupported: "Canvas Worker playback is unavailable in this browser.",
+    effectTrialReason_inactive: "Return to this page to Try.",
+    effectTrialReason_dialog: "Close the other menu or dialog to Try.",
+    effectTrialReason_expired: "This trial offer has expired.",
+    effectTrialSignIn: "Sign in here",
+    effectTrialStopOther: "Stop current trial",
+    effectTrialSettings: "Open playback settings",
+    effectTrialPlayMotion: "Play effects anyway",
+    effectTrial: "Effect trial", effectTrialLocal: "A sample on this page. Nothing is applied or saved.",
+    effectTrialStopped: "Try stopped", effectTrialStart: "Try", effectTrialExpired: "This trial offer has expired.", effectTrialUnavailable: "This trial is no longer available.",
     cmdConfirm: "Clear", cmdConfirmBackend: "Switch and restart", cmdRunning: "Running /{0}…", cmdNotCommand: "Not a command here — Enter sends it as a message.", cmdDismiss: "Dismiss", cmdCommands: "Commands",
     compactRunning: "Compacting…", compactDone: "✅ Conversation compacted", compactUnknown: "This backend does not report when compaction ends.",
     compactTimeout: "No sign that compaction finished within {0} minutes — check the agent's own chat.",
     compactLost: "Can't follow this compaction: the command did not reach the agent, or the agent stopped or changed backend.",
     compactNotCompacted: "kiro did not compact the conversation: it was too short, or the compaction was stopped.",
-    cmdChoose: "Choose", cmdCurrent: "current", chipCompact: "Compact", chipClear: "Clear…", chipContext: "Context {0}% used",
+    cmdChoose: "Choose", cmdCurrent: "current", cmdSignIn: "Sign in", cmdSignInTo: "Sign in to {0}", chipCompact: "Compact", chipClear: "Clear…", chipContext: "Context {0}% used",
     chipModel: "Model: {0} — choose another", chipEffort: "Effort: {0} — choose another",
     cmd_ctx: "Context use, model and effort", cmd_compact: "Compact the conversation", cmd_clear: "Clear the conversation (asks first)",
     cmd_model: "Show or switch the model", cmd_backend: "Switch the CLI backend, then model and effort (restarts)", cmd_effort: "Show or set the reasoning effort", cmd_cancel: "Stop the current reply",
@@ -25,7 +53,8 @@ register("chat", {
     a11yWorking: "{0} started working", a11yIdle: "{0} finished", a11yReplied: "{0} replied", conversationWith: "Conversation with {0}",
     stopping: "Stopping {0}…", awaiting: "{0} is waiting for your input", approxNote: "Read from the terminal, so approximate", elapsedTitle: "Time since this page saw it start (approximate)",
     dropHere: "Drop files to attach them", asText: "As text", pasteAttached: "A long paste ({0} characters) was attached as a text file", pasteKeptAsText: "No room for another attachment: the long paste stays as text",
-    send: "Send", composerPlaceholder: "Message {0}…", composerHint: "Enter to send · Shift+Enter for a new line", composerMore: "/ for commands · Esc stops the reply", attachTitle: "Attach files (any type — or paste / drop them)",
+    send: "Send", composerPlaceholder: "Message {0}…", composerHint: "Enter to send · Shift+Enter for a new line", composerMore: "/ for commands · Esc stops the reply", guestMore: "Esc stops the reply",
+    guestNote: "You're a guest: the agent sees your messages as a guest's (recognition only).", guestNoCommands: "Guests can't run commands — send it without the leading /.", attachTitle: "Attach files (any type — or paste / drop them)",
     pvPreview: "Preview", pvStop: "Stop", pvDownload: "Download", pvMenu: "Preview options", pvHtml: "HTML",
     pvAllowButton: "Allow previews", pvAllow: "Allow HTML previews — they may be able to send data out", pvDisallow: "Stop allowing HTML previews",
     pvConfirm: "Allow HTML previews?\n\nThis applies on every device where you are signed in. A preview runs the agent's HTML in an isolated frame. It cannot use your login, but it may be able to send data out, and it can slow or freeze this tab. You still click Preview each time.",
@@ -71,6 +100,8 @@ register("chat", {
     "pvFail_bad-address": "Cloudflare gave an address that could not be used",
     pvFail_unknown: "an unexpected error",
     pvServer_notOffered: "Previews are not available on this page.",
+    pvServer_listenFailed: "Previews are unavailable: the fleet could not open its preview port ({0}). Another program may be using it — set web.preview_port, then restart AgEnD.",
+    pvServer_notListening: "Previews are not available on this fleet right now.",
     previews: "Allow HTML previews",
     clicked: "Clicked:", clickShow: "Show the message these buttons were on",
     copy: "Copy", copyMessage: "Copy this reply", copied: "Copied", copyFailed: "Copy failed", wrap: "Wrap", showAll: "Show all {0} lines", showMore: "Show more", showLess: "Show less", jumpLatest: "Latest", newBelow: "{0} new",
@@ -94,21 +125,57 @@ register("chat", {
     dNoActivity: "No activity in the last hour.", dWorking: "Working…",
     // #1629: a person's control over an agent's own web theme.
     themeLock: "Lock theme", themeUnlock: "Unlock theme", themeReset: "Reset theme…", themeResetGo: "Reset",
+    pageColours: "Page colours", pageAgentOn: "The agent's choice (on)", pageAgentOff: "The agent's choice (off)", pageWhole: "On the whole page", pageChatOnly: "Only its chat",
     themeResetConfirm: "Reset {0}'s theme to the default? Its colours, picture and working label go; a lock stays.",
     themeResetDone: "{0}'s theme was reset.", themeLocked: "{0}'s theme is locked: the agent can't change it.", themeUnlocked: "{0}'s theme is unlocked.",
     themeFailed: "The theme was not changed ({0}).",
     widgetRemoveHeader: "Remove the chat header widget", widgetRemoveDetails: "Remove the Details widget", widgetRemoved: "{0}'s widget was removed.",
+    // #2117: an agent's ambient effect — why it is not showing here, and a person's Clear.
+    ambientBlocked_hidden: "Ambient effect hidden: agents' themes are off — turn them on",
+    ambientBlocked_safe: "Ambient effect hidden: safe mode (?safe=1) — leave safe mode",
+    ambientBlocked_reducedMotion: "Ambient effect hidden: this device follows reduced motion — play effects anyway",
+    ambientBlocked_unsupported: "Ambient effect hidden: this browser can't animate it",
+    ambientClearLoop: "Clear the ambient effect", ambientClearClick: "Clear the click effect", ambientCleared: "{0}'s ambient effect was cleared.",
+    ambientMotionNote: "Your system asks for reduced motion; effects are on.", ambientMotionNoteLink: "Turn off here", ambientMotionNoteClose: "Close",
     configured: "(configured)", fleetDefault: "(fleet default)",
   },
   "zh-TW": {
-    effectTrial: "效果試播", effectTrialLocal: "需由本機管理員啟用預覽並關閉自訂 CSS，才能試播。",
-    effectTrialStart: "試播", effectTrialExpired: "試播邀請已過期。", effectTrialUnavailable: "無法試播：存取權或播放設定可能已變更。",
+    waking: "正在喚醒 {0}…", retrySend: "重試傳送",
+    sendFailure_wake_capacity: "目前沒有空位可喚醒這個實例。請等其他實例閒置後重試。",
+    sendFailure_wake_credentials: "實例無法登入。請先在主機檢查它的帳號，再重試。",
+    sendFailure_wake_timeout: "實例未能及時就緒。請重試，或在主機檢查它的狀態。",
+    sendFailure_instance_stopped: "這個實例已停止或移除。請先在主機啟動它，再重試。",
+    sendFailure_delivery_unavailable: "實例目前無法接收這則訊息。請在主機檢查它的狀態，再重試。",
+    sendFailure_delivery_changed: "訊息送出前，登入或實例狀態已改變。必要時請重新登入，再重試。",
+    sendFailure_reply_gone: "你回覆的訊息已不在這個聊天裡。內容還在：可以不帶回覆直接送出，或改回覆其他訊息。",
+    reply: "回覆", replyingTo: "回覆 {0}", replyCancel: "取消回覆（Esc）", replyHidden: "之前的一則訊息", replyPhoto: "[圖片]", replyFile: "[檔案]",
+    replyGone: "那則訊息已不在這個聊天裡。", replyJump: "顯示被回覆的訊息", copyText: "複製文字", copyLink: "複製連結", msgMenu: "訊息",
+
+    effectTrialReason_checking: "正在確認工作階段…",
+    effectTrialReason_localAdmin: "請在公開連結以外的儀表板以管理員登入後試播。",
+    effectTrialReason_chatChanged: "請開啟發出試播邀請的聊天。",
+    effectTrialReason_busy: "請先停止目前的試播。",
+    effectTrialReason_safe: "請先關閉安全模式。",
+    effectTrialReason_effectsOff: "請先開啟效果。",
+    effectTrialReason_reducedMotion: "效果跟隨這台裝置的「減少動態效果」設定。",
+    effectTrialReason_saveData: "裝置目前要求節省數據。",
+    effectTrialReason_transport: "隔離效果播放器目前無法使用。請重新載入頁面。",
+    effectTrialReason_unsupported: "此瀏覽器無法播放 Canvas Worker 效果。",
+    effectTrialReason_inactive: "請回到本頁後試播。",
+    effectTrialReason_dialog: "請先關閉其他選單或對話框。",
+    effectTrialReason_expired: "試播邀請已過期。",
+    effectTrialSignIn: "在此登入",
+    effectTrialStopOther: "停止目前試播",
+    effectTrialSettings: "開啟播放設定",
+    effectTrialPlayMotion: "仍然播放效果",
+    effectTrial: "效果試播", effectTrialLocal: "僅在本頁試播，不會套用或儲存。",
+    effectTrialStopped: "試播已停止", effectTrialStart: "試播", effectTrialExpired: "試播邀請已過期。", effectTrialUnavailable: "此試播已無法使用。",
     cmdConfirm: "清空", cmdConfirmBackend: "切換並重新啟動", cmdRunning: "執行 /{0} 中…", cmdNotCommand: "這裡沒有這個指令——按 Enter 會當成一般訊息送出。", cmdDismiss: "關閉", cmdCommands: "指令",
     compactRunning: "壓縮中…", compactDone: "✅ 對話已壓縮", compactUnknown: "這個後端不會回報壓縮何時完成。",
     compactTimeout: "{0} 分鐘內沒有看到壓縮完成的紀錄，請到代理自己的對話確認。",
     compactLost: "無法再追蹤這次壓縮：指令沒有送到代理，或代理已停止、換了後端。",
     compactNotCompacted: "kiro 沒有壓縮對話：對話太短，或壓縮被中止了。",
-    cmdChoose: "選擇", cmdCurrent: "目前", chipCompact: "壓縮", chipClear: "清空…", chipContext: "已用 {0}% 的 context",
+    cmdChoose: "選擇", cmdCurrent: "目前", cmdSignIn: "登入", cmdSignInTo: "登入 {0}", chipCompact: "壓縮", chipClear: "清空…", chipContext: "已用 {0}% 的 context",
     chipModel: "模型：{0}——選擇其他", chipEffort: "推理強度：{0}——選擇其他",
     cmd_ctx: "context 用量、模型與推理強度", cmd_compact: "壓縮對話", cmd_clear: "清空對話（會先確認）",
     cmd_model: "查看或切換模型", cmd_backend: "切換 CLI backend，再選模型和推理強度（會重新啟動）", cmd_effort: "查看或設定推理強度", cmd_cancel: "停止目前的回覆",
@@ -123,7 +190,8 @@ register("chat", {
     a11yWorking: "{0} 開始工作", a11yIdle: "{0} 已完成", a11yReplied: "{0} 已回覆", conversationWith: "與 {0} 的對話",
     stopping: "正在中止 {0}…", awaiting: "{0} 正在等你回應", approxNote: "從終端畫面判讀，僅供參考", elapsedTitle: "從這個頁面看到它開始工作起算（約略）",
     dropHere: "放開即可附加檔案", asText: "改為文字", pasteAttached: "貼上的長文字（{0} 個字元）已改為文字檔附加", pasteKeptAsText: "附件已滿，貼上的長文字保留為一般文字",
-    send: "送出", composerPlaceholder: "傳訊息給 {0}…", composerHint: "Enter 送出 · Shift+Enter 換行", composerMore: "/ 叫出指令 · Esc 中止回覆", attachTitle: "附加檔案（任何類型，也可以貼上或拖曳）",
+    send: "送出", composerPlaceholder: "傳訊息給 {0}…", composerHint: "Enter 送出 · Shift+Enter 換行", composerMore: "/ 叫出指令 · Esc 中止回覆", guestMore: "Esc 中止回覆",
+    guestNote: "你是訪客：agent 會把你的訊息視為訪客的訊息（僅供辨識）。", guestNoCommands: "訪客不能執行指令，請去掉開頭的 / 再送出。", attachTitle: "附加檔案（任何類型，也可以貼上或拖曳）",
     pvPreview: "預覽", pvStop: "停止", pvDownload: "下載", pvMenu: "預覽選項", pvHtml: "HTML",
     pvAllowButton: "允許預覽", pvAllow: "允許預覽 HTML（預覽可能把資料傳出去）", pvDisallow: "不再允許預覽 HTML",
     pvConfirm: "要允許預覽 HTML 嗎？\n\n這會套用到你登入的每一台裝置。預覽會在隔離的框架裡執行 agent 的 HTML。它無法使用你的登入，但可能把資料傳出去，也可能讓這個分頁變慢或卡住。每次仍需要你按「預覽」。",
@@ -168,6 +236,8 @@ register("chat", {
     "pvFail_bad-address": "Cloudflare 給出的網址無法使用",
     pvFail_unknown: "發生了未預期的錯誤",
     pvServer_notOffered: "這個頁面不提供預覽。",
+    pvServer_listenFailed: "無法預覽：fleet 無法開啟預覽用的連接埠（{0}）。可能有其他程式正在使用它——請設定 web.preview_port，然後重新啟動 AgEnD。",
+    pvServer_notListening: "這個 fleet 目前無法預覽。",
     previews: "允許預覽 HTML",
     clicked: "點選了：", clickShow: "顯示這些按鈕所在的訊息",
     copy: "複製", copyMessage: "複製這則回覆", copied: "已複製", copyFailed: "複製失敗", wrap: "換行", showAll: "展開全部 {0} 行", showMore: "顯示更多", showLess: "收合", jumpLatest: "最新", newBelow: "{0} 則新訊息",
@@ -189,10 +259,17 @@ register("chat", {
     dEditInSettings: "到設定編輯", dPause: "暫停", dWake: "喚醒", dPaused: "{0} 已暫停", dWoken: "{0} 正在喚醒", dActionFailed: "沒有成功，請再試一次。",
     dNoActivity: "最近一小時沒有活動。", dWorking: "處理中…",
     themeLock: "鎖定主題", themeUnlock: "解除主題鎖定", themeReset: "重設主題…", themeResetGo: "重設",
+    pageColours: "頁面配色", pageAgentOn: "依 agent 的設定（開）", pageAgentOff: "依 agent 的設定（關）", pageWhole: "整個頁面", pageChatOnly: "只在它的聊天",
     themeResetConfirm: "要把 {0} 的主題重設為預設嗎？顏色、圖片和處理中文字都會移除；鎖定會保留。",
     themeResetDone: "已重設 {0} 的主題。", themeLocked: "已鎖定 {0} 的主題：agent 無法變更。", themeUnlocked: "已解除 {0} 的主題鎖定。",
     themeFailed: "主題沒有變更（{0}）。",
     widgetRemoveHeader: "移除聊天標頭的小工具", widgetRemoveDetails: "移除詳細資料頁的小工具", widgetRemoved: "已移除 {0} 的小工具。",
+    ambientBlocked_hidden: "環境效果未顯示：已關閉 agent 的主題——開啟",
+    ambientBlocked_safe: "環境效果未顯示：安全模式（?safe=1）——離開安全模式",
+    ambientBlocked_reducedMotion: "環境效果未顯示：這台裝置跟隨「減少動態效果」——仍然播放",
+    ambientBlocked_unsupported: "環境效果未顯示：此瀏覽器無法播放",
+    ambientClearLoop: "清除環境效果", ambientClearClick: "清除點擊效果", ambientCleared: "已清除 {0} 的環境效果。",
+    ambientMotionNote: "你的系統要求減少動態效果；效果目前開著。", ambientMotionNoteLink: "在這裡關閉", ambientMotionNoteClose: "關閉",
     configured: "（設定值）", fleetDefault: "（fleet 預設）",
   },
 });