# Everfur Chat Documentation

Primary docs page: /docs
Canonical public contract: /docs/reference/contract
AI-only prompt pack: /ai-prompts/everfur-widget-sdk.md

Public surfaces:
- Hosted widget via /widget/v1.js
- Headless core SDK via @everfur/chat-sdk
- Web React helpers via @everfur/chat-sdk/react
- Native-safe headless usage via @everfur/chat-sdk/react-native

Support boundaries:
- Hosted widget is the only prebuilt UI surface
- No public EverfurChat-style drop-in React component is documented
- React Native / Expo support is headless-only and requires an app-managed UI

Widget API namespace:
- /api/widget/v1/chat
- /api/widget/v1/chat/conversations
- /api/widget/v1/chat/conversations/{conversationId}
- /api/widget/v1/chat/conversations/{conversationId}/messages
- /api/widget/v1/chat/conversations/{conversationId}/classify
- /api/widget/v1/chat/suggested-prompts

Header contract:
- x-everfur-partner-key: required
- x-everfur-session-id: required
- x-everfur-user-ref: durable continuity key when provided
- Content-Type: application/json for JSON bodies

Machine-readable full guide: /llms-full.txt