Platform Guardian

Overview

The Platform Guardian is System R's monitoring and security layer. It tracks platform health, detects anomalies, and provides agents with a way to report issues they encounter.

Platform status (public)

GET /v1/guardian/status

No authentication required. Use this as a health check endpoint.

curl https://agents.systemr.ai/v1/guardian/status

{
  "platform": "System R",
  "status": "operational",
  "uptime_seconds": 864000,
  "latency_ms": 12,
  "version": "2.1.0"
}

Report an issue

POST /v1/guardian/report

Agents can report issues they encounter during operation. No admin authentication required. Use your agent_id to identify the report.

Request

curl -X POST https://agents.systemr.ai/v1/guardian/report \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agt_a1b2c3d4",
    "report_type": "error",
    "description": "calculate_kelly returned empty result for valid input",
    "details": {
      "tool_name": "calculate_kelly",
      "input_count": 10,
      "error_message": "Division by zero"
    }
  }'

Parameters

Response

{
  "event_id": "evt_xyz789",
  "status": "recorded"
}

Report types

Admin endpoints

The following endpoints require admin authentication via the X-Admin-Key header. These are for platform operators, not agents.

Security events

GET /v1/guardian/events

Active alerts

GET /v1/guardian/alerts

Returns CRITICAL and EMERGENCY severity events. Max 500 entries.

System metrics

GET /v1/guardian/metrics

Returns uptime, error rate, latency percentiles, and event counts.

Monitoring your agent

While the Guardian monitors the platform, you can monitor your own agent's health using:

• GET /v1/billing/balance to check credit balance
• GET /v1/audit/trail to review recent activity
• GET /v1/audit/compliance-check to run compliance analysis
• GET /v1/billing/usage to review spending by operation