Class TaskStateBase

src/tasks_core.py:105–137

Fields every concrete task-state subclass carries. Mirrors ``typescript/src/Task.ts:45-57``. TS uses ``startTime``/``endTime`` in milliseconds; Python convention here is float seconds (``time.time()``) for natural arithmetic. ``output_offset`` is the read cursor for incremental disk

@dataclass(kw_only=True)
class TaskStateBase:
    """Fields every concrete task-state subclass carries.

    Mirrors ``typescript/src/Task.ts:45-57``. TS uses ``startTime``/``endTime``
    in milliseconds; Python convention here is float seconds (``time.time()``)
    for natural arithmetic. ``output_offset`` is the read cursor for
    incremental disk-output reads (Phase 2 transcript writer + Phase 3
    notification XML); kept here on the base because every type writes to a
    file, even if the path/format differs.

    ``notified`` is the duplicate-completion-message guard — once the parent
    has been told a task finished, the flag flips to True via the atomic
    check-and-set in WI-3.1's ``enqueue_agent_notification``.

    ``kw_only=True`` is set so subclasses can override fields like ``type``
    with a Literal default without hitting Python's "non-default argument
    follows default argument" rule. All call sites already pass everything
    by name (refactor plan WI-1.1 specifies keyword construction).
    """

    id: str
    type: TaskType
    status: TaskStatus
    description: str
    start_time: float
    output_file: str
    output_offset: int = 0
    notified: bool = False
    tool_use_id: str | None = None
    end_time: float | None = None
    total_paused_seconds: float = 0.0
    # Per-type extension fields land in subclasses (LocalShellTaskState,
    # LocalAgentTaskState, InProcessTeammateTaskState).


def create_task_state_base(