@songsid/agend 2.3.3 → 2.3.4-beta.10

package/dist/view-history.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Claude history in the View (the user, hmsg-a8947a2c / hmsg-b4c7ccdf; leader cid-claude-history-build). Claude Code
+ * draws on the alternate screen, so tmux keeps nothing above it: the View shows the conversation's earlier part from the
+ * instance's own transcript instead, drawn like Claude's own Ctrl+O view above the live screen (view-history.js).
+ *
+ * Read with the Log's reader (LogService.readBack: ClaudeStepParser, masked and cut) — the instance's own transcript,
+ * only when the person scrolls up in its View, a page at a time:
+ * - `GET /api/pane/<name>?transcript=1` — the newest VIEW_HISTORY_PAGE steps; `&before=<n>&key=<k>` — the page before
+ *   that offset of that transcript;
+ * - `?transcript=1&step=<id>&end=<n>&key=<k>` — one step whole (a folded one, clicked): the page it came in is read
+ *   again (its range ends at `end`; step ids depend on the bytes, not on the range) and the step answered unfolded.
+ * Access is the View's own (view-api.ts answers it on the pane's route, behind the pane's gate). Claude only: any other
+ * backend answers `supported: false` (Codex keeps tmux's scrollback). Thinking never shows (the parser has none); a
+ * turn's end and the fleet's state lines are left out.
+ *
+ * Folding happens here, so a page stays small: a long tool result or error keeps its first lines and says how many
+ * more there are; an edit's diff its first rows. Prompts and replies come whole (the parser already bounds them).
+ */
+import type { LogStep } from "./log-steps.js";
+import type { ReadBack } from "./log-service.js";
+export declare const VIEW_HISTORY_PAGE = 100;
+/** A result over `lines` lines keeps `keep`; a diff over `diffRows` rows keeps `diffKeep`; kept text at most `chars`. */
+export declare const VIEW_FOLD: {
+    readonly lines: 5;
+    readonly keep: 3;
+    readonly diffRows: 10;
+    readonly diffKeep: 6;
+    readonly chars: 600;
+};
+export interface ViewStep {
+    id: string;
+    kind: "user" | "assistant" | "tool" | "error";
+    /** tool: the CLI's tool name (the page shows Claude's word for it). */
+    tool?: string;
+    /** tool: what it acts on (a path, a command, a pattern). */
+    subject?: string;
+    status?: "running" | "done" | "failed" | "interrupted";
+    body?: string;
+    /** An edit's change as removed / added lines, hunk by hunk (instead of its result's sentence). */
+    diff?: Array<{
+        del: string[];
+        add: string[];
+    }>;
+    /** Folded: how many more lines (or diff rows) the whole step has. */
+    more?: number;
+    /** Characters the transcript reader itself cut (they are not in the whole step either). */
+    cut?: number;
+}
+export type ViewHistoryAnswer = {
+    view_history: 1;
+    supported: false;
+    reason: string;
+} | {
+    view_history: 1;
+    supported: true;
+    key: string;
+    steps: ViewStep[];
+    before: number | null;
+    end: number;
+    reset?: boolean;
+} | {
+    view_history: 1;
+    supported: true;
+    key: string;
+    step: ViewStep | null;
+};
+export interface ViewHistoryQuery {
+    before?: number;
+    key?: string;
+    step?: string;
+    end?: number;
+}
+/** Reads an instance's steps backwards (LogService.readBack). */
+export type ReadBackFn = (name: string, q: {
+    end?: number;
+    key?: string;
+    limit: number;
+}) => Promise<ReadBack | null>;
+/** The query's own parts from a URL's search params (anything malformed is left out: the newest page). */
+export declare function viewHistoryQuery(params: URLSearchParams): ViewHistoryQuery;
+/** Null: no such instance. */
+export declare function viewHistory(read: ReadBackFn, name: string, q: ViewHistoryQuery): Promise<ViewHistoryAnswer | null>;
+/** A Log step as the View draws it (null: not drawn); `fold`: long results and diffs keep their start. */
+export declare function viewStep(s: LogStep, fold: boolean): ViewStep | null;

package/dist/view-history.js

@@ -0,0 +1,116 @@
+export const VIEW_HISTORY_PAGE = 100;
+/** A result over `lines` lines keeps `keep`; a diff over `diffRows` rows keeps `diffKeep`; kept text at most `chars`. */
+export const VIEW_FOLD = { lines: 5, keep: 3, diffRows: 10, diffKeep: 6, chars: 600 };
+/** The query's own parts from a URL's search params (anything malformed is left out: the newest page). */
+export function viewHistoryQuery(params) {
+    const offset = (v) => (v !== null && /^\d{1,15}$/.test(v) ? Number(v) : undefined);
+    const q = {};
+    const before = offset(params.get("before")), end = offset(params.get("end"));
+    const key = params.get("key"), step = params.get("step");
+    if (before !== undefined)
+        q.before = before;
+    if (end !== undefined)
+        q.end = end;
+    if (key && /^\d{1,20}-\d{1,20}$/.test(key))
+        q.key = key;
+    if (step && step.length <= 200 && /^[\w.:-]+$/.test(step))
+        q.step = step;
+    return q;
+}
+/** Null: no such instance. */
+export async function viewHistory(read, name, q) {
+    if (q.step !== undefined) {
+        if (q.end === undefined)
+            return { view_history: 1, supported: false, reason: "bad_request" };
+        const back = await read(name, { end: q.end, ...(q.key !== undefined ? { key: q.key } : {}), limit: VIEW_HISTORY_PAGE });
+        if (!back)
+            return null;
+        if (back.format !== "claude" || back.steps === undefined)
+            return { view_history: 1, supported: false, reason: back.reason ?? "unsupported" };
+        // Another transcript now (a new session), or past its end: the step is not there to give whole.
+        if (back.reset)
+            return { view_history: 1, supported: true, key: back.key, step: null };
+        const found = back.steps.find((s) => s.id === q.step);
+        return { view_history: 1, supported: true, key: back.key, step: found ? viewStep(found, false) : null };
+    }
+    const back = await read(name, { ...(q.before !== undefined ? { end: q.before } : {}), ...(q.key !== undefined ? { key: q.key } : {}), limit: VIEW_HISTORY_PAGE });
+    if (!back)
+        return null;
+    if (back.format !== "claude" || back.steps === undefined)
+        return { view_history: 1, supported: false, reason: back.reason ?? "unsupported" };
+    const steps = back.steps.map((s) => viewStep(s, true)).filter((s) => s !== null);
+    return { view_history: 1, supported: true, key: back.key, steps, before: back.before, end: back.end, ...(back.reset ? { reset: true } : {}) };
+}
+/** A Log step as the View draws it (null: not drawn); `fold`: long results and diffs keep their start. */
+export function viewStep(s, fold) {
+    if (s.kind === "user" || s.kind === "assistant") {
+        if (!s.body)
+            return null;
+        return { id: s.id, kind: s.kind, body: s.body, ...(s.bodyCut ? { cut: s.bodyCut } : {}) };
+    }
+    if (s.kind === "error")
+        return { id: s.id, kind: "error", ...folded(s.body ?? s.note ?? "", fold), ...(s.bodyCut ? { cut: s.bodyCut } : {}) };
+    if (s.kind !== "tool")
+        return null;
+    const step = { id: s.id, kind: "tool", tool: s.tool ?? "", ...(s.subject ? { subject: s.subject } : {}), ...(s.status ? { status: s.status } : {}) };
+    const diff = s.status !== "failed" ? diffOf(s.tool ?? "", s.input) : null;
+    if (diff) {
+        const rows = diff.reduce((n, h) => n + h.del.length + h.add.length, 0);
+        if (!fold || rows <= VIEW_FOLD.diffRows)
+            return { ...step, diff };
+        let left = VIEW_FOLD.diffKeep;
+        const kept = [];
+        for (const h of diff) {
+            if (left <= 0)
+                break;
+            const del = h.del.slice(0, left);
+            left -= del.length;
+            const add = h.add.slice(0, Math.max(0, left));
+            left -= add.length;
+            kept.push({ del, add });
+        }
+        return { ...step, diff: kept, more: rows - VIEW_FOLD.diffKeep };
+    }
+    const body = clean(s.body ?? "");
+    return { ...step, ...(body ? folded(body, fold) : {}), ...(s.bodyCut ? { cut: s.bodyCut } : {}) };
+}
+/** A tool's error comes wrapped (`<tool_use_error>…</tool_use_error>`): the page shows its words. */
+function clean(text) { return text.replace(/^<tool_use_error>([\s\S]*?)<\/tool_use_error>$/, "$1").replace(/\n+$/, ""); }
+function folded(text, fold) {
+    const lines = text.split("\n");
+    if (!fold)
+        return { body: text };
+    let keep = lines.length > VIEW_FOLD.lines ? lines.slice(0, VIEW_FOLD.keep) : lines;
+    let more = lines.length - keep.length;
+    let body = keep.join("\n");
+    if (body.length > VIEW_FOLD.chars) {
+        body = body.slice(0, VIEW_FOLD.chars);
+        keep = body.split("\n");
+        more = Math.max(1, lines.length - keep.length + 1);
+    }
+    return { body, ...(more > 0 ? { more } : {}) };
+}
+/** An edit's change from its arguments (Edit, MultiEdit, Write), or null — also when the arguments were cut. */
+function diffOf(tool, input) {
+    if (!input || !["Edit", "MultiEdit", "Write"].includes(tool))
+        return null;
+    let args;
+    try {
+        args = JSON.parse(input);
+    }
+    catch {
+        return null;
+    }
+    const lines = (v) => (typeof v === "string" && v !== "" ? v.replace(/\n$/, "").split("\n") : []);
+    if (tool === "Write")
+        return typeof args.content === "string" ? [{ del: [], add: lines(args.content) }] : null;
+    const edits = tool === "MultiEdit" ? (Array.isArray(args.edits) ? args.edits : null) : [args];
+    if (!edits)
+        return null;
+    const hunks = edits
+        .filter((e) => !!e && typeof e === "object")
+        .map((e) => ({ del: lines(e.old_string), add: lines(e.new_string) }))
+        .filter((h) => h.del.length || h.add.length);
+    return hunks.length ? hunks : null;
+}
+//# sourceMappingURL=view-history.js.map

package/dist/view-history.js.map

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

package/dist/web-api.d.ts

@@ -24,6 +24,7 @@ import { type WebPrefsStore } from "./web-prefs.js";
 import { type WebAccount } from "./web-profile.js";
 import { type MentionNames, type MentionQuery } from "./web-mentions.js";
 import type { ExplicitInstanceRemoval } from "./instance-removal.js";
+import { type TopicDeleteOutcome } from "./instance-topic-delete.js";
 /**
  * #1920 §5.2: one event for the guests' streams only, each as projected for it — a message that has just become what
  * its channel saw (an admin's page already has it, unchanged).
@@ -216,7 +217,23 @@ export interface WebApiContext {
             owner: string;
         }): Promise<import("./office-share-service.js").OfficeShareMade>;
         revoke(id: string): number;
+        /** #2911: page share links on the same tunnel (page-share.ts); absent: /ui/page-share is not offered. */
+        pagesEnabled?(): boolean;
+        pagesCdn?(): boolean;
+        listPages?(): import("./page-share.js").PageShare[];
+        createPage?(opts: {
+            html: string;
+            instance: string;
+            title: string;
+            owner: string;
+            from?: import("./page-share.js").PageShare["from"];
+            minutes?: number;
+            stillAllowed?(): boolean;
+        }): Promise<import("./office-share-service.js").PageShareMade>;
+        revokePage?(id: string): import("./page-share.js").PageShare[];
     };
+    /** #2911: a page share was made — said in that instance's channel (who, which page, for how long; never its URL). */
+    pageShareNotice?(who: string, share: import("./page-share.js").PageShare): void;
     /** #2636: a share was made or ended from the page — said in General (who, which office, until when). */
     officeShareNotice?(event: "created" | "revoked", who: string, share: import("./office-share.js").OfficeShare | null, count: number): void;
     /** #2692: the agents' skin-pack changes (approval mode, pending changes, log); absent: /ui/office-pack-changes is not offered. */
@@ -326,6 +343,16 @@ export interface WebApiContext {
         status: number;
         message: string;
     };
+    /** #2910 D2: a web-only fleet's Notices (web-notices.ts); null on a fleet whose General says them. */
+    webNoticesFeed?(): {
+        view(): {
+            items: unknown[];
+            seen: number;
+            unread: number;
+        };
+        markSeen(id: number): number;
+        unread(): number;
+    } | null;
     /** Answer one of them, exactly as a click on its platform button would. */
     /** `text`: #2675 — the typed answer, for the one action the page shows a text box for. */
     clickWebPrompt?(instance: string, nonce: string, action: string, text?: string): Promise<{
@@ -350,6 +377,11 @@ export interface WebApiContext {
         explicit?: boolean;
     }): Promise<void>;
     removeInstance(name: string, authorization: ExplicitInstanceRemoval, execution?: SettingsExecution): Promise<void>;
+    /** delete_instance's removal: the agent, then its own topic (by default), with the platform's answer. */
+    removeInstanceAndTopic?(name: string, authorization: ExplicitInstanceRemoval, opts: {
+        deleteTopic: boolean;
+        execution?: SettingsExecution;
+    }): Promise<TopicDeleteOutcome>;
     lastInboundUser: Map<string, string>;
     saveFleetConfig(): void;
     readonly lifecycle: {

package/dist/web-api.js

@@ -1,4 +1,5 @@
 import { CANVAS_WORKER_EXPERIMENTAL_MESSAGE } from "./web-experimental.js";
+import { daemonTopicMode } from "./web-only-fleet.js";
 import { webHumanOrigin } from "./human-delivery-receipts.js";
 import { classifyWebPeer, confirmAfterBody, noAuthority } from "./authority/web-authority.js";
 import { guestChatRefusal, guestCommandText, guestDeliveries, GUEST_PREF_MAX_BYTES, GUEST_SEARCHES, guestFrameData, guestHistory, guestMessages, guestOwnPrefs, guestPollBody, guestPrefs, guestRequestOf, guestSeesMessage, guestStatus } from "./web-guest-access.js";
@@ -39,7 +40,8 @@ import { readStatuslineModel, resolveInstanceContext } from "./topic-commands.js
 import { z } from "zod";
 import { evaluateWebRequest, isPassiveWebRead, isSecureRequest, isWebRequestAuthorized, WEB_TOKEN_INVALID_MESSAGE } from "./web-auth.js";
 import { dashboardOriginFor } from "./web-preview.js";
-import { WEB_CHAT_CARDS_OVERFLOW, newWebMessageId, parseLastEventId, webChatReplyRef, webChatReplyText } from "./web-chat-history.js";
+import { WEB_CHAT_CARDS_OVERFLOW, catchUpWindow, newWebMessageId, parseLastEventId, webChatReplyRef, webChatReplyText } from "./web-chat-history.js";
+import { PAGE_SHARE_LIMITS, htmlFences, htmlTitle } from "./page-share.js";
 import { attachmentDelivery, createPartFile, displayName, fileTooLargeText, INLINE_MIME, isFileId, MEDIA_RANGE_MAX, publicAttachment, UPLOAD_LIMITS, UPLOAD_MAX_MS, UPLOAD_STALL_MS, UploadSniffer, uploadLimits, wellFormed } from "./web-upload.js";
 import { getAgendHome } from "./paths.js";
 import { OPERATOR, isOwnerEffectKey } from "./web-prefs.js";
@@ -52,6 +54,7 @@ import { resolveTz } from "./tz-utils.js";
 import { QUERY_MAX_CHARS, RESULT_MAX, SEARCH_SOURCES } from "./search/search-store.js";
 import { xmsgShown } from "./search/search-docs.js";
 import { WebSendDedupe } from "./web-send-dedupe.js";
+import { topicFields } from "./instance-topic-delete.js";
 // ── Strict public-facing schemas ────────────────────────────────────────────
 // web-api endpoints must reject unknown fields so the dashboard cannot inject
 // internal-only flags that would reach handleCreate/scheduler/config writers.
@@ -539,6 +542,140 @@ function handleOfficeShare(req, res, url, ctx, path, method) {
     });
     return true;
 }
+/**
+ * #2911 item 8: page share links — GET /ui/page-share (the open ones, and whether this fleet offers them), POST
+ * { instance, boot, id, fence | att, minutes? } (a new one: the server reads the HTML itself — the n-th complete ```html
+ * fence of that agent message, or its .html attachment — and answers the URL once the tunnel is up), DELETE
+ * /ui/page-share/<id|all>. The same admin check as the Office share's (handleOfficeShare): an admin session, directly
+ * or over the /web public link; never the CLI token, a read-only session or a guest. Asked again once the body is in.
+ */
+function handlePageShare(req, res, url, ctx, path, method) {
+    const service = ctx.officeShares;
+    if (!service?.createPage || !service.listPages || !service.revokePage || !service.pagesEnabled) {
+        json(res, 404, { error: "Page share links are not kept on this fleet" });
+        return true;
+    }
+    const one = /^\/ui\/page-share\/([0-9a-f]{8}|all)$/.exec(path);
+    const known = (method === "GET" && path === "/ui/page-share") || (method === "POST" && path === "/ui/page-share") || (method === "DELETE" && !!one);
+    if (!known) {
+        json(res, 404, { error: "not found" });
+        return true;
+    }
+    const who = () => {
+        const verdict = evaluateWebRequest(req, url, ctx.webToken ?? null, ctx.webSessions, { touch: false });
+        if (verdict.kind !== "allow")
+            return { status: 401 };
+        if (verdict.via !== "session" || verdict.session?.tier !== "admin")
+            return { status: 403 };
+        const owner = verdict.session.owner;
+        return { person: owner ? webPersonKey(owner) : "admin-session", name: owner ? ctx.webPerson?.(owner)?.name ?? owner.userId : "admin" };
+    };
+    const refuse = (status) => json(res, status, { error: status === 401 ? WEB_TOKEN_INVALID_MESSAGE : "page_share_needs_an_admin_session" });
+    const first = who();
+    if ("status" in first) {
+        refuse(first.status);
+        return true;
+    }
+    res.setHeader("Cache-Control", "no-store");
+    // `cdn`: whether a share made now may load the preview's CDN libraries (the confirm dialog says so).
+    if (method === "GET") {
+        json(res, 200, { enabled: service.pagesEnabled(), cdn: service.pagesCdn?.() === true, shares: service.listPages() });
+        return true;
+    }
+    if (method === "DELETE") {
+        // Its end is said in the instance's channel by the service's change listener (as an expiry is).
+        const n = service.revokePage(one[1]).length;
+        json(res, n ? 200 : 404, n ? { revoked: n } : { error: "not_found" });
+        return true;
+    }
+    (async () => {
+        let body;
+        try {
+            body = await parseBody(req);
+        }
+        catch {
+            json(res, 400, { error: "Invalid JSON" });
+            return;
+        }
+        if (!permitWebContinuation(req, res, ctx))
+            return;
+        const now = who();
+        if ("status" in now) {
+            refuse(now.status);
+            return;
+        }
+        const fence = body?.fence, att = body?.att;
+        if (!body || typeof body !== "object" || Array.isArray(body) || typeof body.instance !== "string" || !body.instance
+            || typeof body.boot !== "string" || !/^[0-9a-f]{1,32}$/.test(body.boot) || !Number.isSafeInteger(body.id) || body.id < 1
+            || (fence === undefined) === (att === undefined)
+            || (fence !== undefined && (!Number.isInteger(fence) || fence < 0 || fence > 999))
+            || (att !== undefined && (typeof att !== "string" || !isFileId(att)))
+            || (body.minutes !== undefined && typeof body.minutes !== "number")) {
+            json(res, 400, { error: "instance, boot, id, and fence (number) or att (file id); minutes? (number)" });
+            return;
+        }
+        const msg = ctx.webChatHistory?.find(body.instance, body.boot, body.id) ?? null;
+        if (!msg || msg.instance !== body.instance) {
+            json(res, 404, { error: "message_gone" });
+            return;
+        }
+        if (msg.role !== "agent") {
+            json(res, 400, { error: "not_an_agent_page" });
+            return;
+        }
+        let html, name = "";
+        if (fence !== undefined) {
+            const f = htmlFences(msg.text)[fence];
+            if (!f || !f.terminated) {
+                json(res, 404, { error: "page_gone" });
+                return;
+            }
+            html = f.code;
+        }
+        else {
+            const a = (msg.attachments ?? []).find((x) => !("gone" in x) && x.id === att);
+            if (!a || a.kind === "photo" || !/\.html?$/i.test(a.name.trim())) {
+                json(res, 404, { error: "page_gone" });
+                return;
+            }
+            const served = ctx.webFiles?.servedFile?.(a.id) ?? null;
+            if (!served) {
+                json(res, 404, { error: "page_gone" });
+                return;
+            }
+            if (served.size > PAGE_SHARE_LIMITS.maxBytes) {
+                json(res, 413, { error: "too_large" });
+                return;
+            }
+            const read = ctx.webFiles?.read?.(a.id) ?? null;
+            if (!read) {
+                json(res, 404, { error: "page_gone" });
+                return;
+            }
+            html = read.bytes.toString("utf8");
+            name = a.name;
+        }
+        const from = { boot: body.boot, id: body.id, ...(fence !== undefined ? { fence: fence } : { att: att }) };
+        // The caller is asked again once the tunnel is up (#2917 review P2): the same admin, the session still live.
+        const stillAllowed = () => { const currentCaller = who(); return !("status" in currentCaller) && currentCaller.person === now.person; };
+        const made = await service.createPage({ html, instance: body.instance, title: htmlTitle(html) || name, owner: now.person, from, stillAllowed,
+            ...(typeof body.minutes === "number" ? { minutes: body.minutes } : {}) });
+        if (!made.ok) {
+            const status = made.error === "disabled" ? 404 : made.error === "tunnel" ? 503 : made.error === "too_many" ? 409 : made.error === "too_large" ? 413 : made.error === "not_allowed" ? 403 : 400;
+            json(res, status, { error: made.error, ...(made.reason ? { reason: made.reason } : {}) });
+            return;
+        }
+        ctx.pageShareNotice?.(now.name, made.share);
+        json(res, 200, { share: made.share, url: made.url });
+    })().catch(err => {
+        ctx.logger.error({ err: err.message }, "Page share failed");
+        try {
+            json(res, 500, { error: "Page share failed" });
+        }
+        catch { /* already answered */ }
+    });
+    return true;
+}
 /**
  * #2513: the Office view's skin packs (web-office-skins.ts). The reads are the offices' (GET /ui/offices): whoever may
  * open the org chart, the public link too (its manifest lists them; a guest's routes do not): the list, a pack's
@@ -1855,7 +1992,12 @@ export function handleWebRequest(req, res, url, ctx) {
         json(res, 200, {
             status: ctx.getUiStatus(),
             // #2341 review: over the public link, without a summary line that names a card hidden there.
-            messages: history ? visibleMessages(ctx, !!gatewayRequestContext(req), fresh ? history.after(0) : history.replayFor(parseLastEventId(after))) : [],
+            // M-2260: the newest within the catch-up budget; `truncated` when older ones were left out (the page re-reads its
+            // chats' newest history, as a reload would) — never megabytes that a slow link cannot bring in time.
+            ...(() => {
+                const w = catchUpWindow(history ? visibleMessages(ctx, !!gatewayRequestContext(req), fresh ? history.after(0) : history.replayFor(parseLastEventId(after))) : []);
+                return w.truncated ? { messages: w.messages, truncated: true } : { messages: w.messages };
+            })(),
             // The ticks too, so polling never has to re-read a chat's history — that read would count as the person's
             // activity; this poll does not (isPassiveWebRead).
             deliveries: history ? history.deliveries() : [],
@@ -2400,6 +2542,8 @@ export function handleWebRequest(req, res, url, ctx) {
         return handleOfficePackChanges(req, res, url, ctx, path, method);
     if (path === "/ui/office-share" || path.startsWith("/ui/office-share/"))
         return handleOfficeShare(req, res, url, ctx, path, method);
+    if (path === "/ui/page-share" || path.startsWith("/ui/page-share/"))
+        return handlePageShare(req, res, url, ctx, path, method);
     // ── #1630: avatars and Discord server emoji, same-origin (the page never loads a platform's CDN; img-src stays 'self') ──
     const imageMatch = path.match(/^\/ui\/img\/(bot|avatar|emoji)\/([^/]+)$/);
     if (method === "GET" && imageMatch) {
@@ -2741,6 +2885,47 @@ export function handleWebRequest(req, res, url, ctx) {
         return handleBackendLogin(req, res, url, ctx, path, method);
     // #1386: Acknowledge a "Needs you" delivery item — a session write (CSRF, checked by the gate) or the CLI's header
     // token. Who did it is recorded by principal: the session's public handle, never the session id or a credential.
+    // #2910 D2: a web-only fleet's Notices — what General would have said. Admins only (never a guest: not in
+    // GUEST_ROUTES). GET /ui/notices/list lists them; POST /ui/notices/seen {id} marks everything up to it read (a session write).
+    if (path === "/ui/notices/list" && method === "GET") {
+        const feed = ctx.webNoticesFeed?.() ?? null;
+        res.setHeader("Cache-Control", "no-store");
+        json(res, 200, feed ? { enabled: true, ...feed.view() } : { enabled: false, items: [], seen: 0, unread: 0 });
+        return true;
+    }
+    if (path === "/ui/notices/seen" && method === "POST") {
+        (async () => {
+            let body;
+            try {
+                body = await parseBody(req);
+            }
+            catch {
+                json(res, 400, { error: "Invalid JSON" });
+                return;
+            }
+            if (!permitWebContinuation(req, res, ctx))
+                return;
+            const id = body && typeof body === "object" ? body.id : undefined;
+            if (typeof id !== "number" || !Number.isSafeInteger(id) || id < 0) {
+                json(res, 400, { error: "id required" });
+                return;
+            }
+            const feed = ctx.webNoticesFeed?.() ?? null;
+            if (!feed) {
+                json(res, 404, { error: "No notices here" });
+                return;
+            }
+            const seen = feed.markSeen(id);
+            json(res, 200, { seen, unread: feed.unread() });
+        })().catch(err => {
+            ctx.logger.error({ err: err.message }, "Notices mark-read failed");
+            try {
+                json(res, 500, { error: "Mark read failed" });
+            }
+            catch { /* already answered */ }
+        });
+        return true;
+    }
     if (method === "POST" && path === "/ui/needs/ack") {
         if (!ctx.acknowledgeNeedsItem) {
             json(res, 404, { error: "Nothing to acknowledge here" });
@@ -2979,7 +3164,7 @@ export function handleWebRequest(req, res, url, ctx) {
             json(res, 404, { error: `Instance not found: ${name}` });
             return true;
         }
-        const topicMode = ctx.fleetConfig?.channel?.mode === "topic";
+        const topicMode = daemonTopicMode(ctx.fleetConfig);
         (async () => {
             let held = false;
             try {
@@ -3014,12 +3199,17 @@ export function handleWebRequest(req, res, url, ctx) {
                     return;
                 }
                 const execution = settingsRequestExecution(req);
-                if (execution)
+                // The same removal as delete_instance: the agent, then its own topic (the user's default), said truthfully.
+                let topic = null;
+                if (ctx.removeInstanceAndTopic) {
+                    topic = await ctx.removeInstanceAndTopic(name, authorizeExplicitInstanceRemoval("dashboard-confirmed"), { deleteTopic: true, ...(execution ? { execution } : {}) });
+                }
+                else if (execution)
                     await ctx.removeInstance(name, authorizeExplicitInstanceRemoval("dashboard-confirmed"), execution);
                 else
                     await ctx.removeInstance(name, authorizeExplicitInstanceRemoval("dashboard-confirmed"));
                 ctx.emitSseEvent("status", ctx.getUiStatus());
-                json(res, 200, { deleted: name });
+                json(res, 200, { deleted: name, ...topicFields(name, topic) });
             }
             catch (err) {
                 json(res, 500, { error: err.message });