wait_for_cdn_freshness
Poll the CDN until a mutable blob URL returns the expected SHA-256, ensuring content freshness before proceeding. Falls back on timeout.
Instructions
Polls the CDN until a MUTABLE blob URL serves the expected SHA-256, or the timeout elapses. For mutable URLs only — for immutable URLs (the immutableUrl returned by blob_put), no waiting is needed; they're bound to a SHA at upload time and never previously cached. Use this after a re-upload to an existing public mutable key when an end-user-visible URL must reflect the new content before continuing. The probe is single-vantage (us-east-1). On timeout, the tool returns isError=true so an agent can branch into a fallback — typically: switch to the immutableUrl.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | Project ID that owns the URL | |
| url | Yes | Mutable blob URL to poll (e.g. https://app.run402.com/_blob/avatar.png) | |
| sha256 | Yes | Expected hex SHA-256 (from a preceding upload) | |
| timeout_ms | No | Max wait in milliseconds (1 000 – 600 000, default 60 000) |