PIR: Add state engine models for email flexibility

[landomen]

Task/Issue URL: https://app.asana.com/1/137249556945/project/72649045549333/task/1213886961787938?focus=true

Description

Adds state engine models for email flexibility.

Steps to test this PR

Will be testable on upstream PRs once whole feature is finished.

UI changes

No UI changes

---

Note

Medium Risk
Adds new state-engine events/side effects for polling email-extracted data, but the runner handler is currently a TODO; if emitted, executions could stall waiting for email data.

Overview
Extends the PIR state engine model to support email confirmation data extraction by adding State.emailExtractedData plus new events (EmailDataReceived, RetryAwaitEmailData) and a new side effect (AwaitEmailData) with polling/timeout metadata.

Updates PirActionsRunner to recognize the new AwaitEmailData side effect and routes it to a new handleAwaitEmailData method (currently unimplemented/TODO).

^{Reviewed by Cursor Bugbot for commit 4a87e70. Bugbot is set up for automated code reviews on this repo. Configure here.}

[landomen]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• PIR: Add email fallback #8656
• PIR: Add getEmailData pixel #8642
• PIR: Fix email data handling #8641
• PIR: Clear emailExtractedData on step completion #8612
• PIR: Update completeRequestData to support scans and email extracted data #8583
• PIR: Add email polling mechanism #8581
• PIR: Add handling of GenerateEmail action #8294
• PIR: Add broker step action handler logic #8282
• PIR: Add state engine models for email flexibility #8233 👈 (View in Graphite)
• PIR: Add new email flexibility action models #8232
• develop

This stack of pull requests is managed by Graphite. Learn more about stacking.