@songsid/agend 2.3.2-beta.12 → 2.3.2-beta.14

package/dist/setup-i18n.js

@@ -0,0 +1,224 @@
+/**
+ * #2726: the setup pages in English and 繁體中文.
+ *
+ * Both pages are inline (setup-form.ts) and run before any fleet — no dashboard, no /assets — so they carry their own
+ * small dictionary and the few lines that use it (SETUP_I18N_RUNTIME). The choice works as the dashboard's does
+ * (src/ui/shared/app-i18n.js): the language chosen in this browser (`agend_lang`, the dashboard's own key, so the
+ * dashboard opened afterwards on this address keeps it), else the browser's language; a toggle on the page changes it.
+ * The wording is the dashboard's where it already says the same thing (settings-strings.js wizard*).
+ *
+ * What the host says (its errors) is English, or a code: src/ui/shared/setup-host-text.js says each one the page can show
+ * in both languages — the same module the dashboard's Setup wizard uses. One it does not know is shown as it came.
+ */
+import { readFileSync } from "node:fs";
+/** The code-entry page: before the code, nothing about this machine (setup-form.ts SETUP_CODE_PAGE_HTML). */
+export const SETUP_CODE_STRINGS = {
+    en: {
+        title: "Set up AgEnD",
+        otherLang: "中文",
+        langTitle: "Language",
+        lead: "Enter the setup code shown in the terminal where you ran {0}.",
+        continue: "Continue",
+        unreachable: "Could not reach the setup page.",
+        notAccepted: "That code was not accepted.",
+    },
+    "zh-TW": {
+        title: "設定 AgEnD",
+        otherLang: "English",
+        langTitle: "語言",
+        lead: "請輸入執行 {0} 的終端機上顯示的設定代碼。",
+        continue: "繼續",
+        unreachable: "無法連到設定頁。",
+        notAccepted: "這個代碼不正確。",
+    },
+};
+/** The setup form (setup-form.ts SETUP_FORM_HTML). */
+export const SETUP_FORM_STRINGS = {
+    en: {
+        title: "Set up AgEnD",
+        otherLang: "中文",
+        langTitle: "Language",
+        intro: "This page is open only while setup is running. It closes itself when you finish, or after 15 minutes.",
+        signinsLabel: "AI backend sign-ins",
+        stepAgent: "1 · Agent",
+        backend: "Backend",
+        backendFound: "Found on this host: {0}",
+        backendNone: "No backend CLI found on this host — install one first.",
+        dir: "Working directory (optional)",
+        dirPlaceholder: "/home/you/projects/app",
+        dirDefault: "Leave it empty and the agent gets its own folder, {0}, which AgEnD creates. A path you enter must be absolute.",
+        dirDefaultName: "Leave it empty and the agent gets its own folder in AgEnD's workspaces, which AgEnD creates. A path you enter must be absolute.",
+        name: "First agent name",
+        stepPlatform: "2 · Platform",
+        webOnly: "Web only (no bot)",
+        hintTelegram: "Create a bot with @BotFather, then add it to a group.",
+        hintDiscord: "Create an application in the Discord developer portal and invite the bot to your server.",
+        hintWeb: "No bot: you use AgEnD from its web dashboard (chat, sign-ins, settings). Discord or Telegram can be added later in Settings.",
+        stepCredentials: "3 · Credentials",
+        token: "Bot token",
+        tokenNote: "Written to ~/.agend/.env and never shown again.",
+        tokenEnv: "Environment variable",
+        verify: "Verify",
+        verifying: "Asking the provider…",
+        verified: "verified",
+        rejected: "rejected",
+        guild: "Server (guild)",
+        general: "General channel id",
+        discordAdmin: "Your Discord user id",
+        telegramAdmin: "Your Telegram user id",
+        firstAllowed: "Becomes the first allowed user.",
+        group: "Group id",
+        groupHint: "Or post any message in the group and press Detect.",
+        detect: "Detect from a message",
+        detectWaiting: "Waiting for a message in the group…",
+        detectFound: "Found.",
+        detectNone: "No group message yet — post one and press Detect again.",
+        failed: "Failed.",
+        stepReview: "4 · Review and start",
+        preview: "Show what will be written",
+        finish: "Create and start AgEnD",
+        start: "Start AgEnD",
+        reopen: "Reopen it where you started setup: in the Windows installer, press Enter in its window; otherwise run agend setup again on the computer running AgEnD.",
+        closed: "This setup page has closed.",
+        closedFinish: "This setup page has closed. {0} Backends you already signed in stay signed in.",
+        closesIn: "This page closes in {0} at the latest (sooner after 10 minutes without activity).",
+        closesSoon: "{0} Finish soon. If it closes first: {1}",
+        approveHost: "Approve this on the computer running AgEnD. The Windows installer opens a confirmation window for it, and shows a command to paste if no window appears. Otherwise run there: agend settings confirm {0}",
+        confirmGone: "Setup confirmation is no longer available. Review and enter the token again.",
+        notApplied: "Change was not applied. Review and enter the token again.",
+        confirmed: "Configuration confirmed. Select Start AgEnD to finish setup.",
+        lostContact: "Lost contact with the setup page; still trying. If this stays, the page has closed. {0}",
+        finishSignins: "Finish backend sign-in or choose Sign in later before continuing.",
+        notCurrent: "Confirmation is no longer current.",
+        startingWeb: "AgEnD is starting. Its dashboard link shows here once it is up.",
+        startingChat: "AgEnD is starting. Continue in the channel you configured.",
+        requesting: "Requesting host confirmation…",
+        expectedPending: "Expected a pending host confirmation.",
+        connectionFailed: "Connection failed. Retry to find the same confirmation.",
+        upWeb: "AgEnD is up. Open its dashboard: {0} — sign in with the code from agend web --code on the machine running AgEnD. Sign your agents' CLIs in from Settings → Agents → Sign-ins.",
+        upChat: "AgEnD is up. Talk to it in the channel you just set up, or open its dashboard: {0} (sign in with agend web --code on the machine running AgEnD, or send /web to your bot).",
+        notUp: "AgEnD has not come up within 60 seconds. Run `agend start` on the machine itself and check fleet.log — this page cannot tell you any more.",
+        // A host confirmation's outcome (settings-confirmation.ts reason_code; the words of locale.ts settings_confirm.result.*).
+        outcome_apply_failed: "Change could not be applied. Review the configuration and try again.",
+        outcome_fleet_stopped: "Fleet stopped. Review and apply again.",
+        outcome_expired: "Confirmation expired. Review and apply again.",
+        outcome_withdrawn: "Change withdrawn.",
+        outcome_rejected: "Change rejected.",
+        outcome_request_no_longer_current: "The requesting session or fleet changed. Review and apply again.",
+        outcome_settings_changed: "Settings changed since this request. Review and apply again.",
+    },
+    "zh-TW": {
+        title: "設定 AgEnD",
+        otherLang: "English",
+        langTitle: "語言",
+        intro: "這個頁面只在設定進行時開啟。完成設定，或 15 分鐘後，它會自動關閉。",
+        signinsLabel: "AI 後端登入",
+        stepAgent: "1 · Agent",
+        backend: "後端",
+        backendFound: "在這台主機上找到：{0}",
+        backendNone: "這台主機上找不到任何後端 CLI —— 請先安裝一個。",
+        dir: "工作目錄（選填）",
+        dirPlaceholder: "/home/you/projects/app",
+        dirDefault: "留空的話，agent 會有自己的資料夾 {0}，由 AgEnD 建立。若要填寫，必須是絕對路徑。",
+        dirDefaultName: "留空的話，agent 會在 AgEnD 的 workspaces 裡有自己的資料夾，由 AgEnD 建立。若要填寫，必須是絕對路徑。",
+        name: "第一個 agent 名稱",
+        stepPlatform: "2 · 平台",
+        webOnly: "只用網頁（不接 bot）",
+        hintTelegram: "用 @BotFather 建立 bot，然後把它加進一個群組。",
+        hintDiscord: "在 Discord 開發者後台建立應用程式，並把 bot 邀請到你的伺服器。",
+        hintWeb: "不接 bot：從 AgEnD 的網頁儀表板使用它（聊天、登入、設定）。之後可以在設定裡再加上 Discord 或 Telegram。",
+        stepCredentials: "3 · 憑證",
+        token: "Bot token",
+        tokenNote: "會寫入 ~/.agend/.env，之後不會再顯示。",
+        tokenEnv: "環境變數",
+        verify: "驗證",
+        verifying: "正在向平台確認…",
+        verified: "已驗證",
+        rejected: "被拒絕",
+        guild: "伺服器（guild）",
+        general: "General 頻道 id",
+        discordAdmin: "你的 Discord 使用者 ID",
+        telegramAdmin: "你的 Telegram 使用者 ID",
+        firstAllowed: "會成為第一個允許使用者。",
+        group: "群組 id",
+        groupHint: "或在群組裡發任一則訊息，然後按「從訊息偵測」。",
+        detect: "從訊息偵測",
+        detectWaiting: "等待群組訊息中…",
+        detectFound: "找到了。",
+        detectNone: "還沒收到群組訊息 —— 發一則之後再按一次。",
+        failed: "失敗。",
+        stepReview: "4 · 檢查並啟動",
+        preview: "顯示將寫入的內容",
+        finish: "建立並啟動 AgEnD",
+        start: "啟動 AgEnD",
+        reopen: "請在開始設定的地方重新開啟：Windows 安裝程式請在它的視窗按 Enter；否則在執行 AgEnD 的電腦上再執行一次 agend setup。",
+        closed: "這個設定頁已關閉。",
+        closedFinish: "這個設定頁已關閉。{0}已經登入的後端會維持登入。",
+        closesIn: "這個頁面最晚在 {0} 後關閉（閒置 10 分鐘會更早關閉）。",
+        closesSoon: "{0}請盡快完成。如果它先關閉了：{1}",
+        approveHost: "請在執行 AgEnD 的電腦上核准。Windows 安裝程式會為它開一個確認視窗；沒有出現視窗時，會顯示一行可以貼上的指令。否則請在那台電腦上執行：agend settings confirm {0}",
+        confirmGone: "設定確認已不存在。請重新檢查並再輸入一次 token。",
+        notApplied: "變更沒有套用。請重新檢查並再輸入一次 token。",
+        confirmed: "設定已確認。請按「啟動 AgEnD」完成設定。",
+        lostContact: "與設定頁失去連線，仍在重試。如果一直如此，表示頁面已關閉。{0}",
+        finishSignins: "請先完成後端登入，或選擇「稍後登入」再繼續。",
+        notCurrent: "這個確認已不是最新的。",
+        startingWeb: "AgEnD 正在啟動。啟動後，儀表板連結會顯示在這裡。",
+        startingChat: "AgEnD 正在啟動。請到你設定的頻道繼續。",
+        requesting: "正在請主機確認…",
+        expectedPending: "預期會有一個等待主機確認的變更。",
+        connectionFailed: "連線失敗。重試會找回同一個確認。",
+        upWeb: "AgEnD 已啟動。打開它的儀表板：{0} —— 用執行 AgEnD 的電腦上 agend web --code 顯示的代碼登入。agent 的 CLI 請在 設定 → Agents → 登入 裡登入。",
+        upChat: "AgEnD 已啟動。在你剛設定的頻道和它對話，或打開它的儀表板：{0}（在執行 AgEnD 的電腦上用 agend web --code 登入，或對你的 bot 傳 /web）。",
+        notUp: "AgEnD 在 60 秒內沒有啟動。請在那台電腦上執行 `agend start` 並查看 fleet.log —— 這個頁面無法告訴你更多。",
+        outcome_apply_failed: "變更無法套用。請檢查設定後再試一次。",
+        outcome_fleet_stopped: "Fleet 已停止。請重新檢查後再套用。",
+        outcome_expired: "確認已過期。請重新檢查後再套用。",
+        outcome_withdrawn: "變更已撤回。",
+        outcome_rejected: "變更已被拒絕。",
+        outcome_request_no_longer_current: "提出請求的工作階段或 fleet 已改變。請重新檢查後再套用。",
+        outcome_settings_changed: "提出請求後設定已被修改。請重新檢查後再套用。",
+    },
+};
+/** #2726: the host's words and codes in both languages — one module, shared with the dashboard (pasted in below). */
+const HOST_TEXT = readFileSync(new URL("./ui/shared/setup-host-text.js", import.meta.url), "utf8").replace(/^export /gm, "");
+/**
+ * The few lines both pages run first: the dictionary (JSON, `<` escaped so no string can end the script), the language,
+ * `tr` (a key in it), `trHost` (a host message in it), `show` (a text that follows the language when it changes) and
+ * `applyLang`. Plain script, no `${` and no template literal: it is pasted into the pages' own template strings.
+ */
+export function setupI18nRuntime(strings) {
+    const tables = JSON.stringify({ en: strings.en, "zh-TW": strings["zh-TW"] }).replace(/</g, "\\u003c");
+    return "const I18N = " + tables + ";\n" + HOST_TEXT + String.raw `
+  let LANG = (() => {
+    try { const chosen = localStorage.getItem("agend_lang"); if (chosen === "en" || chosen === "zh-TW") return chosen; } catch { /* none kept */ }
+    return typeof navigator !== "undefined" && /^zh/i.test(navigator.language || "") ? "zh-TW" : "en";
+  })();
+  const tr = (key, ...values) => {
+    let text = I18N[LANG][key] ?? I18N.en[key] ?? key;
+    values.forEach((value, i) => { text = text.split("{" + i + "}").join(String(value)); });
+    return text;
+  };
+  // The host's own words or code in this page's language (setup-host-text.js); anything else as it came.
+  const trHost = (text) => hostText(text, LANG);
+  // A text that is redrawn in the new language when it changes: its last render per element.
+  const shown = new Map();
+  const show = (element, render) => { if (!element) return; shown.set(element, render); render(element); };
+  const applyLang = () => {
+    if (document.documentElement) document.documentElement.lang = LANG === "zh-TW" ? "zh-Hant" : "en";
+    document.title = tr("title");
+    for (const node of document.querySelectorAll("[data-i18n]")) { const key = node.getAttribute && node.getAttribute("data-i18n"); if (key) node.textContent = tr(key); }
+    for (const node of document.querySelectorAll("[data-i18n-placeholder]")) { const key = node.getAttribute && node.getAttribute("data-i18n-placeholder"); if (key) node.placeholder = tr(key); }
+    for (const node of document.querySelectorAll("[data-i18n-label]")) { const key = node.getAttribute && node.getAttribute("data-i18n-label"); if (key) node.setAttribute("aria-label", tr(key)); }
+    for (const [element, render] of shown) render(element);
+  };
+  const langButton = document.getElementById("lang");
+  if (langButton) langButton.onclick = () => {
+    LANG = LANG === "zh-TW" ? "en" : "zh-TW";
+    try { localStorage.setItem("agend_lang", LANG); } catch { /* this page only */ }
+    applyLang();
+  };
+  applyLang();
+`;
+}
+//# sourceMappingURL=setup-i18n.js.map

package/dist/setup-i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-i18n.js","sourceRoot":"","sources":["../src/setup-i18n.ts"],"names":[],"mappings":"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"}

package/dist/ui/backend-signin.js

@@ -6,7 +6,7 @@
 // one runs, on which device, and may cancel it. The stream's `backend_login` event carries nothing — it only says to
 // read again. Starting is two steps, as in chat: check (the server keeps what it found) and start (with its id).
 import { html, useEffect, useState, useRef } from "/assets/app-html.js";
-import { t, register } from "/assets/app-i18n.js";
+import { t, register, lang, onLang } from "/assets/app-i18n.js";
 import { appStore, createStore, useStore } from "/assets/app-store.js";
 import { closeDialog, shellStore, showDialog } from "/assets/app-shell.js";
 import { Dialog } from "/assets/ui-dialog.js";
@@ -217,13 +217,14 @@ export function BrowserSignInDialog({ backend, backends, onClose }) {
   const root = useRef(null), close = onClose || closeDialog;
   useEffect(() => {
     let cards, last = "";
-    cards = mountStructuredSignIns(root.current, { endpoint: "/ui/browser-backend-signins", changed: next => {
+    cards = mountStructuredSignIns(root.current, { endpoint: "/ui/browser-backend-signins", lang, changed: next => {
       if (backends) { if (backends.some(b => !next.selected.includes(b))) void cards.addBackends(backends); }
       else if (!next.selected.includes(backend)) void cards.addBackend(backend);
       const signature = JSON.stringify([next.login, next.pending]);
       if (signature !== last) { last = signature; void refreshSignIn(); }
     } });
-    return () => cards.dispose();
+    const unlisten = onLang(() => cards.relabel());
+    return () => { unlisten(); cards.dispose(); };
   }, [backend, backends]);
   const fallback = async (chosen = backend) => {
     const result = await post("/ui/browser-backend-signins", { operation: "cancel" });

package/dist/ui/panel-settings.js

@@ -9,7 +9,8 @@
 // - Not the Apply: confirming hands the staged changes to the app's runner (settings-apply.js) before the first write.
 //   This panel renders that operation from the store, and finds it again when it mounts.
 import { html, useEffect, useMemo, 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 { appStore, useStore } from "/assets/app-store.js";
 import { useLease } from "/assets/app-ctx.js";
 import { DevicePrefs, PanelHeader, PendingChanges, setTitle } from "/assets/app-shell.js";
@@ -55,7 +56,8 @@ const tn = (k, ...v) => t(`settings.${k}`, ...v);
 /** What a refused change says to a person: the server's code in words (the code itself only for one not listed). */
 const APPLY_ERRORS = new Set(["unsupported_sensitive_effect", "confirmation_diff_too_large", "session_required", "admin_required", "settings_changed",
   "request_no_longer_current", "too_many_pending_changes", "fleet_unavailable", "invalid_settings_effect", "settings_confirmation_unavailable", "failed"]);
-export const applyErrorText = (code) => (APPLY_ERRORS.has(code) ? tn(`applyError_${code}`) : tn("applyErrorOther", String(code)));
+// #2726: a code or words of the setup host (the wizard's commit) in the page's language; anything else as it came.
+export const applyErrorText = (code) => (APPLY_ERRORS.has(code) ? tn(`applyError_${code}`) : tn("applyErrorOther", hostText(String(code), lang())));
 const ICONS = { preferences: "user", look: "palette", agents: "bot", "agent-defaults": "sliders", chat: "chat", "web-dashboard": "globe", access: "key", advanced: "code" };
 const RELEASES = "https://github.com/songsid/AgEnD/releases";
 

package/dist/ui/settings-discord.js

@@ -8,7 +8,8 @@
 // Stop, the 2-minute limit or leaving the page each retire what was asked before — an answer about A never lands after
 // B, nor after A again (an older A), nor once the page is gone.
 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 { api } from "./settings-confirm.js";
 import { Select } from "./settings-dialogs.js";
@@ -129,6 +130,6 @@ export function DiscordServerPicker({ idPrefix, token, bot, invite, portal, guil
       ${channels && channels.list && channels.list.length
         ? html`<${Select} id=${`${idPrefix}-gen`} value=${channel} onChange=${pickChannel} options=${["", ...channels.list.map((c) => ({ value: c.id, label: `#${c.name}` }))]} />`
         : html`<input id=${`${idPrefix}-gen`} type="text" value=${channelText} onInput=${(e) => pickChannel(onChannelText(e.target.value))} />`}
-      ${channels && channels.error ? html`<p class="feedback warning">${channels.error}</p>` : null}</div>
+      ${channels && channels.error ? html`<p class="feedback warning">${hostText(channels.error, lang())}</p>` : null}</div>
   </div>`;
 }

package/dist/ui/settings-strings.js

@@ -193,7 +193,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",
@@ -843,7 +846,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",

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 }) {
@@ -83,14 +86,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 +108,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,7 +144,8 @@ 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-wd">${tn("wizardDir")}</label><input id="wz-wd" type="text" placeholder="/home/you/projects/app" aria-describedby="wz-wd-note" value=${dirText} onInput=${(e) => set("working_directory")(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) => set("instance_name")(onNameText(e.target.value))} /></div>`;
   } else if (w.step === 2) {
     body = html`<div class="seg-inline" role="group" aria-label=${tn("wizardPlatform")}>
@@ -169,7 +174,7 @@ export function SetupWizard({ ctx, onClose }) {
       ${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/setup-host-text.js

@@ -0,0 +1,105 @@
+// #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"],
+  ["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;
+}