Agent leaves a to-do after a deploy

Problem

Your agent finishes a deploy and moves on. But there's a manual smoke-test you need to run before the client call — and you'll forget if the agent doesn't remind you. You don't need the agent to block; you just need a nudge on your phone.

The MCP call

# After the deploy succeeds — agent does NOT block
ask_user(
    question='Smoke-test /checkout before the 3pm client call.',
    kind='todo',
    context_md=(
        f'Deploy finished at {deploy_time} UTC.\n'
        f'Staging: {staging_url}\n'
        'Verify the Stripe sandbox sees the payment event.'
    ),
    ttl_minutes=480,   # expires end of workday
    notify='push',
)
# Returns immediately — agent continues to the next task

What you get back

The to-do appears in your pail feed and triggers a push notification. You open it on your phone, run the smoke-test, and tap Done. The agent can optionally check get_decision(decision_id) later to confirm you acted on it.

Follow-up calls

To batch multiple to-dos from one deploy, call ask_user multiple times in sequence. Each becomes a separate card in your feed.

Notes

kind='todo' to-dos never block the agent — there is no await_decision needed. The to-do expires silently if you don't act on it within the TTL.