call-state-reconciler

Call State Reconciler

A finished call hands you a status word, a task_completed boolean and a confidence score. Three answers jammed into a shape that looks like one, and the one everybody branches on is task_completed.

It comes back true for a voicemail box. The recording picks up, the agent asks its question into the tone, and the call ends completed with a schema-valid result and a high score. Nothing in that payload is a lie. There is simply no field in it that says a person was ever on the line.

This skill covers reading a call properly: how it ended, whether the job got done, and whether the answer came from anybody speaking. Three separate questions, answered separately, each one carrying the field it was read from.

When to use it

Use it before a call result moves anything in a system of record. Booking, dispatching, charging, closing a ticket, marking a lead dead.

Use it when a call will not settle, or when you are looking at a batch of calls and need to know which ones need a person today.

Use it when two signals disagree: the call task says one thing and its recipient says another, or the attempt timing does not match the event stream.

Do not use it on a call nobody acts on automatically. A call that produces a note for a human to read has no branch to get wrong, and this is overhead.

The one field that changes everything

The Calls API carries no answered-by field. The calls guide says so directly and tells you to define the classification yourself in a per-recipient result schema:

{
  "type": "object",
  "required": ["answered_by"],
  "properties": {
    "answered_by": {
      "type": "string",
      "enum": ["human", "ivr", "voicemail", "unknown"],
      "description": "Classify the final endpoint. If an IVR transfers the call to a person, use human."
    }
  },
  "additionalProperties": false
}

Send that and the ending stops being a guess. Without it the honest answer to "did a person pick up" is that nothing in the payload establishes one, which is true and not much use to anybody.