# info.description
Interactive AI concierge, speech intelligence proxies, and capability verification endpoints for Aravind Venugopal's personal portfolio.

# paths./api/health.get.description
Verifies active backend providers (Groq LLM/STT, Sarvam TTS) and issues an IP-bound, 30-minute HMAC session token for subsequent proxy calls.

# paths./api/chat.post.description
Streams grounded conversational responses from Groq (openai/gpt-oss-120b) via Server-Sent Events (SSE). Requires session handshake and profile guardrails.

# paths./api/chat.post.responses.200.description
OpenAI-compatible Server-Sent Events (SSE) token stream.

# paths./api/chat.post.responses.403.description
Forbidden cross-origin or guarded query.

# paths./api/chat-summary.post.description
Generates a 2-3 sentence grounded summary suitable for speech synthesis from a full concierge response.

# paths./api/stt.post.description
Transcribes user audio recording using Groq Whisper Turbo (whisper-large-v3-turbo).

# paths./api/stt.post.requestBody.content.multipart/form-data.schema.properties.audio.description
Audio recording (WAV/WebM/MP4, max 10MB).

# paths./api/tts.post.description
Synthesizes spoken audio using Sarvam Bulbul (bulbul:v3). Returns raw WAV audio bytes.

# paths./api/tts.post.requestBody.content.application/json.schema.properties.text.description
Portfolio text to synthesize (max 520 chars).

# components.securitySchemes.SessionToken.description
Cryptographically signed 30-minute HMAC session token issued by GET /api/health.

# components.securitySchemes.BearerAuth.description
Bearer token authentication for automated agent registration.