@songsid/agend 2.3.5-alpha.2 → 2.3.5-alpha.3

package/dist/ui/general-location.js

@@ -0,0 +1,71 @@
+// The location is a separate revision-bound Settings operation, never an agent-config patch.
+import { html, useEffect, useRef, useState } from "/assets/app-html.js";
+import { t, register } from "/assets/app-i18n.js";
+import { appStore, useStore, guestPage } from "/assets/app-store.js";
+import { useLease } from "/assets/app-ctx.js";
+import { toast } from "/assets/ui-toast.js";
+import { confirmedWrite, newKey } from "./settings-confirm.js";
+import { ModelSelect } from "./settings-dialogs.js";
+register("generalLocation", {
+  en: {
+    label: "Run General on", host: "This AgEnD host", windows: "Paired Windows PC",
+    offline: "General’s Windows PC is offline. AgEnD is still running here. Reconnect that PC, or switch General back to this host in Settings. Pending or uncertain requests will not be sent again automatically.",
+    exit: "General was not switched: the previous process has not been confirmed stopped. Reconnect its PC or use the existing stopped-process recovery, then try again. No replacement was started.",
+    start: "General’s location was saved, but it could not start. Check Needs you and choose Start or switch back. Its previous conversation is kept; no input was replayed.",
+    history: "Host and Windows conversations stay separate. Switching does not copy or merge their history.",
+  },
+  "zh-TW": {
+    label: "General 執行位置", host: "這台 AgEnD 主機", windows: "已配對的 Windows 電腦",
+    offline: "General 所在的 Windows 電腦已離線。AgEnD 仍在這台主機運作。請重新連線那台電腦，或到設定把 General 切回這台主機。待處理或結果不明的請求不會自動重送。",
+    exit: "General 尚未切換：還無法確認前一個程序已停止。請重新連線那台電腦，或完成現有的程序停止復原，再重試。沒有啟動替代程序。",
+    start: "General 的執行位置已儲存，但未能啟動。請查看「等你處理」，選擇啟動或切回原位置。先前的對話已保留，沒有重送輸入。",
+    history: "主機與 Windows 各自保留對話，切換時不會複製或合併對話紀錄。",
+  },
+});
+const tr = key => t(`generalLocation.${key}`);
+export function GeneralLocation({ name, attentionOnly = false }) {
+  const app = useStore(appStore);
+  const attentionKey = JSON.stringify((app.needs || []).filter(item => item.generalLocation && (!name || item.instance === name)).map(item => item.id));
+  const lease = useLease("general-location"), [data, setData] = useState(null), [error, setError] = useState(null);
+  const read = async () => {
+    try { const response = await lease.fetch("/api/settings/general-location"); const result = await response.json();
+      if (lease.current()) { if (response.ok) { setData(result); setError(null); } else setError(result.error); }
+    } catch (err) { if (lease.current()) setError(err.message); }
+  };
+  useEffect(() => { if (!guestPage()) void read(); }, [name, attentionKey]);
+  if (guestPage()) return null;
+  return html`<section id="general-location" class="card general-location"><h2>${tr("label")}</h2>
+    ${error ? html`<p role="alert">${error}</p>` : null}
+    ${(data?.generals || []).filter(row => !name || row.name === name).map(row => html`<${LocationRow} key=${row.name + row.revision} row=${row} machines=${data.machines || []} attentionOnly=${attentionOnly} refresh=${read} />`)}
+    ${!attentionOnly ? html`<button type="button" class="btn btn-sm" onClick=${read}>${t("settings.refresh")}</button>` : null}
+  </section>`;
+}
+function LocationRow({ row, machines, attentionOnly, refresh }) {
+  const [target, setTarget] = useState("host"), [cli, setCli] = useState("claude-code"), [model, setModel] = useState("");
+  const [busy, setBusy] = useState(false), flight = useRef(false);
+  const lease = useLease("general-location-row");
+  const machine = machines.find(item => item.id === target);
+  // The rendered revision stays with this click. Never re-read and silently retry a stale proposal.
+  const propose = async next => {
+    if (flight.current || !lease.current()) return; flight.current = true; setBusy(true);
+    try { const result = await confirmedWrite("/api/settings/general-location", { body: { name: row.name, revision: row.revision, target: next }, key: newKey("general"), label: tr("label") });
+      if (lease.current()) { toast(result.body?.message || result.body?.error || t(result.ok ? "app.saved" : "app.failed"), result.ok); await refresh(); }
+    } catch (err) { if (lease.current()) toast(err.message, false); }
+    finally { flight.current = false; if (lease.current()) setBusy(false); }
+  };
+  if (attentionOnly && !row.offline && !row.hold) return null;
+  return html`<div class="general-location-row" data-general=${row.name}>
+    <strong>${row.displayName}</strong><p>${row.location === "host" ? tr("host") : `${machines.find(item => item.id === row.machineId)?.name || tr("windows")} · ${row.cli}`}</p>
+    ${row.offline || row.hold ? html`<p role="alert">${tr(row.hold || "offline")}</p>` : null}
+    <p class="note">${tr("history")}</p>
+    ${row.canSwitchBack ? html`<button type="button" class="btn" disabled=${busy || row.switching} onClick=${() => propose({ location: "host" })}>${tr("host")}</button>` : null}
+    ${row.hold === "start" ? html`<button type="button" class="btn" disabled=${busy || row.switching} onClick=${() => propose(row.retryTarget || (row.location === "host" ? { location: "host" } : { location: "windows", machineId: row.machineId, cli: row.cli, model: row.model }))}>${t("chat.start")}</button>` : null}
+    ${!attentionOnly ? html`<label>${tr("label")}<select value=${target} disabled=${busy || row.switching} onChange=${e => { setTarget(e.target.value); setModel(""); }}>
+      <option value="host">${tr("host")}</option>${machines.map(item => html`<option value=${item.id} disabled=${!item.online}>${item.name}</option>`)}
+    </select></label>
+    ${target !== "host" ? html`<label>${t("settings.backend")}<select value=${cli} onChange=${e => { setCli(e.target.value); setModel(""); }}>
+      ${["claude-code", "codex"].map(id => html`<option value=${id} disabled=${!machine?.clis.some(item => item.id === id)}>${id}</option>`)}
+    </select></label><${ModelSelect} value=${model} onChange=${setModel} backend=${cli} runtime="windows" machineId=${target} instance=${row.name} />` : null}
+    <button type="button" class="btn btn-primary" disabled=${busy || row.switching || target === "host" && !row.canSwitchBack || target !== "host" && (!machine?.online || !machine.clis.some(item => item.id === cli))} onClick=${() => propose(target === "host" ? { location: "host" } : { location: "windows", machineId: target, cli, model })}>${t("settings.save")}</button>` : null}
+  </div>`;
+}

package/dist/ui/native-pane-recovery.js

@@ -23,7 +23,7 @@ export function NativePaneRecovery({ name, inst, lease }) {
     finally { inFlight.current = false; if (lease.current()) setBusy(false); }
   };
   if (guestPage() || inst.native_adapter !== "pane") return null;
-  if (!recovery) return ["stopped", "crashed"].includes(inst.status)
+  if (!recovery) return !inst.general_topic && ["stopped", "crashed"].includes(inst.status)
     ? html`<div class="windows-agent-blocked"><button type="button" class="btn" disabled=${busy} onClick=${() => act(`/ui/start/${encodeURIComponent(name)}`)}>${t("chat.start")}</button></div>` : null;
   if (recovery.kind === "session-unconfirmed") return html`<div class="windows-agent-blocked" role="alert">
     <p>${t(recovery.provider === "codex" ? "chat.paneCodexSessionUnconfirmed" : "chat.paneSessionUnconfirmed")}</p>

package/dist/ui/panel-chat.js

@@ -1,4 +1,5 @@
 import { NativePaneRecovery } from "./native-pane-recovery.js";
+import { GeneralLocation } from "./general-location.js";
 // #1408 step 1: the chat panel. Behind the session gate (/ui/js/), loaded by the app with a dynamic import in "full"
 // mode only. boot() runs once per page (the chat store must hear the stream from the first frame); <ChatPanel> mounts
 // for /ui and /ui/chat/<name>.
@@ -365,6 +366,7 @@ function ChatView({ name, inst, lease, navKey, exec, awaiting }) {
         ${theme && theme.background ? html`<img ref=${bg} class=${`th-bg th-bg-${theme.background.fit}`} src=${themeImageUrl(name, theme.background.image)} alt="" aria-hidden="true" decoding="async" />` : null}
         <${ChatAmbient} name=${name} surface=${effectSurface} part="layer" />
         <${AmbientMotionNote} name=${name} />
+        ${inst.general_topic ? html`<${GeneralLocation} name=${name} attentionOnly=${true} />` : null}
         <${NativePaneRecovery} name=${name} inst=${inst} lease=${lease} />
         ${inst.native_blocked ? html`<div class="windows-agent-blocked" role="alert"><p>${t("chat.nativeBlocked")}</p><button type="button" class="btn" disabled=${recovering} onClick=${recoverNative}>${t("chat.nativeRecover")}</button></div>` : null}
         <${Thread} name=${name} label=${inst.runtime === "windows" ? inst.display_name || name : name} th=${thread} />

package/dist/ui/panel-needs.js

@@ -25,6 +25,7 @@ import { toast } from "/assets/ui-toast.js";
 import { notifyStore, notifySupport, configDetail, reasonText, refreshNotify, setNotify } from "/assets/app-needs.js";
 import { openSignIn, signInOffered } from "./backend-signin.js";
 import { decideProposal, installProposals } from "./agent-proposals.js";
+import { GeneralLocation } from "./general-location.js";
 
 register("needs", {
   en: {
@@ -242,6 +243,7 @@ function NeedsItem({ item, nowMs, owner }) {
     <div class="n-body">
       <div class="n-title"><strong>${reasonText(item)}</strong><span class="n-age">${age(item.since, nowMs)}</span></div>
       ${detailOf(item) ? html`<p class="n-detail">${detailOf(item)}</p>` : null}
+      ${item.generalLocation ? html`<${GeneralLocation} name=${item.instance} attentionOnly=${true} />` : null}
       <div class="n-actions">
         ${item.type === "prompt" && Array.isArray(item.actions) ? item.actions.filter((a) => !a.input).map((a) => html`<button key=${a.id} type="button" class="btn btn-sm"
             disabled=${promptBusy} onClick=${() => answer(a.id)}>${(p ? p.busy : fallback === "busy") ? tn("answering") : a.label}</button>`) : null}

package/dist/ui/panel-settings.js

@@ -53,8 +53,10 @@ import { OfficeSharesCard } from "./office-share-dialog.js";
 import { PageSharesCard } from "./page-share-dialog.js";
 import { syncStage, useDraft } from "./settings-draft.js";
 import { WebAuthorityCard } from "./settings-web-authority.js";
+import { OutsideCard } from "./settings-outside.js";
 import { NamedLinkTest, setTypedTunnelToken } from "./settings-named-test.js";
 import { SignInList } from "./backend-signin.js";
+import { GeneralLocation } from "./general-location.js";
 
 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). */
@@ -385,7 +387,7 @@ export function SettingsPanel({ route, navKey }) {
     : !data ? html`<${Skeleton} lines=${6} />`
     : data.error ? html`<${ErrorState} message=${tn("configLoadFailed")} onRetry=${reload} />`
     : section === "agents" ? html`<${YamlLock} staged=${staged}><${Agents} ctx=${ctx} search=${search} openDialog=${toDialog} /></${YamlLock}>${ctx.providerOk ? html`<${ProviderKeys} ctx=${ctx} />` : null}`
-    : section === "agent-defaults" ? html`<${YamlLock} staged=${staged}><${General} key=${formKey} ctx=${ctx} part="fleet" /></${YamlLock}>`
+    : section === "agent-defaults" ? html`<${GeneralLocation} /><${YamlLock} staged=${staged}><${General} key=${formKey} ctx=${ctx} part="fleet" /></${YamlLock}>`
     : section === "chat" ? html`<${YamlLock} staged=${staged}><${Bots} ctx=${ctx} search=${search} openDialog=${toDialog} /></${YamlLock}>
         <${WebSection} key=${formKey} ctx=${ctx} staged=${staged} part="chat" />
         <div id="classicbot" class="s-anchor"><h2 class="s-ap-group">ClassicBot</h2><${Classic} ctx=${ctx} search=${search} openDialog=${toDialog} />
@@ -1377,6 +1379,8 @@ function WebSection({ ctx, staged, part = "all" }) {
     ${has("access") ? html`<${OfficeSharesCard} />` : null}
     ${has("access") ? html`<${PageSharesCard} />` : null}
     ${has("access") && !overPublicLink ? html`<${GuestsCard} ctx=${ctx} staged=${staged} /><${WebAuthorityCard} ctx=${ctx} staged=${staged} />` : null}
+    ${/* #3008: a web-only fleet's connections from outside — changed on this computer only, shown (read-only) elsewhere. */ ""}
+    ${has("access") ? html`<${OutsideCard} />` : null}
     ${has("chat") ? lock(html`<section class="card"><h3>${tn("webChat")}</h3>
       <label class=${fc("check", "echo")}><input id="webEchoToChannel" type="checkbox" checked=${f.echo} onChange=${(e) => set("echo")(e.target.checked)} /><span>${tn("webEcho")}</span><${Impact} schema=${schema} field="web.echo_to_channel" /></label>
       <p class="note">${tn("webEchoHint")}</p>

package/dist/ui/settings-dialogs.js

@@ -281,8 +281,13 @@ export function AgentDialog({ name, inst, ctx, onClose }) {
     auto: f.inherit.auto_pause_after ? "" : nonNegative(f.auto_pause_after),
     hang: f.inherit.hang ? "" : positive(f.hang),
   };
+  // #3008 G1: a fleet with no chat connection has one General at most — ticking a second says which one it is, right
+  // by the checkbox (kept ticked, Save waits), by the name the chat list shows (the leader's string 18).
+  const otherGeneral = !channelsOf(fleet).length && f.general_topic && !inst.general_topic
+    ? Object.entries(fleet.instances || {}).find(([other, c]) => other !== name && c && (c.general_topic === true || (other === "general" && c.general_topic !== false))) : null;
+  const generalError = otherGeneral ? tn("oneGeneral", ctx.shortName(otherGeneral[0], otherGeneral[1])) : "";
   const failoverWarn = !f.inherit.model_failover && !f.model_failover.trim() ? "failoverEmpty" : "";
-  const ready = !errors.auto && !errors.hang;
+  const ready = !errors.auto && !errors.hang && !generalError;
   const pending = () => agentPatch({ ...f, status_emojis: emojis.value }, inst, defaults, visibilityBaseline, emojis.baseline);
   const stage = () => {
     if (!ready) return;
@@ -360,8 +365,9 @@ export function AgentDialog({ name, inst, ctx, onClose }) {
       </div>
       <div class="field">${L(tn("systemPrompt"), "instance.systemPrompt", "ag-sys")}<input id="ag-sys" type="text" placeholder="e.g. file:prompts/dev.md" value=${f.systemPrompt} onInput=${(e) => set("systemPrompt")(e.target.value)} /></div>
       <div class="field">${L(tn("tags"), "instance.tags")}<${ChipList} items=${f.tags} onChange=${set("tags")} placeholder=${tn("tagPlaceholder")} label=${tn("tags")} /></div>
-      <label class="check"><input type="checkbox" checked=${f.general_topic} onChange=${(e) => set("general_topic")(e.target.checked)} /><span>${tn("generalTopicField")}</span>
+      <label class="check"><input id="ag-general" type="checkbox" checked=${f.general_topic} onChange=${(e) => set("general_topic")(e.target.checked)} /><span>${tn("generalTopicField")}</span>
         <${Impact} schema=${schema} field="instance.general_topic" /></label>
+      ${generalError ? html`<p class="feedback error" role="alert" id="ag-general-one">${generalError}</p>` : null}
     </${Drawer}>
     <${Drawer} title=${tn("statusEmojis")}>
       <p class="note">${tn("statusEmojisInstance")} <${Impact} schema=${schema} field="instance.status_emojis" /></p>

package/dist/ui/settings-model.js

@@ -23,7 +23,8 @@ export const TOOL_SETS = ["worker", "coordinator", "standard", "minimal", "full"
 export function toolSetDefault(defaults, inst, name = "") {
   if (TOOL_SETS.includes(defaults && defaults.tool_set)) return defaults.tool_set;
   const general = hasOwn(inst, "general_topic") ? inst.general_topic === true : !!defaults && defaults.general_topic === true;
-  return general || name === "general" ? "general" : "worker";
+  // The literal-name fallback, unless unticked (general-instance.ts generalByName: an explicit general_topic: false).
+  return general || (name === "general" && !(hasOwn(inst, "general_topic") && inst.general_topic === false)) ? "general" : "worker";
 }
 export const TOOL_PROGRESS = ["off", "standard", "verbose"];
 export const AGENT_MODES = ["mcp", "cli"];

package/dist/ui/settings-outside.js

@@ -0,0 +1,176 @@
+// #3008 ② (alpha.3; decision 28c2d3a3 rule 3, the user's simplified form hmsg-33c3d609): Settings → Access & security →
+// "Connections from outside", on a fleet with no chat connection. This computer's admin, here, sets up an authenticator
+// app (a QR code and the key, then its first code), and turns on "Allow connections from outside": the public link
+// opens, and signing in through it asks for the app's code. Turning it off closes the link and signs everyone out there.
+// Every change applies at once (an action, not a staged setting) and is this computer's only: elsewhere the card shows
+// the state, read-only. The server decides who may (GET /ui/outside's `here`) and refuses everything else regardless.
+// The words are the leader's (cid-alpha3-design, strings 1–13 and 17).
+import { html, useEffect, useRef, useState } from "/assets/app-html.js";
+import { t, register } from "/assets/app-i18n.js";
+import { toast } from "/assets/ui-toast.js";
+import { confirmDialog } from "/assets/ui-confirm.js";
+import { api } from "./settings-confirm.js";
+
+register("outside", {
+  en: {
+    title: "Connections from outside", switch: "Allow connections from outside",
+    needApp: "Set up an authenticator app first. Signing in from outside will ask for its code.",
+    setUp: "Set up authenticator app",
+    scan: "Scan this with Authy, Google Authenticator or Microsoft Authenticator, or type the key. Then enter the 6-digit code it shows.",
+    setUpOn: "Authenticator app set up on {0}.", again: "Set up again",
+    againConfirm: "Codes from the old app stop working, and everyone signed in from outside is signed out.",
+    remove: "Remove", removeConfirm: "Connections from outside are turned off, and everyone signed in from outside is signed out.",
+    openAt: "Open at {0}.", quick: "A quick link gets a new address each time it opens.",
+    hereOnly: "Only on the AgEnD computer.", lostPhone: "Lost your phone? On the AgEnD computer, choose “Set up again”.",
+    wrong: "That code didn't work. Check that your phone's clock is right and try the newest code.",
+    paused: "Too many wrong codes. Try again in {0}.", code: "Authenticator code", key: "Key",
+    minutes: "{0} minutes", minute: "1 minute", hours: "{0} hours", hour: "1 hour",
+  },
+  "zh-TW": {
+    title: "從外面連線", switch: "允許從外面連線",
+    needApp: "請先設定驗證器 App。從外面登入時會要求輸入它的代碼。",
+    setUp: "設定驗證器 App",
+    scan: "用 Authy、Google Authenticator 或 Microsoft Authenticator 掃描，或手動輸入金鑰，再輸入 App 顯示的 6 位數代碼。",
+    setUpOn: "驗證器 App 已於 {0} 設定。", again: "重新設定",
+    againConfirm: "舊 App 的代碼會失效，所有從外面登入的人都會被登出。",
+    remove: "移除", removeConfirm: "從外面連線會關閉，所有從外面登入的人都會被登出。",
+    openAt: "已開啟：{0}。", quick: "快速連結每次開啟網址都不同。",
+    hereOnly: "只能在 AgEnD 電腦上變更。", lostPhone: "手機遺失？請在 AgEnD 電腦上選「重新設定」。",
+    wrong: "代碼不對。請確認手機時間正確，並輸入最新的代碼。",
+    paused: "錯誤次數太多，請 {0} 後再試。", code: "驗證器代碼", key: "金鑰",
+    minutes: "{0} 分鐘", minute: "1 分鐘", hours: "{0} 小時", hour: "1 小時",
+  },
+});
+const to = (k, ...v) => t(`outside.${k}`, ...v);
+
+/** A wait as words: "15 minutes" / 「15 分鐘」, "2 hours" / 「2 小時」 (rounded up). */
+export function waitWords(ms) {
+  const minutes = Math.max(1, Math.ceil(ms / 60000));
+  if (minutes < 60) return minutes === 1 ? to("minute") : to("minutes", minutes);
+  const hours = Math.ceil(minutes / 60);
+  return hours === 1 ? to("hour") : to("hours", hours);
+}
+
+/** The key as an app shows it: groups of four. */
+export function keyGroups(secret) {
+  return String(secret || "").replace(/(.{4})(?=.)/g, "$1 ");
+}
+
+/**
+ * The QR code of an otpauth:// URI as one SVG path (dark modules), drawn by the page — no inline style, no innerHTML
+ * (the CSP). `qrcode` is the vendored encoder's factory (qrcode.module.js).
+ */
+export function qrPath(qrcode, uri) {
+  const qr = qrcode(0, "M");
+  qr.addData(uri);
+  qr.make();
+  const n = qr.getModuleCount();
+  let d = "";
+  for (let r = 0; r < n; r++) for (let c = 0; c < n; c++) if (qr.isDark(r, c)) d += `M${c + 4} ${r + 4}h1v1h-1z`;
+  return { size: n + 8, d };
+}
+
+function Qr({ uri }) {
+  const [shape, setShape] = useState(null);
+  useEffect(() => {
+    let live = true;
+    import("/assets/qrcode.module.js").then((m) => { if (live) setShape(qrPath(m.default || m.qrcode, uri)); }).catch(() => { if (live) setShape(null); });
+    return () => { live = false; };
+  }, [uri]);
+  if (!shape) return null;
+  return html`<svg class="s-out-qr" id="outQr" viewBox=${`0 0 ${shape.size} ${shape.size}`} width="200" height="200" role="img" aria-label=${to("setUp")}>
+    <rect width=${shape.size} height=${shape.size} fill="#fff" /><path d=${shape.d} fill="#000" /></svg>`;
+}
+
+/**
+ * #3035 review: how often the card reads the state again while it is shown — quickly while the link is opening (the
+ * switch answers before the link is up), slowly otherwise (its lifetime ending, a wait starting or ending elsewhere).
+ */
+export const outsidePoll = { quickMs: 2000, slowMs: 15000 };
+
+export function OutsideCard() {
+  const [s, setS] = useState(null), [enroll, setEnroll] = useState(null), [code, setCode] = useState(""), [msg, setMsg] = useState(""), [busy, setBusy] = useState(false);
+  // Fences: an answer that arrives after the card is gone, or after a newer read began, is dropped; nor does a read
+  // land while an action is under way (the box shows the click until the action's own read).
+  const live = useRef({ mounted: true, seq: 0, busy: false });
+  // Every read that ends (answered or not) moves `rev`: the next one is scheduled from there, so a failed read (the
+  // network, a 5xx, an unreadable answer) never stops the card reading again (#3035 review r2) — and keeps what it
+  // showed meanwhile.
+  const [rev, setRev] = useState(0), failed = useRef(false);
+  const load = async () => {
+    const seq = ++live.current.seq;
+    let r = null;
+    try { r = await api("/ui/outside"); } catch { r = null; }
+    if (!live.current.mounted || seq !== live.current.seq) return;
+    const ok = !!(r && r.ok && r.body && typeof r.body === "object");
+    failed.current = !ok;
+    if (ok) setS(r.body);
+    setRev((n) => n + 1);
+  };
+  useEffect(() => { live.current.mounted = true; load(); return () => { live.current.mounted = false; }; }, []);
+  useEffect(() => {
+    if (rev === 0) return undefined;                                              // the first read is still out
+    if (s && !s.webOnly && !failed.current) return undefined;                    // a chat fleet: nothing to follow
+    const opening = !!s && s.outside && (!s.link || s.link.state !== "open");
+    const delay = !s || opening ? outsidePoll.quickMs : outsidePoll.slowMs;      // none read yet, or opening: soon
+    const timer = setTimeout(() => { if (!live.current.busy) load(); else setRev((n) => n + 1); }, delay);
+    return () => clearTimeout(timer);
+  }, [rev]);
+  if (!s || !s.webOnly) return null;
+  const here = s.here === true;
+  const act = async (fn) => {
+    setBusy(true); setMsg(""); live.current.busy = true; live.current.seq++;      // a read under way is outdated now
+    try { await fn(); } finally { live.current.busy = false; if (live.current.mounted) { setBusy(false); load(); } }
+  };
+  const begin = () => act(async () => {
+    const r = await api("/ui/outside/enroll", { method: "POST", body: "{}" });
+    if (r.ok && r.body && r.body.secret) { setEnroll(r.body); setCode(""); } else toast(t("app.failed"), false);
+  });
+  const confirm = () => act(async () => {
+    const r = await api("/ui/outside/enroll/confirm", { method: "POST", body: JSON.stringify({ code }) });
+    if (r.ok) { setEnroll(null); setCode(""); return; }
+    const why = r.body && r.body.error;
+    if (why === "expired") { setEnroll(null); return; }
+    setMsg(why === "wrong" ? to("wrong") : t("app.failed"));
+  });
+  const again = async () => {
+    if (!(await confirmDialog({ title: to("again"), message: to("againConfirm"), confirmLabel: to("again"), danger: true }))) return;
+    begin();
+  };
+  const remove = async () => {
+    if (!(await confirmDialog({ title: to("remove"), message: to("removeConfirm"), confirmLabel: to("remove"), danger: true }))) return;
+    act(async () => { const r = await api("/ui/outside/remove", { method: "POST", body: "{}" }); if (!r.ok) toast(t("app.failed"), false); });
+  };
+  // The box follows the click at once (smoke-web-outside-3008: a controlled box that waits for the server reads as a
+  // click that did nothing); the server's state, read again after, is what stays.
+  const flip = (on) => { setS((x) => ({ ...x, outside: on })); act(async () => {
+    const r = await api("/ui/outside/switch", { method: "POST", body: JSON.stringify({ on }) });
+    if (!r.ok) toast(t("app.failed"), false);
+  }); };
+  const link = s.link, open = link && link.state === "open";
+  return html`<section class="card s-outside" id="outsideCard"><h3>${to("title")}</h3>
+    ${!here ? html`<p class="note" id="outHereOnly">${to("hereOnly")}</p>` : null}
+    <label class="check"><input id="outSwitch" type="checkbox" checked=${s.outside} disabled=${!here || busy || (!s.enrolled && !s.outside)}
+      onChange=${(e) => flip(e.target.checked)} /><span>${to("switch")}</span></label>
+    ${!s.enrolled ? html`<p class="note" id="outNeedApp">${to("needApp")}</p>` : null}
+    ${s.outside && open && link.url ? html`<p class="note" id="outOpenAt">${to("openAt", link.url)}${link.quick ? ` ${to("quick")}` : ""}</p>` : null}
+    ${s.outside && link && !open ? html`<p class="note" id="outStarting">${t("app.loading")}</p>` : null}
+    ${s.pausedForMs > 0 ? html`<p class="note s-va-warn" role="status" id="outPaused">${to("paused", waitWords(s.pausedForMs))}</p>` : null}
+    ${enroll ? html`<div class="s-out-enroll" id="outEnroll">
+        <p class="note">${to("scan")}</p>
+        <${Qr} uri=${enroll.uri} />
+        <p class="note">${to("key")}: <code id="outKey">${keyGroups(enroll.secret)}</code></p>
+        <div class="field"><label for="outCode">${to("code")}</label>
+          <input id="outCode" type="text" inputmode="numeric" autocomplete="one-time-code" maxlength="7" placeholder="123456" value=${code}
+            onInput=${(e) => setCode(e.target.value)} /></div>
+        ${msg ? html`<p class="feedback error" role="alert" id="outMsg">${msg}</p>` : null}
+        <div class="save-row"><button type="button" class="btn" id="outCancel" disabled=${busy} onClick=${() => { setEnroll(null); setMsg(""); }}>${t("app.cancel")}</button>
+          <button type="button" class="btn btn-primary" id="outConfirm" disabled=${busy || !/^\s*\d{3}\s?\d{3}\s*$/.test(code)} onClick=${confirm}>${t("app.confirmOk")}</button></div>
+      </div>`
+      : s.enrolled ? html`<p class="note" id="outSetUpOn">${to("setUpOn", new Date(s.enrolledAt).toLocaleDateString())}</p>
+        <p class="note">${to("lostPhone")}</p>
+        ${here ? html`<div class="save-row"><button type="button" class="btn" id="outAgain" disabled=${busy} onClick=${again}>${to("again")}</button>
+          <button type="button" class="btn btn-danger" id="outRemove" disabled=${busy} onClick=${remove}>${to("remove")}</button></div>` : null}`
+      : here ? html`<div class="save-row"><button type="button" class="btn btn-primary" id="outSetUp" disabled=${busy} onClick=${begin}>${to("setUp")}</button></div>` : null}
+  </section>`;
+}

package/dist/ui/settings-registry.js

@@ -12,6 +12,7 @@ import { GUESTS_SETTINGS } from "./settings-guests.js";
 const L = (en, zh) => ({ en, "zh-TW": zh });
 /** [id, section, target, labelKey | label, config key, words en, words zh] */
 const ROWS = [
+  ["general.location", "agent-defaults", "#general-location", null, null, ["general", "windows", "paired PC", "host", "location"], ["General", "Windows", "電腦", "主機", "執行位置"], L("Run General on", "General 執行位置")],
   // You · Preferences
   ["profile.name", "preferences", "#profile-name", "settings.profileTitle", null, ["name", "display name", "who agents see", "profile"], ["名字", "名稱", "顯示名稱", "個人資料"]],
   ["prefs.theme", "preferences", "#pref-theme", "app.theme", null, ["theme", "dark", "light", "dark mode", "colour scheme"], ["主題", "深色", "淺色", "外觀"]],

package/dist/ui/settings-strings.js

@@ -63,6 +63,7 @@ register("settings", {
     systemPrompt: "System prompt",
     tags: "Tags",
     generalTopicField: "General topic (fleet dispatcher)",
+    oneGeneral: "{0} is already the General. Untick it first.",
     runtimeResources: "Runtime & Resources",
     autoPause: "Auto-pause after",
     minutes: "minutes",
@@ -753,6 +754,7 @@ register("settings", {
     systemPrompt: "System prompt",
     tags: "標籤",
     generalTopicField: "General topic（fleet 分派器）",
+    oneGeneral: "{0} 已經是 General，請先取消勾選它。",
     runtimeResources: "執行環境與資源",
     autoPause: "閒置後自動暫停",
     minutes: "分鐘",

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

@@ -111,7 +111,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_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_config_invalid: "Configuration file needs attention", needs_reason_config_fallback: "Running on stored configuration", config_history_edit: "{0}, line {1}, column {2}: {3}. AgEnD is still running on the previous settings. The next restart would use the stored valid copy from {4}. Correct the YAML error; the file has not been changed by AgEnD.", config_history_no_history: "{0}, line {1}, column {2}: {3}. AgEnD is still running on the previous settings. No stored valid copy is available, so the next restart cannot recover automatically. Correct the YAML error before restarting; the file has not been changed by AgEnD.", config_history_fallback: "{0}, line {1}, column {2}: {3}. AgEnD started using the stored valid copy from {4}. Correct the YAML error and reload the settings. The file on disk has not been changed by AgEnD.", needs_reason_native_pane_hold: "Windows agent needs attention", needs_reason_crashed: "Crashed", needs_reason_usage_limit: "Usage limit reached · reset time unknown", 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_config_invalid: "Configuration file needs attention", needs_reason_config_fallback: "Running on stored configuration", config_history_edit: "{0}, line {1}, column {2}: {3}. AgEnD is still running on the previous settings. The next restart would use the stored valid copy from {4}. Correct the YAML error; the file has not been changed by AgEnD.", config_history_no_history: "{0}, line {1}, column {2}: {3}. AgEnD is still running on the previous settings. No stored valid copy is available, so the next restart cannot recover automatically. Correct the YAML error before restarting; the file has not been changed by AgEnD.", config_history_fallback: "{0}, line {1}, column {2}: {3}. AgEnD started using the stored valid copy from {4}. Correct the YAML error and reload the settings. The file on disk has not been changed by AgEnD.", needs_reason_general_windows_offline: "General’s Windows PC is offline", needs_reason_general_location_hold: "Run General on", needs_reason_native_pane_hold: "Windows agent needs attention", needs_reason_crashed: "Crashed", needs_reason_usage_limit: "Usage limit reached · reset time unknown", 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",
@@ -156,6 +156,6 @@ register("app", {
     search: "搜尋", searchTitle: "搜尋聊天、agent 之間的訊息與任務（{0}）",
     confirmTitle: "請確認", confirmOk: "繼續", cancel: "取消",
     sidePanelLeave: "不儲存就離開「{0}」？你在那裡的修改會遺失。", sidePanelDiscard: "捨棄修改",
-    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_config_invalid: "設定檔需要處理", needs_reason_config_fallback: "正在使用儲存的設定副本", config_history_edit: "{0} 第 {1} 行、第 {2} 欄：{3}。AgEnD 仍使用先前的設定執行。下次重新啟動會改用 {4} 儲存的有效副本。請修正 YAML 錯誤；AgEnD 未更動此檔案。", config_history_no_history: "{0} 第 {1} 行、第 {2} 欄：{3}。AgEnD 仍使用先前的設定執行。沒有可用的有效副本，下次重新啟動將無法自動恢復。請在重新啟動前修正 YAML 錯誤；AgEnD 未更動此檔案。", config_history_fallback: "{0} 第 {1} 行、第 {2} 欄：{3}。AgEnD 已使用 {4} 儲存的有效副本啟動。請修正 YAML 錯誤並重新載入設定。AgEnD 未更動磁碟上的檔案。", needs_reason_native_pane_hold: "Windows 代理需要處理", needs_reason_crashed: "已崩潰", needs_reason_usage_limit: "用量已達上限 · 恢復時間未知", 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_config_invalid: "設定檔需要處理", needs_reason_config_fallback: "正在使用儲存的設定副本", config_history_edit: "{0} 第 {1} 行、第 {2} 欄：{3}。AgEnD 仍使用先前的設定執行。下次重新啟動會改用 {4} 儲存的有效副本。請修正 YAML 錯誤；AgEnD 未更動此檔案。", config_history_no_history: "{0} 第 {1} 行、第 {2} 欄：{3}。AgEnD 仍使用先前的設定執行。沒有可用的有效副本，下次重新啟動將無法自動恢復。請在重新啟動前修正 YAML 錯誤；AgEnD 未更動此檔案。", config_history_fallback: "{0} 第 {1} 行、第 {2} 欄：{3}。AgEnD 已使用 {4} 儲存的有效副本啟動。請修正 YAML 錯誤並重新載入設定。AgEnD 未更動磁碟上的檔案。", needs_reason_general_windows_offline: "General 所在的 Windows 電腦已離線", needs_reason_general_location_hold: "General 執行位置", needs_reason_native_pane_hold: "Windows 代理需要處理", needs_reason_crashed: "已崩潰", needs_reason_usage_limit: "用量已達上限 · 恢復時間未知", needs_reason_delivery_uncertain: "無法確認是否送達", needs_reason_delivery_failed: "傳送失敗", needs_reason_task_review: "等你確認", needs_reason_task_blocked: "卡住，在問你",
   },
 });

package/dist/ui/shared/app.css

@@ -1348,6 +1348,21 @@ body.side-resizing, body.side-resizing * { cursor: col-resize !important; user-s
 /* #1844 Fleet overview → Docs: the arrow says "opens a new tab". */
 .hd-docs .hd-ext { color: var(--text-3); }
 .v-term { flex: 1; min-height: 0; overflow: auto; scrollbar-gutter: stable; padding: 5px 6px; background: #000000; position: relative; }
+/* M-2262: the terminal's box — the scrolling terminal, and its scrollback controls over it (they never scroll with it). */
+/* --v-term-rev: the View's mark (panel-view.js VIEW_REV): a tab still on an older stylesheet reads this one again. */
+.v-term-box { --v-term-rev: 2; flex: 1; min-height: 0; display: flex; flex-direction: column; position: relative; }
+.v-term:focus-visible { outline: 2px solid var(--accent); outline-offset: -2px; }
+.v-term-earlier, .v-term-latest { position: absolute; right: var(--s-4); z-index: 2; display: inline-flex; align-items: center; gap: 4px; opacity: .88; }
+.v-term-earlier { top: var(--s-2); }
+.v-term-latest { bottom: var(--s-3); opacity: 1; }
+.v-term-logbar { flex-shrink: 0; margin: 0; padding: var(--s-2) var(--s-4); background: #111111; border-bottom: 1px solid #2a2a2a; text-align: right; font-size: var(--fs-sm); }
+.v-term-logbar a { display: inline-flex; align-items: center; gap: 4px; color: #9cc8ff; text-decoration: underline; text-underline-offset: 2px; min-height: 28px; }
+@media (pointer: coarse) { .v-term-logbar a { min-height: 44px; } }
+.v-term-latest.has-new { background: var(--accent-fill); border-color: transparent; color: var(--on-accent); }
+.v-term-earlier:hover, .v-term-earlier:focus-visible { opacity: 1; }
+.v-term-history-note { position: absolute; left: var(--s-3); right: var(--s-3); bottom: var(--s-3); z-index: 2; margin: 0; padding: var(--s-1) var(--s-3); border-radius: var(--r-sm); background: rgba(20, 20, 20, .92); border: 1px solid #3a3a3a; color: #e0e0e0; font-size: var(--fs-sm); }
+@media (max-width: 600px) { .v-term-history-note { left: var(--s-4); right: var(--s-4); } }
+@media (pointer: coarse) { .v-term-earlier, .v-term-latest { min-height: 44px; padding-left: var(--s-3); padding-right: var(--s-3); } }
 .v-pre { margin: 0; min-width: 100%; min-height: 100%; font-family: var(--font-mono); line-height: 1.2; white-space: pre; color: #d0d0d0; }
 .v-pre .ansi[data-b] { font-weight: var(--fw-bold); }
 /* #1582: faint text (SGR 2) — a CLI's suggestion or placeholder, never input — stays faint here. */
@@ -2317,7 +2332,7 @@ html.oo-immersive .p-fleet > .panel-body { z-index: 50; }
 .p-fleet > .seg, .p-settings > .seg,
 .p-fleet > .panel-body, .p-needs > .panel-body, .p-notices > .panel-body, .p-settings > .panel-body,
 .p-log > .panel-body, .p-details > .panel-body, .p-view > .panel-body,
-.p-log > .log-bar, .p-view > .v-term, .p-view > .v-id, .p-view > .v-watching { position: relative; z-index: 1; }
+.p-log > .log-bar, .p-view > .v-term-box, .p-view > .v-id, .p-view > .v-watching { position: relative; z-index: 1; }
 /* Keep the existing Apply bar's sticky behavior, in its own bounded stock band. */
 .p-settings > .s-pending { z-index: 1; }
 

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

@@ -294,6 +294,8 @@ function writeFacetsOpen(open) { try { localStorage.setItem(FACETS_KEY, JSON.str
 
 /** The Favorites group's key among the tag groups: no tag can be it (a group name is never a control character). */
 const FAV_GROUP = "\u0000favorites";
+/** #3008 G2: a web-only fleet's General (its status row says `general: true`), pinned first under its own head. */
+const GENERAL_GROUP = "\u0000general";
 /** #1936: the open instance, pinned on top while a filter is on. */
 const PINNED_GROUP = "\u0000pinned";
 function persistOrder(groupNames, instByGroup) {
@@ -515,7 +517,10 @@ export function InstanceNav({ route, items, loaded = true, exec = {}, awaiting =
   // their order. Changing them: a signed-in page that may write preferences (not the public link, not the anonymous
   // reader — they still see the list).
   const known = new Set(byName.keys());
-  const favs = nav.favorites.filter((n) => known.has(n));
+  // #3008 G2: the General, when the server marks one (a web-only fleet), comes first — out of every other group.
+  const general = items.find((it) => it && it.general === true);
+  const generalName = general ? nameOf(general) : null;
+  const favs = nav.favorites.filter((n) => known.has(n) && n !== generalName);
   const favSet = new Set(favs);
   const canStar = !viewOnly && prefsWritable("nav.favorites");
   // #1920: a guest's list is not reordered (the order is the host's). #2855: it stars, sorts and filters as its own
@@ -533,14 +538,15 @@ export function InstanceNav({ route, items, loaded = true, exec = {}, awaiting =
   let shownGroups, shownInsts;
   if (recent) {
     const sortRecent = byRecentReply(ageOf);
-    const rest = groupNames.flatMap((g) => instByGroup.get(g) || []).filter((n) => !favSet.has(n)).sort(sortRecent);
+    const rest = groupNames.flatMap((g) => instByGroup.get(g) || []).filter((n) => !favSet.has(n) && n !== generalName).sort(sortRecent);
     shownGroups = [...(favs.length ? [FAV_GROUP] : []), ...(rest.length ? [RECENT_GROUP] : [])];
     shownInsts = new Map([[FAV_GROUP, favsSorted ? [...favs].sort(sortRecent) : favs], [RECENT_GROUP, rest]]);
   } else {
     shownGroups = favs.length ? [FAV_GROUP, ...groupNames] : groupNames;
-    shownInsts = new Map([...instByGroup].map(([g, names]) => [g, names.filter((n) => !favSet.has(n))]));
+    shownInsts = new Map([...instByGroup].map(([g, names]) => [g, names.filter((n) => !favSet.has(n) && n !== generalName)]));
     if (favs.length) shownInsts.set(FAV_GROUP, favs);
   }
+  if (generalName) { shownGroups = [GENERAL_GROUP, ...shownGroups]; shownInsts.set(GENERAL_GROUP, [generalName]); }
   const f = nav.filter;
   const shown = filterSidebar(shownGroups, shownInsts, byName, f.q, backendLabel, { status: f.status, cli: f.cli, statusOf: facetOf });
   // #1936: while a filter is on, the instance you have open stays on top, pinned and marked "Current", whether or not
@@ -655,6 +661,10 @@ export function InstanceNav({ route, items, loaded = true, exec = {}, awaiting =
       if (g === RECENT_GROUP) return html`<div key=${g} class="v-group v-recent" role="group" aria-label=${tn("recentOthers")}>
         <div class="v-group-head recent-head"><${Icon} name="clock" size=${14} /><span class="grow">${tn("recentOthers")}</span><span class="count">${names.length}</span></div>
         <ul class="inst-list">${names.map((name, i) => row(name, g, i, names.length))}</ul></div>`;
+      // #3008 G2: the General — always open, first, not dragged or starred into another place.
+      if (g === GENERAL_GROUP) return html`<div key=${g} class="v-group v-general" role="group" aria-label=${tn("generalGroup")}>
+        <div class="v-group-head general-head"><span class="grow">${tn("generalGroup")}</span></div>
+        <ul class="inst-list">${names.map((name, i) => row(name, g, i, names.length))}</ul></div>`;
       // #1664: Favorites — always open, not dragged (↑ ↓ in Edit), named in the page's language.
       if (g === FAV_GROUP) return html`<div key=${g} class="v-group v-fav" role="group" aria-label=${tn("favorites")}>
         <div class="v-group-head fav-head"><${Icon} name="star" size=${14} cls="fav-mark" /><span class="grow">${tn("favorites")}</span><span class="count">${names.length}</span></div>