Work out what the job really needs
discoverDiscovery: finds the true requirements of the person's job before any model is chosen. Start with purpose: the reply carries the discovery instructions and the evidence catalogue. YOU ask the person the questions (one thing each, plain words, offering the returned choices); then call again with the sealed session, their answers and your structured updates. Each reply gives progress, rejected updates with reasons, next targets, answer choices from live data and a shortlist. At most 5 rounds. Ends with a confirmation view; call with confirm=true once the person agrees. The person can stop any time (end_now=true). Nothing about the person is stored by XFMS.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| answers | No | The person's answers this round, keyed by the question you asked them (short key or the question text), in their exact words. For an XFMS question the person already answered earlier, send {"choice": choice id, "from_earlier": their exact earlier words} instead of asking it. | |
| confirm | No | The person agrees with the confirmation view. | |
| context | No | Optional, with the person's consent: short labelled excerpts (sample inputs, a conversation summary). Used for this request only, never kept. | |
| end_now | No | The person wants to stop and see the best result so far. | |
| purpose | No | The job the person wants an AI model for, in their own words. Needed to start. | |
| session | No | The sealed session value from the previous discover response. Pass it back unchanged. | |
| updates | No | What you learned from the answers, in the format the first discover reply's instructions give: conclusions, requirements, shapes, open_items, item_moves, relation, usage, survivors_matter, pushback. XFMS checks each against its rules and reports any it rejects. | |
| corrections | No | Changes the person makes in the confirmation view: {requirement_id, field, value}. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||