Skip to content
Cordum
Cordum
Documentation

Dashboard

The dashboard is an optional Vite + React application. In development it runs onhttp://localhost:5173; the Docker Compose stack serves it onhttp://localhost:8082.

Route groups

Operate
//agents/jobs
Orchestrate
/workflows/approvals
Govern
/govern/overview/govern/tenants/govern/quarantine
Extend / Observe
/packs/schemas/audit/dlq
Settings routes
/settings/health/settings/keys/settings/users/settings/notifications/settings/environments/settings/mcp/settings/config/settings/output-safety/settings/input-safety
public/config.json
{
  "apiBaseUrl": "",
  "apiKey": "",
  "tenantId": "default",
  "principalId": "",
  "principalRole": "",
  "traceUrlTemplate": ""
}

Config fields

  • apiBaseUrl
  • apiKey
  • tenantId
  • principalId
  • principalRole
  • traceUrlTemplate

The app also falls back toVITE_API_URLandVITE_WS_URLwhen present.

Realtime event stream

WebSocket auth
const encoded = base64url(apiKey);
const ws = new WebSocket(
  "wss://localhost:8081/api/v1/stream",
  ["cordum-api-key", encoded],
);
Behavior
  • The client derives the stream URL from the API base URL and appends /stream.
  • Reconnect uses exponential backoff and invalidates cached queries on successful reconnect.
  • Legacy routes such as /pools and /system redirect to current pages.