/call-me

Ring the human's phone, read `question` aloud word for word, and return what they say back. It does not have to be a question: an update or a summary of the day ahead works too, up to 2000 characters (about two minutes of speech). Waits up to ~30s; if the result comes back status "ringing" or "in_call", follow up with poll_result. On a local client, read `to` from `~/.aiphone/config.json` → `user_number`; this hosted server cannot read that file itself. It is a Call Me app number, not a regular phone number. If missing, returns setup_required with the download links. Pass a previous session_token to stay in the same thread on their phone. By default the call is a conversation: after their answer the line stays up for `say` until you `hang_up`; keep_open=false hangs up after one answer. `language` ("tr", "de", ...) is the language you are speaking; the call's own short lines follow it. Default English.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "call",
    "arguments": {
      "question": "..."
    }
  }
}

End a call you placed. In a keep_open conversation `goodbye` is spoken first (e.g. "Thanks, I'll get on it."); leave it empty to just hang up.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "hang_up",
    "arguments": {
      "call_id": 0,
      "session_token": "..."
    }
  }
}

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

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "poll_result",
    "arguments": {
      "call_id": 0,
      "session_token": "..."
    }
  }
}

In a call placed with keep_open=true, speak `text` to the human and return what they answer, in the same shape as `call`. Only after their previous answer is in. Waits up to ~30s; on "in_call", follow up with poll_result. "open": false means the call has ended. Pass `language` only to switch the language of the call's own lines; empty keeps it. Anything they said while you were thinking comes back as "said_while_waiting".

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "say",
    "arguments": {
      "call_id": 0,
      "session_token": "...",
      "text": "..."
    }
  }
}

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.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "set_thread_title",
    "arguments": {
      "session_token": "...",
      "title": "..."
    }
  }
}

Return first-setup instructions and clickable App Store and Google Play download links when no number is available.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "setup",
    "arguments": {}
  }
}

Send a one-way text to the human's phone (push notification, no ring). On a local client, read `to` from `~/.aiphone/config.json` → `user_number`; this hosted server cannot read that file itself. If missing, returns setup_required with the download links. Pass a previous session_token to stay in the same thread.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "text",
    "arguments": {
      "body": "..."
    }
  }
}

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.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "wait_for_reply",
    "arguments": {
      "session_token": "..."
    }
  }
}