Call Me

Ring the human's iPhone, speak the question aloud, and return what they say. Waits up to ~30s; if the result comes back status "ringing", follow up with poll_result. `to` is their 10-digit /call-me number (from the /call-me iOS app — not a real phone number). Pass a previous session_token to stay in the same thread on their phone.

Check on a call that was still ringing. Waits up to ~25s for it to settle; returns the final status and transcript once the human answers, declines, or the ring times out ("missed").

Name this session's conversation thread on the human's phone (e.g. the project or task you are working on). Shown as the thread title in the app.

Send a one-way text to the human's phone (push notification, no ring). `to` is their 10-digit /call-me number. Pass a previous session_token to stay in the same thread.

Wait for the human to send something back to this session — texts and voicemail transcripts arrive here. Long-polls up to wait_s (max 30s); returns {events, cursor}. Pass the returned cursor next time to only see new events. An empty events list just means nothing yet — poll again if you are still waiting.