SLA, RBAC & Compliance

POST /api/team/invite
Authorization: Bearer octo_<admin_key>
Content-Type: application/json

{
  "email": "analyst@yourcompany.com",
  "role": "operator"           // "admin" | "operator" | "viewer"
}

DELETE /api/team/members/:user_id
Authorization: Bearer octo_<admin_key>

PATCH /api/team/members/:user_id
Authorization: Bearer octo_<admin_key>
Content-Type: application/json

{
  "role": "viewer"
}

{
  "id": number,              // Unique intent ID (monotonically increasing)
  "text": string,            // The original intent text submitted by the user
  "status": string,          // "completed" | "failed" | "in_progress" | "pending"
  "created_at": ISO8601,     // Timestamp when intent was received
  "completed_at": ISO8601,   // Timestamp when execution finished (null if pending)
  "duration_ms": number,      // Wall-clock execution time in milliseconds

  "winning_agent": {
    "name": string,          // Agent display name (e.g. "Cypress Scout")
    "emoji": string,         // Visual identifier
    "confidence": number,    // Winning bid score (0.0 – 1.0)
    "domain": string,        // Agent's specialist domain
    "reasoning": string      // Agent's self-reported execution rationale
  },

  "competing_agents": [{     // Top-3 agents that submitted bids (excluding winner)
    "name": string,
    "confidence": number,
    "reasoning": string
  }],

  "result": string | null,   // Execution output (markdown, code, or plain text)
  "error": string | null,    // Error message if status = "failed"

  "cost": {
    "input_tokens": number,  // Total input tokens consumed across all agents
    "output_tokens": number, // Total output tokens generated
    "total_tokens": number,  // Sum of input + output
    "cost_usd": number        // Estimated cost in USD (4 decimal places)
  },

  "meta": {
    "auction_tier": string,  // "standard" | "shield"
    "domain_hint": string,   // Optional domain multiplier used
    "api_key_id": string,    // Masked API key identifier (last 8 chars)
    "user_id": number         // Internal user ID of submitter
  }
}

{
  "event_id": "evt_a1b2c3d4",
  "event_type": "intent.completed",
  "timestamp": "2026-04-13T09:00:00.000Z",
  "actor": {
    "user_id": 42,
    "api_key_id": "...abc123",
    "ip": "203.0.113.55"
  },
  "resource": {
    "type": "intent",
    "id": 1234
  },
  "outcome": "success",          // "success" | "failure"
  "duration_ms": 4250,
  "cost_usd": 0.0018,
  "agent": "Cypress Scout"
}

GET /api/admin/analytics/cost-summary
  ?start=2026-04-01&end=2026-04-13
  &group_by=user_id           // "user_id" | "day" | "agent"

Authorization: Bearer octo_<admin_key>

// Response:
{
  "period": { "start": "2026-04-01", "end": "2026-04-13" },
  "total_cost_usd": 12.4832,
  "total_intents": 1847,
  "breakdown": [
    { "user_id": 42, "cost_usd": 7.21, "intents": 982 },
    { "user_id": 57, "cost_usd": 5.27, "intents": 865 }
  ]
}