Bee Box documentation · directory: https://beebox.run/docs/dev/ · index: https://beebox.run/docs/dev/index.md · root: https://beebox.run/llms.txt

# Chat

The conversational surface: web chat with the whole box and everything that serves it. One page per member.

## Members

| Member | What it covers |
|---|---|
| [Sessions](https://beebox.run/docs/dev/chat-session-lifecycle.md) | The backend session lifecycle: phases, queue and drain, park and evict, the shared SDK pump. |
| [History](https://beebox.run/docs/dev/chat-history.md) | The transcript and the acceptance record, and how a replayed photo is served. |
| [Check-ins](https://beebox.run/docs/concepts/chat-schedules.md) | Agent-set timers that come back to one conversation (`bbx remind --here`): lifecycle, targeting, persistence. |
| [Review](https://beebox.run/docs/dev/chat-review.md) | The nightly pass that writes a title, `contains`, and `contains-evidence` to each session's husk card. |
| [Quick chat](https://github.com/ianb/beebox/blob/main/beebox/docs/chat/quick-chat.md) | Routing a captured thought to the right conversation, and the rubric that steers it. |
| [Composer](https://beebox.run/docs/dev/composer.md) | The input bar: its coordination machine and a map of its rendered states. |
| [Scroll](https://github.com/ianb/beebox/blob/main/beebox/docs/chat/scroll.md) | Verifying the message list's scroll behavior: the harness, the browser procedure, the trace. |

## Owned elsewhere

- Which engine and model a chat thinks with, fixed at the chat's birth: [model policy](https://beebox.run/docs/concepts/model-policy.md).
- The HTTP endpoints a client uses (send, upload, transcribe, default session): [mobile contract](https://beebox.run/docs/contracts/mobile-contract.md).
- The chat component's invariants for code changes (scroll model, streaming to finalize, the input store): `src/frontend/src/components/chat/AGENTS.md`.
- Husk cards (`_content/chat/web/*.chat.card`) have no current reference; the design is the chat husks plan.