c1881f58e6
Inclui console handoff Desk↔Console (Spec 019), melhorias DNS Viewer (037), OpenPanel/Nextcloud/VM116 deploy notes, contracts stack e sidebar actualizado. Co-authored-by: Cursor <cursoragent@cursor.com>
48 lines
1.3 KiB
Markdown
48 lines
1.3 KiB
Markdown
# Ligbox Onboard Agents — Cloudflare Workers (Spec 037 B/C/D)
|
|
|
|
Orquestração edge do onboarding DNS/CF/proj_*.
|
|
|
|
## Fases
|
|
|
|
| Fase | Conteúdo |
|
|
|------|----------|
|
|
| A | VM112 FastAPI (fonte de verdade) |
|
|
| B | `OnboardMaestro` Durable Object |
|
|
| C | `ProjMailAgent`, `CfZoneAgent`, `CfHandoffAgent` |
|
|
| D | handoff + provision-client-account via VM112 |
|
|
|
|
## Dev
|
|
|
|
```bash
|
|
cd projects/cloudflare-agents/onboard
|
|
npm install
|
|
npm run dev
|
|
```
|
|
|
|
## Deploy
|
|
|
|
**Não commitar o token.** Guarde em `secrets/cloudflare-wrangler.token` (uma linha `cfat_...`).
|
|
|
|
```bash
|
|
cd projects/cloudflare-agents
|
|
chmod +x deploy.sh
|
|
./deploy.sh
|
|
```
|
|
|
|
`account_id` ibytera já está em `wrangler.toml`. Após deploy: URL `*.workers.dev/health`.
|
|
Rota opcional: `agents.ligbox.com.br` na zona `ligbox.com.br`.
|
|
|
|
## API edge (Fase B)
|
|
|
|
| Método | Path | Descrição |
|
|
|--------|------|-----------|
|
|
| GET | `/health` | Status |
|
|
| POST | `/api/session/{id}/run/proj-mail` | Cria proj_* via VM112 |
|
|
| POST | `/api/session/{id}/run/cf-zone` | provision-zone + apply |
|
|
| POST | `/api/session/{id}/human/ack` | Human-in-the-loop |
|
|
| POST | `/api/session/{id}/run/handoff` | Handoff gestor |
|
|
| GET | `/api/session/{id}/state` | Estado DO |
|
|
|
|
## VM112
|
|
|
|
Toda mutação real passa por `https://onboard.ligbox.com.br/api/onboarding/...`
|