Class MultiAgentRoomCoordinator

The ids of all rooms the coordinator currently tracks (those with ≥1 agent member).

Asks whether an agent MAY take the floor (speak) now — the read-only arbitration check an agent runs before generating speech. Checked in this order:

1. Unknown room / not a member → denied (UnknownRoom / NotInRoom).
2. A backchannel → granted (Backchannel) always: it never takes the floor, so it cannot interrupt anyone, and a listening acknowledgement is welcome even while a human talks.
3. A human is speaking → denied (HumanSpeaking) — humans win, over the facilitator too.
4. The loop cap is reached → denied (LoopCapReached) — agents stay passive until a human speaks.
5. The floor is reserved by a hand-off → granted to the named agent (HandoffGranted); denied to others (ReservedForHandoff) unless the requester is the facilitator.
6. Otherwise the floor rules: free → FloorFree; already the holder → AlreadyHolder; the facilitator → FacilitatorOverride even over a sitting holder; anyone else → HeldByOtherAgent.

Purely advisory until TakeFloor actually claims the floor — keeping the check (read) and the claim (write) separate lets a caller test-then-act atomically within its own turn.

Finishes an agent's turn with what it actually said, so a short acknowledgement that happened to start while the floor was free is not billed against the loop cap as a full turn. Releases the floor when the agent holds it. When the utterance is a backchannel (see import('@memberjunction/ai-bridge-base').IsBackchannel) the turn is un-counted and logged as a Backchannel.

Adjusts the coordinator-wide limits. Omitted fields keep their current value; non-positive or non-finite values are ignored (a cap of 0 would silence every agent forever, which is never intended).

Returns a snapshot of a room's floor state, or null when the room is unknown. Read-only — for the realtime dashboard / observer console and tests.

Whether a given agent currently holds the floor in a room. An agent that was bumped by a facilitator override or a human checks this to learn it should yield.

Whether a room currently has more than one agent session — i.e. floor arbitration is meaningful. Single-agent rooms can skip the floor dance entirely.

Reports human speech activity in the room (call it as audio from a human participant arrives; it is cheap and idempotent). The FIRST activity after quiet preempts: the floor holder loses the floor (the caller flushes its output through the barge-in path), any pending hand-off is cancelled, and the agent-to-agent loop counter resets. While activity continues — and for the hold window after it stops — every agent is denied.

Reports that the human stopped speaking (an explicit end-of-speech signal). Agents are admitted again immediately instead of waiting out the hold window. Optional — the hold window expires on its own.

Reports a completed human TURN (a final human transcript). Unlike NoteHumanSpeech this does NOT preempt — a final transcript routinely lands AFTER a quick agent has already started answering, and must not cut that answer — it only resets the agent-to-agent loop counter ("until a human speaks").

Records a backchannel an agent voiced WITHOUT holding the floor (an overlay on someone else's turn, or on silence). Changes no floor state and never counts toward the loop cap.

Registers an agent session as a participant in a shared room, creating the room on first member. Idempotent — re-registering the same agent updates its facilitator flag without disturbing the floor. Designating an agent as the facilitator records it as the room's arbiter; only one facilitator is tracked (the latest designation wins, mirroring "one chair").

Releases the floor held by an agent (it finished speaking). A no-op when the agent is not the current holder, so a late/duplicate release can never steal the floor from another agent.

Designates (or re-designates) a room's facilitator at runtime — e.g. when the agent running the Meeting Controls channel is determined after join. The agent must already be a room member.

Overrides the loop cap for ONE room (e.g. a staged agent-to-agent conversation that should run longer).

Atomically attempts to claim the floor for an agent: runs CanTakeFloor and, when granted, records the agent as the floor holder (stamping the take time) and returns the decision. When a facilitator overrides a sitting holder, the holder is replaced — the facilitator now holds the floor (the prior holder should observe this via IsFloorHolder on its next check and yield).

A granted Turn that starts a NEW turn counts toward the loop cap. A granted Backchannel is recorded but changes no floor state. Every grant and denial lands in the room's event log.

Unregisters an agent session from a room (the agent left / its bridge stopped). If the leaving agent held the floor, the floor is released. If it was the facilitator, the facilitator slot is cleared. A hand-off reserved for the leaving agent is dropped (nobody is left to take it). When the last member leaves, the room record is discarded.

An agent hands the floor over. Releases the floor if the agent holds it and, when toAgentSessionId names another member, reserves the floor for that agent for the hand-off TTL — so nobody else can start in the gap and the two never start at once. With no target the floor simply goes free.

A yield from an agent that is not the holder, while another agent holds the floor, is a no-op (NotHolder). The hand-off is refused (the floor is still released if held) while a human is speaking or the loop cap is reached: reserving the floor for an agent that would then be denied would only stall the room.