@a-t-h-i/bot-lobby 0.6.44 → 0.6.45

package/webui/dist/build.json

@@ -1,14 +1,14 @@
 {
-  "hash": "94101de16d74326899a0ac448c5e04a721f32608442e634da80afe4b872d85c9",
-  "builtAt": "2026-10-13T19:10:46.500Z",
+  "hash": "0df0d32db3ef3e2e8ea322e11ee37a28e36a5d6bafcb8879f15511b3e650f751",
+  "builtAt": "2026-10-13T20:25:30.590Z",
   "files": [
     {
       "path": "src/lobby/prompts.ts",
-      "sha256": "696581fe10e8c9aae02a9e057657e9f2ffb38063ddbe19be3e33c73ee92ad0f1"
+      "sha256": "3a8cce283a49b576e134d03bbc706f17daf00e5398869b402b590b44706e3fa0"
     },
     {
       "path": "src/webui/protocol.ts",
-      "sha256": "1205af99f6f5f1698d3f586538f9a3507d3c9220649fe51e52aff65957e960f1"
+      "sha256": "9268a55d2be4bce71d06d11ac5ed51f023d2202cf2c52f122498c6d9e573f62c"
     },
     {
       "path": "webui/components.json",
@@ -24,7 +24,7 @@
     },
     {
       "path": "webui/src/app/AltH.tsx",
-      "sha256": "5930789f87f38469306c454abefac485ce1a3175a5ee5c36975db4d2a2fb87a3"
+      "sha256": "8da7cb184294a27afe68834da391882feb55f1248ffc228c91debd44e24920b4"
     },
     {
       "path": "webui/src/app/AppTools.tsx",
@@ -32,7 +32,7 @@
     },
     {
       "path": "webui/src/app/Composer.tsx",
-      "sha256": "4425cfd73cbb2b83c4590ba60b74c386e3bd28ab6f8bb9a4b1a0c98bcb3a51ad"
+      "sha256": "5e268afa7d5cfdf650d55dbb9a9a477bbc0bdca53ad3cf18adb36b4e71b4c79c"
     },
     {
       "path": "webui/src/app/Header.tsx",
@@ -60,7 +60,7 @@
     },
     {
       "path": "webui/src/app/Shell.tsx",
-      "sha256": "286f0b8a4c20840c3c6365b27c85574f435d50f162cea6d4c1181a21ece1a377"
+      "sha256": "4dd0dd60639f56850a17ccbfdc5e5051ae938d706999afe341d1c93c7057b3b5"
     },
     {
       "path": "webui/src/app/Sidebar.tsx",
@@ -76,7 +76,7 @@
     },
     {
       "path": "webui/src/app/TabIcons.tsx",
-      "sha256": "ec2d994087fa509034ada64dbb5f5fe747245c9a37d02c4a75bf0c112f90b5eb"
+      "sha256": "37cafc982a38b556749b28a72414b70ed56f3341d5f63a1d66ca697cd97d3d35"
     },
     {
       "path": "webui/src/app/TabStrip.tsx",
@@ -120,7 +120,7 @@
     },
     {
       "path": "webui/src/app/phoneCarousel.ts",
-      "sha256": "a66551a911bdcbf092b1c9cc590167c3a34b2bca12740123d22546f0d885d8de"
+      "sha256": "690e01f70f04cfdb1432d561b75e9b8a16fc8ad0558ed54bb5296dce0a1deaf5"
     },
     {
       "path": "webui/src/app/readTopic.ts",
@@ -132,7 +132,7 @@
     },
     {
       "path": "webui/src/app/router.ts",
-      "sha256": "a2dc69d7074f3ad6d8820b2c9ebdc8939dac382edf24bf5826d934d7f68505f0"
+      "sha256": "c800b5a5ecd3e03d5d9b278a085b15e2f6acf6c4b5d6d8f89dbf77e2d7fcdbcb"
     },
     {
       "path": "webui/src/app/sound.ts",
@@ -260,7 +260,7 @@
     },
     {
       "path": "webui/src/index.css",
-      "sha256": "83fd0f5beda78f2a06fea060fc2665a08413748e58829278a45ee3ad93011a06"
+      "sha256": "560ccd154241f7ede5806fbf7c17b7919a044542cc4c965d35fc7f2ea636d185"
     },
     {
       "path": "webui/src/lib/act.ts",
@@ -386,25 +386,9 @@
       "path": "webui/src/prompts/payload.ts",
       "sha256": "00aff317aa805303ffb8c6a451bf7b30841cc8a19cf079187cf61a535fe0619a"
     },
-    {
-      "path": "webui/src/tabs/excalidraw/ExcalidrawTab.tsx",
-      "sha256": "e255e3579b7f6c929c05c2437519182e0a429255c94658ff1fe12ac4d356d13f"
-    },
-    {
-      "path": "webui/src/tabs/excalidraw/SessionDetail.tsx",
-      "sha256": "97835ddcd29b89d4768d081ae0c73021fceb7aa174827c8cfb5c68ec1e6e40f0"
-    },
-    {
-      "path": "webui/src/tabs/excalidraw/SessionList.tsx",
-      "sha256": "8d2ea9741214c30c85e8940e95724f71d3d33ab1cfe57f8889f8743285a7f954"
-    },
-    {
-      "path": "webui/src/tabs/excalidraw/words.ts",
-      "sha256": "134b86797a1911abb7d5c396d0603de8a35ed66a8419b98e2d1fef0e154ee5ae"
-    },
     {
       "path": "webui/src/tabs/git/GitTab.tsx",
-      "sha256": "56b08da210544da2b8473228a27d5e0f5e2d4dabb9547610d61e154c1d1a15c3"
+      "sha256": "3514bdf364cc4d20612a86857aa19b795716ca1c8aec9695eef478fd3457c98a"
     },
     {
       "path": "webui/src/tabs/git/PullDetail.tsx",
@@ -428,7 +412,7 @@
     },
     {
       "path": "webui/src/tabs/issues/IssuesTab.tsx",
-      "sha256": "3c4e4a8c181d2a9e2e80793133ecf4c1705b6709f76bc8f32bfc3806e113a230"
+      "sha256": "6c9ba8911c22fea81c77935acfc65fa0b029aba707e38f2caf64f2bd806ea140"
     },
     {
       "path": "webui/src/tabs/issues/words.ts",
@@ -580,31 +564,7 @@
     },
     {
       "path": "webui/src/tabs/registry.tsx",
-      "sha256": "71f5f75285336d3de2d246f5abd704fc7095831c472d93ac3f8be0fd493e396d"
-    },
-    {
-      "path": "webui/src/tabs/sessions/ChatView.tsx",
-      "sha256": "a6d7be372fddb100816304d1b0f8ba2462fa57b05b39394470f432fac5074062"
-    },
-    {
-      "path": "webui/src/tabs/sessions/Dialogs.tsx",
-      "sha256": "b356f5220f0bdbcc8bbc65328033d4ecee5cd19a398ef0980835ba8ff617be21"
-    },
-    {
-      "path": "webui/src/tabs/sessions/SessionDetail.tsx",
-      "sha256": "57a6772eae6441ebe7fc12e43d15cf7ab6e4a5833adc80f67f1467ab68d2bb4e"
-    },
-    {
-      "path": "webui/src/tabs/sessions/SessionsTab.tsx",
-      "sha256": "06b786f615e62fb74aa48de1f8e0e3b850db5796a2782a0371832c0690f5bb7e"
-    },
-    {
-      "path": "webui/src/tabs/sessions/WhereIcon.tsx",
-      "sha256": "4233416cf305ea409bfcc3efd72fff09c57ceaf6e60a1230ec3bb77d150fc21f"
-    },
-    {
-      "path": "webui/src/tabs/sessions/words.ts",
-      "sha256": "4754645dbbb727d1278283f3afdd634b58e4b01e61ddd3f84d6aa84d01f1e8ba"
+      "sha256": "76ceae508932bbe884d0c83d67c45cd3e82786c74314d8827162994e20bd840d"
     },
     {
       "path": "webui/src/tabs/settings/SettingsForm.tsx",
@@ -624,7 +584,7 @@
     },
     {
       "path": "webui/src/tabs/settings/words.ts",
-      "sha256": "c542be63e29fd7bc77a36e1e5bf2b2167f84de30f94fb976c47827283d7984ba"
+      "sha256": "a4a0ba4cf548fcb63d4bacb2c8b7f6c7c20487bf5951d58a7fb04325441f6519"
     },
     {
       "path": "webui/src/tabs/tasks/Comments.tsx",
@@ -652,7 +612,7 @@
     },
     {
       "path": "webui/src/tabs/tasks/ResumeTask.tsx",
-      "sha256": "747a682ab12d2812926ecadb38ce2d8743162e1bfe0fc4731109c62bcef6b6b0"
+      "sha256": "3bbaa2342151be92262f350a7aee0c832a3609a02e1737c356070a17fad67837"
     },
     {
       "path": "webui/src/tabs/tasks/TaskBoard.tsx",
@@ -660,7 +620,7 @@
     },
     {
       "path": "webui/src/tabs/tasks/TaskDetail.tsx",
-      "sha256": "613d4dee6d6060198191cc638afb276bf864dc8828e04a11d63af6b0c6ee811c"
+      "sha256": "91a957d2125347465759276008146e66a8a85e701c6babc7ba4721083d11cebe"
     },
     {
       "path": "webui/src/tabs/tasks/TaskList.tsx",
@@ -720,7 +680,7 @@
     },
     {
       "path": "webui/src/ui/SplitPane.tsx",
-      "sha256": "2e78924aebd7422d08a35fcdb28e15062f766a4cf541d32c27761e0c7953759d"
+      "sha256": "fd8742f29f219fd257e1b682e1bfe032f20d599c8313f829f981ccc1d155dcb9"
     },
     {
       "path": "webui/src/ui/WorkingMark.tsx",

package/webui/dist/index.html

@@ -13,8 +13,8 @@
     <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
     <title>bot-lobby</title>
     <meta property="csp-nonce" nonce="__CSP_NONCE__">
-    <script type="module" crossorigin src="/assets/index-C0T8aK16.js" nonce="__CSP_NONCE__"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-XtSiJAAR.css" nonce="__CSP_NONCE__">
+    <script type="module" crossorigin src="/assets/index-Ct47Kp7Q.js" nonce="__CSP_NONCE__"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-ClwTDiyo.css" nonce="__CSP_NONCE__">
   </head>
   <body>
     <div id="root"></div>

package/src/excalidraw/check.ts

@@ -1,31 +0,0 @@
-/**
- * "Does this session work?": join the room for a moment, as a seat named
- * after the lobby, and say what is there — the server reached, who is in the
- * room, how much is on the board, whether the link's key fits. The seat leaves
- * again at once, so a check never leaves an extra collaborator in the room.
- */
-import { ExcalidrawRoom, type RoomOptions } from "./client.ts";
-import { parseRoomLink } from "./room.ts";
-
-export interface CheckResult {
-  ok: boolean;
-  text: string;
-}
-
-export async function checkSession(link: string, name: string, options: Pick<RoomOptions, "server" | "sceneWaitMs" | "connectTimeoutMs" | "connect"> = {}): Promise<CheckResult> {
-  const parsed = parseRoomLink(link);
-  if (!parsed) return { ok: false, text: "not a valid room link" };
-  const room = new ExcalidrawRoom({ link: parsed, username: "bot-lobby · check", name, ...options });
-  try {
-    const status = await room.ready();
-    // Give an answer to the newcomer's arrival a moment more when someone is there but the board has not come yet.
-    if (status.undecryptable > 0 && status.elements === 0) return { ok: false, text: "reached the room, but its messages would not open: the link's key does not match, so it may have been copied incompletely" };
-    if (status.peers === 0) return { ok: true, text: "reached the server; nobody has this session open yet — open the link in Excalidraw, and agents can read and draw" };
-    const who = status.people.length > 0 ? status.people.join(", ") : `${status.peers} other${status.peers === 1 ? "" : "s"}`;
-    return { ok: true, text: `reached the room with ${who}; ${status.synced ? `${status.elements} element${status.elements === 1 ? "" : "s"} on the board` : "the board has not been sent yet (it comes when someone in the room answers)"}` };
-  } catch (error) {
-    return { ok: false, text: (error as Error).message };
-  } finally {
-    room.close();
-  }
-}

package/src/excalidraw/client.ts

@@ -1,334 +0,0 @@
-/**
- * One agent's seat in an Excalidraw shared session. It joins the room the way
- * a second browser tab would: over Excalidraw's collaboration socket, sending
- * and receiving the encrypted scene messages every client in the room sends.
- * Others in the room answer a newcomer with the whole scene, so a seat learns
- * the board from whoever is there; what the agent draws goes out as an update
- * that every browser merges in place, under the agent's name.
- *
- * A seat never answers a newcomer with a scene it does not have: a browser
- * that took an empty scene from an agent would skip loading the board it saved
- * itself. And it does not draw while nobody else is in the room, because
- * nothing keeps a scene for a room but the browsers in it.
- */
-import { HttpsProxyAgent } from "https-proxy-agent";
-import { io, type Socket } from "socket.io-client";
-import { DEFAULT_ORIGIN, DEFAULT_SERVER, seal, unseal, type RoomLink } from "./room.ts";
-import { describeScene, mergeElements, plainText, planDraw, sceneBounds, visible, type DrawOutcome, type DrawRequest, type Scene, type SceneElement } from "./scene.ts";
-
-/** The part of a socket.io client a seat uses; tests and other transports can stand in for it. */
-export type SocketLike = Pick<Socket, "on" | "emit" | "close" | "connected"> & { id?: string | undefined };
-
-export interface RoomOptions {
-  link: Pick<RoomLink, "roomId" | "roomKey">;
-  /** The name other people see next to this seat's cursor. */
-  username: string;
-  /** The session's name in the lobby, for readings and messages. */
-  name: string;
-  server?: string;
-  connect?: (server: string) => SocketLike;
-  /** Give up on reaching the server after this long. */
-  connectTimeoutMs?: number;
-  /** How long to wait for a collaborator to send the scene (Excalidraw's own client waits five seconds). */
-  sceneWaitMs?: number;
-}
-
-export interface RoomStatus {
-  connected: boolean;
-  /** Others in the room, people and agents, not counting this seat. */
-  peers: number;
-  /** A collaborator has sent the whole scene. */
-  synced: boolean;
-  elements: number;
-  /** Messages that would not open: the link's key does not match the room's. */
-  undecryptable: number;
-  /** Names the collaborators have given themselves. */
-  people: string[];
-}
-
-const CONNECT_TIMEOUT_MS = 10_000;
-const SCENE_WAIT_MS = 5000;
-/** The collaboration server relays at most a megabyte a message; a scene near that is not sent whole. */
-const MAX_MESSAGE_CHARS = 900_000;
-
-function defaultConnect(server: string): SocketLike {
-  const proxy = proxyFor(server);
-  // Where a network lets plain HTTPS through but not a websocket, the seat falls back to long-polling, as a browser does.
-  // socket.io types `agent` for browsers (string | boolean); in Node it is passed on to the http and ws requests as an http.Agent.
-  const agent = proxy ? { agent: new HttpsProxyAgent(proxy) as unknown as string } : {};
-  // Excalidraw's collaboration server refuses handshakes whose Origin is not on its allowlist, so a seat presents the site a browser would come from.
-  let site = DEFAULT_ORIGIN;
-  if (server !== DEFAULT_SERVER) {
-    try {
-      site = new URL(server).origin;
-    } catch {
-      /* fall back to DEFAULT_ORIGIN */
-    }
-  }
-  return io(server, { transports: ["websocket", "polling"], tryAllTransports: true, autoUnref: true, timeout: 8000, extraHeaders: { Origin: site }, ...agent });
-}
-
-/**
- * The proxy the environment names for this server (`HTTPS_PROXY`, `HTTP_PROXY`,
- * `ALL_PROXY`, in either case), unless `NO_PROXY` exempts its host. Node's own
- * sockets ignore these variables, so without this a seat on a network that only
- * lets traffic out through a proxy never reaches the server.
- */
-export function proxyFor(server: string, env: NodeJS.ProcessEnv = process.env): string | undefined {
-  let url: URL;
-  try {
-    url = new URL(server);
-  } catch {
-    return undefined;
-  }
-  const pick = (...names: string[]) => names.map((name) => env[name]?.trim()).find((value) => value);
-  const proxy = url.protocol === "http:" ? pick("http_proxy", "HTTP_PROXY", "all_proxy", "ALL_PROXY") : pick("https_proxy", "HTTPS_PROXY", "all_proxy", "ALL_PROXY");
-  if (!proxy) return undefined;
-  const host = url.hostname.toLowerCase();
-  const exempt = (pick("no_proxy", "NO_PROXY") ?? "").split(/[\s,]+/).filter(Boolean);
-  for (const entry of exempt) {
-    if (entry === "*") return undefined;
-    const name = entry.toLowerCase().replace(/:\d+$/, "").replace(/^\*?\./, "");
-    if (host === name || host.endsWith(`.${name}`)) return undefined;
-  }
-  return /^[a-z][a-z0-9+.-]*:\/\//i.test(proxy) ? proxy : `http://${proxy}`;
-}
-
-/**
- * Why a connection failed, in words a person can act on. socket.io reports
- * every transport failure as "websocket error" or "xhr poll error" and keeps
- * the cause (a refused upgrade, an unknown host, a certificate) underneath.
- */
-export function connectFailure(error: unknown): string {
-  const outer = error as { message?: string; description?: unknown; context?: { responseText?: unknown } } | undefined;
-  const description = outer?.description as { message?: unknown } | number | string | undefined;
-  // A websocket keeps its cause in `description`; long-polling keeps the HTTP status there (0 when no response came) and the cause in the request's text.
-  const polled = typeof outer?.context?.responseText === "string" ? outer.context.responseText.split("\n")[0]!.replace(/^Error: /, "") : "";
-  const text =
-    typeof description === "object" && typeof description?.message === "string" && description.message
-      ? description.message
-      : typeof description === "number" && description > 0
-        ? `Unexpected server response: ${description}`
-        : typeof description === "string" && description
-          ? description
-          : polled || outer?.message || "";
-  const status = /Unexpected server response: (\d{3})/.exec(text)?.[1];
-  if (status) return `the connection was refused with HTTP ${status}`;
-  if (/ENOTFOUND|EAI_AGAIN/.test(text)) return `${text}: the server's name did not resolve, so check the network or DNS`;
-  if (/ECONNREFUSED|ECONNRESET|ETIMEDOUT|EHOSTUNREACH|ENETUNREACH/.test(text)) return `${text}: check the network, or set HTTPS_PROXY if it only lets traffic out through a proxy`;
-  if (/certificate|CERT_|SSL|TLS/i.test(text)) return `${text}: a proxy or firewall may be intercepting HTTPS; NODE_EXTRA_CA_CERTS can point at its certificate`;
-  return text;
-}
-
-export function collaborationServer(env: NodeJS.ProcessEnv = process.env): string {
-  return env.BOT_LOBBY_EXCALIDRAW_SERVER?.trim() || DEFAULT_SERVER;
-}
-
-export class ExcalidrawRoom {
-  readonly scene: Scene = new Map();
-  private readonly options: RoomOptions;
-  private socket: SocketLike | undefined;
-  private opening: Promise<RoomStatus> | undefined;
-  private peerIds: string[] = [];
-  private readonly names = new Map<string, string>();
-  private synced = false;
-  private undecryptable = 0;
-  private closed = false;
-  private timers: Array<ReturnType<typeof setTimeout>> = [];
-
-  constructor(options: RoomOptions) {
-    this.options = options;
-  }
-
-  get name(): string {
-    return this.options.name;
-  }
-
-  /** Which room this seat is in; a seat is replaced when its session's link changes. */
-  get linkKey(): string {
-    return `${this.options.link.roomId},${this.options.link.roomKey}`;
-  }
-
-  status(): RoomStatus {
-    return {
-      connected: this.socket?.connected ?? false,
-      peers: this.peerIds.length,
-      synced: this.synced,
-      elements: visible(this.scene).length,
-      undecryptable: this.undecryptable,
-      people: [...new Set(this.peerIds.map((id) => this.names.get(id)).filter((name): name is string => Boolean(name)))],
-    };
-  }
-
-  /** Join the room (once) and wait until a collaborator has sent the scene, or the wait for it is over. */
-  ready(): Promise<RoomStatus> {
-    this.opening ??= this.open();
-    return this.opening;
-  }
-
-  private open(): Promise<RoomStatus> {
-    return new Promise((resolve, reject) => {
-      // A seat that failed to connect once may try again.
-      this.closed = false;
-      const { roomId } = this.options.link;
-      const server = this.options.server ?? collaborationServer();
-      const socket = (this.options.connect ?? defaultConnect)(server);
-      this.socket = socket;
-      let done = false;
-      let lastError = "";
-      const settle = () => {
-        if (done) return;
-        done = true;
-        resolve(this.status());
-        this.announce();
-      };
-      this.timers.push(
-        setTimeout(() => {
-          if (done) return;
-          done = true;
-          this.opening = undefined;
-          this.close();
-          // Only the proxy's host is named: its URL may carry a password.
-          const via = this.options.connect ? undefined : proxyFor(server);
-          reject(new Error(`could not reach the Excalidraw collaboration server ${server}${via ? ` through the proxy ${new URL(via).host}` : ""}${lastError ? ` (${lastError})` : ""}`));
-        }, this.options.connectTimeoutMs ?? CONNECT_TIMEOUT_MS),
-      );
-      socket.on("connect_error", (error: Error) => {
-        lastError = connectFailure(error) || lastError;
-      });
-      // Every (re)connection is greeted with init-room; the seat answers by joining.
-      socket.on("init-room", () => {
-        socket.emit("join-room", roomId);
-        this.timers.push(setTimeout(settle, this.options.sceneWaitMs ?? SCENE_WAIT_MS));
-      });
-      socket.on("first-in-room", () => settle());
-      socket.on("room-user-change", (clients: string[]) => {
-        this.peerIds = clients.filter((id) => id !== socket.id);
-        for (const id of [...this.names.keys()]) if (!clients.includes(id)) this.names.delete(id);
-      });
-      socket.on("new-user", () => {
-        // What this seat does not know, it does not claim to.
-        if (this.synced || visible(this.scene).length > 0) void this.send("SCENE_INIT", [...this.scene.values()]);
-      });
-      socket.on("client-broadcast", (data: unknown, iv: unknown) => {
-        void this.receive(data, iv).then((initial) => {
-          if (initial) settle();
-        });
-      });
-    });
-  }
-
-  /** A received message; true when it was the scene a newcomer is waiting for. */
-  private async receive(data: unknown, iv: unknown): Promise<boolean> {
-    const message = (await unseal(this.options.link.roomKey, data, iv)) as { type?: string; payload?: Record<string, unknown> } | undefined;
-    if (!message || typeof message !== "object") {
-      this.undecryptable += 1;
-      return false;
-    }
-    const payload = message.payload ?? {};
-    switch (message.type) {
-      case "SCENE_INIT":
-      case "SCENE_UPDATE":
-        if (Array.isArray(payload.elements)) mergeElements(this.scene, payload.elements);
-        if (message.type === "SCENE_INIT") this.synced = true;
-        return message.type === "SCENE_INIT";
-      case "MOUSE_LOCATION":
-      case "IDLE_STATUS":
-        if (typeof payload.socketId === "string" && typeof payload.username === "string" && plainText(payload.username)) this.names.set(payload.socketId, plainText(payload.username).slice(0, 40));
-        return false;
-      default:
-        return false;
-    }
-  }
-
-  /** Send a scene message to the room; false when the seat is not connected. */
-  private async send(type: "SCENE_INIT" | "SCENE_UPDATE" | "IDLE_STATUS" | "MOUSE_LOCATION", body: unknown): Promise<boolean> {
-    const socket = this.socket;
-    if (!socket?.connected || this.closed) return false;
-    const payload = type === "SCENE_INIT" || type === "SCENE_UPDATE" ? { elements: body } : body;
-    if (JSON.stringify(payload).length > MAX_MESSAGE_CHARS) return false;
-    const sealed = await seal(this.options.link.roomKey, { type, payload });
-    socket.emit("server-broadcast", this.options.link.roomId, sealed.data, sealed.iv);
-    return true;
-  }
-
-  /**
-   * Tell the room who this seat is (its collaborator name), and where it just
-   * drew. Excalidraw sends these as volatile messages because it sends them
-   * constantly; a seat says it once, so it does not let the server drop it.
-   */
-  private announce(near?: { x: number; y: number }): void {
-    const socketId = this.socket?.id;
-    if (!socketId) return;
-    void this.send("IDLE_STATUS", { socketId, userState: "active", username: this.options.username });
-    if (near) void this.send("MOUSE_LOCATION", { socketId, pointer: { x: near.x, y: near.y, tool: "pointer" }, button: "up", selectedElementIds: {}, username: this.options.username });
-  }
-
-  /** Why nothing may be drawn right now, or undefined when it may. */
-  cannotDraw(): string | undefined {
-    if (!this.socket?.connected) return "this seat is not connected to the room";
-    if (this.peerIds.length === 0) return "nobody else is in the room, and only a browser keeps a room's board; ask the user to open the session's link in Excalidraw, then try again";
-    return undefined;
-  }
-
-  /** Draw: the elements go out to the room and into this seat's own scene. */
-  async draw(request: DrawRequest): Promise<DrawOutcome> {
-    const outcome = planDraw(this.scene, request);
-    if (outcome.changed.length === 0) return outcome;
-    const reason = this.cannotDraw();
-    if (reason) return { ...outcome, changed: [], drawn: [], removed: [], problems: [...outcome.problems, reason] };
-    for (const element of outcome.changed) this.scene.set(element.id, element);
-    await this.send("SCENE_UPDATE", outcome.changed);
-    const around = sceneBounds(outcome.changed.filter((element) => !element.isDeleted));
-    this.announce(around ? { x: around.x1, y: around.y1 } : undefined);
-    return outcome;
-  }
-
-  /** The board in words, for a model, with what is known about the room around it. */
-  read(): string {
-    const status = this.status();
-    const notes: string[] = [];
-    if (!status.connected) notes.push("Not connected to the room right now; this is the board as last seen.");
-    else if (status.undecryptable > 0 && status.elements === 0) notes.push("Messages in this room would not open: the session link's key does not match the room's, so it may have been copied incompletely.");
-    else if (status.peers === 0) notes.push("Nobody else is in the room, so the board above is not known: ask the user to open the session's link in Excalidraw, then read again.");
-    else if (!status.synced) notes.push("No collaborator has sent the whole board yet, so this may be incomplete; read again in a few seconds.");
-    if (status.peers > 0) notes.push(`In the room with you: ${status.people.length > 0 ? status.people.join(", ") : `${status.peers} other${status.peers === 1 ? "" : "s"}`}.`);
-    return [describeScene(this.scene, this.options.name), ...notes].join("\n");
-  }
-
-  elements(): SceneElement[] {
-    return visible(this.scene);
-  }
-
-  close(): void {
-    this.closed = true;
-    for (const timer of this.timers) clearTimeout(timer);
-    this.timers = [];
-    this.socket?.close();
-  }
-}
-
-/** The seats an agent has open, one per session, kept for the length of its run. */
-export class RoomPool {
-  private readonly rooms = new Map<string, ExcalidrawRoom>();
-  private readonly make: (options: RoomOptions) => ExcalidrawRoom;
-
-  constructor(make: (options: RoomOptions) => ExcalidrawRoom = (options) => new ExcalidrawRoom(options)) {
-    this.make = make;
-  }
-
-  /** The seat for a session, opened on first use; a session whose link changed gets a new seat. */
-  room(key: string, options: RoomOptions): ExcalidrawRoom {
-    const existing = this.rooms.get(key);
-    if (existing && existing.linkKey === `${options.link.roomId},${options.link.roomKey}`) return existing;
-    existing?.close();
-    const room = this.make(options);
-    this.rooms.set(key, room);
-    return room;
-  }
-
-  closeAll(): void {
-    for (const room of this.rooms.values()) room.close();
-    this.rooms.clear();
-  }
-}