@songsid/agend 2.3.2-beta.9 → 2.3.2

package/dist/ui/settings-model.js

@@ -40,26 +40,32 @@ export function changedFields(next, baseline) {
 
 /**
  * The dashboard features an agent may use (dashboard-permissions.ts): each "inherit" (the fleet default: `defaults.dashboard`,
- * else allowed — off for OFF_UNLESS_ON, `office`), "on" or "off". The patch names only the features that changed: null
+ * else allowed — off for OFF_UNLESS_ON, `office` and `office_packs`), "on" or "off". The patch names only the features that changed: null
  * follows the default again.
  */
-export const DASHBOARD_FEATURES = ["appearance", "task_board", "web_settings", "office"];
-/** #2578: the features a person switches on — unset is off (dashboard-permissions.ts OFF_UNLESS_ON). */
-export const OFF_UNLESS_ON = ["office"];
+export const DASHBOARD_FEATURES = ["appearance", "task_board", "web_settings", "office", "office_packs"];
+/** #2578, #2692: the features a person switches on — unset is off (dashboard-permissions.ts OFF_UNLESS_ON). */
+export const OFF_UNLESS_ON = ["office", "office_packs"];
+/** #2601, #2692: the features kept beside `dashboard` under their own key (dashboard-permissions.ts SEPARATE_FEATURE_KEYS). */
+export const SEPARATE_FEATURE_KEYS = { office: "office_access", office_packs: "office_pack_access" };
 export const DASHBOARD_CHOICES = ["inherit", "on", "off"];
 const dashboardOf = (v) => (v && typeof v === "object" && !Array.isArray(v) ? v : {});
 /** What a feature is for an agent with no setting of its own: the default's, else allowed (off for OFF_UNLESS_ON). */
 export const dashboardDefault = (defaults, feature) => {
-  const v = feature === "office" && defaults && Object.hasOwn(defaults, "office_access") ? defaults.office_access : dashboardOf(defaults && defaults.dashboard)[feature];
+  const key = Object.hasOwn(SEPARATE_FEATURE_KEYS, feature) ? SEPARATE_FEATURE_KEYS[feature] : null;
+  const v = key && defaults && Object.hasOwn(defaults, key) ? defaults[key] : dashboardOf(defaults && defaults.dashboard)[feature];
   return OFF_UNLESS_ON.includes(feature) ? v === true : v !== false;
 };
 export function dashboardForm(inst) {
-  const own = { ...dashboardOf(inst.dashboard), ...(Object.hasOwn(inst, "office_access") ? { office: inst.office_access } : {}) };
+  const own = { ...dashboardOf(inst.dashboard) };
+  for (const [feature, key] of Object.entries(SEPARATE_FEATURE_KEYS)) if (Object.hasOwn(inst, key)) own[feature] = inst[key];
   return Object.fromEntries(DASHBOARD_FEATURES.map((f) => [f, own[f] === true ? "on" : own[f] === false ? "off" : "inherit"]));
 }
 export function dashboardPatchValue(choices) {
-  return Object.fromEntries(DASHBOARD_FEATURES.filter((f) => f !== "office").map((f) => [f, choices[f] === "on" ? true : choices[f] === "off" ? false : null]));
+  return Object.fromEntries(DASHBOARD_FEATURES.filter((f) => !Object.hasOwn(SEPARATE_FEATURE_KEYS, f)).map((f) => [f, choices[f] === "on" ? true : choices[f] === "off" ? false : null]));
 }
+/** A separately kept feature's own key in a patch (office_access, office_pack_access): true, false or null (inherit). */
+export const separateChoice = (choice) => (choice === "on" ? true : choice === "off" ? false : null);
 
 /** #1302: cross-instance notices. Unset, or a value the fleet does not know, means full. */
 export const visibilityDefault = (defaults) => (VISIBILITY_MODES.includes(defaults && defaults.cross_instance_visibility) ? defaults.cross_instance_visibility : "full");
@@ -181,7 +187,8 @@ export function agentPatch(form, inst, defaults, visibilityBaseline, statusEmoji
     display_name: form.inherit.display_name ? null : form.display_name.trim(),
     status_emojis: form.status_emojis,
     dashboard: dashboardPatchValue(form.dashboard),
-    office_access: form.dashboard.office === "on" ? true : form.dashboard.office === "off" ? false : null,
+    office_access: separateChoice(form.dashboard.office),
+    office_pack_access: separateChoice(form.dashboard.office_packs),
   };
   return changedFields(next, {
     backend: inst.backend || defaults.backend || "claude-code",
@@ -205,7 +212,8 @@ export function agentPatch(form, inst, defaults, visibilityBaseline, statusEmoji
     display_name: hasOwn(inst, "display_name") ? inst.display_name : null,
     status_emojis: statusEmojisBaseline,
     dashboard: dashboardPatchValue(dashboardForm(inst)),
-    office_access: dashboardForm(inst).office === "on" ? true : dashboardForm(inst).office === "off" ? false : null,
+    office_access: separateChoice(dashboardForm(inst).office),
+    office_pack_access: separateChoice(dashboardForm(inst).office_packs),
   });
 }
 

package/dist/ui/settings-registry.js

@@ -66,6 +66,7 @@ const ROWS = [
   // Fleet · Web dashboard
   ["dash.log-tab", "web-dashboard", "#webLogTab", "settings.webLogTab", "web.log_tab", ["log tab", "steps", "log"], ["Log 分頁", "紀錄", "步驟"]],
   ["dash.usage-public", "web-dashboard", "#webUsagePublic", "settings.webUsagePublic", "web.usage_report_on_public_link", ["usage", "public link", "cost", "tokens"], ["用量", "公開連結", "費用"]],
+  ["dash.office-levels", "web-dashboard", "#webOfficeLevels", "settings.webOfficeLevels", "web.office_levels", ["office", "level", "badge", "profile card"], ["辦公室", "等級", "徽章", "名片"]],
   ["dash.app-icon", "web-dashboard", ".s-app-icon", "settings.appIconTitle", null, ["app icon", "favicon", "home screen", "icon"], ["App 圖示", "圖示", "主畫面"]],
   ["dash.card-limits", "web-dashboard", ".s-card-limits", "settings.cardLimitsTitle", "web.appearance", ["upload limits", "portrait", "banner", "card limits"], ["上傳限制", "身分卡上傳限制"]],
   ["dash.canvas-worker", "web-dashboard", ".s-experimental-effects", "experimentalEffects.title", "web.experimental.canvas_worker", ["canvas worker", "experimental", "effects"], ["Canvas Worker", "實驗功能", "特效"]],

package/dist/ui/settings-strings.js

@@ -39,6 +39,7 @@ register("settings", {
     namedTokenSaved: "Token change saved. Reopen the public link.",
     webEcho: "Web echo",
     webEchoHint: "Copies web messages to the bound Telegram or Discord topic. ClassicBot rooms follow it unless a room sets its own.",
+    webOfficeLevels: "Office levels", webOfficeLevelsHint: "Each agent's level from its lifetime work, on its name tag in the Office and on its profile card. Off removes the badges and the card's level rows. The token counts behind a level follow the usage report's rules. Applies at once.",
     webUsagePublic: "Usage report over the public link", webUsagePublicHint: "Fleet → Usage (up to 400 days of each agent's tokens, requests, messages and API-equivalent amounts) is offered over the temporary public link too. Off by default; guests never see it. Applies at once.",
     webLogTab: "Log tab: each agent's steps", webLogTabHint: "Shows each instance's prompts, replies, tool calls and results, and fleet events in its Log tab, read from its own transcript only while the tab is open. Secret values are masked. Also over the public link. Turning it on waits for a fleet admin's confirmation.",
     general: "General Settings",
@@ -113,6 +114,7 @@ register("settings", {
     dashboard_task_board: "The task board",
     dashboard_web_settings: "Your web appearance settings",
     dashboard_office: "Office: walk, speak and act in the Office view",
+    dashboard_office_packs: "Office skin packs: check, upload, replace and restore them (everyone sees them)",
     dashboardInherit: "Fleet default ({0})",
     dashboardOn: "allowed",
     dashboardOff: "off",
@@ -184,6 +186,7 @@ register("settings", {
     wizardBackendFound: "Found on this host: {0}",
     wizardBackendNone: "No backend CLI found on this host — install one first.",
     wizardAgentName: "First agent name",
+    wizardGeneralNote: "This agent is the General: it answers in the chat's own General topic and hands work to the agents you add later.",
     wizardAgentWhich: "Which agent answers on this bot",
     wizardAgentNew: "A new agent",
     wizardAgentExisting: "An agent you already have",
@@ -192,7 +195,10 @@ register("settings", {
     wizardAgentNewName: "New agent name",
     wizardTopicNotCarried: "Its topic ({0}) is in the chat of its old connection, so it is not carried over: in the new chat it has no topic until one is bound.",
     wizardTopicGeneral: "It is the General agent: in the new chat it takes that chat's General topic.",
-    wizardNeedDir: "Enter an absolute working directory.",
+    wizardNeedDir: "A working directory must be an absolute path, or leave it empty.",
+    wizardDir: "Working directory (optional)",
+    wizardDirDefault: "Leave it empty and the agent gets its own folder, {0}, which AgEnD creates. A path you enter must be absolute.",
+    wizardDirDefaultName: "Leave it empty and the agent gets its own folder in AgEnD's workspaces, which AgEnD creates. A path you enter must be absolute.",
     wizardTelegramHint: "Create a bot with @BotFather, then add it to a group.",
     wizardDiscordHint: "Create an application in the Discord developer portal and invite the bot to your server.",
     wizardToken: "Bot token",
@@ -532,7 +538,7 @@ register("settings", {
     grantsLegacy: "Guests now reach what their chat access gives them. Saving grants switches to explicit access: only the people below, only their ticked agents.",
     grantsConvert: "Start from today's guests", grantsWithAccess: "People with access", grantsNoneYet: "No one has guest access yet.",
     grantsAdd: "Add a person", grantsSearch: "Search people who have written to your agents", grantsNoPeople: "No one matches. A person must have written to an agent first.",
-    grantsChoose: "Choose", grantsChosen: "Chosen", grantsMaySee: "{0} may see:", grantsWroteHere: "wrote here", grantsWroteTo: "Wrote to: {0}",
+    grantsChoose: "Choose", grantsChosen: "Chosen", grantsMaySee: "{0} may see:", grantsClassicRooms: "ClassicBot rooms", grantsWroteHere: "wrote here", grantsWroteTo: "Wrote to: {0}",
     grantsLastSeen: "last seen {0}", grantsRecent: "Recent changes", grantsRecentNone: "No change to anyone's access yet.", grantsAuditDirect: "applied at once", grantsAuditConfirmed: "confirmed in General", grantsAuditEnded: "{0} session(s) ended", grantsAuditCodeSent: "sign-in code sent", grantsAuditCodeNot: "sign-in code not sent ({0})", grantsAuditDmFailed: "the DM did not go through", grantsAuditWait: "asked again within a minute", grantsAuditAdminLimit: "the admin's limit of codes was reached",
     grantsEditAgents: "Edit agents", grantsRemove: "Remove access", grantsUndoRemove: "Keep access",
     grantsWillBeRemoved: "Access ends when you save.", grantsNew: "New — granted when you save", grantsNoAgents: "Tick at least one agent, or remove this person.",
@@ -714,6 +720,7 @@ register("settings", {
     namedTokenSaved: "Token 變更已儲存，請重新開啟公開連結。",
     webEcho: "Web 同步",
     webEchoHint: "將網頁訊息複製到綁定的 Telegram 或 Discord 主題。ClassicBot 聊天室也照這個設定，除非該聊天室另外設定。",
+    webOfficeLevels: "辦公室等級", webOfficeLevelsHint: "每個 agent 依終身工作量得到的等級，顯示在辦公室的名牌與名片上。關閉會移除徽章與名片上的等級列。等級背後的 token 數字依用量報告的規則顯示。變更立即生效。",
     webUsagePublic: "透過公開連結提供用量報告", webUsagePublicHint: "Fleet → 用量（最多 400 天、每個 agent 的 token、請求、訊息與依牌價換算的 API 等值）也會透過臨時公開連結提供。預設關閉；訪客一律看不到。變更立即生效。",
     webLogTab: "紀錄分頁：每個 agent 的步驟", webLogTabHint: "在每個 instance 的「紀錄」分頁顯示提示、回覆、工具呼叫與結果，以及 fleet 事件；只在分頁開著時從它自己的對話紀錄讀取。機密值會遮蔽。公開連結也看得到。開啟需 fleet admin 確認。",
     general: "一般設定",
@@ -762,6 +769,7 @@ register("settings", {
     dashboard_task_board: "任務看板",
     dashboard_web_settings: "你的網頁外觀設定",
     dashboard_office: "辦公室：在辦公室畫面走動、說話、做動作",
+    dashboard_office_packs: "辦公室外觀包：檢查、上傳、取代與還原（全 fleet 都看得到）",
     dashboardInherit: "跟 fleet 預設（{0}）",
     dashboardOn: "允許",
     dashboardOff: "關閉",
@@ -833,6 +841,7 @@ register("settings", {
     wizardBackendFound: "在這台主機上找到：{0}",
     wizardBackendNone: "這台主機上找不到任何後端 CLI —— 請先安裝一個。",
     wizardAgentName: "第一個 agent 名稱",
+    wizardGeneralNote: "這個 agent 就是 General：它在聊天本身的 General 主題回覆，並把工作分給你之後加入的 agent。",
     wizardAgentWhich: "由哪個 agent 在這個機器人上回覆",
     wizardAgentNew: "新的 agent",
     wizardAgentExisting: "既有的 agent",
@@ -841,7 +850,10 @@ register("settings", {
     wizardAgentNewName: "新 agent 名稱",
     wizardTopicNotCarried: "它的 topic（{0}）屬於舊連線的聊天室，不會帶過去：在新的聊天室裡，綁定新的 topic 之前它沒有 topic。",
     wizardTopicGeneral: "它是 General agent：在新的聊天室裡會改用那裡的 General topic。",
-    wizardNeedDir: "請輸入絕對路徑的工作目錄。",
+    wizardNeedDir: "工作目錄必須是絕對路徑，或留空。",
+    wizardDir: "工作目錄（選填）",
+    wizardDirDefault: "留空的話，agent 會有自己的資料夾 {0}，由 AgEnD 建立。若要填寫，必須是絕對路徑。",
+    wizardDirDefaultName: "留空的話，agent 會在 AgEnD 的 workspaces 裡有自己的資料夾，由 AgEnD 建立。若要填寫，必須是絕對路徑。",
     wizardTelegramHint: "用 @BotFather 建立 bot，然後把它加進一個群組。",
     wizardDiscordHint: "在 Discord 開發者後台建立應用程式，並把 bot 邀請到你的伺服器。",
     wizardToken: "Bot token",
@@ -1179,7 +1191,7 @@ register("settings", {
     grantsLegacy: "目前訪客能看到的，取決於他們在聊天中的權限。儲存授權後改為明確授權：只有下列的人，只看得到勾選的 agent。",
     grantsConvert: "以目前的訪客為起點", grantsWithAccess: "有存取權的人", grantsNoneYet: "還沒有人有訪客存取權。",
     grantsAdd: "新增人員", grantsSearch: "搜尋曾傳訊息給你的 agent 的人", grantsNoPeople: "沒有符合的人。對方必須先傳過訊息給某個 agent。",
-    grantsChoose: "選擇", grantsChosen: "已選擇", grantsMaySee: "{0} 可以看到：", grantsWroteHere: "傳過訊息", grantsWroteTo: "傳過訊息給：{0}",
+    grantsChoose: "選擇", grantsChosen: "已選擇", grantsMaySee: "{0} 可以看到：", grantsClassicRooms: "ClassicBot 聊天室", grantsWroteHere: "傳過訊息", grantsWroteTo: "傳過訊息給：{0}",
     grantsLastSeen: "最後出現 {0}", grantsRecent: "最近的變更", grantsRecentNone: "還沒有人的存取權變更過。", grantsAuditDirect: "立即生效", grantsAuditConfirmed: "在 General 確認後生效", grantsAuditEnded: "結束了 {0} 個登入", grantsAuditCodeSent: "已寄出登入碼", grantsAuditCodeNot: "登入碼未寄出（{0}）", grantsAuditDmFailed: "私訊沒有送達", grantsAuditWait: "一分鐘內重複要求", grantsAuditAdminLimit: "已達管理員的登入碼上限",
     grantsEditAgents: "編輯 agent", grantsRemove: "移除存取權", grantsUndoRemove: "保留存取權",
     grantsWillBeRemoved: "儲存後存取權就會結束。", grantsNew: "新增 —— 儲存後授權", grantsNoAgents: "至少勾選一個 agent，或移除這個人。",

package/dist/ui/settings-token.js

@@ -4,7 +4,8 @@
 // lives in this field's state only: never in storage, a URL, a label or the page's other state, and the server never
 // hands it back — afterwards a connection shows "Token set · @bot".
 import { html, useState } from "/assets/app-html.js";
-import { t } from "/assets/app-i18n.js";
+import { t, lang } from "/assets/app-i18n.js";
+import { hostText } from "/assets/setup-host-text.js";
 import { useTypedText } from "/assets/text-undo.js";
 import { Icon } from "/assets/ui-icons.js";
 import { api } from "./settings-confirm.js";
@@ -24,7 +25,7 @@ export async function verifyBotToken(platform, token) {
     .catch(() => ({ ok: false, body: {} }));
   // A Discord bot's invite and portal page come with it (#1519 P3).
   if (res.ok && res.body && res.body.identity) return { ...res.body.identity, invite: res.body.invite_url || null, portal: res.body.portal_url || null };
-  return { valid: false, reason: (res.body && res.body.error) || tn("verifyFailed") };
+  return { valid: false, reason: hostText(res.body && res.body.error, lang()) || tn("verifyFailed") };
 }
 
 /** A bot's name as it is addressed: @name, once. */

package/dist/ui/settings-wizard.js

@@ -3,7 +3,8 @@
 // to the ordinary Apply: the app's runner (settings-apply.js) posts the apply and watches its job, with the same
 // progress, deadline and restart recovery as every other change.
 import { html, useEffect, useRef, useState } from "/assets/app-html.js";
-import { t } from "/assets/app-i18n.js";
+import { t, lang } from "/assets/app-i18n.js";
+import { hostText } from "/assets/setup-host-text.js";
 import { useTypedText } from "/assets/text-undo.js";
 import { useLease } from "/assets/app-ctx.js";
 import { Dialog } from "/assets/ui-dialog.js";
@@ -16,6 +17,8 @@ import { DiscordServerPicker } from "./settings-discord.js";
 
 const tn = (k, ...v) => t(`settings.${k}`, ...v);
 const STEPS = 4;
+// #2726: the host's words (English) or code, in the page's language.
+const said = (text) => hostText(text, lang());
 const post = (path, body) => api(path, { method: "POST", body: JSON.stringify(body) }).catch(() => ({ ok: false, status: 0, body: { error: tn("failed") } }));
 
 export function SetupWizard({ ctx, onClose }) {
@@ -41,7 +44,11 @@ export function SetupWizard({ ctx, onClose }) {
       const agents = Array.isArray(e.agents) ? e.agents : [];
       const names = new Set(agents.map((a) => a.name));
       let n = 1; while (names.has(`agent-${n}`)) n++;
-      setW({ step: 1, env: e, backend: (e.backends || [])[0] || "claude-code", working_directory: "", instance_name: `agent-${n}`,
+      // M-2069: on a fleet with no chat connection and no General, the new agent is the General — named "general" (unless
+      // an agent has that name already: #2744 review).
+      const general = !!e.first_general && !names.has("general");
+      setW({ step: 1, env: e, backend: (e.backends || [])[0] || "claude-code", working_directory: "", instance_name: general ? "general" : `agent-${n}`,
+        general, defaultName: `agent-${n}`, nameTyped: false,
         agent: agents.length ? "existing" : "new", existing_name: agents.length ? agents[0].name : "",
         platform: "telegram", token: "", group_id: "", guild_id: "", general_channel_id: "", admin_user_id: "",
         identity: null, guilds: [], plan: null, offset: 0 });
@@ -51,6 +58,11 @@ export function SetupWizard({ ctx, onClose }) {
   // Every field the plan or a probe is about moves the revision (#1529 review r2): a plan or Detect that began before an
   // edit — target, admin, backend, directory, name — is dropped when it lands, never committed or written over the edit.
   const set = (k) => (v) => { bump(); setW((x) => ({ ...x, [k]: v })); };
+  // #2744 review: the General works in its own folder — a typed directory makes the new agent a worker, so a name not
+  // typed by hand goes back to agent-N (and "general" again once the directory is cleared).
+  const asGeneral = (x) => x.general && !x.working_directory;
+  const setDir = (v) => { bump(); setW((x) => { const next = { ...x, working_directory: v };
+    return x.nameTyped ? next : { ...next, instance_name: asGeneral(next) ? "general" : x.defaultName }; }); };
   // No token env: the plan generates one (#1519 P1: AGEND_<PLATFORM>_<ID>_TOKEN, unique) and the commit carries the plan's.
   // An existing agent (#1519 P7) is named and nothing else: the server keeps its directory and backend.
   const input = () => ({
@@ -83,14 +95,15 @@ export function SetupWizard({ ctx, onClose }) {
     if (!lease.current()) return;
     if (rev.current !== at) { setBusy(""); return; }
     setBusy("");
-    if (!res.ok) { setErr((res.body && res.body.error) || tn("applyFailed")); return; }
+    if (!res.ok) { setErr(said(res.body && res.body.error) || tn("applyFailed")); return; }
     if (res.body.found) setW((x) => ({ ...x, offset: res.body.offset, group_id: String(res.body.found.groupId), admin_user_id: String(res.body.found.userId) }));
     else { setW((x) => ({ ...x, offset: res.body.offset })); setErr(tn("wizardNoStartYet")); }
   };
   const next = async () => {
     setErr("");
     if (w.step === 1) {
-      if (w.agent !== "existing" && !w.working_directory.startsWith("/")) { setErr(tn("wizardNeedDir")); return; }
+      // #2726: none is the agent's own workspace (the server fills it in); one that is given is absolute.
+      if (w.agent !== "existing" && w.working_directory && !w.working_directory.startsWith("/")) { setErr(tn("wizardNeedDir")); return; }
       setW({ ...w, step: 2 }); return;
     }
     if (w.step === 2) { setW({ ...w, step: 3 }); return; }
@@ -104,7 +117,7 @@ export function SetupWizard({ ctx, onClose }) {
       if (!lease.current()) return;
       setBusy("");
       if (rev.current !== at) return;
-      if (!res.ok) { setErr((res.body && res.body.error) || tn("applyFailed")); return; }
+      if (!res.ok) { setErr(said(res.body && res.body.error) || tn("applyFailed")); return; }
       setW((x) => ({ ...x, plan: res.body, step: 4 }));
       return;
     }
@@ -140,8 +153,10 @@ export function SetupWizard({ ctx, onClose }) {
         <p class="note">${tn("wizardAgentExistingNote")}</p></div>` : html`${which}<div class="field"><label for="wz-be">${tn("wizardBackend")}</label>
         <${Select} id="wz-be" value=${w.backend} onChange=${set("backend")} options=${w.env.backends && w.env.backends.length ? w.env.backends : BACKENDS} />
         <p class="note">${w.env.backends && w.env.backends.length ? tn("wizardBackendFound", w.env.backends.join(", ")) : tn("wizardBackendNone")}</p></div>
-      <div class="field"><label for="wz-wd">${tn("workingDir")}</label><input id="wz-wd" type="text" placeholder="/home/you/projects/app" value=${dirText} onInput=${(e) => set("working_directory")(onDirText(e.target.value))} /></div>
-      <div class="field"><label for="wz-name">${agents.length ? tn("wizardAgentNewName") : tn("wizardAgentName")}</label><input id="wz-name" type="text" value=${nameText} onInput=${(e) => set("instance_name")(onNameText(e.target.value))} /></div>`;
+      <div class="field"><label for="wz-wd">${tn("wizardDir")}</label><input id="wz-wd" type="text" placeholder="/home/you/projects/app" aria-describedby="wz-wd-note" value=${dirText} onInput=${(e) => setDir(onDirText(e.target.value))} />
+        <p class="note" id="wz-wd-note">${w.env.workspaces_dir && w.instance_name ? tn("wizardDirDefault", `${w.env.workspaces_dir}/${w.instance_name}`) : tn("wizardDirDefaultName")}</p></div>
+      <div class="field"><label for="wz-name">${agents.length ? tn("wizardAgentNewName") : tn("wizardAgentName")}</label><input id="wz-name" type="text" value=${nameText} onInput=${(e) => { const v = onNameText(e.target.value); bump(); setW((x) => ({ ...x, instance_name: v, nameTyped: true })); }} />
+        ${asGeneral(w) ? html`<p class="note">${tn("wizardGeneralNote")}</p>` : null}</div>`;
   } else if (w.step === 2) {
     body = html`<div class="seg-inline" role="group" aria-label=${tn("wizardPlatform")}>
         ${["telegram", "discord"].map((p) => html`<button key=${p} type="button" class=${`btn${w.platform === p ? " btn-primary" : ""}`} aria-pressed=${w.platform === p ? "true" : "false"}
@@ -164,12 +179,13 @@ export function SetupWizard({ ctx, onClose }) {
     body = !w.plan ? html`<p class="note">${tn("wizardPlanLoading")}</p>` : html`
       <p><strong>${tn("wizardWillWrite")}</strong></p>
       <pre class="s-yaml">${toYaml({ channels: [w.plan.channel], instances: { [w.plan.instance.name]: { working_directory: w.plan.instance.working_directory, backend: w.plan.instance.backend, channel_id: w.plan.instance.channel_id,
-        ...(w.plan.instance.topic && w.plan.instance.topic.to != null ? { topic_id: w.plan.instance.topic.to } : {}) } } })}</pre>
+        ...(w.plan.instance.topic && w.plan.instance.topic.to != null ? { topic_id: w.plan.instance.topic.to } : {}),
+        ...(w.plan.instance.general ? { general_topic: true, ...(w.plan.instance.general.topic_id != null ? { topic_id: w.plan.instance.general.topic_id } : {}) } : {}) } } })}</pre>
       ${w.plan.instance && w.plan.instance.existing ? html`<p class="note">${tn("wizardAgentExistingNote")}</p>` : null}
       ${w.plan.instance && w.plan.instance.topic ? html`<p class="feedback warning">${w.plan.instance.topic.to == null
         ? tn("wizardTopicNotCarried", w.plan.instance.topic.from) : tn("wizardTopicGeneral")}</p>` : null}
       <${Drawer} title=${tn("advancedSection")}><${TokenEnvNote} name=${w.plan.token_env} /></${Drawer}>
-      ${(w.plan.warnings || []).map((x, i) => html`<p key=${i} class="feedback warning">${x}</p>`)}`;
+      ${(w.plan.warnings || []).map((x, i) => html`<p key=${i} class="feedback warning">${said(x)}</p>`)}`;
   }
   return html`<${Dialog} title=${tn("wizardTitle")} onClose=${onClose} wide=${true} busy=${busy === tn("wizardCommitting")}
     actions=${html`<button type="button" class="btn" disabled=${w.step === 1 || !!busy} onClick=${() => setW({ ...w, step: w.step - 1 })}>${tn("wizardBack")}</button>

package/dist/ui/shared/app-i18n.js

@@ -105,7 +105,7 @@ register("app", {
     confirmTitle: "Please confirm", confirmOk: "Continue", cancel: "Cancel",
     sidePanelLeave: "Leave {0} without saving? Your changes there will be lost.", sidePanelDiscard: "Discard changes",
     // The server's own wording (src/locale.ts needs.reason.*), so the web says what Discord says.
-    needs_reason_hang: "Not responding", needs_reason_exited: "Exited", needs_reason_assist: "Waiting at its terminal", needs_reason_permission: "Permission needed", needs_reason_dangerous_command: "Dangerous command waiting", needs_reason_login: "Sign-in needed", needs_reason_dialog: "Waiting at a dialog", needs_reason_terminal_input: "May be waiting for input", needs_reason_auth_paused: "Paused: sign-in needed", needs_reason_backend_signin: "Backend sign-in needed", needs_reason_crashed: "Crashed", needs_reason_delivery_uncertain: "Could not confirm delivery", needs_reason_delivery_failed: "Delivery failed", needs_reason_task_review: "Waiting for your confirmation", needs_reason_task_blocked: "Blocked: asks you",
+    needs_reason_hang: "Not responding", needs_reason_exited: "Exited", needs_reason_assist: "Waiting at its terminal", needs_reason_question: "Asking you a question", needs_reason_permission: "Permission needed", needs_reason_dangerous_command: "Dangerous command waiting", needs_reason_login: "Sign-in needed", needs_reason_dialog: "Waiting at a dialog", needs_reason_terminal_input: "May be waiting for input", needs_reason_auth_paused: "Paused: sign-in needed", needs_reason_backend_signin: "Backend sign-in needed", needs_reason_crashed: "Crashed", needs_reason_delivery_uncertain: "Could not confirm delivery", needs_reason_delivery_failed: "Delivery failed", needs_reason_task_review: "Waiting for your confirmation", needs_reason_task_blocked: "Blocked: asks you",
   },
   "zh-TW": {
     brand: "AgEnD", fleet: "Fleet", fleetOverview: "Fleet 概覽", view: "檢視", settings: "設定", instances: "Instances", newInstance: "新增 instance", newAgent: "新增 Agent",
@@ -145,6 +145,6 @@ register("app", {
     search: "搜尋", searchTitle: "搜尋聊天、agent 之間的訊息與任務（{0}）",
     confirmTitle: "請確認", confirmOk: "繼續", cancel: "取消",
     sidePanelLeave: "不儲存就離開「{0}」？你在那裡的修改會遺失。", sidePanelDiscard: "捨棄修改",
-    needs_reason_hang: "沒有回應", needs_reason_exited: "已結束", needs_reason_assist: "在終端機上等待", needs_reason_permission: "需要權限", needs_reason_dangerous_command: "危險指令待確認", needs_reason_login: "需要登入", needs_reason_dialog: "停在對話框", needs_reason_terminal_input: "可能在等輸入", needs_reason_auth_paused: "已暫停：需要登入", needs_reason_backend_signin: "後端需要登入", needs_reason_crashed: "已崩潰", needs_reason_delivery_uncertain: "無法確認是否送達", needs_reason_delivery_failed: "傳送失敗", needs_reason_task_review: "等你確認", needs_reason_task_blocked: "卡住，在問你",
+    needs_reason_hang: "沒有回應", needs_reason_exited: "已結束", needs_reason_assist: "在終端機上等待", needs_reason_question: "正在問你問題", needs_reason_permission: "需要權限", needs_reason_dangerous_command: "危險指令待確認", needs_reason_login: "需要登入", needs_reason_dialog: "停在對話框", needs_reason_terminal_input: "可能在等輸入", needs_reason_auth_paused: "已暫停：需要登入", needs_reason_backend_signin: "後端需要登入", needs_reason_crashed: "已崩潰", needs_reason_delivery_uncertain: "無法確認是否送達", needs_reason_delivery_failed: "傳送失敗", needs_reason_task_review: "等你確認", needs_reason_task_blocked: "卡住，在問你",
   },
 });

package/dist/ui/shared/app-stream.js

@@ -37,7 +37,7 @@
 // offices — the stored offices changed ({ rev }; SSE only: the Office view reads /ui/offices again).
 // office_skins — a skin pack was uploaded or deleted ({ rev }; SSE only: the Office view reads /ui/office-skins again).
 // office_acts — the agents' live acts in the Office view changed ({ acts }, #2578; a poll page reads /ui/office-acts).
-const EVENTS = ["status", "message", "agent_reply_live", "delivery", "deliveries", "prompt", "prompts", "prompt_resolved", "activity", "needs", "reply_buttons", "reactions", "steps_tick", "clock", "traffic", "delegation", "backend_login", "tasks", "offices", "office_skins", "office_acts"];
+const EVENTS = ["status", "message", "agent_reply_live", "delivery", "deliveries", "prompt", "prompts", "prompt_resolved", "activity", "needs", "reply_buttons", "reactions", "steps_tick", "clock", "traffic", "delegation", "backend_login", "tasks", "offices", "office_skins", "office_acts", "office_pack_changes"];
 const MAX_HELD = 1000;                    // live events held during one catch-up read; more → read again afterwards
 const RETRY_DELAYS = [1000, 2000, 4000];  // after the first failed catch-up read; then it waits for Retry
 const POLL_LIMIT_MS = 10000;              // a poll that has not answered by then counts as failed

package/dist/ui/shared/app.css

@@ -873,6 +873,9 @@ img.amb-p { object-fit: contain; }
 .st-link:hover { text-decoration-thickness: 2px; }
 .prompt .acts { display: flex; gap: var(--s-2); margin-top: var(--s-2); align-items: center; flex-wrap: wrap; }
 .prompt .wait { font-size: var(--fs-xs); color: var(--text-3); }
+/* #2675: a prompt's typed answer. 16px keeps iOS from zooming in on focus (#1612). */
+.prompt .prompt-text { display: flex; gap: var(--s-2); margin-top: var(--s-2); }
+.prompt .prompt-text input { flex: 1; min-width: 0; font-size: 16px; }
 .work-bar { display: flex; gap: var(--s-2); align-items: center; padding: 0 var(--s-2); font-size: var(--fs-sm); color: var(--text-2); }
 .work-bar .lbl { flex: 1; min-width: 0; }
 .work-bar .pulse { width: 8px; height: 8px; border-radius: 50%; background: var(--ok); animation: pulse 1.2s ease-in-out infinite; flex-shrink: 0; }
@@ -931,6 +934,8 @@ img.amb-p { object-fit: contain; }
 .s-guests .guest-names { display: grid; grid-template-columns: repeat(auto-fill, minmax(180px, 1fr)); gap: 2px var(--s-3); max-height: 220px; overflow: auto;
   padding: var(--s-1) 0; border-top: 1px solid var(--border); border-bottom: 1px solid var(--border); }
 .s-guests .guest-name span { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+/* #2667: the ClassicBot rooms follow the fleet's instances under their own heading, across the grid. */
+.s-guests .guest-names-group { grid-column: 1 / -1; margin-top: var(--s-2); }
 .s-guests .guest-list, .s-guests .g-pick { list-style: none; margin: 0 0 var(--s-3); padding: 0; display: flex; flex-direction: column; border-top: 1px solid var(--border); }
 .s-guests .guest-row, .s-guests .g-cand { padding: var(--s-3) 0; border-bottom: 1px solid var(--border); min-width: 0; }
 .s-guests .guest-row.s-dirty { border-radius: 0; margin-left: 0; align-self: stretch; padding-left: calc(var(--s-2) + 3px); padding-right: var(--s-2); }
@@ -1793,6 +1798,8 @@ strong.org-name { font-size: var(--fs-sm); color: var(--text); }
 .oo-zoom .oo-fill { font-size: 11px; font-weight: var(--fw-semibold); }
 .oo-zoom .oo-fill.on { background: var(--accent-dim); color: var(--text); }
 .oo-stage.editing .oo-mini { display: none; }
+/* #2737: a single office all in view (the page sets data-whole): the overview would repeat the panel. */
+.oo-mini[data-whole] { display: none; }
 .oo-mini-scene { fill: var(--bg); }
 .oo-mini-room { fill: var(--surface); stroke: var(--border-strong); stroke-width: 6; }
 .oo-mini-dot { fill: var(--text-3); }
@@ -1802,6 +1809,47 @@ strong.org-name { font-size: var(--fs-sm); color: var(--text); }
 .oo-mini-dot.match { fill: var(--focus); }
 .oo-tip { position: absolute; left: 0; top: 0; z-index: 5; max-width: 240px; pointer-events: none; padding: 6px 10px; font-size: var(--fs-xs); line-height: 1.4;
   color: var(--text); background: var(--surface); border: 1px solid var(--border); border-radius: var(--r-md); box-shadow: var(--shadow-2); overflow-wrap: anywhere; }
+/* #2661: a person's profile card — a popover beside them (placed by the page: transform through the CSSOM), 320 px fixed;
+   on a phone a bottom sheet. Tone over borders; the status tokens for the level's tier. */
+.oo-card { position: absolute; left: 0; top: 0; z-index: 8; width: 320px; box-sizing: border-box; padding: var(--s-3); font-size: var(--fs-sm); line-height: var(--lh-sm);
+  color: var(--text); background: var(--surface); border: 1px solid var(--border); border-radius: var(--r-lg); box-shadow: var(--shadow-2); }
+.oo-card.sheet { position: fixed; left: 0; right: 0; top: auto; bottom: 0; width: auto; transform: none; z-index: 40; border-radius: var(--r-lg) var(--r-lg) 0 0;
+  padding-bottom: calc(var(--s-3) + env(safe-area-inset-bottom, 0px)); touch-action: none; }
+/* On a phone the tab bar is fixed at the window's foot (z 35): the sheet sits above it. */
+@media (max-width: 899px) {
+  .oo-card.sheet { bottom: calc(56px + env(safe-area-inset-bottom, 0px)); padding-bottom: var(--s-3); }
+  .kb-open .oo-card.sheet { bottom: 0; }
+}
+.oo-card-grip { width: 36px; height: 4px; margin: 0 auto var(--s-2); border-radius: var(--r-full); background: var(--surface-2); }
+.oo-card-head { display: flex; gap: var(--s-3); align-items: flex-start; }
+.oo-card-avatar { position: relative; flex: none; width: 56px; height: 56px; border-radius: var(--r-md); background: var(--surface-2); }
+.oo-card-avatar canvas { width: 56px; height: 56px; image-rendering: pixelated; }
+.oo-card-avatar .oo-badge { position: absolute; left: -6px; top: -6px; }
+.oo-card-names { flex: 1; min-width: 0; }
+.oo-card-name { display: block; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+/* One line, cut; a fixed line height so a CJK fallback in the mono stack doesn't make it taller. */
+.oo-card-instance { height: 18px; line-height: 18px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-size: var(--fs-xs); color: var(--text-2); }
+.oo-card-state { color: var(--text-2); }
+.oo-card-close { flex: none; margin: -4px -4px 0 0; }
+.oo-card-xp { margin-top: var(--s-3); }
+.oo-card-bar { display: block; width: 100%; height: 6px; margin-top: var(--s-1); appearance: none; border: 0; border-radius: var(--r-full); background: var(--surface-2); overflow: hidden; }
+.oo-card-bar::-webkit-progress-bar { background: var(--surface-2); border-radius: var(--r-full); }
+.oo-card-bar::-webkit-progress-value { background: var(--accent); border-radius: var(--r-full); }
+.oo-card-bar::-moz-progress-bar { background: var(--accent); border-radius: var(--r-full); }
+.oo-card-rows { display: grid; grid-template-columns: 1fr 1fr; gap: var(--s-2) var(--s-3); margin: var(--s-3) 0 0; }
+.oo-card-rows > div { min-width: 0; }
+.oo-card-rows dt { font-size: var(--fs-xs); color: var(--text-3); }
+.oo-card-rows dd { margin: 0; overflow-wrap: anywhere; }
+.oo-card-now { margin-top: var(--s-3); overflow-wrap: anywhere; }
+.oo-card-actions { display: flex; justify-content: flex-end; gap: var(--s-2); margin-top: var(--s-3); }
+.oo-badge { display: inline-block; min-width: 18px; padding: 0 4px; box-sizing: border-box; font-size: 10px; font-weight: var(--fw-semibold); line-height: 16px; text-align: center;
+  border-radius: var(--r-sm); border: 1px solid var(--border); background: var(--surface-2); color: var(--text-2); }
+.oo-badge.mark { min-width: 10px; width: 10px; height: 10px; padding: 0; transform: rotate(45deg); border-radius: 2px; }
+.oo-badge.tier-1 { background: var(--ok-bg); color: var(--ok); border-color: var(--ok); }
+.oo-badge.tier-2 { background: var(--accent-dim); color: var(--accent); border-color: var(--accent); }
+.oo-badge.tier-3 { background: var(--accent); color: var(--surface); border-color: var(--accent); }
+.oo-badge.tier-4 { background: var(--warn-bg); color: var(--warn); border-color: var(--warn); }
+.oo-badge.tier-5 { background: var(--danger-bg); color: var(--danger); border-color: var(--danger); }
 /* #2554: All offices — each tile's label (office name and head count) just above the tile, placed by the page (left, top,
    max-width through the CSSOM); a button that opens the office, the lobby's a plain chip. */
 .oo-tile-label { position: absolute; left: 0; top: 0; z-index: 3; transform: translateY(calc(-100% - 4px)); max-width: 240px; overflow: hidden; text-overflow: ellipsis;
@@ -1846,10 +1894,18 @@ html.oo-immersive .p-fleet > .panel-body { z-index: 50; }
 .ol-seat > circle { fill: var(--ok); }
 .ol-furniture > rect { fill: var(--warn); }
 .ol-door > rect { fill: var(--danger); }
+/* #2736: the mail drop — an envelope; dashed while it is the automatic spot (the pack names none). */
+.ol-mail > rect { fill: var(--accent-dim); }
+.ol-mail > .ol-flap { fill: none; stroke: var(--text); stroke-width: 1.5; pointer-events: none; }
+.ol-mail.auto > rect { stroke-dasharray: 3 2; fill-opacity: 0.6; }
 /* #2665: an item's night place — a moon on a faint disc, a thin dashed line to its day place. */
 .ol-night > circle { fill: var(--surface); fill-opacity: 0.85; }
 .ol-night > .ol-moon { fill: var(--warn); stroke: none; pointer-events: none; }
 .ol-night-line { stroke: var(--warn); stroke-width: 1.5; stroke-dasharray: 4 3; stroke-opacity: 0.8; pointer-events: none; }
+/* #2691: a reserved seat — a dashed ring round its dot; the selected seat's "Reserved for" picks. */
+.ol-seat > .ol-for-ring { fill: none; stroke: var(--warn); stroke-width: 2; stroke-dasharray: 3 3; pointer-events: none; }
+.ol-for { display: inline-flex; flex-wrap: wrap; align-items: center; gap: 4px var(--s-2); }
+.ol-for > legend { float: left; margin-right: var(--s-2); }
 .ol-waypoint > circle { fill: var(--focus); }
 .ol-handle.on > circle, .ol-handle.on > rect, .ol-handle:focus-visible > circle, .ol-handle:focus-visible > rect { stroke: var(--focus); stroke-width: 4; }
 .ol-bar { position: absolute; left: 0; right: 0; bottom: 0; z-index: 8; display: flex; flex-wrap: wrap; align-items: center; gap: var(--s-2); padding: var(--s-2);
@@ -1861,14 +1917,23 @@ html.oo-immersive .p-fleet > .panel-body { z-index: 50; }
 .ol-corridors { display: inline-flex; flex-wrap: wrap; gap: 4px; }
 .ol-msg { flex-basis: 100%; margin: 0; }
 @media (max-width: 640px) {
-  /* A phone: the bars at the column's narrower padding; the stage at least most of a screen; no overview (as the canvas). */
+  /* A phone: the bars at the column's narrower padding; no overview (as the canvas). #2689: the stage takes the panel's
+     height that is left under the bars (the column, .oc-office and .oo grow into it) and no more, so zoomed in the
+     scene's bottom is on screen: a floor fixed to the window (100dvh less a guess at the bars) put it under the tab bar
+     once the bars wrapped. Its own floor is low enough for a 375 × 667 phone with the Office bar on five rows (215 px
+     left); only a shorter screen scrolls the panel (on the bars: the stage's touches are its own). */
   .oc-office > .oc-bar { padding: var(--s-2) var(--s-3); }
   .oc-office > .oc-legend { margin: 0 var(--s-3) var(--s-2); }
   .oo > :not(.oo-stage):not(dialog) { margin-left: var(--s-3); margin-right: var(--s-3); }
-  .oo-stage { min-height: max(300px, calc(100dvh - 300px)); }
+  .oo-stage { min-height: 200px; }
   .oo-pick .tb-select { max-width: 150px; }
   .oo-mini { display: none; }
   .oo-zoom .icon-btn { width: 40px; height: 40px; }
+  /* #2689: a column of the label and five 40 px buttons (~240 px) is taller than that stage: a row along its top
+     instead, out of fullscreen (there the stage is the screen, and the office switcher is on the left of its top). */
+  .oo:not(.fs) .oo-zoom { flex-direction: row; }
+  .oo:not(.fs) .oo-zoom-pct { display: flex; align-items: center; padding: 0 6px; border-bottom: 0; border-right: 1px solid var(--border); }
+  .oo:not(.fs) .oo-zoom .icon-btn + .icon-btn { border-top: 0; border-left: 1px solid var(--border); }
 }
 /* A phone: Fleet's five tabs fit when only the open one shows its label (the others keep theirs for screen readers). */
 @media (max-width: 479px) {
@@ -2368,6 +2433,9 @@ html.oo-immersive .p-fleet > .panel-body { z-index: 50; }
 .tb-tile-note { display: flex; gap: var(--s-1); align-items: flex-start; font-size: var(--fs-xs); color: var(--text-2); overflow-wrap: anywhere; }
 /* A main task's sub task at work now (its worker in the foot), and what a card waiting for you still lacks. */
 .tb-tile-now { display: flex; align-items: baseline; gap: var(--s-1); min-width: 0; font-size: var(--fs-xs); color: var(--text-2); }
+/* #2080: whom a card in review waits for — the person (accented), or the agent that confirms it. */
+.tb-tile-waits { font-size: var(--fs-xs); color: var(--text-2); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.tb-tile-waits.you { color: var(--text); font-weight: var(--fw-semibold); }
 .tb-now-title { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 .tb-now-label { flex-shrink: 0; font-size: 11px; font-weight: var(--fw-semibold); color: var(--text-2); }
 .tb-now-label.st-claimed { color: var(--accent); }

package/dist/ui/shared/setup-host-text.js

@@ -0,0 +1,107 @@
+// #2726: what the setup host and the wizard's routes answer with — English words, or a code — in English and 繁體中文.
+// One table for every page that shows them: the setup pages (src/setup-i18n.ts pastes this module into them, before any
+// fleet, with its `export`s taken out) and the dashboard's Setup wizard and Apply (/assets/setup-host-text.js). Plain
+// script with no imports and no closing script tag, so it can be pasted as it is.
+
+/**
+ * The host's English words → 繁體中文. `{0}`, `{1}` are the parts that vary (a name, a count). Kept to the exact wording
+ * of the host (setup-host.ts, quickstart-api.ts, token-env-name.ts, the provider probes); tests/setup-i18n-2726.test.ts
+ * drives each source and checks it is here.
+ */
+export const HOST_MESSAGES = [
+  // The code page (setup-host.ts redeem / afterFailure / the cookie gate).
+  ["incorrect — {0} attempts left", "代碼不正確 —— 還可以再試 {0} 次"],
+  ["incorrect — {0} attempt left", "代碼不正確 —— 還可以再試 {0} 次"],
+  ["too many failed attempts — run `agend setup` again on the host", "錯誤次數太多 —— 請在主機上再執行一次 `agend setup`"],
+  ["enter the setup code", "請輸入設定代碼"],
+  ["enter the setup code first", "請先輸入設定代碼"],
+  ["cross-site request rejected", "已拒絕跨站請求"],
+  ["not found", "找不到"],
+  // Finishing (setup-host.ts finishSetup / status).
+  ["Setup changed; review and confirm again.", "設定已改變；請重新檢查並再確認一次。"],
+  ["Setup confirmation unavailable.", "無法取得設定確認。"],
+  // The wizard's validation (quickstart-api.ts validateWizardInput, validateWebOnlyInput).
+  ["working_directory must be an absolute path, or empty for the agent's own workspace", "工作目錄必須是絕對路徑，或留空讓 agent 使用自己的資料夾"],
+  ["instance_name must be [A-Za-z0-9._-], and not only dots", "agent 名稱只能用英文字母、數字和 . _ -，而且不能只有句點"],
+  ["backend must be a known backend", "請選擇一個支援的後端"],
+  ["{0} does not apply to a web-only setup", "只用網頁的設定不使用 {0}"],
+  ["platform must be telegram or discord", "平台必須是 Telegram 或 Discord"],
+  ["token_env must be an UPPER_SNAKE env var name", "環境變數名稱只能用大寫英文字母、數字和底線（例如 AGEND_BOT_TOKEN）"],
+  // A specific wording before the general one it would also match (the first that matches is used).
+  ["guild id must be numeric", "伺服器 id 必須是數字"],
+  ["{0} must be numeric", "{0} 必須是數字"],
+  ["Your Discord user ID is required: enter 17–20 digits, without a leading zero.", "Discord 使用者 ID 必填：請輸入 17–20 位數字，開頭不能是 0。"],
+  ["Your Telegram user ID is required: enter 1–20 positive digits, without a leading zero.", "Telegram 使用者 ID 必填：請輸入 1–20 位正整數字，開頭不能是 0。"],
+  // Conflicts (agentConflict, newConnectionConflict, webOnlyConflict, token-env-name.ts).
+  ["an agent called \"{0}\" already exists — connect it as an existing agent, or choose another name", "已經有名為「{0}」的 agent —— 請把它當作既有的 agent 連接，或換一個名稱"],
+  ["there is no agent called \"{0}\"", "沒有名為「{0}」的 agent"],
+  ["the General agent works in its own folder — leave the working directory empty to make \"{0}\" the General, or choose another name", "General agent 使用自己的資料夾 —— 若要讓「{0}」成為 General，請把工作目錄留空，或換一個名稱"],
+  ["the name \"{0}\" is kept for the fleet's General agent — choose another name", "「{0}」這個名稱保留給 fleet 的 General agent —— 請換一個名稱"],
+  ["a connection called \"{0}\" already exists — a new connection never replaces one", "已經有名為「{0}」的連線 —— 新的連線不會取代既有的連線"],
+  ["this fleet already has a chat connection — add the agent with New agent instead", "這個 fleet 已經有聊天連線 —— 請改用「新增 Agent」加入 agent"],
+  ["{0} is reserved", "{0} 是保留名稱"],
+  ["{0} already holds the token of the \"{1}\" connection — a new connection never replaces one; use Replace token on that connection", "{0} 已經存著「{1}」連線的 token —— 新的連線不會取代它；請在那個連線上用「更換 token」"],
+  ["{0} is no longer free (it was taken after this setup was planned) — plan it again", "{0} 已被使用（在這次設定規劃之後）—— 請重新產生一次"],
+  ["the data dir's .env cannot be read: {0}", "無法讀取資料目錄的 .env：{0}"],
+  // Requests and writes (quickstart-api.ts handlers).
+  ["token required", "請輸入 bot token"],
+  ["invalid JSON", "請求內容不是有效的 JSON"],
+  ["bad request", "請求無效"],
+  ["unknown probe", "不支援的檢查"],
+  ["fleet not loaded", "設定尚未載入"],
+  ["another secret operation is still running", "另一個寫入 token 的操作還在進行中"],
+  ["setup cleanup failed; inspect configuration on the host", "設定的復原失敗；請在主機上檢查設定"],
+  ["setup was not committed", "設定沒有寫入"],
+  ["Token verification is not permitted over a public link", "公開連結不能驗證 token"],
+  ["This bot token is already being polled by the running fleet. Enter the group id by hand, or stop AgEnD first.", "執行中的 fleet 正在使用這個 bot token。請手動輸入群組 id，或先停止 AgEnD。"],
+  ["Another process is already reading this bot's updates. Stop it, or enter the group id by hand.", "另一個程式正在讀取這個 bot 的訊息。請停止它，或手動輸入群組 id。"],
+  ["Discord replied {0}", "Discord 回應 {0}"],
+  ["Telegram replied {0}", "Telegram 回應 {0}"],
+  // The plan's warning (quickstart-api.ts planQuickstart and the web-only plan).
+  ["{0} was not found on this host; the agent will fail to start until it is installed.", "這台主機上找不到 {0}；安裝之前，agent 會無法啟動。"],
+];
+
+/** What the host answers with a code instead of words (the confirmation gate, settings-effect.ts; the finish step). */
+export const HOST_CODES = {
+  en: {
+    invalid_quickstart: "This setup is not valid. Review it and try again.",
+    connection_exists: "That connection already exists — a new connection never replaces one.",
+    agent_conflict: "That agent name is taken, or that agent does not exist.",
+    too_many_pending_changes: "Too many changes are waiting for confirmation. Deal with them on the host first.",
+    idempotency_key_reused: "This request was already sent with different content. Review it and send it again.",
+    settings_confirmation_unavailable: "Host confirmation is not available right now. Try again shortly.",
+    session_required: "This setup session has ended. Reopen setup on the host.",
+    invalid_json: "The request was not valid JSON.",
+    invalid_settings_body: "The request was not valid.",
+    signin_cleanup_failed: "The login process could not be confirmed closed. Close it on the host and restart setup before retrying.",
+  },
+  "zh-TW": {
+    invalid_quickstart: "這份設定無效。請檢查後再試一次。",
+    connection_exists: "這個連線已存在 —— 新的連線不會取代既有的連線。",
+    agent_conflict: "這個 agent 名稱已被使用，或那個 agent 不存在。",
+    too_many_pending_changes: "等待確認的變更太多。請先在主機上處理它們。",
+    idempotency_key_reused: "這個請求已經用不同的內容送出過。請重新檢查後再送出。",
+    settings_confirmation_unavailable: "目前無法要求主機確認。請稍後再試。",
+    session_required: "這個設定工作階段已結束。請在主機上重新開啟設定。",
+    invalid_json: "請求內容不是有效的 JSON。",
+    invalid_settings_body: "請求無效。",
+    signin_cleanup_failed: "無法確認登入程序已關閉。請在主機上關閉它，並重新開始設定後再試。",
+  },
+};
+
+const patterns = HOST_MESSAGES.map(([en, zh]) => ({
+  zh, holes: [...en.matchAll(/\{(\d)\}/g)].map((m) => m[1]),
+  pattern: new RegExp("^" + en.split(/\{\d\}/).map((part) => part.replace(/[.*+?^$|()[\]{}\\]/g, "\\$&")).join("(.+?)") + "$"),
+}));
+
+/** The host's words, or its code, in `lang` ("en" | "zh-TW"); anything it does not know stays as it came. */
+export function hostText(text, lang) {
+  if (typeof text !== "string") return text;
+  if (Object.hasOwn(HOST_CODES.en, text)) return (HOST_CODES[lang] || HOST_CODES.en)[text];
+  if (lang !== "zh-TW") return text;
+  for (const { zh, holes, pattern } of patterns) {
+    const found = pattern.exec(text);
+    if (found) { let out = zh; holes.forEach((hole, i) => { out = out.split("{" + hole + "}").join(found[i + 1]); }); return out; }
+  }
+  return text;
+}