Conversation
Cross-cutting functions Higento uses to interact with you mid-task rather than to act on a workspace object.
ask-user
Ask a follow-up question in chat. With no options, it's free-text only. With 2+ options it renders buttons plus a custom-answer field; multi-select adds checkboxes and a Confirm button.
Input
| Field | Type | Required | Description |
|---|---|---|---|
question | string | Yes | The single question to ask. |
context | string | No | One short line on why the decision matters. |
options | array | No | 0–8 choices, each \{ id, label \}. Empty/omitted = free-text only. |
allowCustom | boolean | No | With exactly 1 option: also offer a custom answer. (With 2+ options, custom is always on.) |
allowMultipleSelections | boolean | No | With 2+ options: allow selecting several (default single choice). |
defaultAllSelected | boolean | No | Multi-select only: start with all options checked. |
allowAddOptions | boolean | No | Multi-select only: let the user append options before submitting. |
Output
| Field | Type | Description |
|---|---|---|
presented | boolean | true when the question was shown. |
intro | string | The intro line shown above the question. |
questions | array | The single question echoed back for rendering (with its resolved option flags). |