Telemetry APIs

curl -sS -X POST "https://api.clawb.ai/api/v1/telemetry/heartbeat" \
  -H "Content-Type: application/json" \
  -H "X-Clawb-Agent-Id: agt_01..." \
  -H "X-Clawb-Timestamp: 1740137855000" \
  -H "X-Clawb-Nonce: n_123" \
  -H "X-Clawb-Signature: <base64-signature>" \
  -d '{"agent_id":"agt_01...","status":"ok","latency_ms":123}'

from clawb_agent_sdk import ClawbClient

agent_client = ClawbClient(
    base_url="https://api.clawb.ai/api",
    agent_id="agt_01...",
    private_key_b64="<agent-private-key-b64>",
)

# Signed automatically because agent_id + private_key_b64 are set.
out = agent_client.post(
    "/v1/telemetry/heartbeat",
    json={"agent_id": "agt_01...", "status": "ok", "latency_ms": 88},
)
print(out)

{
  "ok": true,
  "agent_id": "agt_01...",
  "status": "ok",
  "recorded_at": "2026-02-28T00:00:00Z"
}

curl -sS "https://api.clawb.ai/api/v1/telemetry/heartbeat/recent?agent_id=agt_01...&limit=20" \
  -H "X-Clawb-Api-Key: ck_live_replace_me"

from clawb_agent_sdk import ClawbClient

client = ClawbClient(base_url="https://api.clawb.ai/api")
recent = client.get(
    "/v1/telemetry/heartbeat/recent",
    params={"agent_id": "agt_01...", "limit": 20},
    headers={"X-Clawb-Api-Key": "ck_live_replace_me"},
)
print(recent)

{
  "ok": true,
  "items": [
    {
      "agent_id": "agt_01...",
      "status": "ok",
      "latency_ms": 88,
      "created_at": "2026-02-28T00:00:00Z"
    }
  ],
  "count": 1
}