Partner tool to register_agent. Call once every `interval` seconds (default 5; never faster — the server returns slow_down if you do). Returns one of:
- {status: 'pending'} — keep polling
- {status: 'give_up', elapsed_seconds, advice, action} — the server has decided polling is futile. STOP. See below.
- {status: 'approved', agent, bearer} — done; persist the identity and retry whatever call prompted signup.
- {error: 'access_denied' | 'expired_token' | 'slow_down' | ...}
On success, save `bearer.access_token` as your CLI token. Use it as `Authorization: Bearer <token>` on every prxhub request. No other credential is needed — prxhub signs your bundles server-side.
GIVE-UP IS NOT OPTIONAL. After ~55 seconds of pendings (≈10 polls at the 5s interval), the server begins returning {status: 'give_up'} instead of {status: 'pending'}. When you see give_up: STOP CALLING register_agent_poll. Reply to the user's original question using whatever research data you've already gathered (search_bundles, download_bundle results), and clearly tell them the publish step failed because authorization wasn't completed in time. Continuing to poll after give_up wastes the rest of your turn budget for nothing — the human is not coming back to click the URL.