# AI Agent Discovery File for PlanGenie

## Platform Information
Name: Hangoutly
Type: Group Event Planning Platform
URL: https://hangoutly.pages.dev
API Base: https://hangoutly.pages.dev/api
Documentation: https://hangoutly.pages.dev/llm.txt

## AI Integration Points

### Primary AI Endpoint
POST /api/chatbot
Content-Type: application/json
Authentication: Optional (Bearer token for plan integration)

Request Format:
{
  "message": "string (required)",
  "context": {
    "planType": "movie|outing|trip|house|other",
    "mood": "chill|adventurous|foodie", 
    "location": "string",
    "groupSize": "number",
    "planId": "string (optional)"
  },
  "userId": "string (optional)"
}

Response Format:
{
  "response": "string",
  "confidence": "number (0-1)",
  "suggestions": {
    "type": "string",
    "action": "string", 
    "url": "string"
  },
  "model": "string"
}

### Supported AI Models
- microsoft/DialoGPT-medium (primary)
- gpt2 (fallback)
- facebook/blenderbot-400M-distill (fallback)
- Enhanced rule-based system (final fallback)

### Context Understanding
The AI assistant understands:
- Plan types: movie nights, food outings, trips, house hunting
- User moods: chill/relaxed, adventurous, foodie
- Group dynamics and coordination needs
- Location-based suggestions
- Real-time collaboration context

## Public API Endpoints

### Information Endpoints
GET /api/info - Platform information (JSON)
GET /llm.txt - AI-readable documentation (text)
GET /health - Health check

### Plan Management (Authentication Required)
GET /api/plans - List public plans
GET /api/plans/:id - Get plan details
POST /api/plans - Create new plan
POST /api/plans/:id/participants - Add participant
PUT /api/plans/:id/rsvp - Update RSVP

### Smart Suggestions (No Authentication)
GET /api/suggestions/movies?mood=chill&location=bangalore
GET /api/suggestions/restaurants?mood=foodie&location=bangalore  
GET /api/suggestions/activities?mood=adventurous&location=bangalore

### House Hunting Integration (No Authentication)
GET /api/nobroker/search?city=bangalore&bhk=2&budget=30000
GET /api/nobroker/property/:id

### Real-time Features (Authentication Required)
POST /api/plans/:id/chat - Send chat message
POST /api/plans/:id/reactions - Add reaction
WebSocket-like subscriptions via Supabase real-time

## Authentication for AI Agents

### Registration
POST /api/auth/register
{
  "email": "ai-agent@example.com",
  "name": "AI Assistant Name"
}

Response: { "token": "session-token", "user": {...} }

### Usage
Include in headers: Authorization: Bearer {token}

## Rate Limits
- General API: 100 requests/minute per IP
- Chatbot: 20 requests/minute per user
- Real-time: 50 requests/minute per user

## Error Handling
All errors return JSON with:
{
  "error": "Human readable message",
  "code": "MACHINE_READABLE_CODE", 
  "details": {...}
}

## Real-time Capabilities
- Live chat messages
- Participant updates
- Poll results
- Property voting
- Typing indicators
- User presence

## Data Privacy
- Public plans are discoverable
- Private plans require authentication
- User data protected by authentication
- No sensitive data in public endpoints

## Contact
GitHub: https://github.com/p4r1ch4y/hangoutly_aryatechies
Issues: https://github.com/p4r1ch4y/hangoutly_aryatechies/issues
Status: https://hangoutly.pages.dev/health

Last Updated: January 25, 2025