Stream Run

Opens a Server-Sent Events (SSE) stream for real-time execution progress. This is an alternative to polling GET /v1/runs/{runId} — use whichever fits your architecture better.

Connection: The stream uses standard SSE (text/event-stream). Most HTTP clients and all modern browsers support this natively.

Event types:

Terminal behavior:

• If the execution is already in a terminal state (completed, failed, cancelled) when you connect, the stream sends a single complete or error event and closes.
• Otherwise, the stream stays open and polls internally every 2 seconds.
• The stream automatically closes after 10 minutes with a timeout event.

Agent usage pattern:

const es = new EventSource('/v1/runs/{id}/stream', {
  headers: { 'x-api-key': 'lma_...' }
});
es.addEventListener('complete', (e) => {
  const result = JSON.parse(e.data);
  // result.outputs contains final values
  es.close();
});
es.addEventListener('error', (e) => {
  const result = JSON.parse(e.data);
  console.error(result.errorMessage);
  es.close();
});