feat: F5.3a the simulation rooms on server F

One room per project for everyone in it, held by a few worker_threads,
each room with a replica of the document that Hocuspocus' direct
connection keeps open: changes go in, what the room writes comes back.
/sim?project=... signs in as /sync does and says refusals and partings
as the socket's closing; only a write grant changes the room. The state
names who started the simulation. After the last person the room stays
60 s, then stops, writes back and ends. Freezing stops a running
simulation and refuses to start one, deleting ends the room without
writing back, revoking lets the person go from the room too; a failed
thread ends its rooms, stopping the service stops them all.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-04 14:29:11 +00:00
co-authored by Claude Opus 5.5
parent 5ded84cb33
commit 8cfc518f0c
17 changed files with 1033 additions and 43 deletions
+13 -6
View File
@@ -109,6 +109,8 @@ export interface RoomOptions {
interface Client {
readonly send: (message: HostMessage) => void;
/** Who it is, on F; none in a room of one's own page. */
readonly name: string | undefined;
readonly topics: Set<Topic>;
/** Per card, the number of the last frame sent. */
readonly traceSent: Map<Id, number>;
@@ -149,6 +151,8 @@ export class SimulationRoom {
private readonly browserWindows = new Map<Id, BrowserWindow>();
/** The language of the last start (the pages the devices write themselves). */
private language: PageLanguage | undefined;
/** Who started the simulation that runs. */
private startedBy: string | undefined;
/** Each node's file system and its revision when it was last written back. */
private writtenFiles = new Map<Id, { readonly files: object; readonly revision: number }>();
/** The wall clock's time of the last write-back. */
@@ -320,10 +324,10 @@ export class SimulationRoom {
}
}
/** A new client; it gets the room's state at once. */
connect(send: (message: HostMessage) => void): number {
/** A new client, by name on F; it gets the room's state at once. */
connect(send: (message: HostMessage) => void, name?: string): number {
const id = this.nextClient++;
this.clients.set(id, { send, topics: new Set(), traceSent: new Map(), droppedSent: undefined, appSent: new Map(), nodeSent: new Map(), viewSent: new Map() });
this.clients.set(id, { send, name, topics: new Set(), traceSent: new Map(), droppedSent: undefined, appSent: new Map(), nodeSent: new Map(), viewSent: new Map() });
send(this.state());
return id;
}
@@ -375,7 +379,7 @@ export class SimulationRoom {
for (const topic of input.topics) client.topics.delete(topic);
return;
case 'start':
this.start(input.language);
this.start(input.language, client.name);
return;
case 'stop':
this.stop();
@@ -422,14 +426,14 @@ export class SimulationRoom {
private state(): HostMessage {
const t = this.engine.state.currentTimeMilliseconds;
return message({ kind: 'state', mode: this.mode, speed: this.speed, t, clock: (this.options.epoch ?? Date.now)() - t });
return message({ kind: 'state', mode: this.mode, speed: this.speed, t, clock: (this.options.epoch ?? Date.now)() - t, ...(this.startedBy === undefined ? {} : { startedBy: this.startedBy }) });
}
private broadcast(output: HostMessage): void {
for (const client of this.clients.values()) client.send(output);
}
start(language?: PageLanguage): void {
start(language?: PageLanguage, startedBy?: string): void {
if (this.mode === 'simulation') return;
this.language = language;
const snapshot = this.snapshot();
@@ -442,6 +446,7 @@ export class SimulationRoom {
this.software = this.documentSoftware();
this.syncWindows();
this.mode = 'simulation';
this.startedBy = startedBy;
this.lastWall = this.options.now();
this.lastWriteBack = this.lastWall;
this.broadcast(this.state());
@@ -455,6 +460,7 @@ export class SimulationRoom {
this.engine.handle({ type: 'stop' });
this.dropping.clear();
this.mode = 'design';
this.startedBy = undefined;
this.lastWall = undefined;
this.broadcast(this.state());
this.flush([...this.clients.values()], false);
@@ -487,6 +493,7 @@ export class SimulationRoom {
this.broadcast(message({ kind: 'error', code: 'engineFailed', detail: error instanceof Error ? error.message : String(error) }));
if (this.engine.state.phase === 'running') this.engine.handle({ type: 'stop' });
this.mode = 'design';
this.startedBy = undefined;
this.lastWall = undefined;
this.broadcast(this.state());
this.flush([...this.clients.values()], false);