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"
}

Field	Description
status	Platform status: operational, degraded, maintenance.
uptime_seconds	Seconds since last restart.
latency_ms	Current API latency in milliseconds.
version	Current platform version.

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

Parameter	Type	Required	Description
agent_id	string	Yes	Your agent ID.
report_type	string	Yes	Type: error, degradation, suspicious_activity.
description	string	Yes	Human-readable description of the issue.
details	object	No	Additional context (tool name, error messages, etc.).

Response

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

Report types

Type	When to use
error	A tool returned an unexpected error or incorrect result.
degradation	Response times are notably slower than usual.
suspicious_activity	Unexpected behavior that might indicate a security issue.

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

Parameter	Description
limit	Max events to return (default 100, max 1000).
category	Filter by event category.
severity	Filter by severity level.

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