SILVER
/
NODEDC_PLATFORM
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
NODEDC_PLATFORM/services/ai-workspace-hub/README.md

1.1 KiB
Raw Blame History

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

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.

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.