Agents & Sessions

Endpoints for agent identities, expertise, sessions, and brain health.

Agents

GET /agents

List all agent identities.

GET /agents/{name}

Get agent profile by name.

GET /agents/{name}/expertise

Get domain expertise breakdown.

[
  {"domain": "FastAPI", "level": 0.87, "evidence_count": 23, "last_demonstrated": "2026-04-29T..."},
  {"domain": "PostgreSQL", "level": 0.72, "evidence_count": 15, "last_demonstrated": "2026-04-28T..."}
]

GET /agents/{name}/sessions

Session history with quality scores.

GET /agents/{name}/health

Full brain health report.

Nebula (Activity Log)

GET /nebula

Paginated activity log. Query params: limit, offset, action_type.

GET /nebula/dashboard

Aggregated dashboard data: summary metrics, growth over time, activity by biome, knowledge gaps, contradiction trend, top entities.

curl "http://localhost:8000/api/v1/nebula/dashboard?days=30"

GET /nebula/stream

Server-Sent Events stream for real-time activity updates.

curl -N http://localhost:8000/api/v1/nebula/stream

Audit

GET /audit/status

Last audit run results.

POST /audit/run

Trigger a manual audit (dedup, contradictions, confidence decay, transitive inference).

Merge

POST /merge/propose

Propose merging another Galaxy. Body: {"target_galaxy_id": "g-789"}.

POST /merge/{proposal_id}/accept

Accept a merge proposal.

POST /merge/{proposal_id}/reject

Reject a merge proposal.

POST /merge/{proposal_id}/execute

Execute an accepted merge (entity reconciliation, Sun negotiation, data migration).

GET /merge/{proposal_id}

Get proposal details.

GET /merge/{proposal_id}/sun-preview

Preview the merged Sun document.

GET /merge/{proposal_id}/entity-mappings

Preview entity reconciliation mappings.