NylorunDocsBeta
A2A

effects/v1

The A2A extension that marks a task whose model call's outcome was lost.

URI: https://docs.nylorun.com/a2a/effects/v1

{
  "statusUpdate": {
    "taskId": "t1.…",
    "contextId": "ticket-4821",
    "status": {
      "state": "TASK_STATE_WORKING",
      "timestamp": "2026-11-02T09:14:07.112Z",
      "message": {
        "role": "ROLE_AGENT",
        "parts": [{ "text": "An action's outcome is uncertain; the agent's operator must resolve it before the task continues." }]
      }
    },
    "metadata": {
      "https://docs.nylorun.com/a2a/effects/v1": { "uncertain": "eff_01J…" }
    }
  }
}

When a crash loses a model call's outcome and the Runtime cannot recover it, the session is uncertain and starts no new turn (see Pauses and control). Over A2A, the task stays TASK_STATE_WORKING, because an operator may still resolve it, and its status update carries this extension.

FieldTypeMeaning
uncertainstringThe id of the effect whose outcome was lost. The session's effect.uncertain event names the same id.

The task goes on only when the session does. To stop waiting, cancel the task with CancelTask; a message sent meanwhile is queued for the next task.