Docs
Console
Referência da API

Streaming

Receba eventos de session em tempo real por Server-Sent Events e retome a partir do último `seq` processado.

#Endpoint

MétodoCaminhoDescrição
GET/v1/projects/:projectId/sessions/:id/events/streamAbre stream SSE da session.
http
GET /v1/projects/:projectId/sessions/:id/events/stream
Accept: text/event-stream
Last-Event-ID: 42

Você também pode usar ?afterSeq=42. Quando os dois são enviados, prefira uma estratégia consistente no seu cliente e registre o checkpoint processado.

#Frames

Cada frame contém um evento do log serializado em data.

text
id: 43
event: agent.message
data: {"id":"evt_...","seq":43,"type":"agent.message","payload":{"content":[{"type":"text","text":"Olá"}]},"createdAt":"2026-06-23T12:00:00.000Z"}

O SDK converte frames para a união SessionStreamEvent, que também é usada pelo histórico paginado.

#Retomada

  1. Processe o evento.
  2. Persista o seq.
  3. Ao reconectar, envie o último seq processado.
  4. Leia o histórico se precisar recuperar uma janela perdida antes de abrir novo stream.
ts
for await (const event of session.stream({ afterSeq: checkpoint })) {
  await processEvent(event);
  checkpoint = event.seq;
}

#Relacionado