Expand description
afhttp ui takeover subcommand. Publishes the takeover panel as a UI
session and blocks until that session ends.
panel and fetch --takeover hand back a URL and exit; whether anyone ever
opened it, and whether they are finished, is left for the agent to guess.
This command is the other half: it holds the session open and returns when
it ends, which for a takeover is the only ending there is. A VNC canvas
carries no submit control, so there is nothing for the person to confirm and
no typed result to collect.
Three deliveries of that one session, because the person is not always at
this machine, and the way to them is not always this machine’s screen.
--mode names which, in AFUI’s own three words, and an unset flag means
AFUI_DELIVERY decides — the variable an unattended runner sets once so
nothing under it pops a window nobody is there to see.
windowopens the panel here, and closing it is the ending.linkstarts AFUI’s one-session remote page and hands back that page’s URL. The takeover credential stays behind AFUI’s proxy.sessionannounces the panel and nothing more, forafui session serveto frame later.
All three go through agent_first_ui::UiDeliveryPlan. The separately
hosted panel uses a short internal lease which this process renews while the
AFUI delivery exists and revokes when it ends. That lease is crash cleanup,
never the user-visible lifetime of a Link or Session.