Docs › Temporal Schedules with RunVouch

Temporal Schedules with RunVouch

A Temporal Schedule starts workflows on time; a worker polling the task queue executes them. With no worker, workflow tasks wait in the queue indefinitely with no error, because from Temporal's point of view nothing is wrong yet.

How it runs on Temporal Schedules

Inside the workflow's first and last activity, or around the worker process if one workflow per process. Use the two HTTP calls from an activity (activities may do I/O; workflows must not).

Store the key

An environment variable on the worker.

Wrap the job

# activities.py (activities may do I/O; workflows must not)
import os, requests
from temporalio import activity
H = {"X-API-Key": os.environ["RUNVOUCH_KEY"], "content-type": "application/json"}

@activity.defn
async def start_run(agent: str) -> str:
    return requests.post("https://api.runvouch.com/v1/runs/start", headers=H, timeout=10,
                         json={"agent": agent, "source": "temporal"}).json()["run_id"]

@activity.defn
async def end_run(run_id: str, ok: bool, rows: int) -> None:
    requests.post("https://api.runvouch.com/v1/runs/end", headers=H, timeout=10,
                  json={"run_id": run_id, "status": "ok" if ok else "fail", "evidence": {"rows": rows > 0}})

# the schedule, once:  temporal schedule create --schedule-id nightly-report --cron "0 2 * * *" \
#   --workflow-type NightlyReport --task-queue reports

rv fails open: if RunVouch is unreachable the job still runs and you get one warning line.

Register the cadence and caps

rv agent nightly-report --cadence 24h --grace 30m --max-runtime 1h --evidence --cap-run-cost 2

Register the agent once, from anywhere with the key. Cadence is what turns a schedule that stopped into an alert; --evidence makes a run without evidence a failure; the caps pause the agent when it overspends.

What goes silent on Temporal Schedules

• No worker on the task queue means the schedule fires and the work waits; the schedule's own counters say "running". MISSED and STALLED both apply.
• Activity retries are unlimited by default; an LLM activity that keeps failing keeps spending. The per-run cap ends it.
• Overlap policy Skip drops a start; that is a MISSED you would otherwise not see.

What RunVouch detects

Need a key? Get a free key · Stuck? contact