docs: describe when a prompt listens for the answer

The page said a notification answer is treated like a typed one, without saying
that the prompt has to be listening before the notification exists — the grace
period is why. One paragraph says it, together with the price: a question that
offers a reply field reads in polling mode, so no Tab completion for that
prompt.
This commit is contained in:
2026-10-23 10:25:40 +08:00
parent 16c5e01e44
commit d5c3f712ff
2 changed files with 7 additions and 1 deletions
+6
View File
@@ -45,6 +45,12 @@ session grant: the button means "this once". "Go to terminal" withdraws the
notification and leaves the prompt waiting. A secret is never asked for in a
notification, and never echoed into one.
A prompt that can be answered from the notification reads both surfaces while it
blocks, from the first moment — the notification itself only shows up after
`grace_seconds`, so waiting for it to appear before listening would block on the
terminal alone. Typing at the terminal always wins; a readline-only convenience
(Tab completion on `ask_user_line`) is what a question gives up in exchange.
## Desktop channel
The desktop channel needs the optional extra: