Quando a Elo trabalha no Estúdio, ela envia pelo stream da conversa um evento screen_command ({id, name, projectId, args}), com name em read, edit, look, resolve_source, follow_job, export, listen ou save_preset; no editor de páginas, read, edit, look (imagem da prévia em cada largura pedida) e inspect (o DOM de cada rota da prévia, em data.documents). O editor aberto executa o comando e devolve o resultado aqui, uma única vez, dentro do tempo do comando; depois disso a resposta é ignorada e a Elo é avisada de que o editor não respondeu.
create_project chega também fora do Estúdio, com projectId vazio e o pedido do projeto em args (kind, name, media, sizes, aspect, durationMs). Quem responde é a aba da conversa: ela cria o projeto e, se o usuário escolheu abrir telas sozinho, abre o editor dele. data traz {projectId, kind, opened}, com opened true só quando o editor foi aberto. Uma aba que não pode criar responde ok false com code: no_editor, e outra aba pode responder no lugar dela.
| Campo | Tipo | Regra |
|---|---|---|
| ok | boolean | true quando o comando foi aplicado |
| data | object | resultado do comando (resumo do projeto, ids criados, estado dos trabalhos) |
| error | object | {code, message} quando ok é false; code em snake_case, message com até 600 caracteres |
| images | string[] | no máximo 1 imagem JPEG ou PNG em data URL, até 1,5 MB |
Comandos que mudam algo (edit, save_preset, create_project) só podem ser aplicados depois de POST /chat/threads/{id}/screen/{commandId}/claim e do evento screen_go com o mesmo claimant; assim, um comando que expirou nunca é aplicado mais tarde.
Só o dono da conversa responde; campos desconhecidos e corpos acima de 2 MB são recusados.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||