pi-roundtable-web 0.24.2 → 0.26.0

package/src/i18n/zh-tw.ts

@@ -266,6 +266,9 @@ export const ZH_TW: Readonly<Record<string, string>> = {
 	// 進度
 	"{name} is working…": "{name}正在處理…",
 	"Show the whole stream": "顯示完整串流",
+	"{count} earlier tool": "前面還有 {count} 個工具",
+	"{count} earlier tools": "前面還有 {count} 個工具",
+	"Show fewer tools": "收合工具",
 
 	// 聊天室選單
 	"A thread has no settings.": "討論串沒有設定。",
@@ -280,6 +283,15 @@ export const ZH_TW: Readonly<Record<string, string>> = {
 	"Reply to the agent that started this thread.": "回覆開啟這個討論串的夥伴。",
 	"Yolo mode": "Yolo 模式",
 	"No agents are seated yet.": "圓桌上還沒有夥伴入座。",
+	"Who's at the table": "誰上桌",
+	"Off the table": "離席中",
+	"Leave the table": "離席",
+	"{name} left the table": "{name}已離席",
+	"The table is empty": "圓桌空了",
+	"Every agent has left the table. Choose who sits down.":
+		"所有夥伴都離席了。選擇誰要上桌。",
+	"An agent who leaves the table is muted: its room stops pushing to you. A card that waits for you is always pushed.":
+		"離席的夥伴會被靜音：它的聊天室不再推播給你。等你回應的卡片仍會推播。",
 
 	// 通知
 	"A file is no longer available. Attach it again.":
@@ -318,8 +330,8 @@ export const ZH_TW: Readonly<Record<string, string>> = {
 	// 夥伴
 	"Class, colors and parts. The picture here, in the rooms and in Discord all follow it.":
 		"職業、配色與部件。這裡、聊天室與 Discord 的圖像都會跟著改變。",
-	"Follow the assistant (automatic)": "跟隨助理（自動）",
-	"Follow the assistant": "跟隨助理",
+	"Follow the assistant (automatic)": "跟隨夥伴（自動）",
+	"Follow the assistant": "跟隨夥伴",
 	Look: "造型",
 	Name: "名稱",
 	Prompt: "提示詞",
@@ -338,7 +350,7 @@ export const ZH_TW: Readonly<Record<string, string>> = {
 	Unreachable: "無法連線",
 	"Upstream gateways": "上游閘道",
 	"Upstream MCP gateways and virtual servers used by the assistant.":
-		"助理使用的上游 MCP 閘道與虛擬伺服器。",
+		"夥伴使用的上游 MCP 閘道與虛擬伺服器。",
 	"Used by": "使用者",
 	"Virtual servers": "虛擬伺服器",
 
@@ -349,7 +361,7 @@ export const ZH_TW: Readonly<Record<string, string>> = {
 	running: "進行中",
 	"Owner channels": "擁有者頻道",
 	"Direct messages and channels where the owner talks to the assistant.":
-		"擁有者與助理交談的私訊與頻道。",
+		"擁有者與夥伴交談的私訊與頻道。",
 	"Agent channels": "夥伴頻道",
 	"The agent server's one-to-one channels.": "夥伴伺服器的一對一頻道。",
 	"Group channels": "群組頻道",
@@ -386,12 +398,12 @@ export const ZH_TW: Readonly<Record<string, string>> = {
 	"Search notes": "搜尋記憶",
 	Text: "內容",
 	"What the assistant remembers. A change applies from the next turn.":
-		"助理記得的內容。變更會從下一個回合起生效。",
+		"夥伴記得的內容。變更會從下一個回合起生效。",
 	"Whose notes": "誰的記憶",
 	Core: "核心",
 	"Carried into every turn.": "每個回合都會帶入。",
 	Note: "備忘",
-	"Searched when the assistant needs them.": "助理需要時才會搜尋。",
+	"Searched when the assistant needs them.": "夥伴需要時才會搜尋。",
 	Events: "事件",
 	"Carried into every turn until their date.": "到期日之前每個回合都會帶入。",
 
@@ -406,7 +418,7 @@ export const ZH_TW: Readonly<Record<string, string>> = {
 	"Conversations opened through remote MCP; after deletion the session ID cannot be resumed.":
 		"透過遠端 MCP 開啟的對話；刪除後無法再用該工作階段 ID 接續。",
 	"Direct messages and channels where you mention the assistant. Start over archives; delete removes every archive permanently.":
-		"你在私訊與頻道中提及助理的對話。重新開始會封存；刪除會永久移除所有封存。",
+		"你在私訊與頻道中提及夥伴的對話。重新開始會封存；刪除會永久移除所有封存。",
 	"Enabled by {name} at {time}": "由{name}於 {time} 啟用",
 	idle: "閒置",
 	"Just compacted (limit {limit})": "剛完成壓縮（上限 {limit}）",
@@ -496,6 +508,61 @@ export const ZH_TW: Readonly<Record<string, string>> = {
 	"Could not copy.": "無法複製。",
 	"Could not share.": "無法分享。",
 
+	// 新增、封存與群組
+	"New agent": "新增夥伴",
+	"New group": "新增群組",
+	Archived: "已封存",
+	Archive: "封存",
+	"Archive {name}": "封存{name}",
+	"Archive {name}?": "要封存{name}嗎？",
+	"Archive agent": "封存夥伴",
+	"Archive group": "封存群組",
+	"Archived {name}.": "已封存{name}。",
+	"Restored {name}.": "已還原{name}。",
+	"Deleted {name}.": "已刪除{name}。",
+	"Delete {name}?": "要刪除{name}嗎？",
+	"Made {name}.": "已建立{name}。",
+	"Make agent": "建立夥伴",
+	"Make group": "建立群組",
+	"Making…": "建立中…",
+	"Permanent name": "固定名稱",
+	"Lowercase letters, digits and dashes, up to 32. It names the room and cannot be changed.":
+		"小寫英文字母、數字與連字號，最多 32 個字元。它是聊天室的名稱，建立後無法更改。",
+	"Its job, its sources, its limits and how it reports.":
+		"它的工作、資料來源、限制，以及怎麼回報。",
+	"Opening task": "開場任務",
+	"Optional. The agent starts on it as soon as it is made.":
+		"可不填。夥伴建立後會立刻開始做。",
+	"Your look": "你選的外觀",
+	"Suggested from its role": "依角色建議的外觀",
+	"Choose a look": "選擇外觀",
+	"Use this look": "使用這個外觀",
+	"Edit group": "編輯群組",
+	"Name, members and host": "名稱、成員與主持人",
+	Members: "成員",
+	"Pick 2 to 6 agents. They take turns in the order picked.":
+		"選 2 到 6 位夥伴。他們依選取的順序輪流發言。",
+	Host: "主持人",
+	"It stops answering. The history is kept and it can be restored.":
+		"它會停止回應。歷史會保留，之後可以還原。",
+	"An archived agent stops answering and its schedules are cancelled. Its history is kept, and you can restore it from Archived.":
+		"封存後的夥伴不再回應，排程也會取消。歷史會保留，之後可以從「已封存」還原。",
+	"{name} stops answering and its schedules are cancelled. A group loses it as a member. The history is kept, and Archived in the room list restores it.":
+		"{name}會停止回應，排程也會取消；群組會少掉這位成員。歷史會保留，可以從聊天室列表的「已封存」還原。",
+	"Archived agents and groups no longer answer. Their history is kept until you delete them.":
+		"已封存的夥伴與群組不再回應。歷史會保留，直到你刪除它們。",
+	"Nothing is archived.": "沒有已封存的項目。",
+	"{name} and its messages in this app are deleted for good, and the name can be used again. This cannot be undone.":
+		"{name}和它在這個應用程式裡的訊息會永久刪除，名稱可以再使用。此動作無法復原。",
+	"What the agent can load when a task calls for it. It applies from its next turn.":
+		"夥伴在任務需要時可以載入的技能。下一輪對話起生效。",
+	"Its file cannot be read.": "讀不到它的檔案。",
+	"Built in: every agent carries it.": "內建：每位夥伴都有。",
+	"This host has no skills.": "這個主機沒有技能。",
+	"Give add or remove.": "請給 add 或 remove。",
+	"members must be a list of text.": "members 必須是文字清單。",
+	"Give displayName, members or host.": "請給 displayName、members 或 host。",
+
 	// 聊天室列表
 	Agents: "夥伴",
 	"Dispatch threads": "派工討論串",
@@ -578,7 +645,7 @@ export const ZH_TW: Readonly<Record<string, string>> = {
 
 	// 技能
 	"All agents": "所有夥伴",
-	"Assistant-written": "助理撰寫",
+	"Assistant-written": "夥伴撰寫",
 	"Built-in": "內建",
 	Carriers: "搭載對象",
 	"File missing": "檔案遺失",
@@ -608,7 +675,7 @@ export const ZH_TW: Readonly<Record<string, string>> = {
 	"Tool failed": "工具執行失敗",
 	"Tool result": "工具結果",
 	User: "使用者",
-	Assistant: "助理",
+	Assistant: "夥伴",
 	"Summary of earlier conversation": "先前對話的摘要",
 
 	// 伺服器回應
@@ -654,6 +721,46 @@ export const ZH_TW: Readonly<Record<string, string>> = {
 	"before and limit must be whole numbers.": "before 與 limit 必須是整數。",
 	"Give yolo or longRunning.": "請提供 yolo 或 longRunning。",
 	"muted must be true or false.": "muted 必須是 true 或 false。",
+	// 分組與置頂
+	"Give the folder a name of 1 to 40 characters.": "分組名稱要 1 到 40 個字。",
+	"There is no such folder.": "找不到這個分組。",
+	"A folder of that name exists.": "已經有同名的分組。",
+	"There are 50 folders already.": "分組已達 50 個上限。",
+	"before must be a key or null.": "before 必須是聊天室代號或 null。",
+	"name must be text.": "name 必須是文字。",
+	"Give a name or a place.": "請提供名稱或位置。",
+	"A thread stays under its room.": "派工串跟著原本的聊天室。",
+	"Home stays at the top.": "首頁固定在最上面。",
+	"pinned must be true or false.": "pinned 必須是 true 或 false。",
+	"folder must be a folder id or null.": "folder 必須是分組 ID 或 null。",
+	"Add a folder": "新增分組",
+	"New folder…": "新增分組…",
+	"Folder name": "分組名稱",
+	"Rename folder": "重新命名分組",
+	"Delete folder": "刪除分組",
+	"Delete the folder {name}? Its rooms move to Ungrouped; no room is deleted.":
+		"刪除分組「{name}」？裡面的聊天室會移到未分組，聊天室本身不會刪除。",
+	"Folder menu": "分組選單",
+	"Folders and order": "分組與排序",
+	"Move to folder…": "移到分組…",
+	"No rooms in this folder yet.": "這個分組還沒有聊天室。",
+	"Collapse {name}": "收合「{name}」",
+	"Expand {name}": "展開「{name}」",
+	"{count} room": "{count} 個聊天室",
+	"{count} rooms": "{count} 個聊天室",
+	Ungrouped: "未分組",
+	Pinned: "置頂",
+	Pin: "置頂",
+	Unpin: "取消置頂",
+	Arrange: "整理",
+	"Keep this room at the top of the list.": "把這個聊天室固定在清單最上面。",
+	"Put this room in a folder, or take it out.":
+		"把這個聊天室放進分組，或移出分組。",
+	"Move up": "上移",
+	"Move down": "下移",
+	"Mute the whole folder": "靜音整個分組",
+	"Unmute the whole folder": "取消靜音整個分組",
+	"Some notifications are off": "部分通知已關閉",
 	"This pane is not served.": "沒有提供這個頁面。",
 	"The schedule id is a number.": "排程 ID 必須是數字。",
 	"There is no such schedule.": "找不到這個排程。",
@@ -736,7 +843,7 @@ export const ZH_TW: Readonly<Record<string, string>> = {
 	"character.class.paladin": "聖騎士",
 	"character.class.archivist": "檔案管理員",
 	// 職業適合的工作
-	"character.jobs.wizard": "協調者、規劃者、主要助理",
+	"character.jobs.wizard": "協調者、規劃者、主要夥伴",
 	"character.jobs.knight": "審查者、品質把關、守護者",
 	"character.jobs.scholar": "研究員、文獻回顧",
 	"character.jobs.smith": "程式開發、建置、重構",
@@ -854,4 +961,196 @@ export const ZH_TW: Readonly<Record<string, string>> = {
 	"character.accessory.glasses": "眼鏡",
 	"character.accessory.freckles": "雀斑",
 	"character.accessory.scar": "疤痕",
+
+	// 主要提示詞與技能內容的編輯
+	"Main prompts": "主要提示詞",
+	"Edit the main prompts": "編輯主要提示詞",
+	"The texts the assistant and the agents start from, with a diff to read before you save and a way back to the file's text.":
+		"夥伴們開始工作時所依據的文字；儲存前可檢視差異，也能回到檔案裡的版本。",
+	"The texts the assistant and the agents start from. A text you save here replaces the one from the file from the next turn on, until you go back to the file's.":
+		"夥伴們開始工作時所依據的文字。你在這裡儲存的文字，從下一回合起取代檔案裡的版本，直到你回到檔案版本為止。",
+	"Shared prompt": "共用提示詞",
+	"Guest prompt": "訪客提示詞",
+	"The base every agent's prompt starts with, the main assistant's included.":
+		"每位夥伴的提示詞都以它開頭，主要夥伴也不例外。",
+	"Used instead of the shared prompt when the person speaking is not the owner.":
+		"說話的人不是擁有者時，改用它取代共用提示詞。",
+	"No prompts to edit.": "沒有可編輯的提示詞。",
+	"Differs from the file version": "與檔案版本不同",
+	"File version cannot be read": "讀不到檔案版本",
+	"The file version of this prompt cannot be read, so it cannot be changed here until it can: {reason}":
+		"這份提示詞的檔案版本讀不到，在讀得到之前無法在這裡修改：{reason}",
+	"Set by {name}, {time}": "由{name}設定，{time}",
+	"Revert to the file version": "還原為檔案版本",
+	"Revert {name} to the file version?": "要把{name}還原為檔案版本嗎？",
+	"Back to the file version.": "已還原為檔案版本。",
+	"The text you saved is dropped and the text from the file applies from the next turn. It stays in the history, so you can bring it back.":
+		"你儲存的文字會被移除，從下一回合起改用檔案裡的文字。它仍留在歷史中，之後可以再取回。",
+	History: "歷史",
+	"History of the prompt": "提示詞的歷史",
+	"History of {name}": "{name}的歷史",
+	"No changes have been kept yet.": "還沒有留下任何更動紀錄。",
+	"Back to the file version": "已回到檔案版本",
+	"This change": "這次更動",
+	"It goes into the editor, where you read it over and save it to put it in force.":
+		"它會放進編輯器；檢視差異並儲存後才會生效。",
+	"Use this text": "使用這段文字",
+	"New skill": "新增技能",
+	"Create skill": "建立技能",
+	"Skill created.": "已建立技能。",
+	"This skill cannot be edited here.": "這個技能無法在這裡編輯。",
+	"This skill changed while you were editing it. The changes below are against the version there now; save again to replace it, or go back to edit.":
+		"這個技能在你編輯時被更動了。下方的差異是對照目前的版本；再儲存一次會取代它，或回去繼續編輯。",
+	"Frontmatter holds the name, which cannot change, and a description that starts with “Use when”. The rest is the skill.":
+		"Frontmatter 含有名稱（不能更改）與以「Use when」開頭的描述，其餘就是技能內容。",
+	"Registered skills and their carriers. A skill an agent wrote can be edited here; the others are read-only.":
+		"已登錄的技能與攜帶者。夥伴撰寫的技能可以在這裡編輯，其他的唯讀。",
+	"Built in with the release; it changes with the release.":
+		"隨版本內建；要隨版本更新才會改變。",
+	"From the package {package}; it changes when the package is upgraded.":
+		"來自套件 {package}；套件升級時才會改變。",
+	"Linked from {repo}; change it in its repository.":
+		"連結自 {repo}；請到它的儲存庫修改。",
+	// 主要提示詞與技能內容的編輯：伺服器的拒絕訊息
+	"This host has no prompts to edit.": "這個主機沒有可編輯的提示詞。",
+	"There is no such prompt.": "沒有這份提示詞。",
+	"base must be the text the prompt was edited from.":
+		"base 必須是編輯所依據的提示詞文字。",
+	"base must be the text the prompt was reverted from.":
+		"base 必須是還原所依據的提示詞文字。",
+	"This prompt changed while you were editing it.":
+		"這份提示詞在你編輯時被更動了。",
+	"baseHash must be the hash the skill was read with.":
+		"baseHash 必須是讀取技能時的雜湊值。",
+	"This skill changed while you were editing it.":
+		"這個技能在你編輯時被更動了。",
+	// 成員、登入與設定關卡
+	Profile: "個人資料",
+	Owner: "擁有者",
+	Admin: "管理員",
+	Member: "成員",
+	"Finish setting up": "完成設定",
+	"Finish setting up first.": "請先完成設定。",
+	"These steps come first. The rest of the app opens when they are done.":
+		"請先完成這些步驟，完成後才能使用其餘功能。",
+	"Push is not available to you.": "你不能使用推播通知。",
+	"You are signed out.": "你已登出。",
+	"This account is not allowed to use this app.":
+		"這個帳號不能使用此應用程式。",
+	"Sign-in did not complete.": "登入沒有完成。",
+	// 主機的聊天室、頁面、卡片與已讀
+	"Host room": "主機聊天室",
+	"No rooms yet.": "還沒有聊天室。",
+	"No messages yet.": "還沒有訊息。",
+	"Nothing here.": "這裡沒有內容。",
+	"Show more": "顯示更多",
+	"Search {name}": "搜尋{name}",
+	"Search…": "搜尋…",
+	"Needs attention": "需要處理",
+	"This page is not available.": "這個頁面無法使用。",
+	"You can read this room but not write in it.":
+		"你可以閱讀這個聊天室，但不能在其中發言。",
+	"Send as": "傳送方式",
+	"Ask the agent": "請夥伴處理",
+	"Earlier cards ({count})": "先前的卡片（{count}）",
+	Replaced: "已被取代",
+	Image: "圖片",
+	edited: "已編輯",
+	"{count} file was removed": "已移除 {count} 個檔案",
+	"{count} files were removed": "已移除 {count} 個檔案",
+	"{count} unread message": "{count} 則未讀訊息",
+	"{count} unread messages": "{count} 則未讀訊息",
+	"New messages": "新訊息",
+	"Seen by {count}": "已讀 {count}",
+	"More settings": "更多設定",
+	// 主機聊天室與頁面：伺服器的拒絕訊息
+	"There is no such room.": "沒有這個聊天室。",
+	"There is no such page.": "沒有這個頁面。",
+	"input must be an object.": "input 必須是物件。",
+	"input holds text or lists of text.": "input 只能放文字或文字清單。",
+	"action must be text.": "action 必須是文字。",
+	"card must be text.": "card 必須是文字。",
+	"This is not yours to do.": "這個操作不是你可以做的。",
+	"The page's query is too long.": "頁面的查詢參數太長。",
+	"This action takes no form.": "這個操作沒有表單。",
+	"The form has no such field.": "表單沒有這個欄位。",
+	"This field is required.": "這個欄位必填。",
+	"Choose from the list.": "請從清單中選擇。",
+	"This field takes one value.": "這個欄位只能填一個值。",
+	"This field is too long.": "這個欄位的內容太長。",
+	"Give a web address.": "請填入網址。",
+	"The action could not be done.": "無法執行這個操作。",
+	// 通知、設定步驟與帳號連結
+	Notices: "通知",
+	"Notices, {count} waiting": "通知，{count} 則待處理",
+	"Turn on notifications": "開啟通知",
+	"Link your {name} account": "連結你的 {name} 帳號",
+	"Prove which account is yours, so the app knows who you are there.":
+		"證明哪個帳號是你的，讓應用程式知道你在那裡是誰。",
+	"So that you hear when something needs you, even when the app is closed.":
+		"這樣即使應用程式關著，有事找你時你也聽得到。",
+	Urgent: "緊急",
+	Handled: "已處理",
+	"Nothing needs you.": "目前沒有需要你處理的事。",
+	Linked: "已連結",
+	Required: "必填",
+	Recommended: "建議",
+	"The server's configuration links this account.":
+		"這個帳號由伺服器設定連結，無法在這裡移除。",
+	Unlink: "解除連結",
+	"Unlink {name}?": "要解除連結 {name} 嗎？",
+	"The app will no longer know this account is yours. You can link it again later.":
+		"應用程式將不再知道這個帳號是你的。之後可以再連結。",
+	"Your code": "你的驗證碼",
+	"The code works until {time}.": "驗證碼的有效時間到 {time}。",
+	"A code is waiting to be used.": "有一組驗證碼等著被使用。",
+	"{name} used the code. Confirm that this is you.":
+		"{name} 使用了驗證碼。請確認那是你。",
+	"I did it": "我完成了",
+	"Link {name} first.": "請先連結 {name}。",
+	Link: "連結",
+	"In your quiet hours a normal notice waits in the bell instead of ringing your phone. An urgent one still rings.":
+		"勿擾時段內，一般通知只會留在通知鈴裡，不會響手機；緊急通知照常響。",
+	From: "從",
+	To: "到",
+	"Turn off quiet hours": "關閉勿擾時段",
+	"A test notification is on its way.": "測試通知已送出。",
+	"Send a test notification": "傳送測試通知",
+	"Shown as": "顯示為",
+	"The name and picture of this account are what others see in the app.":
+		"別人在應用程式裡看到的，是這個帳號的名稱與頭像。",
+	Automatic: "自動",
+	"Your accounts": "你的帳號",
+	"Put the app on your phone": "把應用程式放到手機上",
+	"On iPhone and iPad, open this page in Safari, tap Share, then Add to Home Screen, and open the app from there.":
+		"在 iPhone 與 iPad 上，用 Safari 開啟此頁，點「分享」，再點「加入主畫面」，之後從主畫面開啟。",
+	"On a phone, add it to the home screen from the browser's menu so notifications reach you when it is closed.":
+		"在手機上，請從瀏覽器選單加入主畫面，這樣應用程式關著時也收得到通知。",
+	"Allow notifications": "允許通知",
+	"This browser cannot get push notifications.": "這個瀏覽器無法接收推播通知。",
+	"Allowed on this device.": "這台裝置已允許。",
+	"Send a test": "傳送測試",
+	"It arrived. Notifications work on this device.":
+		"收到了。這台裝置的通知可以正常運作。",
+	"Waiting for it…": "等待通知中…",
+	"It has not arrived. Check that notifications are allowed for this app, then send another.":
+		"還沒收到。請確認這個應用程式已允許通知，再傳送一次。",
+	Skip: "略過",
+	"{count} device(s) will get notifications.": "{count} 台裝置會收到通知。",
+	Skipped: "已略過",
+	"There is nothing left to set up.": "沒有需要再設定的項目。",
+	"There is no such notice to handle.": "沒有這則可處理的通知。",
+	"This account has no device that gets push yet. Turn it on first.":
+		"這個帳號還沒有接收推播的裝置，請先開啟推播。",
+	"A receipt needs a tag and received or opened.":
+		"回報需要標籤，以及「已收到」或「已開啟」。",
+	"There is no such notification.": "沒有這則通知。",
+	"Send quiet: {start, end, timeZone} or null.":
+		"請傳入 quiet：{start, end, timeZone}，或 null。",
+	"Send provider: the account's provider, or null for the default.":
+		"請傳入 provider（帳號的提供者），或 null 使用預設。",
+	"There is no picture.": "沒有頭像。",
+	"Send request: the id the code came with.":
+		"請傳入 request：驗證碼附帶的代號。",
+	"That step cannot be waived.": "這個步驟不能略過。",
 };

package/src/layout-order.ts

@@ -0,0 +1,210 @@
+// The arrangement of the room list as plain functions over `LayoutView`. The server applies them to
+// the stored layout under a lock and the page applies the same ones at once (optimistic), so a move
+// means the same on both sides. Nothing here touches a database or the DOM.
+
+import type { FolderView, LayoutView } from "./api-types.ts";
+
+/** The most folders there can be. */
+export const MAX_FOLDERS = 50;
+/** The most code points of a folder's name. */
+export const FOLDER_NAME_MAX = 40;
+
+export const EMPTY_LAYOUT: LayoutView = { pins: [], folders: [] };
+
+/** Why an edit of the layout was refused. */
+export type LayoutProblem = "bad-name" | "no-folder" | "duplicate" | "full";
+
+export class LayoutError extends Error {
+	constructor(readonly code: LayoutProblem) {
+		super(code);
+		this.name = "LayoutError";
+	}
+}
+
+/**
+ * `list` with `item` standing before `before`, or last when `before` is none or not in the list (a
+ * neighbour that was deleted meanwhile). `item` is taken out of its old place first; before itself
+ * it stays where it is.
+ */
+export function moveBefore<T>(
+	list: readonly T[],
+	item: T,
+	before: T | null | undefined,
+): T[] {
+	if (before === item && list.includes(item)) return [...list];
+	const rest = list.filter((one) => one !== item);
+	const at =
+		before === null || before === undefined ? -1 : rest.indexOf(before);
+	if (at < 0) return [...rest, item];
+	return [...rest.slice(0, at), item, ...rest.slice(at)];
+}
+
+/**
+ * Where moving `item` one step goes in the list as it is shown: the neighbour it then stands
+ * before (`null` = last). Undefined when it is not in the list or already at that end. Reading the
+ * neighbour from what is shown keeps a step right when the stored list holds rooms that are hidden.
+ */
+export function nudgeBefore(
+	shownList: readonly string[],
+	item: string,
+	direction: "up" | "down",
+): { before: string | null } | undefined {
+	const at = shownList.indexOf(item);
+	if (at < 0) return undefined;
+	if (direction === "up")
+		return at === 0 ? undefined : { before: shownList[at - 1] ?? null };
+	return at === shownList.length - 1
+		? undefined
+		: { before: shownList[at + 2] ?? null };
+}
+
+/** A folder's name as stored: trimmed, 1 to 40 code points, without control characters. */
+export function folderNameOf(raw: string): string {
+	const name = raw.trim();
+	const length = Array.from(name).length;
+	if (length < 1 || length > FOLDER_NAME_MAX || /\p{Cc}/u.test(name))
+		throw new LayoutError("bad-name");
+	return name;
+}
+
+const same = (a: string, b: string): boolean =>
+	a.toLocaleLowerCase() === b.toLocaleLowerCase();
+
+function folderIndex(layout: LayoutView, id: string): number {
+	const at = layout.folders.findIndex((folder) => folder.id === id);
+	if (at < 0) throw new LayoutError("no-folder");
+	return at;
+}
+
+const withFolders = (
+	layout: LayoutView,
+	folders: FolderView[],
+): LayoutView => ({ pins: layout.pins, folders });
+
+/** The layout with a new last folder. */
+export function createFolder(
+	layout: LayoutView,
+	id: string,
+	rawName: string,
+): LayoutView {
+	const name = folderNameOf(rawName);
+	if (layout.folders.some((folder) => same(folder.name, name)))
+		throw new LayoutError("duplicate");
+	if (layout.folders.length >= MAX_FOLDERS) throw new LayoutError("full");
+	return withFolders(layout, [...layout.folders, { id, name, rooms: [] }]);
+}
+
+export function renameFolder(
+	layout: LayoutView,
+	id: string,
+	rawName: string,
+): LayoutView {
+	const at = folderIndex(layout, id);
+	const name = folderNameOf(rawName);
+	if (layout.folders.some((f) => f.id !== id && same(f.name, name)))
+		throw new LayoutError("duplicate");
+	return withFolders(
+		layout,
+		layout.folders.map((folder, i) =>
+			i === at ? { ...folder, name } : folder,
+		),
+	);
+}
+
+/** The folder moved before another, or last. */
+export function placeFolder(
+	layout: LayoutView,
+	id: string,
+	before: string | null,
+): LayoutView {
+	const at = folderIndex(layout, id);
+	const moving = layout.folders[at] as FolderView;
+	const ids = moveBefore(
+		layout.folders.map((folder) => folder.id),
+		id,
+		before,
+	);
+	return withFolders(
+		layout,
+		ids.map((one) =>
+			one === id
+				? moving
+				: (layout.folders.find((folder) => folder.id === one) as FolderView),
+		),
+	);
+}
+
+/** The layout without the folder; its rooms are in no folder. */
+export function removeFolder(layout: LayoutView, id: string): LayoutView {
+	folderIndex(layout, id);
+	return withFolders(
+		layout,
+		layout.folders.filter((folder) => folder.id !== id),
+	);
+}
+
+/** The layout without a room: not pinned and in no folder. For a room that is gone for good. */
+export const forgetRoom = (layout: LayoutView, room: string): LayoutView => ({
+	pins: layout.pins.filter((one) => one !== room),
+	folders: layout.folders.map((folder) =>
+		folder.rooms.includes(room)
+			? { ...folder, rooms: folder.rooms.filter((one) => one !== room) }
+			: folder,
+	),
+});
+
+/**
+ * A room into a folder before another room of it (or last), or into none with `folder` null. A
+ * room is in one place, so it leaves its pin and its old folder.
+ */
+export function placeRoom(
+	layout: LayoutView,
+	room: string,
+	folder: string | null,
+	before: string | null,
+): LayoutView {
+	if (folder !== null) folderIndex(layout, folder);
+	const clear = forgetRoom(layout, room);
+	if (folder === null) return clear;
+	return withFolders(
+		clear,
+		clear.folders.map((one) =>
+			one.id === folder
+				? { ...one, rooms: moveBefore(one.rooms, room, before) }
+				: one,
+		),
+	);
+}
+
+/** A room pinned before another pinned room (or last), or unpinned. A pinned room leaves its folder. */
+export function setPinned(
+	layout: LayoutView,
+	room: string,
+	pinned: boolean,
+	before: string | null,
+): LayoutView {
+	const clear = forgetRoom(layout, room);
+	if (!pinned) return clear;
+	return {
+		pins: moveBefore(
+			layout.pins.filter((one) => one !== room),
+			room,
+			before,
+		),
+		folders: clear.folders,
+	};
+}
+
+/** The layout with only the rooms `known` accepts, for a reader who must not see a deleted agent's room. */
+export function shown(
+	layout: LayoutView,
+	known: (room: string) => boolean,
+): LayoutView {
+	return {
+		pins: layout.pins.filter(known),
+		folders: layout.folders.map((folder) => ({
+			...folder,
+			rooms: folder.rooms.filter(known),
+		})),
+	};
+}

package/src/notices/api.ts

@@ -0,0 +1,43 @@
+import { ConsoleHttpError as HttpError, json } from "../http.ts";
+import type { FrameHandler, PluggedFrames, RouteArea } from "../web-app.ts";
+import type { NoticeService } from "./service.ts";
+
+/**
+ * `GET api/notices` and `POST api/notices/<tag>/ack`. Both are the signed-in person's own: the
+ * principal is the session's, and a notice not addressed to them answers 404 as if there were none.
+ */
+export function noticesArea(notices: NoticeService): RouteArea {
+	return {
+		area: "notices",
+		async handle(request, parts, { visitor }) {
+			try {
+				const principalId = visitor.principal.id;
+				const [tag, action] = parts;
+				if (tag === undefined && request.method === "GET")
+					return json(await notices.listFor(principalId));
+				if (tag !== undefined && action === "ack" && parts.length === 2) {
+					if (request.method !== "POST")
+						throw new HttpError(405, "Method not allowed.");
+					if (!(await notices.ack(tag, principalId)))
+						throw new HttpError(404, "There is no such notice to handle.");
+					return json({ ok: true });
+				}
+				throw new HttpError(404, "There is no such API.");
+			} catch (error) {
+				if (error instanceof HttpError)
+					return json({ error: error.message }, error.status);
+				throw error;
+			}
+		},
+	};
+}
+
+/** The `ack` frame: the person handled a notice. A notice that is not theirs, or needs no answer, is refused. */
+export function ackFrame(
+	notices: NoticeService,
+): FrameHandler<PluggedFrames["ack"]> {
+	return async ({ frame, viewer, refuse }) => {
+		if (!(await notices.ack(frame.tag, viewer.principalId)))
+			refuse("not_accepted");
+	};
+}