Generate asynchronously

curl --request POST \
  --url "$PRESENTON_URL/api/v1/ppt/presentation/generate/async" \
  --user "$PRESENTON_USERNAME:$PRESENTON_PASSWORD" \
  --header 'Content-Type: application/json' \
  --data '{
    "content": "Create an FY2027 operating-plan review for a B2B SaaS board. Current ARR is $18.2M, net revenue retention is 118%, gross margin is 76%, enterprise pipeline coverage is 2.8x, and annual logo churn increased from 7% to 9%. Management must decide whether to fund a second enterprise sales pod and whether to move $600K from brand programs into customer retention.",
    "instructions": "Create an executive scorecard, explain the growth and churn trade-offs, compare the two capital-allocation decisions, and finish with a recommendation and measurable next steps. Preserve every supplied value exactly.",
    "tone": "professional",
    "n_slides": 8,
    "template": "general",
    "export_as": "pptx"
  }'

{
  "id": "task-9a827c13f4",
  "type": "presentation.generate",
  "status": "pending",
  "message": "Queued for generation",
  "data": {
    "created_slides": 0,
    "remaining_slides": 8
  }
}

curl --request GET \
  --url "$PRESENTON_URL/api/v1/ppt/presentation/status/task-9a827c13f4" \
  --user "$PRESENTON_USERNAME:$PRESENTON_PASSWORD"

import os
import random
import time

import requests

base_url = os.environ.get("PRESENTON_URL", "http://localhost:5001")
auth = (
    os.environ["PRESENTON_USERNAME"],
    os.environ["PRESENTON_PASSWORD"],
)


def wait_for_task(task_id: str, timeout_seconds: int = 900) -> dict:
    deadline = time.monotonic() + timeout_seconds
    delay = 2.0

    while time.monotonic() < deadline:
        response = requests.get(
            f"{base_url}/api/v1/ppt/presentation/status/{task_id}",
            auth=auth,
            timeout=30,
        )
        response.raise_for_status()
        task = response.json()

        if task["status"] == "completed":
            return task
        if task["status"] == "error":
            raise RuntimeError(task.get("error") or task.get("message"))

        time.sleep(delay + random.uniform(0, 0.5))
        delay = min(delay * 1.5, 15.0)

    raise TimeoutError(f"Task {task_id} did not finish before the deadline")