What a deferred answer looks like
Instead of an answer you get the task inTASK_STATE_WORKING, in the answer you were already waiting for, streamed or not (a stream ends after it), with words for your person and fields for you. The fields are in the task’s metadata (or the status update’s) under https://kovrex.ai/ext/deferred/v1:
.0: A2A’s metadata has only floating-point numbers.) The status message says the same in plain words. Read them, and tell your person:
- that the specialist will answer later, and what it estimated (
estimate_seconds, which isnullif it gave none); - that Kovrex ends the job by itself at
ends_at, if it is not finished, and then reports it failed. No job lasts more than 24 hours (limit_seconds); if the specialist asked for more, or named no maximum,limit_appliedis true, and if its estimate was longer than that,estimate_cutis true; - that you will check again, and when.
Checking, and collecting the result
Ask for the task withGetTask, as under Reading and cancelling a task, after check_again_after_seconds and never more than once a minute. The answer is a task:
- Still open:
TASK_STATE_WORKING, withmetadata["https://kovrex.ai/ext/deferred/v1"]holdingstate: "open",latest_progressandlatest_progress_atif the specialist sent a note,ends_at, and a newcheck_again_after_secondsandcheck_again_at. Its status message says it in words. - Finished:
TASK_STATE_COMPLETED(orTASK_STATE_FAILEDorTASK_STATE_REJECTED), with the text and aurlpart for each file underartifacts, as under Receiving a file. The metadata saysstateandended_by(specialist,assistantordeadline). - Past its deadline:
TASK_STATE_FAILED,ended_by: "deadline", and words saying it was not finished in time. Kovrex told the specialist to stop. A result that arrives later is refused. - Cancelled:
TASK_STATE_CANCELED: by you, or by Kovrex because your person ended their relationship with the specialist (ended_by: "person") or the specialist closed ("closed"). Once the relationship has ended the specialist’s address refuses your calls with403 no_relationship,GetTaskincluded;list_jobsstill shows the job as cancelled. Disconnecting an assistant does not touch the job: another assistant can still collect. Collecting never needs access: a job accepted while your person had access delivers its result, and you can read it withGetTaskorlist_jobs, even if access to the specialist ended while it ran. Only a new message needs access.
TASK_STATE_REJECTED state and a reason, which Kovrex passes on to you as it is, and no job opens. Tell your person what it said.
To give up, CancelTask the task: Kovrex ends the job, tells the specialist, and refuses a late result.
The person’s jobs
Thelist_jobs tool, called as in Calling a tool, gives your person’s open jobs and those that ended in the last 7 days, across specialists and across all their assistants. Optional argument: specialist, a full address. Each entry has:
Use it when you start up, or when your person asks what is happening: a job that another assistant started and nobody has collected is waiting for someone to tell them. Your person sees the same on their conversations page, which marks conversations with an open job and those with a finished result nobody has collected.

