Developer guide

Bee agent

The Flue worker turns text or voice into validated tool calls, responses, and structured UI.

Request flow

1. The client sends text or transcribed speech to the user’s session.
2. Bee interprets the request with current Goal and Highlight context.
3. Validated tools query Convex or submit an intent-level command.
4. The client receives text, optional speech, and structured UI.

Rules

• Keep business invariants in Convex, not model instructions.
• Validate tool inputs before calling backend functions.
• Keep first-focus previews unpersisted until confirmation.
• Fall back to text when generated UI is malformed.

Run and build

bun run agent
bun run --cwd packages/agent build
bun run --cwd packages/agent deploy

The local worker listens on http://localhost:3583. Production deploys to Cloudflare Workers.