Class _ThreadHistoryPayload

libs/code/deepagents_code/app.py:1345–1396

Data returned by `_fetch_thread_history_data`.

@dataclass(frozen=True, slots=True)
class _ThreadHistoryPayload:
    """Data returned by `_fetch_thread_history_data`."""

    messages: list[MessageData]
    """Converted message data ready for bulk loading."""

    context_tokens: int
    """Persisted `_context_tokens` from the checkpoint (0 if absent)."""

    model_spec: str
    """Persisted `_model_spec` from the checkpoint, or `""` for legacy threads
    saved before model persistence existed."""

    model_params: dict[str, Any] | None = None
    """Persisted `_model_params` from the checkpoint, if any."""

    rubric: str | None = None
    """Legacy persisted rubric or graph rubric input, if any."""

    sticky_rubric: str | None = None
    """Persisted sticky rubric, if explicitly recorded by the TUI."""

    sticky_rubric_recorded: bool = False
    """Whether the checkpoint explicitly recorded TUI sticky rubric state."""

    goal_objective: str | None = None
    """Persisted active goal objective, if any."""

    goal_status: GoalStatus | None = None
    """Persisted active goal status, if any.

    Coerced to a known `GoalStatus` (or `None`) at construction; an unrecognized
    persisted value is dropped.
    """

    goal_rubric: str | None = None
    """Persisted accepted goal criteria, if any."""

    goal_status_note: str | None = None
    """Persisted evidence or blocker note, if any."""

    pending_goal_completion_note: str | None = None
    """Persisted completion evidence awaiting rubric/user approval."""

    rubric_status: str | None = None
    """Latest rubric grading status from `RubricMiddleware`, if any."""

    pending_goal_objective: str | None = None
    """Persisted pending goal objective, if any."""

    pending_goal_rubric: str | None = None
    """Persisted pending goal criteria, if any."""


def _new_thread_id() -> str: