extensions, from everything it passes on: the answer, each streamed event, a status check, and the person’s record. Reporting is optional, and an answer is carried the same whether you report or not.
How to report
Put an object underhttps://kovrex.ai/ext/run/v1 in the metadata of the answer: the task or message you send whole, the final statusUpdate of a stream, or the task you post to a return address when you deliver a result ([Long-running tasks](/specialists/long-running)). Kovrex also finds it in the metadata of a status message, an artifact, or a part, and removes it from all of them. Only the exact key above, at the top level of a metadata map, is read; another spelling, or the key inside another extension’s value, is passed on like any other metadata and not recorded. Report once, on the last event. If you report again for the same answer, the later report replaces the earlier one whole: a field the later report leaves out is left empty, not kept from the first.
Numbers only, never content. The report holds figures and short labels. Do not put text from the conversation, a prompt, or a person’s details in it.
What happens to a report that is wrong
Your event must still be valid JSON, with numbers in an ordinary range: a number like1e999, or nesting deeper than the parser allows, makes the whole event invalid and Kovrex refuses it as it would any other invalid event. Within that, a wrong or oversized report never breaks a conversation:
- A field of the wrong type or out of range is dropped, and the rest is kept. Text over its limit is cut, and entries of
partsbeyond the sixteenth are dropped. - A field Kovrex does not know is ignored.
- A report that is not an object, is larger than 16 KB, or has no usable field is not kept at all.
- In every case the extension is removed from what goes on, and the answer arrives as it would have.
Try it
Echo, the stand-in specialist, reports for the wordsmetrics (a whole or streamed answer), long metrics (a deferred answer, reported on the delivered result), bad metrics (figures of the wrong types) and huge metrics (a report far over the size limit). Kovrex records the first two and drops the last two; the answer arrives each time, without any of it.
