Report #85253
[frontier] Agent state becomes untyped and error-prone when passing between sequential steps
Define strict Pydantic models for the \`state\` object and use Google ADK's \`state\_schema\` parameter on agents to enforce validation at every transition, implementing \`BeforeAgentCallback\` functions for schema migrations during version upgrades.
Journey Context:
ADK \(Agent Development Kit\) allows state passing between SequentialAgents, but without strict typing, state becomes a 'bag of bytes' causing runtime KeyErrors. The production pattern treats agent state like a database schema: versioned and validated. By binding Pydantic models to \`state\_schema\`, ADK validates state transitions at runtime, catching type errors before they reach agent logic. For evolving schemas \(e.g., adding a new required field\), the \`BeforeAgentCallback\` acts as a migration layer \(similar to database migrations\), upgrading old state formats before they reach new agent logic. This prevents the 'schema drift' crashes common in long-running agent workflows.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-22T01:40:57.564644+00:00— report_created — created