Skip to content
beam-agents
GitHub

dataclass

FallbackContext

beam_agents.core.agent.FallbackContext

FallbackContext(entity_key: 'bytes' = b'', seq: 'int' = 0, snapshot: 'bytes' = b'', kind: 'str' = 'timer', deadline_ms: 'int' = 0, fired_at_ms: 'int' = 0, pending_intent_ids: 'tuple[str, ...]' = ()) -> None

Docstring

Passed to the HITL policy when a pending approval/result times out.

Carries the *expired continuation handle* — the suspended activation's seq, the snapshot the agent persisted, the deadline_ms that elapsed, and the pending_intent_ids nothing ever answered — plus fired_at_ms, the timer's fire timestamp. kind says why the fallback ran; only "timer" exists today.

Every time value the policy could need is carried here so the policy never reads a clock: it runs inside a timer callback whose bundle can be retried, and a retry must reach the same decision.

src/beam_agents/core/agent.py:128

Members

7 declared on FallbackContext

Introspected from the class itself. A member with no docstring is shown as having none rather than described from its name.