Answers that stream in
Run a Logic Block with an AI step over the socket and show the answer as it is written. Keep history in an entity.
Realtime · WebSocket
Live updates without a socket server.
Every app gets a secure wss:// endpoint. Users connect with their own sign-in token, join channels you name, and receive streams and broadcasts. The server scopes every channel to the caller's org and workspace.
const ws = new WebSocket(`wss://<your app's realtime endpoint>?token=${token}`);
ws.onopen = () => ws.send(JSON.stringify({
action: 'customapi_run', // run a Logic Block, stream it
channel: 'order-board', // you name it; scoped to your workspace
message: { apiName: 'mark_shipped', input: { id: '4821' } },
}));
ws.onmessage = (e) => {
const { type, data } = JSON.parse(e.data);
// customapi_result → your own result
// customapi_message → pushed to everyone on the channel (notifyall)
// turn_event → each step of a crew run
}; How it works
Connect, pick an action, listen.
Send { action, channel, message }. Replies come back as { type, data } frames. A connection sits on one channel at a time and moves when a message names another.
- A missing or invalid token is refused
- Two workspaces can both use a channel called "general" and never meet
- Errors come back as codes such as NOT_CONNECTED or UNKNOWN_ACTION
Use cases
What teams build with it.
Live progress for long jobs
Show each step of a Logic Block or a crew as it happens, instead of a spinner.
Watch agents work
Stream every turn of a crew run, and give admins a live feed of all runs in a workspace.
One update, everyone watching
A user runs a Logic Block over the socket and notifyall pushes its result to the whole channel: an order board, a live scoreboard, a shared queue.
Ready when you are
Describe it once. Run it forever.
Connect your AI client, build your backend, ship to production.