Stream - ProvenLog

GET /v1/stream

WebSocket endpoint for live event streaming.

Connection

const ws = new WebSocket("ws://localhost:7600/v1/stream");

ws.onmessage = (event) => {
  const provenlogEvent = JSON.parse(event.data);
  console.log(provenlogEvent);
};

Message format

Each WebSocket message is a JSON-encoded ProvenLogEvent:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "agent_id": "my-agent",
  "action_type": "TOOL_CALL",
  "action_name": "search_database",
  "action_status": "success",
  "sequence": 42,
  "hash": "sha256...",
  "timestamp": "2026-02-17T10:30:00Z"
}

Events are sent as they’re ingested — there’s no buffering or batching on the server side.

Use cases

Live monitoring — watch agent activity in real time
Alerting — trigger alerts on specific event patterns
Dashboard — the built-in dashboard uses this endpoint for its Live Stream page