Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Quorum is a child process inside the hive container, like the `spektacular` bina

1. Hive writes a fresh random bearer token to a file at boot, and the tenant's Vexa API key (and, if used, the Discord bot token) from its keystore to files.
2. Hive starts `node quorum.mjs serve` with the `QUORUM_*` variables below and supervises it. `GET /healthz` answers `{"ok":true,...}` once it is listening.
3. Hive is the MCP client: `POST http://127.0.0.1:8765/mcp` with `Authorization: Bearer <token>` (streamable HTTP, stateless, JSON responses). Tools: `meeting.join`, `meeting.leave`, `meeting.status`, `transcript.read`, `chat.post`, `say`, `say.tone` (the soft listening chime: played by the Vexa bot, and by quorum itself on Discord), `say.prewarm`, `meeting.delete`. Every result is `{ok:true,...}` or `{ok:false,error:{code,message}}` in `structuredContent` and as JSON text.
3. Hive is the MCP client: `POST http://127.0.0.1:8765/mcp` with `Authorization: Bearer <token>` (streamable HTTP, stateless, JSON responses). Tools: `meeting.join`, `meeting.leave`, `meeting.status`, `transcript.read`, `chat.post`, `say`, `say.tone` (the soft listening chime: played by the Vexa bot, by quorum itself on Discord, and by the desktop companion on the host's computer), `say.prewarm`, `meeting.delete`. Every result is `{ok:true,...}` or `{ok:false,error:{code,message}}` in `structuredContent` and as JSON text.
4. Hive follows each meeting on `GET /events?meeting_id=<id>` (Server-Sent Events, same bearer): `segment`, `chat` and `state` events, one JSON object per `data:` line, `id:` = `seq`. Reconnect with `after_seq=<last seq>` to replay what was missed. `GET /events` without `meeting_id` carries every meeting, including Discord `/hive join` requests.
5. On SIGTERM quorum leaves Discord channels and exits. Vexa bots keep running until hive calls `meeting.leave`; a restarted quorum that is asked to join the same meeting adopts the running bot.

Expand Down Expand Up @@ -64,6 +64,8 @@ Secrets are only ever read from files, on use, so hive can rotate them without a
| `QUORUM_COMPANION_MAX_SEGMENT_S` | `20` | Longer companion speech is cut into segments of this length. |
| `QUORUM_COMPANION_VAD_THRESHOLD` | `500` | Frame RMS (int16 scale) that counts as speech. |
| `QUORUM_COMPANION_OUTBOX_MAX` | `200` | Lines kept for the companion window. |
| `QUORUM_COMPANION_CONNECTED_MS` | `5000` | A companion that fetched its outbox this recently is connected: `say.tone` only plays for a connected companion. |
| `QUORUM_COMPANION_TONE_TTL_MS` | `4000` | A listening tone the companion has not fetched this long after `say.tone` is dropped, so a late chime never plays. |
| `QUORUM_TTS_TIMEOUT_MS` | `30000` | Timeout for each TTS request. |
| `QUORUM_CHAT_MAX_CHARS` | `2000` | Longest `chat.post` text. |
| `QUORUM_CHAT_CONFIRM_TIMEOUT_MS` | `30000` | How long `chat.post {confirm:true}` waits for Vexa to report the line posted or failed. |
Expand Down
Loading
Loading