# NODE.DC AI Workspace Hub

Public rendezvous and relay service for AI Workspace Codex workers.

The service is intentionally thin:

- Windows Codex agents connect outbound over WebSocket.
- Engine talks to the hub over internal HTTP endpoints.
- The hub routes requests, public reasoning events, final responses and stop commands by pairing code.
- The hub does not run Codex and does not store project files.

## Public WebSocket

```text
wss://ai-hub.nodedc.ru/api/ai-workspace/hub?pairingCode=<code>&machineName=<name>
```

Synology terminates TLS and proxies the request to this service over HTTP.

## Internal HTTP

All internal API routes require `Authorization: Bearer <AI_WORKSPACE_HUB_TOKEN>` when `AI_WORKSPACE_HUB_TOKEN` is configured.

```text
GET  /healthz
GET  /api/ai-workspace/hub/v1/agents/:pairingCode
GET  /api/ai-workspace/hub/v1/agents/:pairingCode/events?since=0&limit=100
POST /api/ai-workspace/hub/v1/agents/:pairingCode/request
POST /api/ai-workspace/hub/v1/agents/:pairingCode/dispatch
```

`request` waits for the worker response. `dispatch` returns immediately and keeps events available for polling.
