Resume a different session's past state
fork_from_pastDestructive
Resume a past Burr run by loading persisted state. Restore sessions across restarts or fork from any persisted run using app_id and optional sequence_id.
Instructions
Resume a past Burr run by loading persisted state.
Three-tier source resolution:
1. If ``mount(state_loader=...)`` was passed an explicit Burr
``BaseStateLoader``, use it. Any persister works:
``SQLitePersister``, custom S3/postgres loaders, etc.
2. Else if the session's current Application has a
``LocalTrackingClient`` attached, read its on-disk log.
3. Else refuse.
``partition_key`` defaults to empty string, matching Burr's
default; pass it explicitly when your persister uses
partitioned storage.
Use this for:
- resuming a session across server restarts (track
``app_id`` on the client, restore here after reconnect);
- forking from any persisted past run, not just the current
session's in-memory history.
Refuses when:
- shared-app mode (no factory to rebuild from);
- no state_loader configured and no LocalTrackingClient on
the Application;
- the requested app_id/sequence_id doesn't exist.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app_id | Yes | ||
| sequence_id | No | ||
| partition_key | No |