nudge_pending_readmissions

Send one reminder, with a fresh link, to every member a channel recovery re-admitted who has not joined the new chat yet.

Purpose

After a swap, get_recovery_roll_call shows who is still outside (pending) and whether a reminder may go out (can_nudge). This sends it: one message per straggler with a fresh link, recorded on the operation so the cooldown can be enforced. Every reminder reaches a real person, so do not loop it. The REST twin is POST /v1/recovery/operations/{operation}/nudge.

Required ability

project-recovery:update

Input schema

{
    "type": "object",
    "required": [
        "operation_id"
    ],
    "properties": {
        "operation_id": {
            "type": "string",
            "description": "UUID of the completed channel recovery whose stragglers to remind."
        }
    }
}

Output shape

{
    "data": {
        "operation_id": "9a4d2e71-5b38-4c6f-8e12-3d7c9b0a5f21",
        "nudged": 2
    },
    "meta": {}
}

Example prompts

"Remind the two members who have not joined the new Lounge yet."

Failure modes

VALIDATION_FAILED — nobody is waiting, the last reminder is too recent, the recovery is not a completed channel swap, or not the creator's own; the context carries the reason.
RESOURCE_NOT_FOUND — operation_id is not in this creator's ledger.
AUTHENTICATION_REQUIRED — no authenticated user on the request.
TOKEN_MISSING_ABILITY — token lacks project-recovery:update.

get_recovery_roll_call — read can_nudge first.
Recovery API