How do I show a run's progress to my own users?

1. Start and stream the run on your server. Keep the key there.
2. Turn events into simple updates for your users:
   • status → "Working…"
   • step with type: "message" → show the text.
   • step with type: "tool" → "Running a command…" (you may not want to show raw arguments).
   • done → show output and links to files.
3. Forward the updates to your front end with your own WebSocket or SSE endpoint.

Tool arguments and output can contain paths or data you don't want users to see, so filter what you forward.

Learn more#

• Streaming events
• Stream run events