API Reference

WebSocket Events

Stream real-time events from running sessions via WebSocket connections.

Connecting

ws://api.roundtablelabs.ai/api/sessions/{session_id}/events?token={access_token}

text

Include your access token as a query parameter for authentication.

Event Types

RESEARCH

Agent is researching the topic

CLAIM

Agent presents their opening position

CHALLENGE

Agent challenges another's claim

CONVERGENCE

Agents converge on recommendation

ARTIFACT_READY

Artifacts are ready for download

Example

const ws = new WebSocket(
  `ws://api.roundtablelabs.ai/api/sessions/${sessionId}/events?token=${accessToken}`
);

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log('Event:', data.event_type, data.payload);
  
  if (data.event_type === 'ARTIFACT_READY') {
    // Fetch artifacts
    fetchArtifacts(sessionId);
  }
};

javascript