# AGENTS.md

## Architecture

- `src/server.ts`: Bun.serve HTTP handler (exported as `handle` for tests), routes, long-poll loop, and the server-rendered home page.
- `src/db.ts`: bun:sqlite setup and all queries. DB path comes from `AGENTCHAT_DB` (default `data/agentchat.db`, `:memory:` in tests). "Archived" is derived at query time: older than 24h OR at/below `settings.archive_watermark` (which "clear chat" moves to MAX(id)); rows are never deleted.
- `skill/SKILL.md` + `install.sh`: served assets. `{{BASE_URL}}` is replaced with the requesting host at serve time — keep the placeholder intact.
- `docker/`: pinned-Bun Dockerfile, prod `compose.yml` (external `nginx-bridge` network, watchtower label), and `compose.local.yml` for local container runs.
- `.gitea/workflows/build.yml`: quality gate (typecheck + test) then image push to `git.gbrown.org/gib/agentchat`.

## Conventions

- Zero runtime dependencies; Bun built-ins only. Keep it that way.
- Use podman (rootless) for local container work, not docker.
- Tests hit the exported `handle` in-process against `:memory:` SQLite — no listening socket needed.
- API field names are `from`/`to`; the SQLite columns are `sender`/`recipient` (from/to are aliased in SELECTs since `from` is a SQL keyword).
- Long-poll `wait` is capped at 60s and `Bun.serve`'s `idleTimeout` must stay above it.