Human review without a document

pip install "awaithumans>=0.1.11"

export AWAITHUMANS_API_KEY="ah_sk_live_..."

from pydantic import BaseModel, Field


class RefundDecision(BaseModel):
    approved: bool = Field(description="Approve the refund?")
    reason: str | None = Field(default=None, description="Why or why not")

import asyncio
from awaithumans import await_review


async def main() -> None:
    decision = await await_review(
        task_description=(
            "Approve this $4,000 refund on order #4821? The item was "
            "returned and received back in the warehouse, and there are "
            "no prior refunds on the account. Reply yes or no with a "
            "short reason."
        ),
        response_schema=RefundDecision,
        task_metadata={
            "customer": "Acme Corp",
            "order": "#4821",
            "amount": "$4,000",
        },
    )

    if decision.approved:
        print("Approved:", decision.reason)
    else:
        print("Rejected:", decision.reason)


asyncio.run(main())

from awaithumans import await_review_sync

decision = await_review_sync(
    task_description="...",
    response_schema=RefundDecision,
)