DeepResearch HITL

import time

while True:
    status = client.deepresearch.status(task_id)

    if status.status in ("awaiting_input", "paused"):
        interaction = status.interaction
        client.deepresearch.respond(
            task_id,
            interaction_id=interaction.interaction_id,
            response=build_response(interaction),  # see checkpoint shapes below
        )
    elif status.status in ("completed", "failed", "cancelled"):
        break

    time.sleep(5)

# planning_questions - interaction.data has {"questions": [{"question": ..., "context": ...}]}
{"answers": [{"question": "What regions?", "answer": "North America and EU"}]}

# plan_review - interaction.data has {"plan": ..., "estimated_steps": ..., "research_areas": [...]}
{"approved": True}
{"approved": False, "modifications": "Focus more on supply chain analysis"}

# source_review - interaction.data has {"domains": [{"domain": ..., "ai_recommendation": ...}], "total_sources": ...}
{"included_domains": ["sec.gov"], "excluded_domains": ["example.com"]}
# Domains not listed fall back to the AI recommendation; pass [] to accept all recommendations.

# outline_review - interaction.data has {"outline": ..., "sections": [...]}
{"approved": True}
{"approved": False, "modifications": "Add a regulatory risks section"}

client.deepresearch.respond_planning_questions(
    task_id, interaction_id=...,
    answers=[("What regions?", "North America and EU")],
)
client.deepresearch.approve_plan(task_id, interaction_id, modifications="...")     # omit modifications to approve
client.deepresearch.respond_source_review(
    task_id, interaction_id,
    included_domains=["sec.gov"], excluded_domains=["example.com"],
)
client.deepresearch.approve_outline(task_id, interaction_id, modifications="...")  # omit to approve

for entry in client.deepresearch.status(task_id).hitl_history or []:
    print(entry.type, "auto_continued:", entry.auto_continued)