{
  "version": "1.2",
  "name": "RadikL Agent Ecosystem",
  "description": "Autonomous Agriculture & Smart Hydroponics Platform",
  "authentication": {
    "type": "RadikL Passport",
    "format": "radikl.web.app-######",
    "header": "X-Agent-Passport",
    "issuance_flow": {
      "step_1": "User generates a LINK_CODE (RADIKL-XXXX) in the app settings.",
      "step_2": "Agent visits /vincular/{code} to redeem the persistent PASSPORT_ID.",
      "step_3": "Agent uses PASSPORT_ID for all subsequent API requests."
    },
    "security": {
      "revocation": "User can revoke any passport instantly at Mi Cuenta > Agentes.",
      "scope_enforcement": "Requests without required scope are rejected with 403 Forbidden.",
      "policies": "SENSORS_CONFIG scope requires high-level trust and user confirmation."
    },
    "scopes": [
      { "id": "READ_NOTIFICATIONS", "description": "Read user alerts and system notifications" },
      { "id": "READ_MESSAGES", "description": "Access private inbox and chat history" },
      { "id": "READ_ORDERS", "description": "View order status and history" },
      { "id": "SENSORS_CONSULT", "description": "Monitor real-time hydroponic sensor data" },
      { "id": "SENSORS_CONFIG", "description": "Write access to sensor rules and actuators" },
      { "id": "CART_MANAGE", "description": "Full access to add/remove items from cart" },
      { "id": "ORDERS_MAKE", "description": "Initiate checkout and place orders" }
    ]
  },
  "entry_points": {
    "discovery_portal": "/agentes",
    "linking_endpoint": "/vincular/{code}",
    "wiki": "/wiki",
    "marketplace": "/productos",
    "automation_center": "/autom"
  },
  "examples": {
    "auth_header": "X-Agent-Passport: radikl.web.app-123456",
    "linking": "GET /vincular/RADIKL-1234"
  },
  "contact": "agentes@radikl.com"
}