@songsid/agend 2.3.0-beta.9 → 2.3.1

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: {}, pendingFiles: {}, sending: {}, outgoing: {}, 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));
@@ -106,6 +108,8 @@ export function createChatStore(deps) {
     liveReplies.message(m, extra);
     const before = s.msgs[m.instance];
     s.msgs[m.instance] = R().mergeMessages(before, [m], 500);
+    // The live copy of a message this page sent carries its clientId: its pending bubble goes in this same redraw.
+    if (settleOutgoing(m.instance, m.role === "user" ? m.clientId : undefined) && s.msgs[m.instance] === before) changed(m.instance, "msgs");
     if (m.instance === s.current && s.msgs[m.instance] !== before && m.role !== "status" && !isUser(m, m.instance) && (s.msgs[m.instance] || []).length > (before || []).length) deps.announce(tf("chat.a11yReplied", m.sender));
     if (s.msgs[m.instance] !== before) changed(m.instance, "msgs");
   }
@@ -127,6 +131,13 @@ export function createChatStore(deps) {
     s.msgs[u.instance] = R().applyReplyButtons(before, u.buttons);
     if (s.msgs[u.instance] !== before) changed(u.instance, "msgs");
   }
+  /** #2305: the instance reacted to a message — its bubble shows it. */
+  function applyReactions(u) {
+    if (!u || typeof u.instance !== "string" || typeof u.boot !== "string" || typeof u.id !== "number") return;
+    const before = s.msgs[u.instance];
+    s.msgs[u.instance] = R().applyReactions(before, u.boot, u.id, u.reactions);
+    if (s.msgs[u.instance] !== before) changed(u.instance, "msgs");
+  }
   /**
    * #1266: click one of a reply's buttons (the first click anywhere answers for everyone). On a poll (#1823) it is this
    * session's vote: the answer is its ballot, which only this page marks.
@@ -142,16 +153,22 @@ 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);
       s.msgs[name] = R().mergeMessages(s.msgs[name], r.messages, 500);
+      settleOutgoing(name);
       changed(name, "msgs");
     } catch { s.historyRead.delete(name); /* the live stream still works; the next visit tries again */ }
     void lease;
@@ -228,51 +245,186 @@ export function createChatStore(deps) {
   }
   const promptsFor = (instance) => Object.values(s.prompts).filter(p => p.instance === instance);
 
-  // ── Sending. Never lose anything: a failed send's files go back to that chat's list and its text back into its own
-  // composer when that is empty, otherwise it is kept for its chat and offered back (Put back).
-  async function uploadFile(target, file) {
-    const r = await deps.fetch(`/ui/upload?instance=${encodeURIComponent(target)}`, {
-      method: "POST",
-      headers: { "Content-Type": file.type || "application/octet-stream", "X-Agend-Filename": encodeURIComponent(file.name || "file") },
-      body: file,
+  // ── Sending (Discord-like, the user's request): a message shows at once as its own bubble, dimmed while it goes; its
+  // files show their upload progress. The server's copy replaces it when it arrives — matched by the page's clientId
+  // (on the live copy) or the messageId the send answered with — so it is never shown twice. A send that fails stays,
+  // marked, with Retry and Delete: nothing is lost, and nothing is put back into the composer behind the person's back.
+  // Sends of one chat go out in order, one at a time; a later one waits behind an earlier one still going.
+  let outSeq = 0;
+  const objectUrl = (f) => { try { return globalThis.URL && typeof URL.createObjectURL === "function" && /^image\/(png|jpeg|gif|webp)$/.test(f.type || "") ? URL.createObjectURL(f) : null; } catch { return null; } };
+  const freeUrl = (u) => { try { if (u) URL.revokeObjectURL(u); } catch { /* gone */ } };
+  const newClientId = () => {
+    const bytes = new Uint8Array(12);
+    try { globalThis.crypto.getRandomValues(bytes); } catch { for (let i = 0; i < bytes.length; i++) bytes[i] = Math.floor(Math.random() * 256); }
+    return "c" + [...bytes].map((x) => x.toString(16).padStart(2, "0")).join("");
+  };
+  /** Pending bubbles the server's copy now stands for go (their previews freed). Returns whether any went. */
+  function settleOutgoing(name, clientId) {
+    const list = s.outgoing[name];
+    if (!list || !list.length) return false;
+    const ids = new Set((s.msgs[name] || []).map((m) => m.messageId).filter(Boolean)), clients = new Set(clientId ? [clientId] : []);
+    const kept = list.filter((e) => !((e.messageId && ids.has(e.messageId)) || clients.has(e.clientId)));
+    if (kept.length === list.length) return false;
+    for (const e of list) if (!kept.includes(e)) for (const f of e.files) freeUrl(f.url);
+    s.outgoing[name] = kept;
+    return true;
+  }
+  /** The thread as drawn: the server's messages, then this page's pending ones. */
+  function threadRows(name) {
+    const out = s.outgoing[name];
+    return out && out.length ? (s.msgs[name] || []).concat(out) : (s.msgs[name] || []);
+  }
+  /** Upload one file, its progress told as it goes (XHR: fetch cannot report an upload's progress). */
+  async function uploadFile(target, file, onProgress) {
+    const url = `/ui/upload?instance=${encodeURIComponent(target)}`;
+    const X = deps.XMLHttpRequest;
+    if (!X) {                                                            // no XHR given (a test): the whole file at once
+      const r = await deps.fetch(url, { method: "POST", headers: { "Content-Type": file.type || "application/octet-stream", "X-Agend-Filename": encodeURIComponent(file.name || "file") }, body: file });
+      let body = {};
+      try { body = await r.json(); } catch { /* not JSON */ }
+      if (!r.ok || !body || typeof body.id !== "string") throw new Error(body && body.error ? `${file.name}: ${body.error}` : `${file.name}: upload failed (${r.status})`);
+      onProgress?.(file.size || 0, file.size || 0);
+      return body;
+    }
+    // The CSRF header the page's fetch adds (agend-auth.js), added here too; a 401 ends the session as fetch's would.
+    const csrf = globalThis.AgendAuth && typeof globalThis.AgendAuth.csrf === "function" ? await globalThis.AgendAuth.csrf().catch(() => null) : null;
+    return new Promise((resolve, reject) => {
+      const xhr = new X();
+      xhr.open("POST", url);
+      xhr.setRequestHeader("Content-Type", file.type || "application/octet-stream");
+      xhr.setRequestHeader("X-Agend-Filename", encodeURIComponent(file.name || "file"));
+      if (csrf) xhr.setRequestHeader("X-Agend-CSRF", csrf);
+      if (xhr.upload && onProgress) xhr.upload.onprogress = (ev) => { if (ev.lengthComputable) onProgress(ev.loaded, ev.total); };
+      xhr.onload = () => {
+        let body = {};
+        try { body = JSON.parse(xhr.responseText || "{}"); } catch { /* not JSON */ }
+        if (xhr.status === 401) globalThis.AgendAuth?.unauthorized?.();
+        if (xhr.status >= 200 && xhr.status < 300 && body && typeof body.id === "string") resolve(body);
+        else reject(new Error(body && body.error ? `${file.name}: ${body.error}` : `${file.name}: upload failed (${xhr.status})`));
+      };
+      xhr.onerror = () => reject(new Error(`${file.name}: ${t("chat.uploadNoConnection")}`));
+      xhr.onabort = () => reject(new Error(`${file.name}: ${t("chat.uploadNoConnection")}`));
+      xhr.send(file);
     });
-    let body = {};
-    try { body = await r.json(); } catch { /* not JSON */ }
-    if (!r.ok || !body || typeof body.id !== "string") throw new Error(body && body.error ? `${file.name}: ${body.error}` : `${file.name}: upload failed (${r.status})`);
-    return body;
   }
-  async function send(target) {
+  /** Send what the composer holds: its bubble at once, then out in this chat's order. */
+  function send(target) {
     const txt = (s.drafts[target] || "").trim();
     const files = (s.pendingFiles[target] || []).slice();
-    if ((!txt && !files.length) || !target || s.sending[target]) return;
-    s.sending[target] = true;
+    if ((!txt && !files.length) || !target) return;
+    const quote = s.replies[target];
+    const e = {
+      // "You" until the server's copy (with the person's name) replaces it: no request is made for a name.
+      boot: "out", id: ++outSeq, instance: target, role: "user", sender: t("chat.you"), text: txt,
+      ts: new Date().toISOString(), clientId: newClientId(), replyTo: quote ? { boot: quote.boot, id: quote.id, sender: quote.sender, text: quote.text, media: quote.media } : undefined,
+      quote, outgoing: { state: "queued" },
+      files: files.map((f) => ({ file: f, name: f.name || "file", size: f.size || 0, type: f.type || "", url: objectUrl(f), loaded: 0, total: f.size || 0, state: "waiting", id: null })),
+    };
+    (s.outgoing[target] = s.outgoing[target] || []).push(e);
     s.drafts[target] = "";
-    s.pendingFiles[target] = []; s.inFlightFiles[target] = files;
+    s.pendingFiles[target] = [];
+    if (quote) delete s.replies[target];
+    changed(target, "msgs");
     changed(target);
     changed(target, "sent");          // your own message: the thread goes to the bottom
+    return pump(target);
+  }
+  /** Take this chat's waiting sends, one after another. */
+  async function pump(target) {
+    if (s.sending[target]) return;
+    s.sending[target] = true;
+    try {
+      for (let e = nextQueued(target); e; e = nextQueued(target)) await deliver(target, e);
+    } finally { s.sending[target] = false; delete s.waking[target]; changed(target); }
+  }
+  const nextQueued = (target) => (s.outgoing[target] || []).find((x) => x.outgoing.state === "queued");
+  /** One send: its files (each with its own progress), then the message. */
+  async function deliver(target, e) {
+    e.outgoing = { state: "sending" };
+    s.waking[target] = s.instanceStatus[target] === "paused";
+    changed(target, "msgs"); changed(target);
     let r;
     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 });
-    } catch (err) { r = { error: err && err.message ? err.message : t("chat.disconnected") }; }
-    s.sending[target] = false;
-    delete s.inFlightFiles[target];
-    if (r && !r.error) { changed(target); return; }
-    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;
+      for (const f of e.files) {
+        if (f.id) continue;                                              // uploaded by an earlier try
+        f.state = "uploading"; f.loaded = 0; changed(target, "progress");
+        let last = 0;
+        const body = await uploadFile(target, f.file, (loaded, total) => {
+          f.loaded = loaded; f.total = total || f.total;
+          const at = deps.now ? deps.now() : Date.now();
+          if (at - last > 60 || loaded >= f.total) { last = at; changed(target, "progress"); }
+        });
+        f.id = body.id; f.state = "done"; f.loaded = f.total; changed(target, "progress");
+      }
+      const body = { instance: target, message: e.text, clientId: e.clientId };
+      const ids = e.files.map((f) => f.id);
+      if (ids.length) body.attachments = ids;
+      if (e.quote) body.replyTo = { boot: e.quote.boot, id: e.quote.id };
+      r = await api("POST", "/ui/send", body);
+    } catch (err) {
+      const f = e.files.find((x) => x.state === "uploading");
+      if (f) f.state = "failed";
+      // The browser's own words for a request that never reached the server (Chrome, Firefox, Safari): the page's.
+      const offline = err && err.name === "TypeError" && /failed to fetch|networkerror|load failed/i.test(err.message || "");
+      r = { error: offline ? t("chat.sendNoConnection") : err && err.message ? err.message : t("chat.disconnected") };
     }
-    changed(target);
-    deps.toast(r && r.error ? r.error : t("chat.disconnected"), false);
+    if (!(s.outgoing[target] || []).includes(e)) return;                // deleted meanwhile
+    if (r && !r.error && r.sent !== false) {
+      e.outgoing = { state: "sent" };
+      if (typeof r.messageId === "string") e.messageId = r.messageId;
+      settleOutgoing(target);
+      changed(target, "msgs"); changed(target);
+      return;
+    }
+    // Files the server no longer holds (they are released when a delivery fails) are uploaded again on Retry.
+    if (r && typeof r.error === "string" && /files? (are|is) not available|no such file|already sent/i.test(r.error)) for (const f of e.files) { f.id = null; f.state = "waiting"; }
+    // #2272: the quoted message is gone: Retry sends it without the quote.
+    if (r && r.reason === "reply_gone") { e.quote = undefined; e.replyTo = undefined; }
+    const why = r && r.reason;
+    const key = typeof why === "string" ? `chat.sendFailure_${why}` : "";
+    const localized = key ? t(key) : "";
+    e.outgoing = { state: "failed", error: localized && localized !== key ? localized : (r && r.error ? r.error : t("chat.disconnected")) };
+    changed(target, "msgs"); changed(target);
+    deps.toast(e.outgoing.error, false);
+  }
+  /** A failed send, sent again (the same bubble; files already uploaded are not uploaded again). */
+  function retryOutgoing(target, clientId) {
+    const e = (s.outgoing[target] || []).find((x) => x.clientId === clientId);
+    if (!e || e.outgoing.state !== "failed") return;
+    e.outgoing = { state: "queued" };
+    for (const f of e.files) if (f.state === "failed") f.state = "waiting";
+    changed(target, "msgs");
+    return pump(target);
+  }
+  /** A failed send, let go (its previews freed). */
+  function deleteOutgoing(target, clientId) {
+    const list = s.outgoing[target] || [];
+    const e = list.find((x) => x.clientId === clientId);
+    if (!e || e.outgoing.state !== "failed") return;
+    for (const f of e.files) freeUrl(f.url);
+    s.outgoing[target] = list.filter((x) => x !== e);
+    changed(target, "msgs"); changed(target);
+  }
+  /**
+   * A failed send, back in the composer to change it: its text before what is typed there now, its files (within the
+   * limits) and its reply, if none is started; the bubble goes. The page records the composer's undo step first.
+   */
+  function putBackOutgoing(target, clientId) {
+    const list = s.outgoing[target] || [];
+    const e = list.find((x) => x.clientId === clientId);
+    if (!e || e.outgoing.state !== "failed") return;
+    const draft = s.drafts[target] || "";
+    s.drafts[target] = e.text ? (draft ? e.text + "\n" + draft : e.text) : draft;
+    for (const f of e.files) freeUrl(f.url);
+    s.outgoing[target] = list.filter((x) => x !== e);
+    if (e.quote && !s.replies[target]) s.replies[target] = e.quote;
+    changed(target, "msgs");
+    if (e.files.length) addFiles(target, e.files.map((f) => f.file)); else changed(target);
   }
   function addFiles(target, list) {
     if (!target) return;
-    const inFlight = s.inFlightFiles[target] || [];
-    const res = R().checkFiles(inFlight.concat(s.pendingFiles[target] || []), [...(list || [])]);
-    s.pendingFiles[target] = res.kept.slice(inFlight.length);
+    const res = R().checkFiles(s.pendingFiles[target] || [], [...(list || [])]);
+    s.pendingFiles[target] = res.kept;
     for (const x of res.rejected) { const why = R().fileRejection(x.reason); deps.toast(`${x.name}: ${t(why.key, ...why.values)}`, false); }
     changed(target);
   }
@@ -282,7 +434,7 @@ export function createChatStore(deps) {
     if (!target) return false;
     const stamp = new Date().toISOString().slice(0, 19).replace(/[-:T]/g, "");
     const f = new File([text], `pasted-${stamp}.txt`, { type: "text/plain" });
-    const taken = (s.inFlightFiles[target] || []).concat(s.pendingFiles[target] || []);
+    const taken = s.pendingFiles[target] || [];
     if (R().checkFiles(taken, [f]).rejected.length) { deps.toast(t("chat.pasteKeptAsText")); return false; }
     pastedTexts.set(f, text);
     addFiles(target, [f]);
@@ -299,16 +451,32 @@ export function createChatStore(deps) {
     changed(target);
   }
   const isPasted = (f) => pastedTexts.has(f);
-  function putBack(target) {
-    const kept = s.failedSends[target];
-    if (!kept) return;
-    s.drafts[target] = R().putBack(kept, s.drafts[target] || "");
-    delete s.failedSends[target];
+  /** Typing stays local. */
+  function setDraft(target, value) { s.drafts[target] = value; }
+  /**
+   * #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 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; }
+  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); settleOutgoing(name); 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.
@@ -391,6 +559,7 @@ export function createChatStore(deps) {
     stream.on("prompts", applyPrompts);
     stream.on("prompt_resolved", resolvePrompt);
     stream.on("reply_buttons", applyReplyButtons);
+    stream.on("reactions", applyReactions);                              // #2305
     stream.on("clock", noteServerClock);                                  // #1823
   }
 
@@ -402,7 +571,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, retryOutgoing, deleteOutgoing, putBackOutgoing, threadRows, addFiles, removeFile, attachPastedText, fileBackAsText, isPasted, setDraft,
+    startReply, clearReply, findQuoted,
     cancelReply, isUser, runCommand, dismissCommand, commandFree,
   };
 }

package/dist/ui/chat-strings.js

@@ -3,6 +3,20 @@ import { register } from "/assets/app-i18n.js";
 
 register("chat", {
   en: {
+    waking: "Waking {0}…", retrySend: "Retry send",
+    // A message being sent (its own bubble at once) and its files' uploads.
+    you: "You", sending: "Sending…", uploadingFile: "Uploading {0}", uploadWaiting: "waiting", uploadFailed: "failed",
+    uploadNoConnection: "the upload was cut off — check the connection", sendNoConnection: "it did not reach AgEnD — check the connection", notSentBecause: "Not sent: {0}", deleteUnsent: "Delete",
+    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.",
@@ -27,7 +41,7 @@ register("chat", {
     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",
@@ -42,7 +56,7 @@ 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", guestMore: "Esc stops the reply",
+    send: "Send", composerPlaceholder: "Message {0}…", composerHint: "Enter to send · Shift+Enter for a new line", composerHintTouch: "Return adds a line · tap Send to send", 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",
@@ -61,6 +75,8 @@ register("chat", {
     pvPage: "Page", pvCode: "Code", pvReload: "Reload", pvClose: "Close the panel", pvBack: "Back to the chat", pvResize: "Resize the preview panel",
     pvNewer: "A newer version is in the reply from {0}.", pvNewerShow: "Show it", pvPanelIdle: "Click Preview to run it here.",
     lbLabel: "Image: {0}", lbLabelNoName: "Image", lbClose: "Close", lbOpenOriginal: "Open original", lbPrev: "Previous image", lbNext: "Next image", lbCount: "{0} / {1}",
+    // #2333: zoom in the lightbox.
+    lbZoomIn: "Zoom in (+)", lbZoomOut: "Zoom out (−)", lbZoomLevel: "{0}% — click for fit or actual size (0 / 1)", lbFitWidth: "Fit width (W)",
     // #1554: preview.js's words (its English is the fallback there), and the server's reasons by code.
     pvWhyOptin: "HTML previews are off. Allow them from this card's ⋯ menu or Settings → Preferences.",
     pvWhyOptinPanel: "HTML previews are off.",
@@ -94,10 +110,10 @@ register("chat", {
     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",
-    disconnected: "disconnected", tick_queued: "Waiting behind another message", tick_processing: "Handed to the agent", tick_delivered: "The agent has it", tick_failed: "Not delivered", tick_cancelled: "Dropped by Stop",
+    disconnected: "disconnected", tick_queued: "Waiting behind another message", tick_processing: "Handed to the agent", tick_delivered: "The agent has it", tick_failed: "Not delivered", tick_cancelled: "Dropped by Stop", reactedBy: "{0} reacted",
     promptAnswering: "Answering…", promptGone: "This prompt is no longer open", promptFor: "{0}: {1}",
     working: "{0} is working…", stuck: "{0} looks stuck", stopReply: "Stop reply", stopReplyTitle: "Stop the current reply (like Esc) and drop the messages still waiting. The instance keeps running.", stopSent: "Stopped",
-    file_empty: "empty file", file_too_large: "over {0} MB", file_too_large_public: "over {0} MB — the most the public link carries in one upload", file_too_many: "at most {0} files per message", file_too_much: "the files together would be over {0} MB", removeFile: "Remove", notSent: "Not sent:", putBack: "Put back", discard: "Discard",
+    file_empty: "empty file", file_too_large: "over {0} MB", file_too_large_public: "over {0} MB — the most the public link carries in one upload", file_too_many: "at most {0} files per message", file_too_much: "the files together would be over {0} MB", removeFile: "Remove", putBack: "Put back", 
     noMessages: "Type a task below.",
     pick: "Choose an agent to start chatting.", noAgents: "Create an agent to start chatting.", newAgent: "New agent", notFound: "No instance called “{0}”", notFoundHint: "It may have been deleted or renamed.", backToList: "Choose an agent",
     details: "Instance details", start: "Start instance", stopInstance: "Stop instance", restart: "Restart instance", delete: "Delete instance…",
@@ -114,6 +130,7 @@ 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}).",
@@ -128,6 +145,19 @@ register("chat", {
     configured: "(configured)", fleetDefault: "(fleet default)",
   },
   "zh-TW": {
+    waking: "正在喚醒 {0}…", retrySend: "重試傳送",
+    you: "你", sending: "傳送中…", uploadingFile: "正在上傳 {0}", uploadWaiting: "等待中", uploadFailed: "失敗",
+    uploadNoConnection: "上傳中斷了，請檢查網路連線", sendNoConnection: "沒有送到 AgEnD，請檢查網路連線", notSentBecause: "沒有送出：{0}", deleteUnsent: "刪除",
+    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: "請開啟發出試播邀請的聊天。",
@@ -152,7 +182,7 @@ register("chat", {
     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: "停止目前的回覆",
@@ -167,7 +197,7 @@ 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 中止回覆", guestMore: "Esc 中止回覆",
+    send: "送出", composerPlaceholder: "傳訊息給 {0}…", composerHint: "Enter 送出 · Shift+Enter 換行", composerHintTouch: "Return 換行 · 按「送出」傳送", composerMore: "/ 叫出指令 · Esc 中止回覆", guestMore: "Esc 中止回覆",
     guestNote: "你是訪客：agent 會把你的訊息視為訪客的訊息（僅供辨識）。", guestNoCommands: "訪客不能執行指令，請去掉開頭的 / 再送出。", attachTitle: "附加檔案（任何類型，也可以貼上或拖曳）",
     pvPreview: "預覽", pvStop: "停止", pvDownload: "下載", pvMenu: "預覽選項", pvHtml: "HTML",
     pvAllowButton: "允許預覽", pvAllow: "允許預覽 HTML（預覽可能把資料傳出去）", pvDisallow: "不再允許預覽 HTML",
@@ -186,6 +216,7 @@ register("chat", {
     pvPage: "頁面", pvCode: "程式碼", pvReload: "重新載入", pvClose: "關閉面板", pvBack: "回到對話", pvResize: "調整預覽面板寬度",
     pvNewer: "{0} 的回覆裡有較新的版本。", pvNewerShow: "顯示", pvPanelIdle: "按「預覽」在這裡執行。",
     lbLabel: "圖片：{0}", lbLabelNoName: "圖片", lbClose: "關閉", lbOpenOriginal: "開啟原圖", lbPrev: "上一張", lbNext: "下一張", lbCount: "{0} / {1}",
+    lbZoomIn: "放大（+）", lbZoomOut: "縮小（−）", lbZoomLevel: "{0}%：點一下切換「符合視窗」與「實際大小」（0 / 1）", lbFitWidth: "符合寬度（W）",
     pvWhyOptin: "還沒允許 HTML 預覽。可從這張卡片的 ⋯ 選單或「設定 → 偏好設定」允許。",
     pvWhyOptinPanel: "還沒允許 HTML 預覽。",
     pvWhyNever: "這台裝置在這個工作階段已關閉預覽。",
@@ -218,10 +249,10 @@ register("chat", {
     previews: "允許預覽 HTML",
     clicked: "點選了：", clickShow: "顯示這些按鈕所在的訊息",
     copy: "複製", copyMessage: "複製這則回覆", copied: "已複製", copyFailed: "複製失敗", wrap: "換行", showAll: "展開全部 {0} 行", showMore: "顯示更多", showLess: "收合", jumpLatest: "最新", newBelow: "{0} 則新訊息",
-    disconnected: "已斷線", tick_queued: "排在前一則訊息之後", tick_processing: "已交給 agent", tick_delivered: "agent 已收到", tick_failed: "未送達", tick_cancelled: "已被中止取消",
+    disconnected: "已斷線", tick_queued: "排在前一則訊息之後", tick_processing: "已交給 agent", tick_delivered: "agent 已收到", tick_failed: "未送達", tick_cancelled: "已被中止取消", reactedBy: "{0} 的回應",
     promptAnswering: "回覆中…", promptGone: "這個提示已經結束", promptFor: "{0}：{1}",
     working: "{0} 處理中…", stuck: "{0} 似乎卡住了", stopReply: "中止回覆", stopReplyTitle: "中止目前的回覆（同 Esc），並取消還在排隊的訊息。instance 會繼續運行。", stopSent: "已中止",
-    file_empty: "空檔案", file_too_large: "超過 {0} MB", file_too_large_public: "超過 {0} MB，這是公開連結單次上傳的上限", file_too_many: "每則訊息最多 {0} 個檔案", file_too_much: "檔案合計會超過 {0} MB", removeFile: "移除", notSent: "未送出：", putBack: "放回輸入框", discard: "捨棄",
+    file_empty: "空檔案", file_too_large: "超過 {0} MB", file_too_large_public: "超過 {0} MB，這是公開連結單次上傳的上限", file_too_many: "每則訊息最多 {0} 個檔案", file_too_much: "檔案合計會超過 {0} MB", removeFile: "移除", putBack: "放回輸入框", 
     noMessages: "直接在下方輸入任務。",
     pick: "選一個 Agent 開始聊天。", noAgents: "先建立一個 Agent，再開始聊天。", newAgent: "新增 Agent", notFound: "沒有叫「{0}」的 instance", notFoundHint: "它可能已被刪除或改名。", backToList: "選擇 Agent",
     details: "Instance 詳細資料", start: "啟動 instance", stopInstance: "停止 instance", restart: "重新啟動 instance", delete: "刪除 instance…",
@@ -236,6 +267,7 @@ 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}）。",