pi-roundtable-web 0.26.3 → 0.27.0

package/dist/index.html

@@ -9,7 +9,7 @@
 		
 		
 		
-	<link rel="stylesheet" crossorigin href="./chunk-index-4jf4jvfd.css"><script type="module" crossorigin src="./chunk-index-kankja6p.js"></script></head>
+	<link rel="stylesheet" crossorigin href="./chunk-index-j4x9dq30.css"><script type="module" crossorigin src="./chunk-index-2e4am3hw.js"></script></head>
 	<body>
 		<div id="root"></div>
 		

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-hck7mhf8.js","chunk-action-menu-beqh40k6.js","chunk-agent-znnth24t.js","chunk-arranged-rooms-wfakrddk.js","chunk-bulk-actions-c4tkvk9g.js","chunk-character-creator-qwcsdytw.js","chunk-confirm-z95j9jt3.js","chunk-connectors-7xqsg5q5.js","chunk-conversations-zc4mv6vj.js","chunk-drag-0mefcvp3.js","chunk-entry-hrt97qed.js","chunk-folder-list-nemtqbnc.js","chunk-folds-xpg9qcwf.js","chunk-gate-86r8a2vf.js","chunk-group-scene-g24kxz6f.js","chunk-group-table-851jm8ef.js","chunk-host-icons-23zhqpmc.js","chunk-host-picture-8tnh2wam.js","chunk-host-state-j41sp065.js","chunk-host-ui-cje7a9t9.js","chunk-index-0q15ysrb.js","chunk-index-1fn8q4ps.js","chunk-index-30vw4nhh.js","chunk-index-3aa5czxj.js","chunk-index-3k7sdph2.js","chunk-index-3wbyq10m.js","chunk-index-47yspxa4.js","chunk-index-4jf4jvfd.css","chunk-index-4s1qj9we.js","chunk-index-5fz5e1ct.js","chunk-index-67p2sc14.js","chunk-index-84wbc80d.js","chunk-index-8eexybcx.js","chunk-index-agrvqf5b.js","chunk-index-azrnzgev.js","chunk-index-c2ag3qw2.js","chunk-index-e90kztkx.js","chunk-index-efgm0066.js","chunk-index-eh0wb6g0.js","chunk-index-eyc2rkq5.js","chunk-index-fe0m5mht.js","chunk-index-gt42wjby.js","chunk-index-hc0dgmrs.js","chunk-index-hczrjnky.js","chunk-index-hrtyanda.js","chunk-index-j479p62w.js","chunk-index-jq970hsd.js","chunk-index-kankja6p.js","chunk-index-kb44jp50.js","chunk-index-m65cv329.js","chunk-index-mnwdbb4n.js","chunk-index-n6zrc05a.js","chunk-index-n93wqszt.js","chunk-index-nrexxkar.js","chunk-index-pgxgq61x.js","chunk-index-q5vzjqr5.js","chunk-index-qqwk157d.js","chunk-index-r1v895tj.js","chunk-index-r3tqhew8.js","chunk-index-raf772z6.js","chunk-index-rcxz5w5d.js","chunk-index-rg9vh59e.js","chunk-index-sxq69p1f.js","chunk-index-taq2psr6.js","chunk-index-tsxsy4qs.js","chunk-index-wc83vb0a.js","chunk-index-xbs8q4kn.js","chunk-index-xxbveevc.js","chunk-index-zx6yka30.js","chunk-layout-actions-6assr93n.js","chunk-menu-items-9szcza00.js","chunk-mode-toggle-bzbq7ycq.js","chunk-note-row-g20h11pm.js","chunk-notes-gc8bssxn.js","chunk-notice-bell-jehad6sx.js","chunk-notices-prqkv7ge.js","chunk-onboarding-mdtc2mb7.js","chunk-overview-2j1s6kqg.js","chunk-palette-4qt6ewem.js","chunk-placement-items-2eect825.js","chunk-profile-pfzyc04p.js","chunk-prompt-history-2bcp2rky.js","chunk-prompts-052mb05y.js","chunk-room-confirms-asvmjh5s.js","chunk-room-menu-dm2r2hk6.js","chunk-rooms-menu-button-32hemzxc.js","chunk-schedules-64h9gfwn.js","chunk-seat-menu-vrpc40v9.js","chunk-sheet-hosts-jaqx490x.js","chunk-shortcut-help-bdbkdcs9.js","chunk-shortcuts-qft33r8t.js","chunk-skill-editor-z3dx2895.js","chunk-skills-4jfcv39n.js","chunk-switcher-list-xysjd4tw.js","chunk-tab-dot-1p68ybf8.js","chunk-table-0v4q4dx3.js","chunk-table-seats-f683hx8k.js","chunk-table2d-1a6atjhj.js","chunk-thread-actions-4rpfg4fq.js","chunk-thread-cards-t794fp4d.js","chunk-thread-list-1pcygpka.js","chunk-transcript-km4e3aey.js","chunk-where-phjwqggy.js","chunk-workspace-d064v56e.js","chunk-zh-tw-qf18hcxc.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-fc485222cec1");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-fc485222cec1"),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-fc485222cec1").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-fc485222cec1").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.3",
+	"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.3",
+		"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. */
@@ -578,6 +585,22 @@ 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;
@@ -783,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 {
@@ -977,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`. */
@@ -1181,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. */
 	| {
@@ -1215,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

@@ -51,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";
@@ -118,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?: {
@@ -272,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;
 
@@ -285,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;
@@ -536,6 +547,15 @@ export class AppApi {
 			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") {

package/src/app/surface.ts

@@ -14,7 +14,7 @@ import {
 	roomOf,
 	type TurnProgress,
 } from "pi-roundtable";
-import type { RoomFile, RoomMessage } from "../api-types.ts";
+import type { RoomFile, RoomMessage, RoundView } from "../api-types.ts";
 import type { OwnerDesk } from "./desk.ts";
 import { type FileBinding, type FileDir, typeByName } from "./files.ts";
 import type { NewRoomMessage, RoomLog } from "./room-log.ts";
@@ -115,6 +115,8 @@ export class AppSurface implements ChatSurface {
 	readonly threads: AppSurfaceThreads;
 	readonly #options: AppSurfaceOptions;
 	readonly #activity = new Map<ChannelKey, Activity>();
+	/** The round each group room runs now; an ended round is dropped, since the page keeps what it was told. */
+	readonly #rounds = new Map<ChannelKey, RoundView>();
 	/** When a page last sent a message to each room. */
 	readonly #askedAt = new Map<ChannelKey, number>();
 	/** The turns running in each room that a page's message started. */
@@ -196,6 +198,21 @@ export class AppSurface implements ChatSurface {
 		};
 	}
 
+	/** Where the group room's running round stands, for a page that opens mid-round. */
+	roundOf(room: ChannelKey): RoundView | undefined {
+		return this.#rounds.get(room);
+	}
+
+	/** Shows a group round's step to the sockets that may have the room. */
+	groupRound(channel: ChannelKey, round: RoundView): void {
+		if (round.state === "ended") this.#rounds.delete(channel);
+		else this.#rounds.set(channel, round);
+		this.#options.sockets.deliver(
+			{ type: "round", room: channel, round },
+			this.#options.audienceOf(channel),
+		);
+	}
+
 	/** The agents with a turn working in an app room now: a room's own agent, or a group's speaker. */
 	workingAgents(): Set<string> {
 		const names = new Set<string>();

package/src/app/team-routes.ts

@@ -133,7 +133,17 @@ export class TeamApi {
 			// The app's part runs inside the delete, after its checks and before the row goes: a
 			// cleanup that fails leaves the agent there to delete again.
 			const room = agentRoomKey(this.#options.surface, name);
-			await this.#options.team.remove(name, () => this.#forget(room, by));
+			await this.#options.team.remove(name, async () => {
+				// Its archived temp knights go with it, and so does what the app kept of their rooms.
+				for (const helper of this.#options.directory
+					.agents()
+					.filter((one) => one.parent === name))
+					await this.#forget(
+						agentRoomKey(this.#options.surface, helper.name),
+						by,
+					);
+				await this.#forget(room, by);
+			});
 			this.#options.changed();
 			return json({ ok: true });
 		}
@@ -311,6 +321,15 @@ export class TeamApi {
 			avatar: rooms.avatarOf(agent),
 			character: characterOf(agent),
 			room: agentRoomKey(surface, agent.name),
+			...(agent.parent
+				? {
+						helper: {
+							parent: agentRoomKey(surface, agent.parent),
+							parentName:
+								directory.agent(agent.parent)?.displayName ?? agent.parent,
+						},
+					}
+				: {}),
 		};
 	}
 
@@ -412,6 +431,7 @@ export class TeamApi {
 						displayName: agent.displayName,
 						avatar: rooms.avatarOf(agent),
 						character: characterOf(agent),
+						...(agent.parent ? { parent: agent.parent } : {}),
 					}),
 				),
 			...directory

package/src/i18n/zh-tw.ts

@@ -282,16 +282,38 @@ export const ZH_TW: Readonly<Record<string, string>> = {
 	"Reply to the knight that started this thread.": "回覆開啟這個討論串的騎士。",
 	"Yolo mode": "Yolo 模式",
 	"No knights are seated yet.": "圓桌上還沒有騎士入座。",
-	"Who's at the table": "誰上桌",
-	"Off the table": "離席中",
-	"Leave the table": "離席",
-	"{name} left the table": "{name}已離席",
 	"The table is empty": "圓桌空了",
 	"There are no rooms to seat yet.": "還沒有可以入座的聊天室。",
-	"Every knight has left the table. Choose who sits down.":
-		"所有騎士都離席了。選擇誰要上桌。",
-	"A knight who leaves the table is muted: its room stops pushing to you. A card that waits for you is always pushed.":
-		"離席的騎士會被靜音：它的聊天室不再推播給你。等你回應的卡片仍會推播。",
+	"All rooms": "所有聊天室",
+	"Council: {name} ▾": "評議會：{name} ▾",
+	Council: "評議會",
+	Councils: "評議會",
+	"{count} knights": "{count} 位騎士",
+	"Pick who sits": "選誰上桌",
+	"No council yet": "還沒有評議會",
+	"The council is empty": "評議會沒有人了",
+	"Every member of this council is gone. Edit who sits.":
+		"這個評議會的成員都不在了。請重新選誰上桌。",
+	"A council is a group of up to {max} knights who answer in turn. Pick who sits.":
+		"評議會是最多 {max} 位騎士組成的群組，他們輪流發言。請選誰上桌。",
+	"Edit this council": "編輯這個評議會",
+	"{count} of {max} picked": "已選 {count}/{max}",
+	"At most {max} knights": "最多 {max} 位",
+	"A council needs at least {min} knights.": "評議會至少要有 {min} 位騎士。",
+	"Council name": "評議會名稱",
+	"Save as a new council": "另存為新評議會",
+	"Make council": "建立評議會",
+	"Private chat": "私下對話",
+	"Remove from the council": "移出評議會",
+	"{name} left the council": "{name}已移出評議會",
+	"Speaking order": "發言順序",
+	"has spoken": "已發言",
+	"Reply {n} of {limit}": "第 {n}／{limit} 則",
+	"{count} of {limit} replies": "{count}／{limit} 則回覆",
+	"Limit reached": "已達上限",
+	"Round stopped": "本輪已停止",
+	"Stop the round": "停止本輪",
+	"Your message waits for the next round": "你的訊息排在下一輪",
 
 	// 通知
 	"A file is no longer available. Attach it again.":
@@ -542,7 +564,7 @@ export const ZH_TW: Readonly<Record<string, string>> = {
 	"Edit group": "編輯群組",
 	"Name, members and host": "名稱、成員與主持人",
 	Members: "成員",
-	"Pick 2 to 6 knights. They take turns in the order picked.":
+	"Pick 2 to 8 knights. They take turns in the order picked.":
 		"選 2 到 6 位騎士。他們依選取的順序輪流發言。",
 	Host: "主持人",
 	"It stops answering. The history is kept and it can be restored.":
@@ -598,6 +620,20 @@ export const ZH_TW: Readonly<Record<string, string>> = {
 	"Clear finished": "清除已完成",
 	Finished: "已完成",
 	"In progress": "進行中",
+	Ended: "已結束",
+	"Temp knight": "臨時騎士",
+	"{count} temp knight": "{count} 位臨時騎士",
+	"{count} temp knights": "{count} 位臨時騎士",
+	"Made by {name}": "隸屬 {name}",
+	"Temp knight of {name}": "{name} 的臨時騎士",
+	"Clear finished temp knights": "清除已結束的臨時騎士",
+	"Archived {count} temp knight": "已封存 {count} 位臨時騎士",
+	"Archived {count} temp knights": "已封存 {count} 位臨時騎士",
+	"Archive this temp knight": "封存這位臨時騎士",
+	"{name} archived {count} temp knight: {names}":
+		"{name}封存了 {count} 位臨時騎士：{names}",
+	"{name} archived {count} temp knights: {names}":
+		"{name}封存了 {count} 位臨時騎士：{names}",
 	"More actions for {name}": "{name} 的更多動作",
 	"Cleared “{name}”": "已清除「{name}」",
 	"Cleared {count} finished thread": "已清除 {count} 個已完成的討論串",
@@ -605,6 +641,7 @@ export const ZH_TW: Readonly<Record<string, string>> = {
 	"The thread is still open.": "這個討論串還在進行中。",
 	"threads must be a list of at most 100 keys.":
 		"threads 必須是最多 100 個鍵的清單。",
+	"Give names, the temp knights to restore.": "請提供要復原的臨時騎士名稱。",
 	"rooms must be a list of at most 500 keys.":
 		"rooms 必須是最多 500 個鍵的清單。",
 	"restore must be a list of at most 500 moves.":

package/dist/chunk-account-hck7mhf8.js

@@ -1 +0,0 @@
-import{h,Q,S,e,w}from"./chunk-index-kankja6p.js";var a={profile:S(()=>(h("pfzyc04p"),import("./chunk-profile-pfzyc04p.js")).then((o)=>({default:o.ProfilePage}))),notices:S(()=>(h("prqkv7ge"),import("./chunk-notices-prqkv7ge.js")).then((o)=>({default:o.NoticesPage}))),onboarding:S(()=>(h("mdtc2mb7"),import("./chunk-onboarding-mdtc2mb7.js")).then((o)=>({default:o.OnboardingPage})))};function n({pane:o}){let t=a[o];return t?e(Q,{fallback:e(w,{}),children:e(t,{})}):null}export{n as default};

package/dist/chunk-action-menu-beqh40k6.js

@@ -1 +0,0 @@
-import{s,Fe,a,r,g,e,n,o,kt,zo}from"./chunk-index-kankja6p.js";import{L}from"./chunk-index-47yspxa4.js";var k=()=>typeof matchMedia==="function"&&matchMedia("(max-width: 719px)").matches,x={rtMenu:!0},H=()=>Boolean(window.history.state?.rtMenu),w=8,M=(t)=>t?.isConnected?t:null;function y(t){return t.items.map((u)=>n("button",{type:"button",role:u.checked===void 0?"menuitem":"menuitemcheckbox",...u.checked===void 0?{}:{"aria-checked":u.checked},className:"menu-item menu-link","data-tone":u.tone,onClick:()=>t.onChoose(u),children:[u.icon?e("span",{className:"menu-icon","data-tone":u.tone,children:e(o,{name:u.icon,size:18})}):null,e("span",{className:"menu-text",children:e("strong",{children:u.label})}),u.checked?e(o,{name:"check",size:18,className:"menu-check"}):null]},u.id))}function T({menu:t}){let u=a(void 0);if(t)u.current=t;let c=u.current,m=a(!1),p=a(void 0),h=t?.serial;return s(()=>{if(h===void 0)return;return window.history.pushState(x,"",window.location.href),m.current=!0,()=>{if(m.current)m.current=!1,window.history.back()}},[h]),s(()=>{let f=()=>{if(!m.current||H())return;m.current=!1,kt();let E=p.current;p.current=void 0,E?.()};return window.addEventListener("popstate",f),()=>window.removeEventListener("popstate",f)},[]),e(L,{open:t!==void 0,title:c?.title??"",onClose:kt,restoreFocus:()=>M(c?.source??null),children:c?e("div",{className:"menu action-items",role:"menu","aria-label":c.title,children:e(y,{items:c.items,onChoose:(f)=>{if(!m.current){kt(),f.run();return}p.current=f.run,window.history.back()}})}):null})}function C({menu:t}){let u=a(null),[c,m]=r(t.at),{source:p}=t,h=(i)=>{M(p)?.focus(),kt(),i?.()},f=a(h);f.current=h,Fe(()=>{let i=u.current;if(!i)return;let d=i.getBoundingClientRect();m({x:Math.max(w,Math.min(t.at.x,window.innerWidth-d.width-w)),y:Math.max(w,Math.min(t.at.y,window.innerHeight-d.height-w))}),i.querySelector('[role^="menuitem"]')?.focus()},[t.serial]),s(()=>{let i=(l)=>{if(l.target instanceof Node&&u.current?.contains(l.target))return;kt()},d=()=>kt();return document.addEventListener("pointerdown",i,!0),document.addEventListener("wheel",i,{capture:!0,passive:!0}),document.addEventListener("touchmove",i,{capture:!0,passive:!0}),window.addEventListener("resize",d),()=>{document.removeEventListener("pointerdown",i,!0),document.removeEventListener("wheel",i,!0),document.removeEventListener("touchmove",i,!0),window.removeEventListener("resize",d)}},[]);let E=(i)=>{let d=[...u.current?.querySelectorAll('[role^="menuitem"]')??[]],l=d.indexOf(document.activeElement),v=(b)=>{i.preventDefault(),d[(b+d.length)%d.length]?.focus()};switch(i.key){case"Escape":i.preventDefault(),i.stopPropagation(),f.current();return;case"ArrowDown":return v(l+1);case"ArrowUp":return v(l<0?-1:l-1);case"Tab":return v(i.shiftKey?l<0?-1:l-1:l+1);case"Home":return v(0);case"End":return v(-1)}};return e("div",{ref:u,className:"action-popover",role:"menu","aria-label":t.title,tabIndex:-1,style:{left:`${c.x}px`,top:`${c.y}px`},onKeyDown:E,children:e(y,{items:t.items,onChoose:(i)=>h(i.run)})})}function O(){let t=zo(),u=a(void 0);if(t&&u.current?.serial!==t.serial)u.current={serial:t.serial,sheet:k()};let c=Boolean(t&&u.current?.sheet);return n(g,{children:[e(T,{menu:c?t:void 0}),t&&!c?e(C,{menu:t},t.serial):null]})}export{O as ActionMenuHost};

package/dist/chunk-agent-znnth24t.js

@@ -1 +0,0 @@
-import{s,e,F,d,w,tt}from"./chunk-index-kankja6p.js";function g({name:o}){let i=d((t)=>t.listed),r=d((t)=>Object.values(t.rooms).find((m)=>m.view?.kind==="agent"&&m.view.name===o)?.view?.key,o);return s(()=>{if(r)F("room",r,{replace:!0}),tt(o);else if(i)F("rooms",void 0,{replace:!0})},[r,i,o]),e("div",{className:"page",children:e(w,{})})}export{g as AgentPage};