33 lines
1.1 KiB
Markdown
33 lines
1.1 KiB
Markdown
# 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.
|