Runs

started = client.run("workflows.extract-invoice", input={})

result = client.run(
    "workflows.extract-invoice",
    input={},
    wait_for_completion=60,
)

final = client.run_and_wait("agents.invoice-agent", input={})

run = client.runs.get(started.id)
# { id, type, finished, execution, output?, files?, error?, timing, ... }

run = client.runs.get(started.id, expand=["usage", "execution"])
print(run.output, run.usage, run.execution)

listing = client.runs.list(
    type="workflow",
    status="failed,cancelled",
    limit=50,
)

client.runs.usage(started.id)
client.runs.steps(started.id)
client.runs.events(started.id)
client.runs.trace.get(started.id)
client.runs.reviews.get(started.id)
client.runs.reviews.update(started.id, {"note": "Looks wrong", "verdict": "incorrect", "status": "open"})

artifacts = client.runs.artifacts.list(started.id)
content = client.runs.artifacts.download(started.id, artifacts.artifacts[0].path)

client.runs.cancel(started.id)
rerun = client.rerun(started.id, wait_for_completion=60)

result = client.runs.promote(started.id, name="golden-invoice")
print(result.example_id, result.name)