Handbook

A10 — Web UI and chat API

Executor: Composer 2.5

Updated

Ceiling: technical ≤ I2_integrated, autonomy ≤ A1_supervised.

Plan

Add orchestrator web UI and HTTP chat proxy: agent admin, room/agent listing, and /api/chat routing to channel agents.

Do

  1. Add orchestrator/src/forge_agents_orchestrator/ui/ — static SPA or server-rendered admin+chat.
  2. Implement chat_proxy.py — route web chat to agent sidecar or Matrix as-user.
  3. Expose health and agent list endpoints consumed by UI.
  4. Document FAEP (/admin/apps/forge-agents/) vs Caddy /agents/ exposure options.
  5. Do not add Platform envelope wiring in this phase (A11).

Check

forge-agents/scripts/forge-agents-pdca/check-phase-gate.sh A10

Act

Fix UI/API until A10 gate passes; proceed to envelopes (A11).

Refuse

  • A2+ autonomy — web chat must not bypass human approval for register/deregister.
  • Lenses SoR replacement — UI is ops surface only, not ForgeRun editor.
  • Second executor — do not ship alternate UI stack without program override.
  • Analytics dashboard — chat + admin only; analytics remains HORIZON.