Add platform AI Workspace Hub

2026-05-30 13:28:23 +03:00
parent e605e95920
commit 469657d526
13 changed files with 1403 additions and 7 deletions
@@ -0,0 +1,32 @@
+# 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.