# Symbia Messaging Service

> Real-time messaging bus for users and agents with private/group conversations and admin tooling.

## Overview

Symbia Messaging provides:
- REST APIs for conversations, participants, messages, and control events
- WebSocket stream for realtime messages and control signals
- Admin endpoints for stats, conversation inspection, and moderation
- Identity-based auth (JWT, API key, or session cookie)

## Quick Start

1. **Authenticate**: POST /api/auth/login (proxy to Identity)
2. **List conversations**: GET /api/conversations
3. **Send message**: POST /api/conversations/:id/messages
4. **Realtime**: Connect to WebSocket at `/` for live events

## Authentication

All authenticated endpoints accept:
- Bearer token (JWT): `Authorization: Bearer <token>`
- API key: `X-API-Key: <key>`
- Session cookie: `token` or `symbia_session`

## Key Endpoints

- GET /api/health - Service health
- GET /api/bootstrap - Service metadata + docs URLs
- GET /api/conversations - List conversations
- POST /api/conversations - Create conversation
- POST /api/conversations/:id/messages - Send message
- GET /api/admin/stats - Admin stats
- GET /api/admin/conversations - Admin conversation listing

## Docs

- OpenAPI: /docs/openapi.json (also /api/openapi.json, /api/docs/openapi.json)
- LLM docs: /docs/llms-full.txt (also /api/docs/llms-full.txt)
- Architecture: /docs/messaging-architecture.md
- Spec: /docs/messaging-spec.md