REST API endpoints for Archon manifest CRUD #531

Closed
opened 2026-03-25 17:50:30 +00:00 by perplexity · 1 comment
Member

Parent: #527

What

Add REST endpoints to the Nexus API server (port 8642) for reading and triggering body manifests.

Endpoints

GET  /api/archons                    → list all manifests
GET  /api/archons/:agent_id          → single manifest
POST /api/archons/:agent_id/assess   → trigger gauntlet run
GET  /api/archons/:agent_id/history  → assessment history

Storage

SQLite table archon_manifests in the existing Nexus database. Store full JSON manifest + metadata.

POST /assess Flow

  1. Receives agent_id + agent endpoint config
  2. Calls gauntlet MCP server (via subprocess or HTTP) to run assessment
  3. Stores resulting manifest
  4. Emits WS event archon_entering with manifest
  5. Returns manifest in response

Acceptance Criteria

  • All 4 endpoints respond with correct JSON
  • POST /assess triggers gauntlet and returns manifest within 5 min timeout
  • Concurrent GET requests don't block during assessment
  • Manifests validate against body_manifest.schema.json
Parent: #527 ## What Add REST endpoints to the Nexus API server (port 8642) for reading and triggering body manifests. ## Endpoints ``` GET /api/archons → list all manifests GET /api/archons/:agent_id → single manifest POST /api/archons/:agent_id/assess → trigger gauntlet run GET /api/archons/:agent_id/history → assessment history ``` ## Storage SQLite table `archon_manifests` in the existing Nexus database. Store full JSON manifest + metadata. ## POST /assess Flow 1. Receives agent_id + agent endpoint config 2. Calls gauntlet MCP server (via subprocess or HTTP) to run assessment 3. Stores resulting manifest 4. Emits WS event `archon_entering` with manifest 5. Returns manifest in response ## Acceptance Criteria - All 4 endpoints respond with correct JSON - POST /assess triggers gauntlet and returns manifest within 5 min timeout - Concurrent GET requests don't block during assessment - Manifests validate against body_manifest.schema.json
perplexity self-assigned this 2026-03-25 17:50:30 +00:00
Author
Member

Closed per direction shift (#542). Reason: Archon manifest REST API — for 3D avatar system being deleted.

The Nexus has three jobs: Heartbeat, Harness, Portal Interface. This issue doesn't serve any of them.

Closed per direction shift (#542). Reason: Archon manifest REST API — for 3D avatar system being deleted. The Nexus has three jobs: Heartbeat, Harness, Portal Interface. This issue doesn't serve any of them.
perplexity added the deprioritized label 2026-03-25 23:30:23 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Timmy_Foundation/the-nexus#531