Class TextualSessionState

libs/code/deepagents_code/app.py:1650–1712

Session state for the Textual app.

class TextualSessionState:
    """Session state for the Textual app."""

    def __init__(
        self,
        *,
        auto_approve: bool = False,
        thread_id: str | None = None,
    ) -> None:
        """Initialize session state.

        Args:
            auto_approve: Whether to auto-approve tool calls
            thread_id: Optional thread ID (generates UUID7 if not provided)
        """
        self.auto_approve = auto_approve
        self.approval_mode_key: str | None = None
        self.turn_number = 0
        """1-based user-turn count for the thread (coding-agent-v1 turn_number)."""
        self.turn_id: str | None = None
        """Stable id for the current user turn (coding-agent-v1 turn_id)."""
        # Assign the backing field directly: the setter reads `self._thread_id`
        # to detect a thread change, and it isn't set yet.
        self._thread_id = thread_id or _new_thread_id()

    @property
    def thread_id(self) -> str:
        """Active LangGraph thread id for the session."""
        return self._thread_id

    @thread_id.setter
    def thread_id(self, value: str) -> None:
        # Per-thread turn markers (coding-agent-v1): restart on every thread
        # change so traces never inherit the prior thread's sequence.
        if value != self._thread_id:
            self.turn_number = 0
            self.turn_id = None
        self._thread_id = value

    def advance_turn(self) -> tuple[str, int]:
        """Begin a new user turn, advancing the per-thread turn markers.

        Generates a fresh `turn_id` and increments `turn_number`. Call once per
        user prompt, before building the stream config.

        Returns:
            The `(turn_id, turn_number)` for the new turn.
        """
        from uuid import uuid4

        self.turn_number += 1
        self.turn_id = str(uuid4())
        return self.turn_id, self.turn_number

    def reset_thread(self) -> str:
        """Reset to a new thread.

        Returns: