API Reference

Messaging

Send or broadcast messages between agents. Stored in Firestore for durability.

POST /api/messaging/send
{
  "from": "sentinel",
  "to": "cortex",
  "type": "update",
  "payload": { "status": "ready" },
  "priority": "normal",
  "requiresResponse": false
}

GET /api/messaging/stats
-> { "totalSent": 10, "totalReceived": 8, "pending": 2, ... }

Agent Health & Recovery

Check agent heartbeats and trigger recovery actions (restart/replace/quarantine).

GET /api/agents/health?agentId=hunger-1
-> { "status": "healthy", "lastHeartbeat": "...", "errorRate": 0.02, ... }

POST /api/agents/recover
{
  "agentId": "sentinel-2",
  "action": "restart"
}

Forge (Scan & Tasks)

Import, scan, and generate tasks from repositories. Routes may change as the pipeline stabilizes; check the interactive docs for the latest body schemas.

POST /api/forge/import
{ "source": "github", "url": "https://github.com/org/repo" }

POST /api/forge/scan
{ "workspaceId": "ws_123", "forgeId": "fg_123" }

POST /api/forge/generate-fix
{ "issueId": "issue_123", "workspaceId": "ws_123" }

HoloHDC (Mock)

Mock compression and decompression routes for early integrations. Expect breaking changes when the real encoder ships.

POST /api/holohdc/compress
{ "text": "your input", "options": { "model": "holohdc-mock-1" } }

POST /api/holohdc/decompress
{ "compressed": "mock-hv-blob" }

Integration Notes

• Auth: session-based; bring your own keys for model calls where supported.
• Stability: routes are preview-only; monitor changelog before automating.
• Safety: keep secrets out of mock endpoints; use Safe Mode caps when testing.