Call Me

Return first-setup instructions and a clickable App Store download link when no number is available.

{
  "type": "object",
  "properties": {},
  "title": "setupArguments"
}

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. 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 App Store link. Pass a previous session_token to stay in the same thread on their phone.

{
  "type": "object",
  "properties": {
    "question": {
      "title": "Question",
      "type": "string"
    },
    "to": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "To"
    },
    "from_label": {
      "default": "Someone's AI",
      "title": "From Label",
      "type": "string"
    },
    "session_token": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Session Token"
    }
  },
  "required": [
    "question"
  ],
  "title": "callArguments"
}

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").

{
  "type": "object",
  "properties": {
    "call_id": {
      "title": "Call Id",
      "type": "integer"
    },
    "session_token": {
      "title": "Session Token",
      "type": "string"
    }
  },
  "required": [
    "call_id",
    "session_token"
  ],
  "title": "poll_resultArguments"
}

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 App Store link. Pass a previous session_token to stay in the same thread.

{
  "type": "object",
  "properties": {
    "body": {
      "title": "Body",
      "type": "string"
    },
    "to": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "To"
    },
    "from_label": {
      "default": "Someone's AI",
      "title": "From Label",
      "type": "string"
    },
    "session_token": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Session Token"
    }
  },
  "required": [
    "body"
  ],
  "title": "textArguments"
}

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.

{
  "type": "object",
  "properties": {
    "session_token": {
      "title": "Session Token",
      "type": "string"
    },
    "cursor": {
      "default": 0,
      "title": "Cursor",
      "type": "integer"
    },
    "wait_s": {
      "default": 25,
      "title": "Wait S",
      "type": "integer"
    }
  },
  "required": [
    "session_token"
  ],
  "title": "wait_for_replyArguments"
}

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.

{
  "type": "object",
  "properties": {
    "session_token": {
      "title": "Session Token",
      "type": "string"
    },
    "title": {
      "title": "Title",
      "type": "string"
    }
  },
  "required": [
    "session_token",
    "title"
  ],
  "title": "set_thread_titleArguments"
}