pi-roundtable-web 0.26.2 → 0.27.0

package/dist/sw.js

@@ -1 +1 @@
-var o=self,i=new URL(o.registration.scope);var d=new URL("index.html",i).href,h=new Set(["index.html","account-zk4efb87.css","chunk-account-nhpd9j90.js","chunk-action-menu-ec9jqtxq.js","chunk-agent-d1xfrawq.js","chunk-arranged-rooms-bga8yk2v.js","chunk-character-creator-k67f77w5.js","chunk-confirm-wc5xraev.js","chunk-connectors-mhnw6d79.js","chunk-conversations-yjyq4g1y.js","chunk-drag-nyq52ck7.js","chunk-entry-red1597w.js","chunk-folder-list-x56y26yq.js","chunk-folds-3p7s2nvx.js","chunk-gate-h41bv4y9.js","chunk-group-scene-7eb6jyev.js","chunk-group-table-rca48kt0.js","chunk-host-icons-x318gjqp.js","chunk-host-picture-xswcakgy.js","chunk-host-state-bpahvk54.js","chunk-host-ui-tsbwwk38.js","chunk-index-029209sy.js","chunk-index-066vzexw.js","chunk-index-0h4h76kw.js","chunk-index-0n6ja7my.js","chunk-index-0q15ysrb.js","chunk-index-1f0j335v.js","chunk-index-2f5nfekb.js","chunk-index-31ays46f.js","chunk-index-43k1rjmx.js","chunk-index-4gk88a0x.js","chunk-index-4jf4jvfd.css","chunk-index-4mf29sbx.js","chunk-index-51n20yhb.js","chunk-index-6tpr6r6d.js","chunk-index-7bbqtdce.js","chunk-index-84v7j6vh.js","chunk-index-8f9jer8r.js","chunk-index-91z3g774.js","chunk-index-934zgd18.js","chunk-index-9nents16.js","chunk-index-9w0sar6s.js","chunk-index-a768zmp6.js","chunk-index-b7jjca66.js","chunk-index-c5x70d9g.js","chunk-index-cmxs5y22.js","chunk-index-cwc1vvpw.js","chunk-index-d85x96q0.js","chunk-index-datrrs6b.js","chunk-index-dep2e3f3.js","chunk-index-dtste2ed.js","chunk-index-ewj52be9.js","chunk-index-f3b5nch2.js","chunk-index-frwa2fmc.js","chunk-index-grkczq2c.js","chunk-index-gzvkpe3e.js","chunk-index-kfv996qe.js","chunk-index-kw85ajap.js","chunk-index-satam151.js","chunk-index-smw1n2pt.js","chunk-index-th43f690.js","chunk-index-ths2hxpe.js","chunk-index-tmx30r1w.js","chunk-index-y00wke93.js","chunk-index-y4sqmenv.js","chunk-index-yrhbhmxz.js","chunk-index-zd76pr2k.js","chunk-layout-actions-cgghzj1w.js","chunk-menu-items-24cfwawa.js","chunk-mode-toggle-v4baz3r1.js","chunk-note-row-72n6cqyk.js","chunk-notes-83s3tsey.js","chunk-notice-bell-a4ty5h1p.js","chunk-notices-evny44be.js","chunk-onboarding-q1avjbrx.js","chunk-overview-42h45ehd.js","chunk-palette-e44qepmh.js","chunk-placement-items-v466t0sv.js","chunk-profile-bqcgkgk4.js","chunk-prompt-history-hgbtcn4b.js","chunk-prompts-czs8y6r1.js","chunk-room-confirms-h8cdj3ng.js","chunk-room-menu-7s0feajw.js","chunk-rooms-menu-button-gawqvpsr.js","chunk-schedules-zba7krac.js","chunk-seat-menu-ca5p4e9q.js","chunk-sheet-hosts-ssbz6hf2.js","chunk-skill-editor-n0y9pd90.js","chunk-skills-ea4vb2s4.js","chunk-switcher-list-pj5csqr9.js","chunk-tab-dot-4tkpxqeh.js","chunk-table-j8nmtdnn.js","chunk-table-seats-qeytqe0m.js","chunk-table2d-18y029k9.js","chunk-thread-actions-w3eadnh7.js","chunk-thread-cards-fbpky3c9.js","chunk-thread-list-pghe84be.js","chunk-transcript-eqzxgqys.js","chunk-where-ygyr4jdj.js","chunk-workspace-h0p32ygy.js","chunk-zh-tw-k6xx1hp2.js"].map((e)=>new URL(e,i).href)),w=/\/chunk-table3d-[a-z0-9]+\.js$/,g=/\/chunk-(?:codeeditor|lang-[a-z]+)-[a-z0-9]+\.js$/,k=["api/","auth/","login","files/","avatars/"],m=(e)=>{let n=e.pathname.slice(i.pathname.length);return k.some((t)=>n.startsWith(t))};async function v(e){let n=await caches.open("roundtable-web-d442d154a5a4");try{let t=await fetch(e);if(t.ok&&new URL(e.url).href===i.href)await n.put(d,t.clone());return t}catch{let t=await n.match(d);if(t)return t;throw Error("offline and the shell is not cached")}}async function W(e){let n=await caches.open("roundtable-web-d442d154a5a4"),t=await n.match(e);if(t)return t;let a=await fetch(e);if(a.ok)await n.put(e,a.clone());return a}var r=(e,n)=>typeof e==="string"&&e?e.slice(0,n):void 0;function l(e){if(typeof e!=="string")return i.href;let n=URL.parse(e,i);return n&&n.origin===i.origin&&n.pathname.startsWith(i.pathname)?n.href:i.href}var E=new Set(["notice","test"]);async function u(e,n){if(!e?.tag||!e.kind||!E.has(e.kind))return;try{await fetch(new URL("api/push/receipts",i),{method:"POST",credentials:"include",headers:{"content-type":"application/json"},body:JSON.stringify({tag:e.tag,event:n})})}catch{}}async function y(e){if(typeof e!=="number"||!Number.isSafeInteger(e)||e<0)return;try{if(e>0)await o.navigator.setAppBadge?.(e);else await o.navigator.clearAppBadge?.()}catch{}}async function P(e){let n={};try{let s=e.data?.json();if(typeof s==="object"&&s!==null)n=s}catch{}let t=r(n.tag,200),a=r(n.kind,16);if(await y(n.badge),a==="clear"){if(t)for(let s of await o.registration.getNotifications({tag:t}))s.close();return}await o.registration.showNotification(r(n.title,120)??"Roundtable",{body:r(n.body,240),icon:new URL("icons/192.png",i).href,badge:new URL("icons/badge-96.png",i).href,...t?{tag:t,renotify:!0}:{},...n.urgency==="high"?{requireInteraction:!0}:{},data:{url:l(n.url),...t?{tag:t}:{},...a?{kind:a}:{}}}),await u({...t?{tag:t}:{},...a?{kind:a}:{}},"received")}async function b(e){e.notification.close();let n=e.notification.data,t=l(n?.url),a=r(n?.tag,200),s=r(n?.kind,16),f=u({...a?{tag:a}:{},...s?{kind:s}:{}},"opened"),c=(await o.clients.matchAll({type:"window",includeUncontrolled:!0})).find((p)=>p.url.startsWith(i.href));if(c)await c.focus(),c.postMessage({type:"roundtable:open",url:t});else await o.clients.openWindow(t);await f}o.addEventListener("install",(e)=>{e.waitUntil(caches.open("roundtable-web-d442d154a5a4").then((n)=>n.addAll([...h])).then(()=>o.skipWaiting()))});o.addEventListener("activate",(e)=>{e.waitUntil(caches.keys().then((n)=>Promise.all(n.filter((t)=>t.startsWith("roundtable-web-")&&t!=="roundtable-web-d442d154a5a4").map((t)=>caches.delete(t)))).then(()=>o.clients.claim()))});o.addEventListener("fetch",(e)=>{let{request:n}=e;if(n.method!=="GET")return;let t=new URL(n.url);if(t.origin!==i.origin||!t.pathname.startsWith(i.pathname))return;if(m(t))return;if(n.mode==="navigate")e.respondWith(v(n));else if(h.has(t.origin+t.pathname)||w.test(t.pathname)||g.test(t.pathname))e.respondWith(W(n))});o.addEventListener("push",(e)=>{e.waitUntil(P(e))});o.addEventListener("notificationclick",(e)=>{e.waitUntil(b(e))});
+var o=self,i=new URL(o.registration.scope);var d=new URL("index.html",i).href,h=new Set(["index.html","account-zk4efb87.css","chunk-account-1ecx5kt7.js","chunk-action-menu-zh2n0ahf.js","chunk-agent-ynm2tcbx.js","chunk-arranged-rooms-qnz8vese.js","chunk-bulk-actions-pr0mw0kc.js","chunk-character-creator-caj4pmg4.js","chunk-confirm-g76v5d9r.js","chunk-connectors-j79ze3j1.js","chunk-conversations-2farn72g.js","chunk-council-sheet-s9sz1bzf.js","chunk-drag-45e8222r.js","chunk-entry-q11n47h9.js","chunk-folder-list-4gcj7g7h.js","chunk-folds-ten4ykfw.js","chunk-gate-kcv1a4t0.js","chunk-group-scene-12ghcvzd.js","chunk-group-table-t458kdgn.js","chunk-host-icons-h1k9k96a.js","chunk-host-picture-3p0wzn3v.js","chunk-host-state-7mdve7cb.js","chunk-host-ui-bdgwa6sf.js","chunk-index-02vfshtt.js","chunk-index-0a81da8z.js","chunk-index-0q15ysrb.js","chunk-index-0w4bfjb5.js","chunk-index-12zyshae.js","chunk-index-18pgxxw3.js","chunk-index-2e4am3hw.js","chunk-index-2fdns8tn.js","chunk-index-2t30xwed.js","chunk-index-31x6krbs.js","chunk-index-3d8s3565.js","chunk-index-5bfqek1d.js","chunk-index-64rsz6pf.js","chunk-index-6bkcq9ka.js","chunk-index-8d81qy69.js","chunk-index-92zgb7my.js","chunk-index-aamhjg5n.js","chunk-index-ac1ktr56.js","chunk-index-ak6ecqy3.js","chunk-index-b73y2gc0.js","chunk-index-b8cpvr7y.js","chunk-index-bhqczxr3.js","chunk-index-cdctnw71.js","chunk-index-dj0tbfyb.js","chunk-index-dnjftvtq.js","chunk-index-e2dqjde8.js","chunk-index-ebg48jgy.js","chunk-index-ek5mek4j.js","chunk-index-f6q0stqx.js","chunk-index-ffbrm6tr.js","chunk-index-g1awv7rk.js","chunk-index-g3wrs02w.js","chunk-index-j0m16cj1.js","chunk-index-j4kk1m59.js","chunk-index-j4x9dq30.css","chunk-index-jgzygbt8.js","chunk-index-kb3w11mn.js","chunk-index-kbrg32sx.js","chunk-index-msqhgvfx.js","chunk-index-pefwfm26.js","chunk-index-pyfx77cj.js","chunk-index-q7g62sgm.js","chunk-index-qfgkfq86.js","chunk-index-rh0x9rzf.js","chunk-index-sm7m4fej.js","chunk-index-sv9qpmhv.js","chunk-index-t998yg8y.js","chunk-index-tk4se135.js","chunk-index-v6smgw77.js","chunk-index-w42rcbx1.js","chunk-index-x4enmj72.js","chunk-index-xq84gg8w.js","chunk-index-xxeb2xp0.js","chunk-index-zyvwhxga.js","chunk-layout-actions-y73mpsh1.js","chunk-menu-items-bza16bw6.js","chunk-mode-toggle-nj9gnt3b.js","chunk-note-row-6fmhrdng.js","chunk-notes-wv0e6ssf.js","chunk-notice-bell-9z27epd2.js","chunk-notices-fte9f196.js","chunk-onboarding-c5twahc3.js","chunk-overview-k4ccprax.js","chunk-palette-9rbp2fab.js","chunk-placement-items-me598wsb.js","chunk-profile-s7r7fcvz.js","chunk-prompt-history-hf296e7v.js","chunk-prompts-c8s0nhkm.js","chunk-room-confirms-ga2sbvhc.js","chunk-room-menu-7h4jym2b.js","chunk-rooms-menu-button-pgtaanb6.js","chunk-schedules-mbnwcxpc.js","chunk-seat-menu-r0k0eawr.js","chunk-sheet-hosts-a5dfevy9.js","chunk-shortcut-help-a6pkjcq7.js","chunk-shortcuts-cgt87jkz.js","chunk-skill-editor-67yk4x7t.js","chunk-skills-rewemey4.js","chunk-switcher-list-t8rbay2y.js","chunk-tab-dot-vr11dfrw.js","chunk-table-52nh0azk.js","chunk-table2d-g57vr6h0.js","chunk-thread-actions-qcxt1y1g.js","chunk-thread-cards-c2mrp2gj.js","chunk-thread-list-0071q455.js","chunk-transcript-789yqysq.js","chunk-where-hmwmme9e.js","chunk-workspace-wr1qrtsh.js","chunk-zh-tw-z5p5mpph.js"].map((e)=>new URL(e,i).href)),w=/\/chunk-table3d-[a-z0-9]+\.js$/,g=/\/chunk-(?:codeeditor|lang-[a-z]+)-[a-z0-9]+\.js$/,k=["api/","auth/","login","files/","avatars/"],m=(e)=>{let n=e.pathname.slice(i.pathname.length);return k.some((t)=>n.startsWith(t))};async function v(e){let n=await caches.open("roundtable-web-7a28cdb79a14");try{let t=await fetch(e);if(t.ok&&new URL(e.url).href===i.href)await n.put(d,t.clone());return t}catch{let t=await n.match(d);if(t)return t;throw Error("offline and the shell is not cached")}}async function W(e){let n=await caches.open("roundtable-web-7a28cdb79a14"),t=await n.match(e);if(t)return t;let a=await fetch(e);if(a.ok)await n.put(e,a.clone());return a}var r=(e,n)=>typeof e==="string"&&e?e.slice(0,n):void 0;function l(e){if(typeof e!=="string")return i.href;let n=URL.parse(e,i);return n&&n.origin===i.origin&&n.pathname.startsWith(i.pathname)?n.href:i.href}var E=new Set(["notice","test"]);async function u(e,n){if(!e?.tag||!e.kind||!E.has(e.kind))return;try{await fetch(new URL("api/push/receipts",i),{method:"POST",credentials:"include",headers:{"content-type":"application/json"},body:JSON.stringify({tag:e.tag,event:n})})}catch{}}async function y(e){if(typeof e!=="number"||!Number.isSafeInteger(e)||e<0)return;try{if(e>0)await o.navigator.setAppBadge?.(e);else await o.navigator.clearAppBadge?.()}catch{}}async function P(e){let n={};try{let s=e.data?.json();if(typeof s==="object"&&s!==null)n=s}catch{}let t=r(n.tag,200),a=r(n.kind,16);if(await y(n.badge),a==="clear"){if(t)for(let s of await o.registration.getNotifications({tag:t}))s.close();return}await o.registration.showNotification(r(n.title,120)??"Roundtable",{body:r(n.body,240),icon:new URL("icons/192.png",i).href,badge:new URL("icons/badge-96.png",i).href,...t?{tag:t,renotify:!0}:{},...n.urgency==="high"?{requireInteraction:!0}:{},data:{url:l(n.url),...t?{tag:t}:{},...a?{kind:a}:{}}}),await u({...t?{tag:t}:{},...a?{kind:a}:{}},"received")}async function b(e){e.notification.close();let n=e.notification.data,t=l(n?.url),a=r(n?.tag,200),s=r(n?.kind,16),f=u({...a?{tag:a}:{},...s?{kind:s}:{}},"opened"),c=(await o.clients.matchAll({type:"window",includeUncontrolled:!0})).find((p)=>p.url.startsWith(i.href));if(c)await c.focus(),c.postMessage({type:"roundtable:open",url:t});else await o.clients.openWindow(t);await f}o.addEventListener("install",(e)=>{e.waitUntil(caches.open("roundtable-web-7a28cdb79a14").then((n)=>n.addAll([...h])).then(()=>o.skipWaiting()))});o.addEventListener("activate",(e)=>{e.waitUntil(caches.keys().then((n)=>Promise.all(n.filter((t)=>t.startsWith("roundtable-web-")&&t!=="roundtable-web-7a28cdb79a14").map((t)=>caches.delete(t)))).then(()=>o.clients.claim()))});o.addEventListener("fetch",(e)=>{let{request:n}=e;if(n.method!=="GET")return;let t=new URL(n.url);if(t.origin!==i.origin||!t.pathname.startsWith(i.pathname))return;if(m(t))return;if(n.mode==="navigate")e.respondWith(v(n));else if(h.has(t.origin+t.pathname)||w.test(t.pathname)||g.test(t.pathname))e.respondWith(W(n))});o.addEventListener("push",(e)=>{e.waitUntil(P(e))});o.addEventListener("notificationclick",(e)=>{e.waitUntil(b(e))});

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-roundtable-web",
-	"version": "0.26.2",
+	"version": "0.27.0",
 	"description": "A web console for the owners of a pi-roundtable host: conversations, transcripts, and memory notes, with live updates",
 	"type": "module",
 	"license": "MIT",
@@ -43,7 +43,7 @@
 		"jose": "6.2.12"
 	},
 	"peerDependencies": {
-		"pi-roundtable": ">=0.26.0 <0.27.0"
+		"pi-roundtable": ">=0.27.0 <0.28.0"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "2.5.15",
@@ -70,7 +70,7 @@
 		"@types/react": "19.3.0",
 		"@types/react-dom": "19.3.0",
 		"@types/three": "0.186.0",
-		"pi-roundtable": "0.26.2",
+		"pi-roundtable": "0.27.0",
 		"react": "19.3.0",
 		"react-dom": "19.3.0",
 		"react-markdown": "10.1.0",

package/src/api-types.ts

@@ -507,6 +507,11 @@ export interface RoomView {
 	members?: string[];
 	/** A thread's parent room. */
 	parent?: string;
+	/**
+	 * A temp knight's room: `parent` is the room of the knight that made it, and `finished` is set
+	 * when it has nothing running, queued or waiting. Absent on every permanent knight.
+	 */
+	helper?: { parent: string; parentName: string; finished?: true };
 	/** A thread's room takes no messages from the page. */
 	readOnly: boolean;
 	/**
@@ -528,6 +533,8 @@ export interface RoomView {
 	agent?: string;
 	/** A turn runs that Stop would end. */
 	stoppable: boolean;
+	/** A group room: the round running now, who has spoken and who is next; absent when none runs. */
+	round?: RoundView;
 	/** The newest stored message, if any. */
 	last?: RoomMessage;
 	/** Messages past this person's read cursor; absent when none. */
@@ -573,6 +580,44 @@ export interface ThreadsDismissed {
 	dismissed: number;
 }
 
+/** What one clear-all across rooms dismissed: the finished threads' room keys, by the room they hang under. */
+export interface ThreadsDismissedAll extends ThreadsDismissed {
+	threads: Record<string, string[]>;
+}
+
+/**
+ * What a system line of a room starts with when its knight cleared its temp knights: the rest is a
+ * JSON list of `{ name, displayName }`, which the page words and offers the undo of.
+ */
+export const HELPERS_ENDED = "Temp knights archived: ";
+
+/** `POST api/rooms/archive-finished-helpers`: the temp knights archived, by the room of the knight that made them. */
+export interface HelpersArchived {
+	archived: { room: string; names: string[] }[];
+}
+
+/** `POST api/rooms/restore-helpers`: the temp knights that came back; a name no longer archived is passed over. */
+export interface HelpersRestored {
+	restored: string[];
+}
+
+/** A cursor that marking rooms read moved: where it was (0 for a room never read) and where it is. */
+export interface ReadMove {
+	room: string;
+	from: number;
+	to: number;
+}
+
+/** What marking rooms read moved; the page keeps it to undo the marking. */
+export interface ReadAllView {
+	moved: ReadMove[];
+}
+
+/** What undoing a marking put back: the rooms whose cursor went back. */
+export interface ReadAllUndone {
+	restored: string[];
+}
+
 /** What taking dismissed threads back onto the room list restored. */
 export interface ThreadsRestored {
 	restored: number;
@@ -761,6 +806,8 @@ export interface AgentProfileView {
 	avatar: string;
 	character: CharacterSpec;
 	room: string;
+	/** A temp knight's profile: the room of the knight that made it, and its name. */
+	helper?: { parent: string; parentName: string };
 }
 
 export interface ModelsView {
@@ -955,6 +1002,8 @@ export interface ArchivedEntry {
 	character?: CharacterSpec;
 	/** A group's members that are still on the team. */
 	members?: string[];
+	/** A temp knight's parent, by name; the archive page groups it under that knight. */
+	parent?: string;
 }
 
 /** `GET api/archive`. */
@@ -1159,6 +1208,28 @@ export type ClientFrame =
 	| { type: "cancel"; prompt: string };
 
 /** What the server sends: one JSON object per WebSocket text message. */
+/**
+ * Where a group's round stands: the members' answers to one owner message, one after another.
+ * `id` is the group message that opened the round, so a new round is told from the last one.
+ */
+export interface RoundView {
+	id: number;
+	state: "running" | "ended";
+	/** The member speaking now, by name. */
+	current?: string;
+	/** The members still to speak, in order, a handoff appended. */
+	next: string[];
+	/** The members who have replied so far, in order. */
+	spoken: string[];
+	/** The replies made so far, and the most a round holds. */
+	replies: number;
+	limit: number;
+	/** Why the round ended: every member spoke, it reached its limit, or the owner stopped it. */
+	ended?: "done" | "limit" | "stopped";
+	/** The owner's messages waiting in the room for the next round. */
+	queued?: number;
+}
+
 export type ServerFrame =
 	/** The socket is authenticated; sent first, and followed by every open card. */
 	| {
@@ -1193,6 +1264,8 @@ export type ServerFrame =
 			/** Only on the frame where `typing` turns false. */
 			outcome?: "done" | "failed";
 	  }
+	/** Where a group room's round stands; sent at each step and when it ends. */
+	| { type: "round"; room: string; round: RoundView }
 	/** Which agents work now, anywhere (Discord included); sent after `ready` and when it changes. */
 	| { type: "presence"; agents: Record<string, { busy: boolean }> }
 	| { type: "prompt"; room: string; prompt: PromptFrame }

package/src/app/app.ts

@@ -13,8 +13,8 @@ import type {
 	ScheduleStore,
 	WebSocketRoute,
 } from "pi-roundtable";
-import { channelKey } from "pi-roundtable";
-import { APP_CLOSE_EXPIRED } from "../api-types.ts";
+import { agentRoomKey, channelKey, isHelper, roomOf } from "pi-roundtable";
+import { APP_CLOSE_EXPIRED, HELPERS_ENDED } from "../api-types.ts";
 import type { Authenticated, Authenticator } from "../auth/authenticator.ts";
 import type { ConsolePresentation } from "../features.ts";
 import type { Gate } from "../gate.ts";
@@ -209,6 +209,11 @@ export class OwnerApp {
 		const quiet = quietClock
 			? (at: number) => quietClock.quietAt(at)
 			: undefined;
+		const held = roomMuted(
+			mutes,
+			threads,
+			channelKey(options.surface, "thread."),
+		);
 		const mounted = mountNotices({
 			database: options.database,
 			logger,
@@ -246,7 +251,16 @@ export class OwnerApp {
 			visible: (principalId) => sockets.anyVisible(principalId),
 			preview: options.push.preview,
 			...(quiet ? { quiet } : {}),
-			muted: roomMuted(mutes, threads, channelKey(options.surface, "thread.")),
+			muted: async (room) => {
+				const named = roomOf(room as ChannelKey, [options.surface]);
+				// A temp knight's answers reach its knight's room, which pushes; its own room stays quiet.
+				if (
+					named?.kind === "agent" &&
+					isHelper(agents.directory.agent(named.name))
+				)
+					return true;
+				return held(room);
+			},
 			urlOf: options.push.urlOf,
 			logger,
 		});
@@ -334,7 +348,10 @@ export class OwnerApp {
 			log,
 			modes,
 			mutes,
-			activity: (room) => surface.activityOf(room),
+			activity: (room) => {
+				const round = surface.roundOf(room);
+				return { ...surface.activityOf(room), ...(round ? { round } : {}) };
+			},
 			// The agent rooms are the owners'; where there are several, they can leave each other notes.
 			readers: async () => (await identity.owners()).length > 1,
 		});
@@ -398,6 +415,23 @@ export class OwnerApp {
 			},
 			push,
 		});
+		// A knight clearing its own temp knights leaves a line in its room, with the undo.
+		agents.team.onHelpersEnded((event) => {
+			const named = event.names.map((name) => ({
+				name,
+				displayName: agents.directory.agent(name)?.displayName ?? name,
+			}));
+			void surface
+				.publish({
+					room: agentRoomKey(options.surface, event.parent),
+					kind: "system",
+					author: "Notice",
+					text: `${HELPERS_ENDED}${JSON.stringify(named)}`,
+				})
+				.catch((error) =>
+					logger.warn({ err: error }, "the temp knights' line was not posted"),
+				);
+		});
 		this.#api = new AppApi({
 			...(options.presentation ? { presentation: options.presentation } : {}),
 			surface,

package/src/app/helper-routes.ts

@@ -0,0 +1,106 @@
+import type {
+	AgentDirectory,
+	AgentTeam,
+	ChannelKey,
+	Speaker,
+} from "pi-roundtable";
+import { agentRoomKey, isHelper, roomOf } from "pi-roundtable";
+import type { HelpersArchived, HelpersRestored } from "../api-types.ts";
+import { json } from "../http.ts";
+import { bad, bodyOf } from "./api-http.ts";
+
+/** The most rooms or names one request of these routes names. */
+const MAX_NAMED = 500;
+
+export interface HelperRoutesOptions {
+	surface: string;
+	directory: Pick<AgentDirectory, "agent" | "agents">;
+	team: Pick<
+		AgentTeam,
+		"finishedHelpers" | "archiveHelpers" | "restoreHelpers"
+	>;
+	changed(): void;
+}
+
+/** A list of at most 500 strings, or undefined when the body leaves it out. */
+function listOf(value: unknown, field: string): string[] | undefined {
+	if (value === undefined) return undefined;
+	if (
+		!Array.isArray(value) ||
+		value.length > MAX_NAMED ||
+		!value.every((one) => typeof one === "string" && one.length <= 300)
+	)
+		throw bad(`${field} must be a list of at most ${MAX_NAMED} strings.`);
+	return value;
+}
+
+/**
+ * The two bulk calls on temp knights, for owners: archiving the finished ones of some knights (or
+ * of every knight) and putting back the ones an archive took. They reach the same team operations
+ * as the knight's own `helper_end`.
+ */
+export class HelperRoutes {
+	readonly #options: HelperRoutesOptions;
+
+	constructor(options: HelperRoutesOptions) {
+		this.#options = options;
+	}
+
+	/**
+	 * `POST api/rooms/archive-finished-helpers`: archives the finished temp knights of the named
+	 * knights' rooms, or of every knight when none is named. Answers what it archived by room.
+	 */
+	async archiveFinished(request: Request, owner: Speaker): Promise<Response> {
+		const { surface, directory, team } = this.#options;
+		const keys = listOf((await bodyOf(request)).rooms, "rooms");
+		let parents: string[] | undefined;
+		if (keys) {
+			parents = [];
+			for (const key of new Set(keys)) {
+				const named = roomOf(key as ChannelKey, [surface]);
+				const agent =
+					named?.kind === "agent" ? directory.agent(named.name) : undefined;
+				if (!agent || isHelper(agent))
+					throw bad(`"${key}" is not the room of a knight.`);
+				parents.push(agent.name);
+			}
+		}
+		const finished = team.finishedHelpers(parents);
+		const byParent = new Map<string, string[]>();
+		for (const helper of finished)
+			byParent.set(helper.parent as string, [
+				...(byParent.get(helper.parent as string) ?? []),
+				helper.name,
+			]);
+		const done = new Set(
+			await team.archiveHelpers(
+				finished.map((helper) => helper.name),
+				owner.principalId ?? owner.name,
+			),
+		);
+		const archived = [...byParent]
+			.map(([parent, names]) => ({
+				room: agentRoomKey(surface, parent),
+				names: names.filter((name) => done.has(name)),
+			}))
+			.filter((entry) => entry.names.length > 0);
+		if (archived.length > 0) this.#options.changed();
+		return json({ archived } satisfies HelpersArchived);
+	}
+
+	/**
+	 * `POST api/rooms/restore-helpers`: puts back archived temp knights, the undo of an archive. A
+	 * name that is not a temp knight is refused by name; one no longer archived is passed over.
+	 */
+	async restore(request: Request): Promise<Response> {
+		const { directory, team } = this.#options;
+		const names = listOf((await bodyOf(request)).names, "names");
+		if (!names) throw bad("Give names, the temp knights to restore.");
+		for (const name of names)
+			if (!isHelper(directory.agent(name)))
+				throw bad(`"${name}" is not a temp knight.`);
+		const restored = await team.restoreHelpers([...new Set(names)]);
+		if (restored.length > 0) this.#options.changed();
+		return json({ restored } satisfies HelpersRestored);
+	}
+}

package/src/app/rooms.ts

@@ -12,6 +12,7 @@ import {
 	channelKey,
 	characterOf,
 	groupRoomKey,
+	isHelper,
 	roomOf,
 } from "pi-roundtable";
 import type { RoomKind, RoomView } from "../api-types.ts";
@@ -44,7 +45,7 @@ export interface RoomsOptions {
 	mutes: Pick<PushMutes, "all">;
 	activity(
 		room: ChannelKey,
-	): Pick<RoomView, "typing" | "stoppable" | "phase" | "agent">;
+	): Pick<RoomView, "typing" | "stoppable" | "phase" | "agent" | "round">;
 	/**
 	 * Whether more than one person reads the agent and group rooms, so a message may be an
 	 * internal note. Absent: one person does, and a room takes only turns.
@@ -127,7 +128,9 @@ export class Rooms {
 		const coordinator = team.coordinator();
 		const home =
 			(coordinator ? directory.agent(coordinator) : undefined) ??
-			directory.agents().find((agent) => agent.status === "active");
+			directory
+				.agents()
+				.find((agent) => agent.status === "active" && !isHelper(agent));
 		return home?.status === "active"
 			? agentRoomKey(surface, home.name)
 			: undefined;
@@ -144,7 +147,7 @@ export class Rooms {
 			[
 				...directory
 					.agents()
-					.filter((agent) => agent.status === "active")
+					.filter((agent) => agent.status === "active" && !isHelper(agent))
 					.map((agent) => agentRoomKey(surface, agent.name)),
 				...directory
 					.groups()
@@ -225,6 +228,18 @@ export class Rooms {
 					avatar: this.avatarOf(agent),
 					character: characterOf(agent),
 					...(agent.name === coordinator ? { coordinator: true as const } : {}),
+					...(agent.parent
+						? {
+								helper: {
+									parent: agentRoomKey(surface, agent.parent),
+									parentName:
+										directory.agent(agent.parent)?.displayName ?? agent.parent,
+									...(agent.finishedAt ? { finished: true as const } : {}),
+								},
+								// A temp knight's answers reach its knight's room, which pushes; its cards still do.
+								muted: true as const,
+							}
+						: {}),
 				}),
 			),
 			...groups.map((group: AgentGroup) =>

package/src/app/routes.ts

@@ -11,7 +11,7 @@ import type {
 	SkillRegistry,
 	Speaker,
 } from "pi-roundtable";
-import { PluginError } from "pi-roundtable";
+import { channelKey, PluginError } from "pi-roundtable";
 import { CharacterError } from "pi-roundtable/characters";
 import { AgentError } from "pi-roundtable/kit";
 import type {
@@ -19,6 +19,8 @@ import type {
 	CharacterRefusal,
 	MessagesView,
 	ModelsView,
+	ReadAllUndone,
+	ReadAllView,
 	RoomOneView,
 	RoomsView,
 	SchedulesView,
@@ -26,6 +28,7 @@ import type {
 	SessionView,
 	SkillView,
 	ThreadsDismissed,
+	ThreadsDismissedAll,
 	ThreadsRestored,
 	WorkspaceConflict,
 	WorkspaceNew,
@@ -38,6 +41,7 @@ import type { Authenticated } from "../auth/authenticator.ts";
 import { type ConsolePresentation, message } from "../features.ts";
 import type { Gate } from "../gate.ts";
 import type { HostApp } from "../host/host-app.ts";
+import { MAX_READ_ALL } from "../host/read-all.ts";
 import type { RoomReads } from "../host/reads.ts";
 import { readsOf, withExpiredFiles } from "../host/room-views.ts";
 import { json } from "../http.ts";
@@ -47,6 +51,7 @@ import { viewerOf, type WebAppRegistry } from "../web-app.ts";
 import { bad, bodyOf, HttpError, notFound } from "./api-http.ts";
 import type { CardLog } from "./card-log.ts";
 import { type FileDir, fileResponse, isFileId } from "./files.ts";
+import { HelperRoutes } from "./helper-routes.ts";
 import type { LayoutStore } from "./layout.ts";
 import { LayoutRoutes } from "./layout-routes.ts";
 import { PromptApi, type PromptApiOptions } from "./prompt-routes.ts";
@@ -66,6 +71,8 @@ import {
 
 /** The most threads one request puts back on the room list: more than the list ever shows. */
 const MAX_RESTORED = 100;
+/** The most rooms one bulk request names. */
+const MAX_BULK_ROOMS = MAX_READ_ALL;
 
 export interface AppApiOptions {
 	/** The host's wording: a refusal reaches a client of the API in this locale when the catalog has it. */
@@ -87,6 +94,7 @@ export interface AppApiOptions {
 		| "removeUnder"
 		| "dismiss"
 		| "dismissFinished"
+		| "dismissFinishedUnder"
 		| "restore"
 		| "restoreFinished"
 	>;
@@ -111,6 +119,9 @@ export interface AppApiOptions {
 		| "remove"
 		| "createGroup"
 		| "updateGroup"
+		| "finishedHelpers"
+		| "archiveHelpers"
+		| "restoreHelpers"
 	>;
 	/** Present when the host has the skills addon: the catalog an agent's skills are chosen from, and the change of what it carries. */
 	skills?: {
@@ -132,7 +143,7 @@ export interface AppApiOptions {
 	/** The read cursors, for each room's unread count and who has read what. */
 	reads?: Pick<RoomReads, "unread" | "cursorOf" | "marks">;
 	/** Who may be served a file bound to a host room or a page. */
-	host?: Pick<HostApp, "mayRead">;
+	host?: Pick<HostApp, "mayRead" | "readAll" | "unreadAll">;
 	/** The name the app shows for a person. */
 	nameOf?(principalId: string): Promise<string>;
 	/** Present when the workspace pane is served. */
@@ -158,6 +169,22 @@ export interface AppApiOptions {
 	logger: Logger;
 }
 
+/** A cursor move as the page sends it back to undo a marking. */
+const isReadMove = (
+	value: unknown,
+): value is { room: string; from: number; to: number } => {
+	if (typeof value !== "object" || value === null) return false;
+	const { room, from, to } = value as Record<string, unknown>;
+	return (
+		typeof room === "string" &&
+		room.length <= 300 &&
+		Number.isSafeInteger(from) &&
+		(from as number) >= 0 &&
+		Number.isSafeInteger(to) &&
+		(to as number) >= 0
+	);
+};
+
 /** A refusal of the workspace pane as the HTTP error the owner reads. */
 function refusalOf(refusal: WorkspaceRefusal): HttpError {
 	const { status } = refusal;
@@ -249,6 +276,7 @@ export class AppApi {
 	readonly #options: AppApiOptions;
 	readonly #team: TeamApi;
 	readonly #layout: LayoutRoutes;
+	readonly #helpers: HelperRoutes;
 	readonly #prompts: PromptApi | undefined;
 	readonly #skillDocs: SkillDocApi | undefined;
 
@@ -262,6 +290,12 @@ export class AppApi {
 			owner: (admission) => this.#owner(admission),
 			changed: () => options.changed(),
 		});
+		this.#helpers = new HelperRoutes({
+			surface: options.surface.surface,
+			directory: options.directory,
+			team: options.team,
+			changed: () => options.changed(),
+		});
 		this.#prompts = options.prompts
 			? new PromptApi({ prompts: options.prompts })
 			: undefined;
@@ -508,6 +542,20 @@ export class AppApi {
 				...(await this.#layout.view()),
 			} satisfies RoomsView);
 		}
+		// No room key is a bare word: the bulk calls take that place.
+		if (key === "read-all" && !action && method === "POST")
+			return this.#readAll(request, admission);
+		if (key === "dismiss-finished-threads" && !action && method === "POST")
+			return this.#dismissAllFinished(request, admission);
+		if (key === "archive-finished-helpers" && !action && method === "POST")
+			return this.#helpers.archiveFinished(
+				request,
+				await this.#owner(admission),
+			);
+		if (key === "restore-helpers" && !action && method === "POST") {
+			await this.#owner(admission);
+			return this.#helpers.restore(request);
+		}
 		const room = await rooms.resolve(key);
 		if (!room) throw notFound();
 		if (!action && method === "GET") {
@@ -605,6 +653,81 @@ export class AppApi {
 		throw new HttpError(404, "There is no such API.");
 	}
 
+	/**
+	 * Reads the person's rooms up to their newest message in one call: the named ones, or every room
+	 * the list shows. A room they may not read is passed over as if it were not named. With `restore`
+	 * instead, the cursors a call moved go back, where the person has not read on since.
+	 */
+	async #readAll(
+		request: Request,
+		admission: Authenticated,
+	): Promise<Response> {
+		const { host } = this.#options;
+		if (!host) throw new HttpError(404, "There is no such API.");
+		const viewer = viewerOf(admission.visitor);
+		const body = await bodyOf(request);
+		if (body.restore !== undefined) {
+			const { restore } = body;
+			if (
+				!Array.isArray(restore) ||
+				restore.length > MAX_BULK_ROOMS ||
+				!restore.every(isReadMove)
+			)
+				throw bad("restore must be a list of at most 500 moves.");
+			const restored = await host.unreadAll(viewer, restore);
+			if (restored.length) this.#options.changed();
+			return json({ restored } satisfies ReadAllUndone);
+		}
+		const named = await this.#named(body.rooms);
+		const keys =
+			named ?? (await this.#options.rooms.list()).map((one) => one.key);
+		const moved = await host.readAll(viewer, keys);
+		if (moved.length) this.#options.changed();
+		return json({
+			moved: moved.map(({ room, from, to }) => ({ room, from, to })),
+		} satisfies ReadAllView);
+	}
+
+	/** Takes every finished thread under the named rooms, or under every room the list shows, off the list. */
+	async #dismissAllFinished(
+		request: Request,
+		admission: Authenticated,
+	): Promise<Response> {
+		await this.#owner(admission);
+		const { rooms, threads, surface } = this.#options;
+		const named = await this.#named((await bodyOf(request)).rooms);
+		const listed = named ?? (await rooms.list()).map((one) => one.key);
+		const parents: string[] = [];
+		for (const key of new Set(listed)) {
+			const one = await rooms.resolve(key);
+			if (one && one.kind !== "thread") parents.push(one.key);
+		}
+		const dismissed = await threads.dismissFinishedUnder(parents);
+		const byParent: Record<string, string[]> = {};
+		for (const { id, parent } of dismissed)
+			byParent[parent] = [
+				...(byParent[parent] ?? []),
+				channelKey(surface.surface, id),
+			];
+		if (dismissed.length) this.#options.changed();
+		return json({
+			dismissed: dismissed.length,
+			threads: byParent,
+		} satisfies ThreadsDismissedAll);
+	}
+
+	/** The room keys a bulk body names; undefined when it names none, meaning every room. */
+	async #named(value: unknown): Promise<string[] | undefined> {
+		if (value === undefined) return undefined;
+		if (
+			!Array.isArray(value) ||
+			value.length > MAX_BULK_ROOMS ||
+			!value.every((one) => typeof one === "string" && one.length <= 300)
+		)
+			throw bad("rooms must be a list of at most 500 keys.");
+		return value;
+	}
+
 	/** Takes one finished thread off the room list for every owner; an open one is refused. */
 	async #dismiss(
 		room: ResolvedRoom,