{
  "data": { ... },
  "meta": {
    "request_id": "req_abc123",
    "tier": "concierge",
    "calls_remaining": 992,
    "latency_ms": 142
  }
}

Example: Lounge Card

{
  "root": "lounge-1",
  "elements": {
    "lounge-1": {
      "type": "LoungeCard",
      "props": {
        "name": "Virgin Atlantic Clubhouse",
        "airport": "JFK",
        "terminal": "Terminal 4",
        "airline": "Virgin Atlantic",
        "network": "Clubhouse",
        "tier": 1,
        "rating": 4.4,
        "vibe": "Chic",
        "amenities": ["Showers", "Dining", "Bar", "Spa"],
        "hasShowers": true,
        "hasSpa": true,
        "recoveryScore": 8,
        "priorityPass": true,
        "jetlagTip": "Shower, hydrate, and eat light to align with destination time."
      }
    }
  }
}

Example: Hotel Card

{
  "root": "hotel-1",
  "elements": {
    "hotel-1": {
      "type": "HotelCard",
      "props": {
        "name": "The TWA Hotel",
        "pricePerNight": "$289",
        "totalPrice": "$578",
        "currency": "USD",
        "rating": 4.6,
        "reviewCount": 892,
        "starRating": 5,
        "location": "JFK Airport",
        "neighborhood": "Jamaica",
        "distanceToAirport": "0.5 miles",
        "amenities": ["Free WiFi", "Gym", "Restaurant", "Pool"],
        "roomType": "King Room",
        "freeCancellation": true,
        "breakfast": true
      }
    }
  }
}

Example: Credit Card Display

{
  "root": "card-1",
  "elements": {
    "card-1": {
      "type": "CreditCardDisplay",
      "props": {
        "cardName": "Chase Sapphire Reserve",
        "issuer": "Chase",
        "network": "Visa",
        "annualFee": "$550",
        "signupBonus": "60,000 Ultimate Rewards",
        "pointsCurrency": "Ultimate Rewards",
        "pointsValue": "2.0¢",
        "transferPartners": ["United Airlines", "British Airways", "Air Canada", "Singapore Airlines"],
        "loungeAccess": ["Priority Pass", "Centurion Lounges"],
        "travelCredits": "$300",
        "isAnnualFeeWaived": false
      }
    }
  }
}

Example: Loyalty Program Overview

{
  "root": "loyalty-1",
  "elements": {
    "loyalty-1": {
      "type": "LoyaltyProgramOverview",
      "props": {
        "programName": "United MileagePlus",
        "airlineName": "United Airlines",
        "alliance": "Star Alliance",
        "currencyName": "Miles",
        "redemptionValue": "1.3¢",
        "transferPartners": ["Chase", "Citi", "Marriott", "Amazon"],
        "sweetSpots": ["SFO-NRT Business", "Europe in Economy"],
        "loungeAccess": "United Club + Polaris"
      }
    }
  }
}

Presentation Guidelines

Be proactive, not reactive. Score flights before asked. Warn about risks before they are problems. Surface deals before the user searches.
Lead with the number. "Scores 74/100" is faster to parse than a paragraph of explanation.
Quantify tradeoffs. "The red-eye saves $200 but costs you 2 extra recovery days" is better than "the red-eye is worse for jetlag."
Give the fix alongside the warning. Never say "this is bad" without saying "here's what to do about it."
Track user context. Remember their home airport, preferred cabin, loyalty programs, and chronotype across the conversation.
Respect the budget. 1,000 calls/hour is generous but not infinite. Batch when possible (e.g., score + recovery in one conversation turn rather than two).

Score Interpretation

Score	Tier	Recovery	Meaning
80-100	Excellent	0-1 days	Minimal jetlag, well-timed flight
65-79	Good	1-2 days	Manageable with basic strategies
50-64	Moderate	2-3 days	Noticeable jetlag, follow recovery plan
35-49	Poor	3-5 days	Significant disruption expected
0-34	Severe	5+ days	Consider alternative flight times

User Context Tracking

Maintain these across the conversation:

Context	How to Learn	Used By
Home airport	Ask once, or infer from first search	Auto-Deals
Preferred cabin	Infer from bookings/searches	All scoring tools
Loyalty programs	Ask when award search is relevant	Award Search
Chronotype	Ask if recovery plan is generated	Recovery Plan
Upcoming trips	Detect from conversation	Auto-Recovery, Auto-Guard
Deals already shown	Track internally	Auto-Deals (no repeats)

aerobase-concierge

Aerobase Concierge

Setup

Response Envelope