// AI Platform Drift

Agents SDK v0.30.0 requires irreversible Pi 1.4 schema migration

Cloudflare developer changelog · published 2026-10-23 04:52 UTC
ACTION NEEDED MIGRATE APIMODEL
WHAT CHANGEDAgents SDK v0.30.0 upgrades PiHarness to Pi 1.4, which migrates session storage to a new SQLite schema that Pi 1.3 cannot read. The upgrade adds hibernation during task sleep, parked task recovery after repeated crashes, storage error recovery, and model stream retry on transient failures.
WHY IT MATTERSThe schema migration is one-way: once deployed, you cannot roll back to any version before v0.30.0. A failed deployment or discovered regression after upgrade requires a forward fix, not a rollback.
WHAT TO DOBefore upgrading to v0.30.0, verify your rollback strategy accounts for the irreversible migration. Test the upgrade in a non-production environment. Review the Agents SDK v0.30.0 changelog and Pi Durable 1.4.0 changelog for breaking changes that affect your harness implementation.
Model-reported confidence 95% (not measured accuracy) Primary source ↗ written by anthropic/claude-sonnet-4.5
Show the reasoning — raw diff, triage verdict, confidence
RAW DIFF
+## Agents - Agents SDK now supports the latest Pi 1.4 release
+https://developers.cloudflare.com/changelog/post/2026-10-22-pi-harness-pi-1-4/
+Thu, 22 Oct 2026 00:00:00 GMT
+
+Agents SDK v0.30.0 runs PiHarness on Pi 1.4 ↗︎, and makes it recover more reliably from evictions, crashes, and storage errors.
+
+Hibernation while Pi's tasks sleep. PiHarness passes Pi's new onWake callback to your harness factory. While a task sleeps, such as during a model retry backoff, the Durable Object can hibernate until the task is due instead of staying in memory.
+Parked tasks. Pi 1.4 parks a task that keeps crashing the object instead of restarting it forever. Parked operations show as parked in pending(), and session.retry() runs them again.
+Recovery from storage errors. PiHarness reopens Pi after a storage error instead of failing every call until the object restarts. Its wake-up job retries failed steps with a backoff instead of being dropped.
+Retried model streams. agents/models/pi-ai reports a cut-off or idle model stream as a transient error, so Pi retries the turn instead of failing it.
+
+Upgrade
+The Agents SDK v0.30.0 changelog ↗︎ has step-by-step upgrade instructions. Point your coding agent at them and upgrade today:
+Copy promptPrompt copied!
+Pi 1.4 migrates the session storage in the object's SQLite database to a schema that Pi 1.3 cannot open, so a deployment cannot roll back past this upgrade. Refer to the Pi Durable 1.4.0 changelog ↗︎ for Pi's own breaking changes.
HOW IT WAS JUDGED
Triage signals below are model-reported assertions, preserved verbatim; they are not independent arithmetic verification.
triage verdictMATERIAL at 0.92, needed 0.5
triage reasoningNew SDK version with breaking schema migration, new API callbacks, and changed error recovery behavior.
signalsnew model version released (Pi 1.4) · SDK version bump (v0.30.0) · breaking change: schema migration prevents rollback · new API surface (onWake callback) · behavioral changes to error handling and task management · upgrade required with irreversible database migration
suppression—
triage modelanthropic/claude-haiku-4.5 ($0.00000)
writer modelanthropic/claude-sonnet-4.5 ($0.00000)